Initial Setup

In order to receive access to integrate LoginID you will need to create your client credentials. This is similar to the credentials you would create with Google to use Google authentication. This allows your servers to call LoginID services in a secure, authenticated fashion.

To obtain the client keys you will need to perform the following steps:

For OIDC Integrations

Create a New Account

Registration Page
  1. Enter a username and hit the “Next” button and click on “Register”

  2. You will be prompted to authenticate using biometrics

Biometrics Prompt

You must already have configured your own personal device for biometric authentication. The way that devices do this varies by browser, operating system, and more.

If you are not on a FIDO supported device/browser you will be prompted to create your account via username/password:

Non FIDO Registration Detection
Non FIDO Registration - Password

The native dialogs for doing so vary by browser, operating system, and the type of authenticator you are using.

Enter the Integration Dashboard

Dashboard - Integration Page
  1. Use the navigation bar to select “Integration”, or

  2. Press the “Add Integration” button

Sign the CLA

  1. Scroll down the page to Step 1

  2. View and 'Accept' Agreement

Add new Web OIDC Integration

OIDC Integration Credential Creation
OIDC Credentials
  1. Enter a name for your application, website or service

  2. Enter the callback URL for your application, website or service

  3. Copy the Application ID and Application Secret and store in a safe place

Your Application Secret is very important to protect, if you lose it or expose it accidentally, you will need to create a new one. So, please don’t check it into source control.

Your Application ID is a unique identifier used to describe your application to LoginID. The Application Secret is a secret you must keep safe and is used to authenticate the request when interacting with LoginID.

Once you have gone through the above steps you should have received and saved the following:

Field

Value

Domain

https://exchange.domain

Client ID

Auto generated client ID

Client Secret

Auto generated client secret

For iOS SDK

  1. Register and login into the dashboard: https://usw1.loginid.io/en/register

  2. Follow the same steps as OIDC, except create integration type iOS

iOS Integration Creation
iOS integration Created

By creating your client credentials, your servers will then be able to call LoginID services in an authenticated fashion. Below is an example of client credentials:

Field Name

Value

clientId

6fcd5bdd-bd51-4e26-9cd6-14f6e41b5862

baseUrl

060ce487-b934-43d0-a925-b66e80c7532f.sandbox.loginid.io

For Android/Flutter/React Native SDK Integrations

Obtain Client Keys

The first step to onboard yourself with LoginID is to create your client credentials. This allows your servers to call LoginID services in an authenticated fashion.

  1. Prepare to provide your Android package name and Android signing certificate fingerprint (sha256) to LoginID as part of the initial configuration setup. You will be able to find more information on fingerprint signing on the official android documentation page. An example of what needs to be provided:

    Field Name

    Value

    Android Package Name

    com.example.myapplication

    Android Signing Fingerprint (sha256)

    72:90:77:A4:F1:6C:61:9F:4E:1F:11:94:0F:3B:8D:FC:3E:53:1F:FE:94:19:BF:FD:BD:4A:8D:90:05:32:B0:42

    clientID

    6fcd5bdd-bd51-4e26-9cd6-14f6e41b5862

    baseUrl

    060ce487-b934-43d0-a925-b66e80c7532f.loginid.io

  2. Register and login into the dashboard: https://usw1.loginid.io/en/register

  3. Follow steps as iOS except choose Android Integration.

Android Integration Creation
Android Integration Created

Android signing fingerprint is a sha256 value of the signing certificate that used to sign your app. You will be able to find more information on fingerprint signing on the official android documentation page.