Thunder v0.105.0

WSO2 Thunder ⚡

Identity Management Suite

Thunder is a modern, open-source identity management service designed for teams building secure, customizable authentication experiences across applications, services, and AI agents. It enables developers to design and orchestrate login, registration, and recovery flows using a flexible identity flow designer.

Designed for extensibility, scalability, and seamless containerized deployment, Thunder integrates naturally with microservices and DevOps environments—serving as the core identity layer for your cloud platform.

Full Changelog: v0.104.0...v0.105.0

⚡ Quickstart

This Quickstart guide will help you get started with WSO2 Thunder quickly. It walks you through downloading and running the product, trying out the sample app, and exploring registering a user, logging in, and using the Client Credentials flow.

Download and Run WSO2 Thunder

You can run WSO2 Thunder either by downloading the release artifact or using the official Docker image.

Option 1: Run from Release Artifact

Follow these steps to download the 0.105.0 release of WSO2 Thunder and run it locally.

1. Download the distribution from the 0.105.0 release

OS	Architecture	Download Link
macOS	ARM64 (Apple Silicon)	thunder-0.105.0-macos-arm64.zip
macOS	x64 (Intel)	thunder-0.105.0-macos-x64.zip
Linux	x64	thunder-0.105.0-linux-x64.zip
Linux	ARM64	thunder-0.105.0-linux-arm64.zip
Windows	x64	thunder-0.105.0-win-x64.zip

2. Unzip the product

   Unzip the downloaded file using the following command:

   unzip thunder-0.105.0-<os>-<arch>.zip

   Navigate to the unzipped directory:

   cd thunder-0.105.0-<os>-<arch>/

3. Setup the product

   You need to setup the server with the initial configurations and data before starting the server for the first time.

   If you are using a Linux or macOS machine:

   ./setup.sh

   If you are using a Windows machine:

   .\setup.ps1

4. Start the product

   If you are using a Linux or macOS machine:

   ./start.sh

   If you are using a Windows machine:

   .\start.ps1

   The product will start on https://localhost:8090.

Option 2: Run with Docker

Follow these steps to run WSO2 Thunder using Docker.

1. Pull the Docker image

   docker pull ghcr.io/asgardeo/thunder:0.105.0

2. Setup the product

   You need to setup the server with the initial configurations and data before starting the server for the first time.

       docker run -it --rm \
           ghcr.io/asgardeo/thunder:0.105.0 \
           ./setup.sh

   [!NOTE]
   This will shut down the container after the setup is complete. You need to start the container again using the command in step 3. If you are using sqlite as the database, then you need to mount a volume to persist the database file and share it between the setup and server run containers.

3. Run the container

   docker run --rm \
     -p 8090:8090 \
     ghcr.io/asgardeo/thunder:0.105.0

   Optionally if you want to modify the server configurations, you can mount a custom deployment.yaml file. Create a deployment.yaml file in your working directory similar to the deployment.yaml, and mount it as below:

   docker run --rm \
     -p 8090:8090 \
     -v $(pwd)/deployment.yaml:/opt/thunder/repository/conf/deployment.yaml \
     ghcr.io/asgardeo/thunder:0.105.0

   Optionally if you want to use custom configurations or certificates, you can mount them as follows:

   docker run --rm \
     -p 8090:8090 \
     -v $(pwd)/deployment.yaml:/opt/thunder/repository/conf/deployment.yaml \
     -v $(pwd)/certs/server.cert:/opt/thunder/repository/resources/security/server.cert \
     -v $(pwd)/certs/server.key:/opt/thunder/repository/resources/security/server.key \
     ghcr.io/asgardeo/thunder:0.105.0

Try Out the Product

Try out the Developer Console

Follow these steps to access the Developer Console:

1. Open your browser and navigate to https://localhost:8090/develop.

2. Log in using the admin credentials created during the initial data setup (admin / admin).

Try Out with the Sample App

To quickly get started with Thunder, you can use the sample app provided with the product. This guide demonstrates how to download and run the sample app, self register a user and try out login to the sample app.

Download and Run the Sample App

1. Download the sample app from the 0.105.0 release

OS	Architecture	Download Link
macOS	ARM64 (Apple Silicon)	sample-app-0.105.0-macos-arm64.zip
macOS	x64 (Intel)	sample-app-0.105.0-macos-x64.zip
Linux	x64	sample-app-0.105.0-linux-x64.zip
Linux	ARM64	sample-app-0.105.0-linux-arm64.zip
Windows	x64	sample-app-0.105.0-win-x64.zip

2. Unzip and navigate to the sample app directory

   unzip sample-app-0.105.0-<os>-<arch>.zip
   cd sample-app-0.105.0-<os>-<arch>/

3. Create required application for sample app in Thunder

   Before using the sample app, you need to create an application in Thunder:

   curl -kL -X POST -H 'Content-Type: application/json' -H 'Accept: application/json' https://localhost:8090/applications \
   -d '{
       "name": "Sample App",
       "description": "Sample application for testing",
       "url": "https://localhost:3000",
       "logo_url": "https://localhost:3000/logo.png",
       "tos_uri": "https://localhost:3000/terms",
       "policy_uri": "https://localhost:3000/privacy",
       "contacts": ["admin@example.com", "support@example.com"],
       "auth_flow_graph_id": "auth_flow_config_basic",
       "registration_flow_graph_id": "registration_flow_config_basic",
       "is_registration_flow_enabled": true,
       "user_attributes": ["given_name","family_name","email","groups"],
       "inbound_auth_config": [{
           "type": "oauth2",
           "config": {
               "client_id": "sample_app_client",
               "client_secret": "sample_app_secret",
               "redirect_uris": ["https://localhost:3000"],
               "grant_types": ["authorization_code", "client_credentials"],
               "response_types": ["code"],
               "token_endpoint_auth_method": "client_secret_basic",
               "pkce_required": false,
               "public_client": false,
               "scopes": ["openid", "profile", "email"],
               "token": {
                   "issuer": "thunder",
                   "access_token": {
                       "validity_period": 3600,
                       "user_attributes": ["given_name","family_name","email","groups"]
                   },
                   "id_token": {
                       "validity_period": 3600,
                       "user_attributes": ["given_name","family_name","email","groups"],
                       "scope_claims": {
                           "profile": ["name","given_name","family_name","picture"],
                           "email": ["email","email_verified"],
                           "phone": ["phone_number","phone_number_verified"],
                           "group": ["groups"]
                       }
                   }
               }
           }
       }]
   }'

   Note the id from the response - you'll need it for the sample app configuration.

4. Configure the sample app

   Open the runtime.json file in the thunder-sample-app-0.105.0--/app directory and update the configurations:

   • applicationID: Use the application ID from step 3
   • flowEndpoint: The root endpoint for the flow execution API (default: https://localhost:8090/flow)

5. Start the sample app

   sh start.sh

Open your browser and navigate to https://localhost:3000 to see the sample app in action.

Self Register a User

To self register a user in the sample app, follow these steps:

1. Open the sample app in your browser at https://localhost:3000 and click on the "Sign up" button.

2. Provide a username and password for the new user and click on the "Create Account" button.

   

3. Fill in the additional user attributes such as first name, last name and email address. Click "Continue" to complete the registration.

   

4. After successful registration, you will be automatically logged in to the sample application.

Login to the Sample App

To log in to the sample app, follow these steps:

1. Open the sample app in your browser at https://localhost:3000.

2. Enter username and password you used during the self registration process and click on the "Sign In" button.

   

3. If the login is successful, you will be redirected to the home page of the sample app with the access token.

Try Out Client Credentials Flow

The Client Credentials flow is used to obtain an access token for machine-to-machine communication. This flow does not require user interaction and is typically used for server-to-server communication.

To try out the Client Credentials flow, follow these steps:

1. Create a Client Application

   Create a client application in the system to use for the Client Credentials flow. You can use the following cURL command to create a new application.

   curl -kL -X POST -H 'Content-Type: application/json' -H 'Accept: application/json' https://localhost:8090/applications \
   -d '{
       "name": "Test Sample App",
       "description": "Initial testing App",
       "auth_flow_graph_id": "auth_flow_config_basic",
       "inbound_auth_config": [
           {
               "type": "oauth2",
               "config": {
                   "client_id": "<client_id>",
                   "client_secret": "<client_secret>",
                   "redirect_uris": [
                       "https://localhost:3000"
                   ],
                   "grant_types": [
                       "client_credentials"
                   ],
                   "token_endpoint_auth_method": "client_secret_basic",
                   "pkce_required": false,
                   "public_client": false,
                   "scopes": ["api:read", "api:write"]
               }
           }
       ]
   }'

2. Obtain an Access Token

   Use the following cURL command to obtain an access token using the Client Credentials flow. Make sure to replace the <client_id> and <client_secret> with the values you used when creating the client application.

   curl -k -X POST https://localhost:8090/oauth2/token \
     -d 'grant_type=client_credentials' \
     -u '<client_id>:<client_secret>'

License

Licenses this source under the Apache License, Version 2.0 (LICENSE), You may not use this file except in compliance with the License.

---

(c) Copyright 2025 WSO2 LLC.