Affinidi Login with Java

In this guide, learn how to enable passwordless login in your application using Java and Springboot framework.

The Affinidi Login is a passwordless authentication solution that verifies user identity using Affinidi Vault as the identity provider managed by the end-user.

In this lab, we will use JAVA 21 and Springboot from the available sample applications to take you through the step-by-step guide for creating a Login Configuration and setting up the application to implement passwordless authentication for end-users.

Before you begin
  1. Set up Affinidi Vault account. Follow the guide below if you haven’t set it up yet.
Set up Affinidi Vault
  1. Set up an Affinidi Vault account using the web app or install the mobile app .

The same installation steps for mobile app.

  1. Click on Start if you are creating a new account, or click on Restore from Backup if you have an existing backup of your Affinidi Vault.

Use this guide to learn how to migrate your existing Affinidi Vault account.

Affinidi Vault Setup
  1. Secure your Vault by providing a passphrase. Use this passphrase to unlock your Vault.
Affinidi Vault Passphrase
  1. Provide your Email Address to verify with OTP.
Affinidi Vault Email Verification

After successfully providing the OTP, you are redirected to your Affinidi Vault dashboard.

  1. Get the Redirect URI of your application for OIDC. This is the URI configured on your Login Configuration to receive the idToken after successful authorisation.

  2. Optionally, Install the Affinidi CLI. Follow the guide below if it hasn’t been installed.

Set up Affinidi CLI
  1. Download and install NodeJS on your machine if you haven’t set it up yet.
  1. Install Affinidi CLI using Node Package Manager (npm).
npm install -g @affinidi/cli
  1. Verify that the installation is successful.
affinidi --version
  1. Install JAVA 21 on your machine if you haven’t installed yet using this guide .

Download Application

You can clone this sample application from our Github and start exploring how to integrate Affinidi Login to provide a passwordless login experience for your end-users.

Create Login Configuration

To create a Login Configuration, you can either use Affinidi CLI or  Affinidi Portal.

Expand the section below for your preferred method:

Java Springboot App Settings:

Name: Java Springboot App

Redirect URIs: http://localhost:8080/login/oauth2/code/javademo

Expand the section below for your preferred method:

Using Affinidi CLI
  1. Log in to Affinidi CLI by running:
affinidi start
  1. Once you have successfully logged in, create the Login Configuration by running:
affinidi login create-config --name='Java Springboot App' --redirect-uris='http://localhost:8080/login/oauth2/code/javademo'
  • --name is what you want your login configuration to be called.
  • --redirect-uris is the URL on your application where the user gets redirected after the successful authentication.

Learn more on how to manage your Login Configurations using Affinidi CLI.

Using Affinidi Portal
Create new Login Configuratioin
  1. Go to  Affinidi Login under the Services section.

  2. Click on the Create Login Configuration and provide the required details.

  • Name is the string that describes your login configuration.
  • Redirect URIs is the URL on your application where the user gets redirected after the successful authentication.
  1. Click on create and confirm if all the details are correct.
Login Configuratation new client
  1. After confirming the details, another popup shows the Client ID and Client Secret for your Login Configuration. Copy the generated Client Credentials and use them to integrate with Affinidi Login.

  2. After copying the Client ID and Client Secret and closing the popup, you are redirected back to the Affinidi Login page.

Login Configuration uses the default Presentation Definition (presentationDefinition) and ID Token Mapping (idTokenMapping) that is used to request the user’s email address during the authentication flow.

Learn more about customising the Presentation Definition and ID Token using this guide.

Set up the Sample Application

After creating the Login Configuration required to set up the sample application. Let’s start setting up the Java application by configuring the following settings:

Configure Env Variables

Create the .env file using the following command:

cp .env.example .env

Set the environment variables based on the auth credentials received from the Login Configuration created earlier:

  "auth": {
    "clientId": "<AUTH.CLIENT_ID>",
    "clientSecret": "<AUTH.CLIENT_SECRET>",
    "issuer": "https://<PROJECT_ID>"

Set the following fields in the .env file


Build and Run

sh mvnw clean
sh mvnw install
sh mvnw spring-boot:run

After successfully running the command, go to http://localhost:8080/ to access the page with the Affinidi Login button.

Key Changes to Sample Application

To enable a seamless passwordless login experience with Affinidi Login, refer to the following key changes were implemented:

  1. Registered javademo as the oauth2 client provider in the ./src/main/resources/application.yml including the client credentials.
            client-name: Affinidi Login
            client-id: ${PROVIDER_CLIENT_ID}
            client-secret: ${PROVIDER_CLIENT_SECRET}
            redirect-uri: http://localhost:8080/login/oauth2/code/javademo
            scope: openid,offline_access
            client-authentication-method: client_secret_post
            provider: afflogin
            issuer-uri: ${PROVIDER_ISSUER}
     org.springframework: WARN
     login.affinidi: INFO
    port: 8080
  1. Implemented the following method in the ./java/login/affinidi/client/controller/
    • user method to extract the user claims from the ID Token provided by the Affinidi Login.
    • populateModel method populates the user model from the ID Token to display on UI.
package login.affinidi.client.controller;
import java.util.ArrayList;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.GetMapping;
import com.nimbusds.jose.shaded.gson.internal.LinkedTreeMap;

public class UserController {

    public String index(){
        return "index";
     * This method acts as handler for /user endpoint. It extracs details from
     * authenticator oidc user for user interface
     * @param model
     * @param oidcUser
     * @return
    public String user(Model model,
                        @AuthenticationPrincipal OidcUser oidcUser) {
        ArrayList<LinkedTreeMap<String, Object>> customNodeFromToken = 
            (ArrayList<LinkedTreeMap<String, Object>>)oidcUser.getAttributes().get("custom");
        populateModel(customNodeFromToken, model);
        return "user";
     * This method extracts every populated attribute from custom node of idToken
     * and adds it to UI model for display
     * @param customNodeFromToken
     * @param model
    private void populateModel(ArrayList<LinkedTreeMap<String, Object>> customNodeFromToken, Model model){
        for(LinkedTreeMap<String, Object> eachAttribute : customNodeFromToken){
            if(eachAttribute != null){
                for(String key : eachAttribute.keySet()){
                    model.addAttribute(key, eachAttribute.get(key));


    actor User
    participant Java
    participant Affinidi Login
    participant Affinidi Vault
    participant Affinidi Verifier

    User->>Java: My Login
    Java->>Affinidi Login: Authenticate user
    Note over Java, Affinidi Login:  login_challenge
    Affinidi Login->>Affinidi Vault: Verify user identity
    Note over Affinidi Login, Affinidi Vault:  presentationDefinition
    Affinidi Vault->>User: Request user confirmation to share Email VC
    User->>Affinidi Vault: User confirmed consent to share Email VC
    Affinidi Vault->>Affinidi Vault: Generate VP Token from VC
    Affinidi Vault->>Affinidi Login: Send Email VP Token
    Affinidi Login->>Affinidi Verifier: Validate VP Token
    Note over Affinidi Login, Affinidi Verifier:  vp_token, presentation_submission, presentation_definition
    Affinidi Login->>Affinidi Login: Generate idToken
    Affinidi Login->>Java: Send generated idToken from VP
    Java->>User: Provide access to the user

Using the Java and Springboot as the sample application, we have configured it to integrate with Affinidi Login as the Auth provider and parse the idToken sent by the Affinidi Login to confirm the user’s successful authentication using the Affinidi Vault.