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
| Prerequisite | Required for | How to obtain or configure |
|---|---|---|
| Jumio Account | All Jumio integrations | Contact your Jumio Account Manager to set up your account. OAuth 2.0 is automatically enabled when the account is created. |
| Workflow Key | All workflow integrations | Select the appropriate workflow key from the Standard Services documentation. |
| Client ID and Client Secret | REST API integrations | Retrieve your credentials from the Jumio Portal under Settings > Configuration > API Credentials. See API Credentials. |
| Account Settings | All applicable verification workflows | Configure the required settings in the Jumio Portal based on your integration requirements. |
| TLS Support | All integrations | Configure 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