Authenticating your connection

2024-08-27Last updated

Before you can connect with Genetec ClearID™ to synchronize data or issue API commands, you must first authenticate your applications (or API environment) so that your applications or API can communicate with ClearID.

What you should know

Use the API integration key to authenticate your applications when making requests to your ClearID account.
  • The OAUTH 2.0 protocol is used to authenticate non-user system communications or connections with ClearID.
  • Store your key securely and don’t share it.
Important: When you regenerate your key, you must update any applications that access this account to use the new key.
You can create an API integration to authenticate communications for the following:
  • Genetec ClearID™ API
  • Genetec ClearID™ One Identity Synchronization Tool (Azure AD, Database, File)

Procedure

  1. Add an API integration.
    1. In ClearID, click Administration > API integrations .
    2. Click Add API integration.
      Name
      Enter a name for the API integration. For example, API user connection or One Identity synchronization.
      Description
      Enter a meaningful description for the API integration.
    3. Click Save.
  2. Select a user from the API integration list.
    1. Click Generate key and then click Confirm, to generate the authentication key for your API integration.
      CAUTION: The current API integration key immediately becomes invalid and isn’t recoverable.
    2. Click Download authentication key.
      Tip: Make a note of the downloaded file location for later use.

      By default, the authentication key for your API integration is named key-systemID-APIintegrationname.json.

You’re now ready to configure your applications to synchronize data or issue API commands.

Example

Watch this video to learn more. Click the Captions icon (CC) to turn on video captions in one of the available languages.

After you finish

Depending on how attributes are set up in your organization, do one of the following: