Guides

Tenant Discovery: Wristband-Hosted UI

Suggest Edits

By default, the Action Link in the Tenant Discovery email directs users to a Wristband-hosted Tenant Discovery Page (for the case where a user's email address exists in 2 or more tenants).

Email Address (1 Tenant)

At a high level:

  1. The user clicks on the Login button either on your website or within your application.
  2. The user gets sent to your application's Wristband-hosted Application-level Login Page.
  3. The user enters their email address and clicks the submit button.
  4. Wristband calls the Find User Tenant API to find the Tenant-level Login URL.
  5. The user gets redirected to the Login Endpoint implemented by your application with the appropriate Tenant Domain.

From here, the user would be sent through the Authorization Code Flow in order to login to their tenant and gain entry to the application.

Email 1 Tenant

Email Address (2+ Tenants)

At a high level:

  1. The user clicks on the Login button either on your website or within your application.
  2. The user gets sent to your application's Wristband-hosted Application-level Login Page.
  3. The user enters their email address and clicks the submit button.
  4. Wristband calls the Find User Tenant API to find the Tenant-level Login URL. During API execution, a Tenant Discovery email is sent to the email address that the user provided on the Login Form.
  5. A message is displayed to the user to check their email inbox.
  6. The user clicks on the Action Link in the Tenant Discovery email that was sent to their inbox.
  7. The user is redirected to the Wristband-hosted Tenant Discovery Page.
  8. Wristband calls the Wristband Fetch Tenants API, passing along the Email Authorization Code.
  9. The user clicks on the Tenant Login button for the tenant they wish to be redirected to.
  10. The user gets redirected to the Login Endpoint implemented by your application with the appropriate Tenant Domain.

From here, the user would be sent through the Authorization Code Flow in order to login to their tenant and gain entry to the application.

Email 2 Tenants

Tenant Domain Name

At a high level:

  1. The user clicks on the Login button either on your website or within your application.
  2. The user gets sent to your application's Wristband-hosted Application-level Login Page.
  3. The user enters their tenant domain name and clicks the submit button.
  4. Wristband calls the Resolve Tenant Login URL API to find the Tenant-level Login URL.
  5. The user gets redirected to the Login Endpoint implemented by your application with the appropriate Tenant Domain.

From here, the user would be sent through the Authorization Code Flow in order to login to their tenant and gain entry to the application.

Tenant Domain Name

Updated 3 months ago