Skip to main content

​
Prerequisites

Your app must be associated with your website to use Passkeys. This requires proper configuration of Digital Asset Links. Complete the enablement of passkeys for native apps.

​
OwnID SDK Setup

Minimum requirements:
  • Android API level 23 or higher
  • Java 8+
  • Kotlin support
Installation Add the OwnID Android SDK to your app’s build.gradle file. Maven Central 
implementation "com.ownid.android-sdk:core:<latest version>"
Enable Java 8 compatibility: 
android {
   compileOptions {
      sourceCompatibility JavaVersion.VERSION_1_8
      targetCompatibility JavaVersion.VERSION_1_8
   }
   kotlinOptions {
      jvmTarget = "1.8"
   }
}
OwnID Configuration Create a new json config file inside the assets folder (example:assetsProd/ownIdSdkConfig.json) in your project: 
{
    "appId": "your-app-id"
}
OwnID supports multiple environments: production (default) and uat. To use uat environment add the env parameter: 
{
  "appId": "your-app-id",
  "env": "uat"
}
Example of advanced configuration
{
    "appId": "your-app-id",
    "env": "uat",
    "region": "us",
    "enableLogging": true
}
Data CenterBy default, OwnID SDK connects to the US datacenter. For EU region support:
{
  "region": "eu"
}
Logging
It is strongly recommended to disable logging in production builds.
{
  "enableLogging": true
}

​
Language

By default, the SDK uses the device’s locale settings. You can override this behavior:
OwnIdLoginViewModel.setLanguageTagsProvider { 
    listOf("en","fr") 
}

​
Integration Options

Choose between two different integration paths based on your needs: OwnID Elite and OwnID Boost. Each path offers unique capabilities:

OwnID Elite

Use OwnID screens to improve and simplify your authentication

OwnID Boost

Add OwnID as an add-on to your existing login and registration screens