End User Guide

Performing Bulk Actions in Axis IdP

Suggest Edits

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

The Import and Edit Users in Bulk dialog appears.

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

📘

Note

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

Field

Description

Example

Email*

Enter an email address for the user

[email protected]

First Name*

Enter the user's first name

Bob

Last Name*

Enter the user's last name

Jones

Username*

Enter a username for the user

BJones

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

The Import and Edit Users in Bulk dialog appears.

  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

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

The Delete Users dialog appears.

  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:
  1. Enter the information as shown in the following table.

📘

Note

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

Field

Description

Example

Email*

Enter an email address for the user

[email protected]

First Name

Enter the user's first name

Bob

Last Name

Enter the user's last name

Jones

Username*

Enter a username for the user

BJones

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 ";"

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

The Delete Users dialog appears.

  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.

Error

Solution

Invalid CSV

Make sure that all the headers (Email, First Name, Last Name, Username, Password, Groups) appear in the file.

The file exceeds the maximum size of 1MB

Reduce CSV file size or divide it into two or more separate files.

The CSV file is empty

Make sure that all the required fields are populated

The file exceeds the maximum number of 2000 rows

Divide 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 empty

Make sure the Email field is populated for all users

Error: Missing Information - Username field can’t be empty

Make sure the Username field is populated for all users

Error: Invalid username “” - Username must be at least 3 characters

Make sure Usernames contain at least 3 characters

Error: A user with the same username ““ already exists in the CSV - First appearance will be used

Change the Username and upload the file.

Error: A user with the same username already exists with a different email. Email can only be changed manually

Change 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 manually

Change the Username and upload the file

Error: A user with the same email “” already exists in the CSV - First appearance will be used

Change 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 digits

Change the password to adhere to requirements

Updated 23 days ago

Did this page help you?