Configuring Okta identity field mappings

2026-09-03Last updated

To define how identity data flows between Okta and Genetec ClearID™, you must configure your identity field mappings.

Before you begin

What you should know

You must be an Account administrator to configure Okta identity field mappings.

Procedure

  1. From the Access management section on the sidebar, click Administration > Identity synchronization .
  2. Select the Okta configuration you want to configure.
  3. In the Identity field mappings section, click Configure.
  4. In the Identity field mappings dialog box, configure the mappings as needed.
    Three ClearID fields are mapped to Okta fields by default:
    • External ID
    • First name
    • Active
  5. To add a new mapping, click Add mapping field and fill out the row:
    ClearID field
    Select the identity field to map.
    Mapping type
    Choose a type:
    Direct
    The direct mapping type directly applies the Okta value to the ClearID identity field when synchronized.
    Regex
    The regex mapping type applies a regex transformation to the field value when synchronizing from the Okta user to the ClearID identity.
    Fixed
    The fixed mapping type applies a fixed value for the field. For example, the value for the Active field will always be true.
    Okta field
    Select the source field from Okta.
    Sample value from Okta
    View a sample value pulled from your Okta application.
  6. (Optional) To use the recommended identity field mappings, click Set default mapping.
  7. Click Save.

After you finish

Define how access credentials (such as card numbers, facility codes, and activation dates) flow into the system. This ensures your synchronized users receive functional access rights.