The biid Auth SDK is the easiest way to integrate authentication via the biid App in an Android app. The biid Auth SDK library contains a biid Client. This client communicates with the biid App and the biid Identity Service.

The developers guide describes how to integrate the biid Auth SDK library and use the biid Client. For further details please check the javadoc.


Include the biid Auth SDK library as a dependency in your Android project:

repositories {


    maven {
        url ""


dependencies {


    compile ('com.biid:sdk-auth-android:0.19.46'){transitive=true}


biid will provide you with a manifest file. Place this file in the assets directory of your Android project.

Your app will need the following permission:

    <uses-permission android:name="" />

Get a reference to the biid Client like this:

AuthClient client = Sdk.getClient();

The first call to the client must be


When the client is no longer required, call


Authentication via the biid App

Start the authentication flow with


The biid App will ask the user for their credentials. Handle the result of the authentication flow as follows:

    protected void onActivityResult(int requestCode, int resultCode, Intent data) {


        if (client.onAuthenticationResult(requestCode, resultCode, data)) {
            // authentication was successful
        } else {
            // this is not a result of the authentication flow