Skip to main content

Quick start guide

Learn how to test out a ReuseID onboarding or step-up flow using the Authenticator App and the ReuseID API.

This quick start guide shows you how to:

  1. Perform a ReuseID onboarding or step-up flow.
  2. Review the identity proofing process.
  3. Reuse the ReuseID.
  4. Manage the users.
Want to try ReuseID without making API requests?

This guide requires that you make API requests using a tool of your choice.

If you want to try out ReuseID without making API requests, then you can use the Try it out page in the Signicat Dashboard. Here, you can use a button to trigger ReuseID operations instead.

Prerequisites​

1. Connect to the ReuseID API​

Before you can start making requests to this API, you need to learn how to connect to it. To do this, follow steps 1-3 in the Connect to Signicat APIs Quick start guide.

What permissions are required?

Ensure that you set the following permissions for your API client:

  • ReuseID Onboarding API
  • ReuseID MobileID Device API

2. Add MobileID to your account​

To use MobileID as the authentication method in ReuseID you need to add the product to your account. To do this:

  1. Go to Signicat Dashboard > Products > MobileID.
  2. Click the + Add MobileID button.

Set it up​

Next, you have to set up a tool for triggering operations and access our Authenticator App to perform them.

1. Set up Postman​

Using other tools

This guide provides steps for using Postman as a tool for initiating the APIs, however, you can use the preferred tool of your choice.

To set up ReuseID ready-made onboarding API in Postman and obtain an access token:

  1. Open Postman.
  2. Import the collection. To do this:
    1. Navigate to the Collections tab on the left-hand side of the screen, then click the Import button.
    Screenshot showing import of ReuseID Onboarding collection into Postman

    Screenshot showing import of ReuseID Onboarding collection into Postman

    1. In the blank field in the dialogue box, paste the URL to our ReuseID Onboarding API specification
      Our recommendation

      We recommend that you generate the request and response parameters from the examples in the schema, and that you create folders according to the tags. To do this:

      1. Click the View import settings button.
      2. In the Parameter generation section, select Example from the dropdown menu.
      3. In the Folder organization section, select Tags from the dropdown menu.
    2. Click the Import button in the dialogue box to finalise the import.
  3. Create variables. To do this, click the Variables tab, and add the following:
    Screenshot showing creation of variables in Postman

    Screenshot showing creation of variables in Postman

  4. Set up authorisation. To do this, go to the Authorization tab and and update the following:
    Screenshot showing set up of authorisation in Postman

    Screenshot showing set up of authorisation in Postman

  5. Click on the Get new access token button to get an access token.
  6. To add the token to the requests, click Proceed, then Use Token.
  7. Save your changes.
Auto-refresh your access token

To automatically refresh your access token after it has expired, enable the Auto-refresh token toggle button under the Authorization tab.

You can only enable auto-refresh tokens after you have received your first valid token.

Success!

You have now set up Postman for the ReuseID ready-made Onboarding APIs.

2. Install our Authenticator App​

The Authenticator App is our white-label mobile application which enables you to perform operations on a mobile device, so that you can start testing out ReuseID as quickly as possible.

Want to use our SDK instead?

It is also possible to use our SDK and integrate it into your own app instead. To get access to the SDK, you can contact us by creating a support ticket in the Signicat Dashboard.

iOS​

To install our Authenticator App on your iPhone, you have to:

  1. Scan the QR code below on your mobile device:
    QR code to install the iOS Authenticator App

    QR code to install the iOS Authenticator App

  2. Install the latest version.

Android​

To install our Authenticator App on your Android, you have to:

  1. Scan the QR code below on your mobile device:
    QR code to install the Android Authenticator App

    QR code to install the Android Authenticator App

  2. Install the latest version.

3. Configure our Authenticator App​

Once you have installed the Authenticator App, you need to configure it to use your account.

To do this, you need to update the following values:

  • Application ID (applicationId)
  • Public E2E key (publicKey)
  • Server URL (https://api.signicat.com/encore/encap)
Note

Our server URL is the same for both sandbox and production accounts.

How to obtain these values​

To get your application ID (applicationId) and public E2E key (publicKey), you need to:

  1. Go to Signicat Dashboard > Products > MobileID > Details.
  2. Click on Quick configuration in the top-right corner.
Manually add values

If you do not wish to use the QR code scanner, then you can also find the Application ID value under the Account tab, and the Public key value under the E2E keys tab.

How to set these values​

Other options

It is also possible to select a configuration from the dropdown list, or manually add your own configuration by clicking +.

Try onboarding with eIDV and MobileID authentication​

You have now completed all required preparations and are ready to perform ReuseID operations

In this guide you'll learn how to use ReuseID ready-made flows which performs identity proofing with an eIDV and authenticates with MobileID.

  • Onboarding flow
    • Creates a MobileID user.
    • Activates a MobileID device.
    • Performs identity proofing process.
    • Creates a strong binding between the ReuseID user and the identity proofing process.
    • Adds identity attributes to the ReuseID user.
  • Step-up flow
    • Performs a MobileID device authentication.
    • Performs an identity proofing process.
    • Creates a strong binding between the ReuseID user and the identity proofing process.
    • Adds identity attributes to the ReuseID user.

Ready-made ReuseID onboarding​

  1. In Postman, navigate to Signicat ReuseID Onboarding API reference > Onboarding > Start onboarding.
  2. Under the Body tab, you can input your own request body. This API will default to signicatvideoid as provider if not specified in the request.
    Example: ReuseID onboarding request body
    {
      "externalRef": "000-000-000",
      "provider" : "signicatvideoid",
      "videoidProviderOptions" : {
        "docTypes" : [138,169,147,245,277],
        "defaultId" : 138
    }
    }
  3. Click the Send button.
  4. You have now started a registration operation. The response contains an activationCode, which you need in the next step.
Show activation code as QR code in Postman

To get the best the user experience, Postman can show the activation code as a QR code. This means that you do not have to manually type the code in the Authenticator App.

To do this, add the following snippet to Script > Post-response in the POST request:

let response = pm.response.json();

let qrcTemplate = '<img width="250" height="250" src="https://qrcode.tec-it.com/API/QRCode?data=' + encodeURIComponent(response.data.activationCode) + '">';
pm.visualizer.set(qrcTemplate, {});
Example: Start ReuseID onboarding response
{
  "data": {
    "status": "Pending",
    "transactionId": "94099e7e-b391-45fb-9404-b54682f16d03",
    "userId": "7f1994f0-5fed-4e0f-a8e2-64da520a09cb",
    "activationCode": "2005468691",
    "dossierId": "41ff5755-4ece-42cf-b7de-3efd0181ba88",
    "processId": "8be8325a-9654-4165-a56f-0d1ccdc3bd3e"
  }
}
  1. Open the Authenticator App.
  2. Click on the button to start the onboarding on the device.
  3. Scan or enter the activationCode that was obtained in Step 4.
    Note

    The activation code is only valid until the session expiry time (sessionExpiryTime).

  4. Select a PIN.
  5. Select if you want to activate biometrics.
  6. Follow the instructions for the identity proofing process.
  7. Once you completed the identity proofing process in the Authenticator app go back to Postman.
  8. In Postman, navigate to Onboarding > Get onboarding.
  9. Under the Params tab, update the value of transactionId to the value you obtained in the Start onboarding response.
  10. Click the Send button.
    Example: Get result of ReuseID onboarding response
    {
      "data": {
        "transactionId": "e35ebbf7-9631-4966-9762-ae939c80eda1",
        "userId": "a1e26081-35b4-4557-a46a-ef50bc91672f",
        "activationCode": "8954685641",
        "deviceId": "b1g73121-55c4-9238-l39j-ek60dc91872g",
        "proofingId": "30745db7-4403-4403-aa7e-cb35435ee565",
        "dossierId": "3d563ac4-9d26-4a6a-b58d-5a29cacfe015",
        "processId": "2f54b0a4-1a77-42e2-98d8-369116ef2055",
        "status": "Completed",
        "userData": {
          "firstName": "JANE",
          "lastName": "SMITH",
          "dateOfBirth": "1990-01-01",
          "gender": "F",
          "nationality": "NOR"
        }
      }
    }
Success!

You have now completed a ready-made flow for onboarding to ReuseID with eIDV and setup credentials for MobileID.

What does it look like in the Authenticator App?

Ready-made ReuseID step-up​

  1. In Postman, navigate to Signicat ReuseID Onboarding API reference > Step-up > Start step-up.
  2. Under the Body tab, you can input your own request body. For this API, it is required to set both the user ID (userId) and the device ID (deviceId). These are the IDs of the ReuseID user and MobileID device. This API will default to signicatvideoid as provider if not specified in the request.
    Example: ReuseID step-up request body
    {
      "userId": "a1e26081-35b4-4557-a46a-ef50bc91672f",
      "deviceId": "b1g73121-55c4-9238-l39j-ek60dc91872g",
      "provider" : "signicatvideoid",
      "videoidProviderOptions" : {
        "docTypes" : [138,169,147,245,277],
        "defaultId" : 138
    }
    }
  3. Click the Send button.
    Example: ReuseID step-up response
    {
      "data": {
        "status": "Pending",
        "transactionId": "0160e8b9-dabc-4a16-b995-29d88e6f102f",
        "userId": "0eb66632-88d0-4ef4-8126-495c64a0abd2",
        "deviceId": "f8d74181-9e00-41ba-ba4f-43aa6a3dfea5",
        "dossierId": "e73801d2-3e7f-4184-8fda-67cc3b03416d",
        "processId": "0dca14cf-957d-46d9-b374-520f9c650859"
      }
    }
  4. Open the Authenticator App.
  5. The app shows a dialogue box asking you to authenticate before you can verify your identity.
  6. Click the Continue button.
  7. Authenticate in the app with biometrics (or PIN if biometrics is not enabled).
  8. Follow the instructions for the identity proofing process.
  9. Once you completed the flow in the Authenticator app go back to Postman.
  10. In Postman, Navigate to Step-up > Get step-up.
  11. Under the Params tab, update the value of transactionId to the value you obtained in the Start step-up response.
  12. Click the Send button.
    Example: Get result of ReuseID step-up
    {
      "data": {
        "transactionId": "e35ebbf7-9631-4966-9762-ae939c80eda1",
        "userId": "cdf82275-1bbb-4756-9cb6-7e51ac3f480b",
        "deviceId": "3a1ba38a-0303-4de9-a696-1dc2a6d13614",
        "proofingId": "30745db7-4403-4403-aa7e-cb35435ee565",
        "dossierId": "3d563ac4-9d26-4a6a-b58d-5a29cacfe015",
        "processId": "2f54b0a4-1a77-42e2-98d8-369116ef2055",
        "status": "Completed",
        "userData": {
          "firstName": "JANE",
          "lastName": "SMITH",
          "dateOfBirth": "1990-01-01",
          "gender": "F",
          "nationality": "NOR"
        }
      }
    }
Success!

You have now completed a ready-made flow for step-up on ReuseID with eIDV and MobileID authentication.

What does it look like in the Authenticator App?

Review the identity proofing process​

The identity proofing is handled by our ID Document and Biometric Verification products. The stored result is linked to the ReuseID user that performed the process.

You can use our APIs to:

  • Get all identity proofings for an end-user.
  • Get the full data set for the process.

You can learn how to carry our these operations in our API reference documentation:

Get identity proofings for user
Get all identity proofings for a user with our MobileID User API
Get details for process
Get all process details with our ID Document and Biometric Verification API

Reuse the ReuseID​

In this guide we leverage MobileID devices for authentication, the key to make the ReuseID user reusable.

You can learn about how to get started with our MobileID device operations and the features that it offers in our MobileID developer documentation:

MobileID quick start guide
Learn how to trigger authentications and authorisations
MobileID API reference
Look up all API endpoints and properties. View sample requests and responses
MobileID features
Learn about all MobileID features

Manage the users​

You can manage your ReuseID users and their MobileID devices with our ReuseID APIs.

You can learn how to carry our these operations in our API reference documentation:

Manage your end-users
Manage your end-users with our MobileID User API
Manage your end-users' devices
Manage your end-users' devices with our MobileID Device management API
On this page