Product Documentation

Provisioning File Formats

Dec 21, 2015

A provisioning file that you create manually and use to import user accounts and properties to Device Manager needs to have the following format:

For a user provisioning file of a .csv file type, the field separator is the ';'. The fields are the following:

user;password;role;group1;group2

Note: Because ';' is used as the separator character, it needs to be escaped if present in string values -> '\;'

An example of a user provisioning file content is as follows:

user01;pwd\;01;USER;myGroup.users01;myGroup.users02;myGroup.users.users01

in which:

  • User: user01
  • Password: pwd;01
  • Role: USER
    Note: Role can only be one of the following: USER, ADMIN, SUPPORT, or DEVICE_PROVISIONING .
  • Groups:
    • myGroup.users02
    • myGroup.users02
    • myGroup.users.users01
      Note: The '.' character is used as a separator to create group hierarchy, and so this character is forbidden in the groups name.

An example of the file format to provision user attributes is as follows:

user;propertyName1;properyValue1;propertyName2;properyValue2

Note: Because ';' is used as the separator character, it needs to be escaped if present in string values -> '\;'

An example of a user attributes provisioning file is as follows:

user01;propertyN;propertyV\;test\;1\;2;prop 2;prop2 value

in which:

  • User: user01
  • Property 1:
    • name: propertyN
    • value: propertyV;test;1;2
      Note: Property attributes must be lower case. The database is case-sensitive
  • Property 2:
    • name: prop 2
    • value: prop2 value