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.
Create an application
An application in ThunderID represents your product. When you register one, you get a Client ID, which links your frontend or backend to ThunderID's authentication layer.
-
Sign in to the Console at https://localhost:8090/console using the default admin credentials (
admin/admin). -
Go to Applications and click Add Application.
-
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.
-
Enter an Application Name (for example,
my-app) and click Continue. -
Select an Organization Unit for the application and click Continue.
-
On the Design screen, optionally choose an application logo and color theme, then click Continue.
-
Under Sign In Options, toggle the authentication methods you want to enable (for example, Username & Password) and click Continue.
-
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.
-
On the Configuration screen, set the URL where your application is hosted:
- React or Vue Quickstart
- Sample App
- My Own App
Set Where is your application hosted? to
http://localhost:5173.This is the default Vite development server port used by both the React and Vue quickstarts.
Set Where is your application hosted? to
http://localhost:3000.The ThunderID sample app runs on port
3000by default.Set Where is your application hosted? to the root URL of your app (for example,
http://localhost:3000).Leave After Sign-in URL set to Same as Application Access URL unless your app handles the callback at a specific path such as
/callback. In that case, choose Custom URL and enter the full callback URL.Click Continue to finish creating the application.
Open the application details page and note the Client ID. You will need it when configuring your SDK.
Create a Test User
You need at least one user to verify that sign-in works end-to-end.
- In the Console, go to Users and click Add User.
- Select a User Type from the dropdown. Choose Customer to match the access setting above.
- Fill in the user details:
username,email,given_name,family_name, andpassword. - 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.
