1. The Add User dialog appears.

   

2. Provide the required details for the mandatory fields (Email, First Name, Last Name, and Password.)

3. To associate the user to a Group: In Add / Select Group (s), select the required check boxes for the available groups from the list. The default groups are Admins and Members.

   

   • To add new group, follow these steps:
     1. Enter the name for a new group in the text field.
     2. Click the Add Group. The new group is created and added to the list.

   If you have not selected any group, the user is added to the Members group by default.

   Note: For more details on how to use Groups, refer to Using Groups in an App.

4. Click ADD USER.

   You can add another user by repeating these steps above in the procedure.

Importing users to a User Repository

You can add multiple users to the Volt MX Foundry console through a CSV file in the Import Users window.

To import users to a User Repository, follow these steps:

1. After you create a user repository identity service, click IMPORT USERS. The Import Users dialog appears.

1. Click IMPORT USERS. The Import Users dialog appears.

   

   You can import multiple users either by using the sample template provided in a .CSV file format or similar to the template.CSV file. The .CSV file must include all the headers such as Email, First Name, Last Name, Password, Phone, Status, and Groups. It is mandatory that the .CSV file contains all the Required Fields (Email, First Name, Last Name, Password, and Phone.)

   Note: Data entered in your .CSV file should have all the following mandatory fields. You can use alphanumeric and special characters to fill the data for each field as follows:

   • Email: Contains only a valid mail.
   • First Name  and  Last Name:

     • Cannot contain special characters:  **>, <, &, +,

       , /, \, ***

     • Min size - 1 (or Empty String) ; Max size - 128
   • Password
     • Contains only a valid password includes at least one uppercase, one lowercase, and one digit.
     • Min size - 8; Max size - 20
   • Phone
     • Contains a white space or a valid phone number (digits 0 to 9, #, -, +)
     • Min size - 1; Max size - 20

   Note: Data entered in your .CSV file can have all the following optional fields:

   • Status  Contains a white space (space or -) or a valid status such as pending, active, blocked, or disabled

     • Pending: Users in the pending state cannot log in or use any of the MBaaS services.

       Users enter the pending state in one of the following ways:

       • A user is imported into authentication via direct user registration to the Volt MX User Repository but pending confirmation from sysadmin/email verification.
       • A user is added to the system after logging in via an external provider. However, the provider’s policy is set to “new users will be in pending state unless confirmed by administrator.”

     • Active: Users can log in and use services.

       Users enter the active state by an admin/user action or due to a policy on provider as default active when logged in to MBaaS.

     • Blocked: Users cannot log in or use any service.

       Blocked is typically an automated action by an authentication service based on policies such as nonconsecutive log-ins.

       Users can be reactivated through an admin action, with a policy that is auto-enabled after 24 hours, or via answers to secret questions.

     • Disabled: Users cannot log in or use any of the services. This status is set by an explicit admin action.

   • Groups
     • Contains group names (digits 0 to 9, #, -, +)

     • Can contain special characters:  **>, <, &, +,

       , /, \, ***

     • Min size - 1 (or Empty String) ; Max size - 128
     • If you want to specify multiple groups, use semi-colon to separate the group names. For example, Employees;Admins;Managers
2. To use the sample template CSV file, follow these steps. Otherwise, proceed to the next Step 4.
   1. Click Download sample CSV file. The sample.CSV file downloads into your local system.
   2. Navigate to the sample.CSV file and open it, and then fill in details. After filling, save the file and then close it.

3. Click the Browse button to browse and upload your CSV file.

   After you select a CSV file, the system shows the file name. If no file is selected, its status is set to  No file selected

   Note: The Import button is made available only after you upload your .CSV file.

4. Click Import to import your data.

   The system will validate your CSV file for the following:

   • If you select any file type other than a CSV file, an error will display, such as Unsupported File type.
   • If the file size is greater than 75KB, an error will display, such as the Selected file is too Hilarge. Size limit is 75KB.

   • If a field in the CSV file contains wrong data, the system will throw an error, as shown below:

     

5. To view error logs, click Download Error Log. The system generates an error.csv file, and prompts you to open or save the file.

6. To continue importing users, click Continue. The system imports only users with valid data into the console successfully, generates an error.csv file, and prompts you to open or save the file. The details of imported users are displayed in the grid list.

   Important:  If you click Continue, the system successfully imports only users with correct data into the console. An error.csv file contains only users fields with invalid data and corresponding error messages.

7. Click Save. The system saves the error.csv in your browser’s default download location. For example, in Firefox, the system prompts you to save or open the file.

   The following is a list of error messages for each field:

   Field With Wrong Data	Error Message Displayed
   Email - for example, sample_email	Email/User ID contains illegal characters and is invalid
   First Name - for example, &&	First Name must be a maximum of 128 characters First Name contains illegal characters and is invalid
   Last Name - for example, &&	Last Name must be at a maximum of 128 characters Last Name contains illegal characters and is invalid
   Phone - for example, 12346753abc	Phone field contains illegal characters and is invalid
   Password - for example, passw	Password must be between 8-20 characters
   Status - for example, my status	User status my status is invalid. Pending, active, blocked, and disabled are valid statuses.