Skip to main content

Integration Prerequisites

Complete the following prerequisites before starting your Jumio integration. Work with your Jumio Account Manager to obtain the required credentials, workflow configuration, and account setup.

Prerequisites​

PrerequisiteRequired forHow to obtain or configure
Jumio AccountAll Jumio integrationsContact your Jumio Account Manager to set up your account. OAuth 2.0 is automatically enabled when the account is created.
Workflow KeyAll workflow integrationsSelect the appropriate workflow key from the Standard Services documentation.
Client ID and Client SecretREST API integrationsRetrieve your credentials from the Jumio Portal under Settings > Configuration > API Credentials. See API Credentials.
Account SettingsAll applicable verification workflowsConfigure the required settings in the Jumio Portal based on your integration requirements.
TLS SupportAll integrationsConfigure your integration environment to support TLS. See Supported Cipher Suites.

Workflow Keys​

Obtain the workflow key or keys required for your integration from your Jumio Account Manager.

The workflow key identifies the workflow that you want to run when creating a transaction.

If your integration uses multiple workflows, obtain a workflow key for each workflow.

OAuth 2.0 Activation​

If your integration uses Jumio REST APIs, OAuth 2.0 must be activated for your account before you can generate an access token.

Contact your Jumio Account Manager to activate OAuth 2.0 and obtain your Client ID and Client Secret.

After OAuth 2.0 is activated, use your Client ID and Client Secret to obtain an access token.

See Authorization for information about authenticating API requests.

Jumio Platform Configuration​

Configure the required settings in the Jumio Portal before starting your integration.

For more information, see About the Identity Verification Settings.

TLS Requirements​

Your integration environment must support the TLS protocols and cipher suites required by Jumio.

If your environment requires explicit cipher-suite configuration, see the supported cipher suites below.

Supported TLS Cipher Suites​

The following cipher suites (listed in server-preferred order) are supported by Jumio during the TLS handshake:

  • TLS_AES_128_GCM_SHA256
  • TLS_AES_256_GCM_SHA384
  • TLS_CHACHA20_POLY1305_SHA256
  • ECDHE-ECDSA-AES128-GCM-SHA256
  • ECDHE-RSA-AES128-GCM-SHA256
  • ECDHE-ECDSA-AES256-GCM-SHA384
  • ECDHE-RSA-AES256-GCM-SHA384

These additional cipher suites are supported for the following domains:

portal.<region>.jumio.ai
portal.jumio.ai
*.web.<region>.jumio.ai
web-sdk.<region>.jumio.ai
diws.<region>.jumio.ai
auth.<region>.jumio.ai
  • ECDHE-ECDSA-CHACHA20-POLY1305
  • ECDHE-RSA-CHACHA20-POLY1305