Performing Bulk Actions in Axis IdP

You can perform the following actions in bulk by using a dedicated CSV (comma-separated values) file:

  • Add/ Edit users- instead of adding individual users, use a CSV file to create and add a number of users to Axis IdP or upload a file with changes.
  • Export users- export a list of current users in Axis IdP to a CSV file to edit their information or delete them from Axis IdP.
  • Delete users- instead of deleting users one by one, create a CSV file with the users you want to delete from Axis IdP.

Adding Users in Bulk

To accelerate the onboarding process, users can be created and imported in bulk using a CSV file.

To create and import users in bulk:

Step 1: Download and modify CSV file

  1. Go to Settings-> Axis IdP-> Users.
  2. Click Bulk Actions-> Import users from CSV
20322032

The Import and Edit Users in Bulk dialog appears.

13701370
  1. Click Download CSV Template.
  2. Open the downloaded CSV file.
  3. Delete the explanation and example rows as shown in the following screenshot:
17121712
  1. Enter the information as shown in the following table.

πŸ“˜

Note

Headers marked with an asterisk (*) are required for importing the users.

FieldDescriptionExample
Email*Enter an email address for the user[email protected]
First Name*Enter the user's first nameBob
Last Name*Enter the user's last nameJones
Username*Enter a username for the userBJones
Password (Optional)Enter a password for the user, You can leave this field empty.Password1
Groups*Enter the names of the groups the user belongs to separated by a semicolon ";"
Note: If left empty, the user will only be added to the general groups determined in the Groups section of the Import and Edit Users in Bulk dialog (see below). If the new file includes changes to existing users, an empty field will remove the user from any groups he was a member of.
Admins; Sales

Step 2: Upload the CSV file to Axis Security

To upload the CSV file:

  1. In the Management Console, go to Settings > Axis IdP-> Users
  2. Click Bulk Actions-> Import users from CSV
20322032

The Import and Edit Users in Bulk dialog appears.

13701370
  1. Click Upload CSV File and attach the modified CSV file.

Group Information (Optional)

  • Click the drop-down menu to select a group to assign all the users to.
  • Start typing to create a new group for the users.

πŸ“˜

Notes

  1. This action will take effect on all of the users created using the CSV file.
  2. If left empty, the users will be added to a default group with a name similar to the following: "users03-01-2022_16.46.30(utc)"

Temporary Users (Optional)

  • Check the Make these users temporary option to delete the users after a certain time in days, weeks, or months.

Step 3: Finalize import

  1. Click Submit.
  2. Click Apply changes-> Commit changes.

Exporting User Data

Export user data from Axis IdP to a CSV file.
To export user data:

  1. In the Management Console, go to Settings > Axis IdP-> Users
  2. Click Bulk Actions-> Export Users to CSV
20322032

The CSV file with Axis IdP users is downloaded to your computer.

Deleting Users in Bulk

To delete users in bulk, create and upload a CSV file with the users' information.

πŸ“˜

Note

You can use the export users option (see above) to create a CSV file with all the users in Axis IdP.

To delete users in bulk:
###Step 1: Download and modify CSV file

  1. In the Management Console, go to Settings > Axis IdP-> Users
  2. Click Bulk Actions-> Delete Users
20322032

The Delete Users dialog appears.

13721372
  1. Click Download CSV Template or use your own CSV file.
  2. Open the downloaded CSV file.
  3. Delete the example row as shown in the following screenshot:
980980
  1. Enter the information as shown in the following table.

πŸ“˜

Note

Headers marked with an asterisk (*) are required for deleting the users.

FieldDescriptionExample
Email*Enter an email address for the user[email protected]
First NameEnter the user's first nameBob
Last NameEnter the user's last nameJones
Username*Enter a username for the userBJones
Password (Optional)Enter a password for the user, You can leave this field emptyPassword1
GroupsEnter the names of the groups the user belongs to separated by a semicolon ";"Admins; Sales

Step 2: Upload the CSV file to Axis Security

To upload the CSV file:

  1. In the Management Console, go to Settings > Axis IdP-> Users
  2. Click Bulk Actions-> Delete Users
20322032

The Delete Users dialog appears.

13721372
  1. Click Upload CSV File and attach the complete CSV file.

Step 3: Finalize deletion

  1. Click Submit.
  2. Click Apply changes-> Commit changes.

Troubleshooting Bulk Actions

The following table describes errors in bulk actions and how to manage them.

ErrorSolution
Invalid CSVMake sure that all the headers (Email, First Name, Last Name, Username, Password, Groups) appear in the file.
The file exceeds the maximum size of 1MBReduce CSV file size or divide it into two or more separate files.
The CSV file is emptyMake sure that all the required fields are populated
The file exceeds the maximum number of 2000 rowsDivide the file into two or more files and upload each one separately
Error: No user was found with the email β€œβ€ and the username β€œβ€Make sure the spelling is correct
Error: Missing Information - Email field can’t be emptyMake sure the Email field is populated for all users
Error: Missing Information - Username field can’t be emptyMake sure the Username field is populated for all users
Error: Invalid username β€œβ€ - Username must be at least 3 charactersMake sure Usernames contain at least 3 characters
Error: A user with the same username β€œβ€œ already exists in the CSV - First appearance will be usedChange the Username and upload the file.
Error: A user with the same username already exists with a different email. Email can only be changed manuallyChange the Email and upload the file.
Error: Invalid email β€œβ€Make sure Emails are valid and adhere to the structure "[email protected]"
Error: A user with the same email already exists with a different username. Username can only be changed manuallyChange the Username and upload the file
Error: A user with the same email β€œβ€ already exists in the CSV - First appearance will be usedChange the Email and upload the file
Error: Password must be at least 8 characters long, use both upper case and lower case letters, and must include one or more digitsChange the password to adhere to requirements