Set Up a Wristband Application
Start your Wristband integration by creating an application in the dashboard. You'll use this application to configure authentication and manage your users and tenants.
Key aspects of Wristband applications
- Environment separation: Wristband supports environment isolation by using separate applications for QA, staging, and production. Each application maintains its own configuration, allowing production-level validation policies to be enabled or disabled independently for each environment.
- Hierarchy: All subordinate entities, including tenants, users, and OAuth2 clients, are scoped to a specific application.
- Domain assignment: Each application is assigned a unique vanity domain that is used to access its login and signup flows.
Create a New Application
To create an application, log in to the Dashboard and perform the following steps:
- Select Add Application.
Figure 1: Create an application from the Dashboard.
- Select Quickstart > Continue.
Figure 2: Select the Quickstart type.
- Select your framework > Continue
Figure 3: Choose your framework.
- Enter your application name > Continue.
Figure 4: Name your application.
- Review the summary > Create.
Figure 5: Review and create.
-
Following provisioning, copy the displayed environment variables. These values are required to initialize the SDK instance.
Click Done to exit, or click the framework link to view integration steps.
Figure 6: Copy SDK variables.
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: Find the vanity domain.
-
-
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: Find the client ID.
-
-
WRISTBAND_CLIENT_SECRETClient secrets are only displayed once after creation. If lost, generate a new one via rotation:
- Navigate: OAuth2 Clients > Select your client.
- Locate: Go to Edit Client > Scroll to Client Secret Settings.
- Action: Click Rotate and copy the new secret from the pop-up modal.
Figure 9: Rotate the client secret.
Updated 3 days ago
What’s Next
Now that your Wristband application is created, refer to one of the framework-specific quickstart guides to complete the integration.