Report errors or omissions

 

Import users and groups

Use the Bulk import users and groups bulk operation to assign users to groups. Before you begin, review the information in Perform bulk operations.

When performing a bulk import of users and groups:

The header row must only contain two headers: the User ID and Group Names separated by the delimiter you select when you perform the bulk import.

Each data row must list an existing user's User ID and a set of groups they are to be associated with. The groups must be identified by the group name.

You can include more than one group name with each user to associate a user to multiple groups in one import operation.

Note: You can include more than one group name with each user to associate a user to multiple groups in one import operation.

CSV file format

The following is a sample CSV file to help you get started. You can also download a sample file from the Bulk Import Users/Group page and then edit it to match your requirements. See Bulk import users and groups.

User ID, Group Names
User1,group1,group2,group3
User2,group1,group3
User3,group1,group3,group4,group5

Download a sample file: UserGroupSample.csv

User/group attributes

The following table summarizes supported Identity as a Service user/group import attributes.

Table: Bulk assign users to groups attributes

Attribute

Header Value

Required

User IDUser ID

The User ID of the user. This value must be unique. If the User ID already exists, then the user record will fail.

User ID

Yes

NameName

The group or groups to be assigned to the user. Every data row must have at least one group name.

Group Names

Yes

Bulk import users and groups

How to bulk import users and groupsHow to bulk import users and groups

Click > Bulk Operations. The Bulk Operations page appears.

Click . The Add Bulk Operation page appears.

From the Actions drop-down list, select Import.

From the Operations drop-down list, select Users/Groups.

Note: When you a select Users/Groups import operation a sample file appears. You can download this file or copy it to a clipboard and then modify it as required.

Select the File Delimiter Pipe (|) or Comma (,). The File Delimiter type identifies the character in your CSV file used to specify the boundary between each user or group name.

Note: If a data field requires a delimiter value or white space, put quotation marks around that field. If you do not, the information will not import.

Set the Maximum Number of Retries to set the number of bulk import attempts if it is not immediately successful. The default value is 5. This setting prevents an endless number of retry attempt if the operation fails.

Enter a unique Name that identifies the operation in the Bulk Operations List page.

Enter a Description that describes the purpose of the operation.

Optional. Copy or download the same bulk file and modify it as required.

Click Initiate. The File to upload dialog box appears.

Click the checkered box and browse to select your bulk import file and click Open.

Click Upload. The Start/Stop dialog box appears.

Click Start. When the upload completes, a Finished prompt appears.

Click Finished. You are returned to the Bulk Operations List page. Your bulk operation appears in the Bulk Operations page.

To see a summary of the upload, click to view the details of the bulk operation, including any error information.

To download a log file of the import operation, click next to the name of your operation to download the log file.

Click in the Refresh column to refresh the status of a bulk operation. This option appears only when a refresh is available.

Click to view the details of the bulk operation.