---
updatedAt: 2026-09-21T19:56:03.000Z
agentTools:
  projectIndex: https://docs.wristband.dev/llms.txt
---

# Passwords

Set up password login and password policies for the Wristband Identity Provider.

Password login enables users to authenticate by entering a login identifier (e.g., email address) and password on the sign-in page.

## Enabling Password Login

Configure the Wristband IdP login factors by navigating to **Identity Providers** → **Wristband** within the Application View of the Wristband Dashboard. The **Supported Login Factors** setting controls the available options on your sign-in screen.

* **Enable Passwords:** Passwords are enabled by default; however, you can manually activate them by setting **Supported Login Factors** to either **Only enter a password** or **Choose either a password or magic link**.
* **Set the Default View:** If you choose the hybrid approach (both password and magic link enabled), users can toggle between them on the sign-in screen. Use the **Primary Login Factor** setting to dictate which method loads first.

<Image src="https://files.readme.io/a249236b2ecdd0f1b9f8279468b8c41b75c31ff18cbc77118ff32aab7abb3067-Screenshot_2026-08-27_at_2.41.22_PM.png" alt="The Primary Login Factor setting is visible when both passwords and magic links are enabled." align="center" width="800px" caption="Figure 1: Wristband IdP configurations." />

## Password Policies

To enforce password complexity and credential requirements, manage your settings under **Security** → **Password Policies** in the Application View of your dashboard.

<Image src="https://files.readme.io/fdcc85814b98308a46c7e65ba445f46db9e2a55de18946ab7e91844ad36ddd60-Screenshot_2026-04-13_at_11.27.56_AM.png" align="center" caption="Figure 2: Password Policies configuration." />

You can configure your password rules using the settings outlined below:

* **Minimum Password Length:** Defines the lowest number of characters allowed for a user password. This value must be between **8** and **64&#x20;**&#x63;haracters and defaults to **8**.
* **Require Lowercase Character:** When enabled, passwords must contain at least one lowercase letter \[a-z].
* **Require Uppercase Character:** When enabled, passwords must contain at least one uppercase letter \[A-Z].
* **Require Numeric Digit:** When enabled, passwords must contain at least one non-alphanumeric character (e.g., `!`, `#`, `$`, `%`, `&`).
* **Require Special Character:** When enabled, passwords must contain at least one special character (e.g., `!`, `#`, `$`, `%`, `&`).
* **Password Breach Detection:** Enable this setting to block weak or leaked credentials. Wristband cross-references all password creation and authentication attempts with global data breach registries.
* **Force Reset on Breached Password:** Mandate password updates for exposed accounts by turning this setting on (requires **Breach Detection** to be enabled). Active enforcement prevents users from logging in using leaked credentials until they change their password, while disabling it allows them to bypass the warning and authenticate anyway.

### Tenant-Level Override

To customize password requirements for an individual customer, apply a tenant-level override:

1. **Select** **the target tenant** from the dropdown menu in the Application View.
2. Navigate to **Security** → **Password Policies**.
3. Open the **Edit Tenant Config** tab.
4. Switch on the **tenant override** toggle to define unique password complexity rules for this tenant.

<Image src="https://files.readme.io/9cecaf5bbbde16852ec216364b8acafc2ecc5cae628818157b6b04bf44a445ae-Screenshot_2026-08-27_at_3.12.58_PM.png" alt="Password Policies configuration in Tenant View with the tenant override toggle enabled." align="center" width="800px" caption="Figure 3: Password Policies configuration in Tenant View with the tenant override toggle enabled." />

<br />

<HTMLBlock>{`
<style>
.UpdatedAt {
  display: none;
}
</style>
`}</HTMLBlock>