Skip to content

Managing Source Account Schemas

Each source supports a variety of details, or attributes, about each user who has an account, such as their name, email address, manager name, and location.

The set of account attributes each source stores and how they're organized is known as the account's schema. To best represent your data, you can configure IdentityNow's sources to use an account schema matching the one you use in the external connector.

Viewing an Account Schema

Most sources have an account schema as soon as they're connected to IdentityNow. To view your account schema:

  1. Go to Admin > Connections > Sources.
  2. Select the source you want to edit.
  3. Go to Import Data > Account Schema.

Each source schema has one attribute marked as the Account Name and one attribute marked as the Account ID. Editing the Account Name or Account ID after aggregation can result in serious issues and is strongly discouraged.

If your source doesn't have an account schema, you can create one by adding attributes to the source in IdentityNow that match your external connector.

Editing an Account Schema

You can add and delete attributes from an account schema, as well as indicate whether an attribute supports multiple values.

  1. Go to Admin > Connections > Sources.
  2. Select the source you want to edit.
  3. Go to Import Data > Account Schema.

    • To add a new attribute, select + Add New Attribute and fill out all required fields.

      Important

      Attribute names cannot contain periods.

    • To delete an attribute, select the Delete icon in the Actions column beside the attribute.

    • To mark an attribute as multi-valued, meaning it can support more than one value in a single attribute, select the checkboxes next to the attributes you want to edit. At the top of the table, select the Multi-Valued checkbox.

    • To remove the Multi-Valued setting on an attribute, select the checkboxes beside the attributes you want to edit. Clear the checkbox for the Multi-Valued setting. You can also do this in the Edit Attribute overlay.

    • To mark an attribute as an entitlement, select the Edit icon beside the attribute and select the Entitlement checkbox. Select Save.

      Note

      Boolean attributes cannot be marked as entitlements.

    • To edit a source's Account Name and Account ID attributes, select the Select Actions > Edit Schema. Under Account ID and Account Name, choose the attributes that should be used to provide those values and select Update.

      Warning

      Updating the Account Name or Account ID attributes for a source after aggregating accounts is strongly discouraged and can cause significant errors.

      The Account Name attribute is immutable, and editing it after accounts have been aggregated can cause duplicate accounts and identities to be aggregated and created. The Account ID attribute is used in multiple places across systems to reference accounts. Changing the Account ID can break these references in serious and unexpected ways.