Configure the CSV directory integration settings

  1. In the Admin Console, go to Directory > Directory Integrations.

  2. Click the new CSV directory
  3. Click the Provisioning tab.
  4. Select Integration in the SETTINGS menu.
  5. Complete these tasks on the Integration page.
    1. The Connect to these agents check boxes are preselected for all active agents. Select only the relevant agents . Note the agents must be version 01.03.00 or greater. You cannot use OPP agents that were previously installed, such as versions earlier than 01.03.00.
    2. In the Unique User Field Name, enter a name for the field you want to use as the unique user identifier within the CSV file. For example, employeeid.
      • This should be the variable name for the attribute—not the display name.
      • This unique identifier is the sole identifying attribute for new or existing users and it must be enforced to be both unique and immutable.

      Note: Once set, this attribute cannot be changed.

    3. Define the local file path and the .csv file name. This must be the absolute path, for example:
      • For Windows: C:\Users\Administrator\Desktop\csv\test.csv
      • For Linux: /opt/OktaProvisioningAgent/csv/test.csv

      Note: For Linux, the .csv file must be located where the Okta On-Premises agent is installed. The default location is /opt/OktaProvisioningAgent/.

  6. To set up incremental imports, complete these tasks on the Integrations tab.

    This is an Early Access feature. To enable it, contact Okta Support.

    1. The Connect to these agents check boxes are preselected for all active agents. Select only the relevant agents. Note the agents must be version 01.03.00 or greater. You cannot use OPP agents that were previously installed, such as versions earlier than 01.03.00.
    2. In the Unique identifier field, enter a name for the field you want to use as the unique user identifier within the CSV file. For example, employeeid.
      • This should be the variable name for the attribute—not the display name.
      • This unique identifier is the sole identifying attribute for new or existing users and it must be enforced to be both unique and immutable.

      Note: Once set, this attribute cannot be changed.

    3. Enter a name for the Deactivation field and a Deactivation value that will be associated with it. Only the users who have this field marked with the designated value will be deactivated upon incremental import.
    4. Note: When these fields are enabled, they also affect full imports. During a full import, both the users who have the field marked and those who have been removed from the CSV file will be deactivated.

    5. Define the incremental import local file path and the .csv file name. This must be the absolute path and cannot be the same as the full import file path.
  7. Click Save.