Bulk Import and Manage DS Users with Rake Tasks

To import and manage DS users in bulk, use the following commands:

asctl faspex:rake users:bulk_create -- -u userfile -p propertyfile
asctl faspex:rake users:bulk_update -- -u userfile -p propertyfile
asctl faspex:rake users:bulk_delete -- -u userfile

Rake Task Options

Option Description

userfile (required)

Option	Description
userfile (required)	Full path to the CSV file specifying attributes to be applied to individual users. For example: `name,first_name,last_name,email,ad_objectguid user1,John,Doe,jdoe@example.com,e43f8A9d325ed740b8dbefb3ca0f7bb8 user2,Susan,Lee,slee@example.com,2b42959ff79507498f0af3138e5d37e3 user3,Jay,Johnson,jjohnson@example.com,cc07cacc5d9dfa40a9fb3a4d50a172b0` The objectGUID is the DS Distinguished Name (DN). Important: If you are importing from Active Directory, you must find the objectGUID attribute for a user and copy it in hexadecimal format. Edit the user and go to Properties > Attribute Editor > objectGUID. Edit the attribute, select hexadecimal format, and copy the whole string. This string is different from the string displayed on the main page. Use this string instead of the one on the main page. When entering the string into the CSV file, enter it as one string without spaces. For example, if the string is "E4 3F 8A 9D 32 5E D7 40 B8 DB EF B3 CA 0F 7B B8", enter it as "E43F8A9D325ED740B8DBEFB3CA0F7BB8".
propertiesfile (required)	Full path to the CSV file specifying attributes to be applied to all users. The properties file for adding DS users to Faspex would look like this: `type,authorization_domain_id DirectoryServiceUser,id_num` The authorization_domain_id can be found by going to Server > Authentication > Directory Services and editing the Directory Service. Look at the URL and find the ID number after "authorization_domains. For example, if the URL is https://198.51.100.24/aspera/faspex/admin/authorization_domains/1/edit, the ID number is "1"

Full path to the CSV file specifying attributes to be applied to individual users.

For example:

name,first_name,last_name,email,ad_objectguid
user1,John,Doe,jdoe@example.com,e43f8A9d325ed740b8dbefb3ca0f7bb8
user2,Susan,Lee,slee@example.com,2b42959ff79507498f0af3138e5d37e3
user3,Jay,Johnson,jjohnson@example.com,cc07cacc5d9dfa40a9fb3a4d50a172b0

The objectGUID is the DS Distinguished Name (DN).

Important: If you are importing from Active Directory, you must find the objectGUID attribute for a user and copy it in hexadecimal format. Edit the user and go to Properties > Attribute Editor > objectGUID. Edit the attribute, select hexadecimal format, and copy the whole string.

This string is different from the string displayed on the main page. Use this string instead of the one on the main page.

When entering the string into the CSV file, enter it as one string without spaces. For example, if the string is "E4 3F 8A 9D 32 5E D7 40 B8 DB EF B3 CA 0F 7B B8", enter it as "E43F8A9D325ED740B8DBEFB3CA0F7BB8".

propertiesfile (required)

Full path to the CSV file specifying attributes to be applied to all users.

The properties file for adding DS users to Faspex would look like this:

type,authorization_domain_id
DirectoryServiceUser,id_num

The authorization_domain_id can be found by going to Server > Authentication > Directory Services and editing the Directory Service. Look at the URL and find the ID number after "authorization_domains. For example, if the URL is https://198.51.100.24/aspera/faspex/admin/authorization_domains/1/edit, the ID number is "1"

Delete Options

Option Description

userfile (required)

Option	Description
userfile (required)	Full path to the CSV file specifying attributes to be applied to individual users. For example: `name user1 user2 user3`

Full path to the CSV file specifying attributes to be applied to individual users.

For example:

name
user1
user2
user3