Skip to content

User Role Import

The user role import package allows to import users role from a CSV file.

Configuration

Configuration

  • User identifier: select the identifier to use to search the user:

    • Username
    • Email

  • Import assets from: select how you want to provide the input file to be processed.

    Directly upload a CSV file containing the assets. Note that this is generally limited to ~10-20MB.

    • Assets file: the CSV file containing details to load, for assets.

    Read the file from an object storage.

    Specify the details of an S3 object, for which there is no size limit.

    • File path: full file path (path + filename including its extension), e.g. path/to/files/file.csv
    • AWS access key: you can leave this blank if a cross-account bucket policy is setup.
    • AWS secret key: you can leave this blank if a cross-account bucket policy is setup.
    • Region: the S3 region where the input file is hosted.
    • Bucket: the bucket from which to retrieve the object store object(s).

    When cross-account bucket policy is required

    When the cross-account bucket policy is required, you must first set up a cross-acount bucket policy for Atlan to have access to your S3 bucket and object within it.

    Specify the details of an GCS object, for which there is no size limit.

    • File path: full file path (path + filename including its extension), e.g. path/to/files/file.csv
    • Project ID: the ID of the GCP project.
    • Service account JSON: the JSON for your service account credentials.
    • Bucket: the bucket from which to retrieve the object store object(s).

    Specify the details of an ADLS object, for which there is no size limit.

    • File path: full file path (path + filename including its extension), e.g. path/to/files/file.csv
    • Azure client ID: he unique application (client) ID assigned to your app by Azure AD when the app was registered.
    • Azure client secret
    • Azure tenant ID: the unique identifier of the Azure Active Directory instance.
    • Storage account name: the name of your storage account.
    • Container: the container from which to retrieve the object store object(s).

File format

The file has to be a csv with the following headers:

  • Username (either "Username" or "Email address" is mandatory). Mandatory if "Username" is selected as "User identifier".
  • Email address (either "Username" or "Email address" is mandatory). Mandatory if "Email" is selected as "User identifier".

  • License type: the accepted values (not case sensitive) are:

    • Guest
    • $guest
    • Member
    • $member
    • Admin
    • $admin

Warning

Any additional header will be ignored.

What it does

The package performs the following steps:

  • Read the uploaded csv file.
  • Upload the user roles according the roles specified in the file.