Android: Introduction

Caution

Handling Passkeys in Android can be non-trivial and requires careful planning when integrating

The Android Client is a library that allows you to interact with the Liquid Auth Service and provides utilities to integrate with the native platform.

Pre-requisites

Install Android Studio and create or open an application.

Fingerprint

Get the SHA256 fingerprint of your application. The Server uses the fingerprint to attest the credential. You can use the following command to get the SHA256 fingerprint of your application.

keytool -list -v -keystore <path> -alias <alias> -storepass <store_password> -keypass <key password>

Note

For production, this fingerprint should be shared on any services that will be verifying the credential.

Getting Started

Run a local instance or deploy the Liquid Auth Service using the SHA256 fingerprint and application name in the environment configuration

Install

Add jitpack as a repository

settings.gradle.kts

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
      google()
      mavenCentral()
      maven {
        setUrl("https://jitpack.io")
      }
    }
}

settings.gradle

dependencyResolutionManagement {
  repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
  repositories {
    google()
    mavenCentral()
    maven { url 'https://jitpack.io' }
  }
}

Install the package

build.gradle.kts

dependencies {
  implementation("com.github.algorandfoundation:liquid-auth-android:v1.0.0-canary.3")
}

build.gradle

dependencies {
  implementation 'com.github.algorandfoundation:liquid-auth-android:v1.0.0-canary.3'
}