Login: Wristband Hosted-UI

The Authentication Concepts documentation page covers concepts around the Login Flow for different types of OAuth2 Client types. Refer to that page to see how the flow changes for each type.

Client Type Examples
All example flow diagrams below demonstrate a Backend Server OAuth2 Client type. The other client types can be inserted into the Login Workflow in a similar manner by following the examples and patterns laid out in the Authentication Concepts documentation.

Wristband Identity Provider: Password Login

Refer to the Authorization Code Flow documentation section to see the Wristband-hosted Login Flow for password-based login.

Wristband Identity Provider: Magic Link Login

The default login factor for the Wristband Identity Provider is Password Login, but you can opt to configure Magic Link Login instead. Additionally, you have the flexibility to enable both Password Login and Magic Link Login simultaneously. When both are active, the end user can choose the preferred method on the Login Page.

Magic Link Login operates by the end user entering their email address on the Login Page. Subsequently, Wristband dispatches a transactional email to that address, including a magic link. This link holds a one-time email authorization code, which, once clicked, authenticates the user with Wristband.

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 the Login Endpoint implemented by your application.
3. Your application creates an Authorization Request and redirects the user to the Wristband Authorize Endpoint.
4. Wristband validates and records the Authorization Request and then subsequently redirects the user to the Wristband-hosted Login page for your application.
5. The user clicks the Login button, which triggers a call to the Wristband Request Magic Link for Login API.
6. The Login Page will show a message telling the user to check their inbox for a Magic Link Email.
7. The user will click on the Magic Link within the email that was sent from Wristband.
8. The user is sent to the Verify Magic Link Page, where a call to the Wristband Verify Magic Link API is triggered to authenticate the user.
9. Upon successful authentication, the Login Page will redirect to your application's Callback Endpoint with an authorization code.
10. The Callback Endpoint will call Wristband's Token Endpoint to exchange the authorization code for an access token.
11. The Callback Endpoint will establish an application session for the end user. The session contains the access token and refresh token (and optionally the ID token and/or any other useful user data). A session cookie is generated by the server.
12. The Callback Endpoint redirects the user into your application's entry point of choice (e.g., the home page).

External Identity Provider Login

External Identity Providers refer to any identity provider that is not Wristband. This includes both Social Login Providers and Enterprise Single Sign-On (SSO) Providers. Before you enable an External Identity Provider for your authentication method, you should refer to the setup instructions for your given identity provider.

Configuring Identity Providers Documentation:

• Social Login
• Enterprise SSO

External IDP Login Examples
The example diagrams below demonstrate External IDP Login using Google as the provider. From the point of view of Wristband, the flow is essentially the same when using other External Identity Providers as well.

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 the Login Endpoint implemented by your application.
3. Your application creates an Authorization Request and redirects the user to the Wristband Authorize Endpoint.
4. Wristband validates and records the Authorization Request and then subsequently redirects the user to the Wristband-hosted Login page for your application.
5. The user clicks the Login with Google button, which triggers a call to the Wristband External IDP Authorize Endpoint.
6. Wristband redirects the user to Google's account login page.
7. The user submits their Google credentials.
8. Google redirects the user to the Wristband External IDP Callback Endpoint (which can be found in the Identity Providers section of the Wristband dashboard for your given IDP), where Wristband creates an External IDP Authorization Code required for completing authentication.
9. The user is sent to the Wristband-hosted External IDP Login Page -- along with the External IDP authorization code -- where a call to the Wristband Verify User for External IDP Login API is triggered to authenticate the user.
10. Upon successful authentication, the Login Page will redirect to your application's Callback Endpoint with an authorization code.
11. The Callback Endpoint will call Wristband's Token Endpoint to exchange the authorization code for an access token.
12. The Callback Endpoint will establish an application session for the end user. The session contains the access token and refresh token (and optionally the ID token and/or any other useful user data). A session cookie is generated by the server.
13. The Callback Endpoint redirects the user into your application's entry point of choice (e.g., the home page).

Enterprise SSO with JIT Provisioning

When Just In Time (JIT) Provisioning is enabled for an enterprise external identity provider, the login workflow changes after the user authenticates with the external IDP. Despite workflow policy configurations or other conditions, the SSO login workflow with JIT provisioning follows a common sequence up to a certain point. At a high level, this represents the shared portion of the sequence of events:

No Email Verification Required

Coming soon...

Email Verification with One-Time Password

Coming soon...

Email Verification with Asynchronous Email Confirmation

Coming soon...