Skip to content

Digidentity Platform integration

The Digidentity IDK is a client-server solution which communicates to the Digidentity platform. To facilitate this communication, the following is required:

Configure Firebase project

For Digidentity to generate Dynamic Links via your domain, the following URL schemes must be whitelisted in your Firebase project. Regex strings used should be flexible enough to allow a UUID structure at the end of each URL.

  • Pre-production: https://gate.digidentity-preproduction.eu/qr/{{UUID}}
  • Production: https://gate.digidentity.eu/qr/{{UUID}}

Provide Firebase details

The Digidentity platform uses Firebase Cloud Messaging to send push notifications to mobile apps. To get started, your Firebase project must be configured for Firebase Cloud Messaging. See the external dependencies setup documentation for details.

The following details can be found in your Firebase Console and must be shared with Digidentity. For security, please send keys using a secure channel (e.g. via a 'burn after reading' link from https://privatebin.net/).

  • Web API key
  • Cloud Messaging Server key
  • Fallback URLs (optional): To redirect users opening dynamic links without the app installed (e.g. a link to the Google Play Store or Apple App Store)

Since Firebase Dynamic links is deprecated, please check external dependencies setup documentation for details first. For existing projects, which still require Firebase Dynamic links, extra details must be provided.

Provide mobile platform specific details

We also request that you provide the following details at your earliest convenience. These are not required to start working with the IDK, but must be provided before moving to production. Firebase details can be found in your Firebase console

  • App name
  • App logo URL
  • Firebase Project number
  • Firebase Android App ID
  • Firebase iOS App ID
  • Android package name
  • Android SHA-256 fingerprints
  • Android Store URL
  • iOS App ID
  • iOS App Store URL
  • iOS bundle ID
  • iOS team ID

Get client secret

Once the details above have been shared with Digidentity, we will provide a 'client secret token' in return. This is a unique access token required for the IDK to function and be configured. Please refer to the IDK usage documentation for further information.