Run ThunderID

2

Register an app

3

Build a flow

4

Connect your app

Register an Application

By the end of this guide you will have:

• A registered application in ThunderID with a Client ID
• A test user you can sign in with
• Everything ready to build your sign-in flow and connect your app

Prerequisites

• ThunderID is running. If not, get ThunderID first.
• You can reach the ThunderID Console at https://localhost:8090/console.

1

Create an application

An application in ThunderID represents your product. When you register an OAuth 2.0 application, you get a Client ID, which links your frontend or backend to ThunderID's authentication layer.

1. Sign in to the Console at https://localhost:8090/console using the default admin credentials (admin / admin).

2. Go to Applications and click Add Application.

3. On the Technology Stack screen, select your technology (for example, React or Next.js) and then choose an Application Type:

   Type	Use when
   Browser App	React, Angular, Vue, or any SPA running in the browser
   Full-Stack App	Server-rendered apps (Next.js, Express, Spring) where the backend handles token exchange
   Mobile App	Native or cross-platform mobile (React Native, Flutter, Swift, Kotlin)
   Backend Service	Server-to-server calls with no user sign-in

   Click Continue.

4. Enter an Application Name (for example, my-app) and click Continue.

5. Select an Organization Unit for the application and click Continue.

6. On the Design screen, optionally choose an application logo and color theme, then click Continue.

7. Under Sign In Options, toggle the authentication methods you want to enable (for example, Username & Password) and click Continue.

8. Under Sign-In Experience:

   • Set Sign-In Approach to Redirect to ThunderID sign-in/sign-up handling pages, the recommended approach. Users are sent to ThunderID-hosted pages you control with the Flow Designer.
   • Under User Access, select Customer (for self-service end users) or Person (for admin-managed accounts).

   Click Continue.

9. On the Configuration screen, click Continue to finish creating the application.

Save your Client ID

Open the application details page and note the Client ID. You will need it when configuring your SDK.

2

Create a Test User

You need at least one user to verify that sign-in works end-to-end.

1. In the Console, go to Users and click Add User.
2. Select a User Type from the dropdown. Choose Customer to match the access setting above.
3. Fill in the user details: username, email, given_name, family_name, and password.
4. Click Create User.

What's Next

Your application is registered and your test user is ready. The next step is building the sign-in flow that authenticates them.

Step 3 → Build a Sign-In FlowUse the visual flow designer to configure how users authenticate: password, passkeys, social login, or any combination.Build your flow →