API access

To begin integrating with Identomat, you’ll need API keys to authenticate requests

Obtaining API keys

  • Navigate to the Integration section: Log into your Identomat dashboard and select Integration from the menu, nested under Settings .

  • Generate key: In the API section, click the Generate key button.

  • Store securely: Copy the generated API key and securely store it. For security purposes, the key will only be displayed once. If lost, you’ll need to generate a new one.

💡 HMAC authorization: For enhanced security, you can implement HMAC authorization using your secret key as the encryption key. This is optional but recommended for production environments.

Procedure

The integration procedure consists of the following steps:

  1. Acquiring a session_token.

  2. Redirecting the user's browser to widget.identomat.com.

  3. Checking for a result.

To acquire a session_token, the company server needs to call the /begin endpoint and provide the following arguments: company_key, flags and steps. The steps array contains the configuration for individual steps in the identification process, each of which can have its own set of flags specific to that step.

The endpoint used to create a session_token:

https://widget.identomat.com/begin/

For more details, see:

Last updated

Was this helpful?