Installation and usage

The Tanker Identity SDK is distributed as a Maven package.

If you are using Gradle for your project, you need to patch the build.gradle file at the top project to add the Maven repository used by Tanker:

allprojects {
  repositories {
    // ...
    maven {
      url 'https://storage.googleapis.com/maven.tanker.io'
    }
  }
}

Then add the Identity library to the list of dependencies:

dependencies {
  implementation 'io.tanker.identity:identity:1.0.0-beta-1'
}

Create identity

Create a new Tanker identity. This identity is secret and must only be given to a user who has been authenticated by your application. This identity is used by the Tanker client SDK to open a Tanker session.

import io.tanker.identity.Identity;

String identity = Identity.createIdentity(appId, appSecret, userId);
Parameters
appId: String The app ID, you can access it from the Tanker dashboard
appSecret: String The app secret, secret that you have saved right after the creation of your app
userId: String The unique ID of a user in your application
Returns
String An identity

Provisional identity

Create a Tanker provisional identity. It allows you to share a resource with a user who does not have an account in your application yet. It must be served to an authenticated user, and attached client-side to access the resource. You will need to verifiy the associated email.

String identity = Identity.createProvisionalIdentity(appId, email);
Parameters
appId: String The app ID, you can access it from the Tanker dashboard
email: String The email associated with the provisional identity
Returns
String A provisional identity

Public identity

Return the public identity from an identity or a provisional identity. This public identity can be used by the Tanker client SDK to share encrypted resources and add users to groups.

String publicIdentity = Identity.getPublicIdentity(identity);
Parameters
identity: String An identity or a provisional identity
Returns
String A public identity