Set Up a Wristband Application

Understanding Wristband Applications

Before integrating Wristband into your application, you'll need to create a Wristband application in the Dashboard. This application serves as the foundation for configuring authentication and managing users, tenants, and other resources.

Key Concepts of Wristband Applications

Environment Isolation: Use separate Wristband applications for development, QA, staging, and production environments. Each application maintains its own configuration, allowing you to independently manage authentication settings, security policies, and other environment-specific requirements.
Resource Hierarchy: Each application serves as the parent for its associated resources, including tenants, users, and OAuth2 clients. These resources are scoped to their respective applications.
Vanity Domain: Each application is assigned a unique vanity domain used to access its authentication endpoints, including hosted login and signup flows.

Create a New Application

To create a Wristband application, log in to the Wristband Dashboard and perform the following steps:

Select Add Application.

Wristband Dashboard Home Page — Figure 1: Select Add Application from the Wristband Dashboard home page.

Select Quickstart > Continue.

Wristband create application modal — Figure 2: Select Quickstart to create an application configured for your framework.

Select your framework > Continue

Quickstart select framework — Figure 3: Choose the framework you will use to integrate Wristband authentication.

Enter your application name > Continue.

Quickstart set application name — Figure 4: Enter a name for your Wristband application.

Review the summary > Create.

Quickstart summary page — Figure 5: Review the application summary before selecting Create.

Once your application has been created, copy the generated SDK configuration values. You'll need these values when configuring the Wristband authentication SDK in your project.

Click the framework-specific link to continue with the integration instructions. You can also click the Done button to close the modal and return to the Wristband Dashboard.

Quickstart environment variables — Figure 6: Copy the generated SDK configuration values and follow the framework-specific integration link.

Manually Retrieving SDK Configuration Values

Upon reaching the final screen of the Add Quickstart Application modal, three environment variables necessary for Wristband SDK configuration are displayed.

WRISTBAND_APPLICATION_VANITY_DOMAIN
WRISTBAND_CLIENT_ID
WRISTBAND_CLIENT_SECRET

If these configuration parameters are lost, use the following steps to recover them:

WRISTBAND_APPLICATION_VANITY_DOMAIN
- Navigate: Go to Dashboard Home and click your application.
- Locate: Open Settings and copy the value from the Application Vanity Domain field.
Figure 7: Copy the Application Vanity Domain from your application's Settings page.
WRISTBAND_CLIENT_ID
- Navigate: Dashboard Home -> Your App -> OAuth2 Clients (left menu).
- Locate: Select the relevant client to view its Client ID in the top section.
Figure 8: Copy the Client ID for your OAuth2 client.
WRISTBAND_CLIENT_SECRET

Client secrets are only displayed once after creation. If lost, generate a new one via rotation:
1. Navigate: OAuth2 Clients > Select your client.
2. Locate: Go to Edit Client > Scroll to Client Secret Settings.
3. Action: Click Rotate and copy the new secret from the pop-up modal.
Figure 9: Rotate the client secret in Client Secret Settings to generate a replacement for a lost secret.

Set Up a Wristband Application

Understanding Wristband Applications

Key Concepts of Wristband Applications

Create a New Application

Manually Retrieving SDK Configuration Values

`WRISTBAND_APPLICATION_VANITY_DOMAIN`

`WRISTBAND_CLIENT_ID`

`WRISTBAND_CLIENT_SECRET`

What’s Next