Try It Out

Each walkthrough below runs one of the use cases from Customer Identity against the Wayfinder sample, using one of the patterns from Solution Patterns.

Meet Wayfinder

Wayfinder is a consumer travel-booking application. Through Wayfinder, consumers search for flights and hotels, book trips, and manage their travel profile.

Meet the Cast

• Consumers book travel. They sign themselves up, sign in, manage their own profile, and recover access when they lose it.
  • John Doe is a returning traveller who signs in, manages his profile, and recovers his password.
  • Jane Smith is another returning traveller. She and John both book trips through Wayfinder.
  • Emma Wilson is a new arrival who signs up with her email and a password.
• Staff run the product. They are onboarded by an operations admin from the ThunderID console.
  • Alex Carter is the operations admin who onboards everyone else.
  • Sam Rivera is the support agent.
  • Maya Patel is the destinations curator.

Sample Architecture

Wayfinder runs as three deployable pieces:

• Wayfinder Web: the browser-based app that consumers interact with.
• Wayfinder Server: holds the booking data and exposes the booking API.
• ThunderID: authenticates users and issues the tokens.

Set Up Your Environment

1

Run ThunderID

Get ThunderID running locally. Follow Get ThunderID for download, setup, and start commands.

2

Configure the Server

Edit repository/conf/deployment.yaml and add the Wayfinder origin under cors.allowed_origins. Leave any existing entries in place.

cors:
  allowed_origins:
    # ...existing entries...
    - "http://localhost:5173"

Restart ThunderID after the change.

3

Get the Wayfinder Sample

Download the latest Wayfinder sample distribution. It ships with a thunderid-config/ directory containing a declarative YAML bundle and a thunderid.env file with the environment variables it references.

4

Import the Sample Bundle

Apply the bundle through the ThunderID Console. It creates everything the walkthroughs share.

1. Sign in to the ThunderID Console at https://localhost:8090/console.
2. On first sign-in, a welcome screen appears with an Open button. (Later, reach the same screen from the user profile menu in the top-right corner of the Console.)
3. Click Open and select your thunderid-config/thunderid-config.yaml file from the sample distribution.
4. Select your thunderid-config/thunderid.env file to provide the environment variables referenced in the YAML.
5. The Console imports the files and reports the resources it created when the import completes.

5

Run the Sample

Start all Wayfinder services from the extracted sample directory:

Linux / macOS

./start.sh

Windows

.\start.ps1

The sample opens at http://localhost:5173.

Walkthroughs

Pick a walkthrough to begin. Each one starts from the setup above.

LoginJohn Doe signs in to Wayfinder and arrives at the dashboard.Go to Login →

Self Sign-UpEmma Wilson signs up with email and password.Go to Self Sign-Up →

View ProfileJohn views and updates his profile.Go to View Profile →

Account RecoveryJohn resets a forgotten password through an email link.Go to Account Recovery →

Onboard Internal UsersAlex invites staff members from the console.Go to Onboard Internal Users →

Going Deeper

• Curious how the bundle maps to ThunderID concepts? See Identity Concepts.
• Prefer to build the same setup manually instead of importing the bundle? See Configure It Yourself.