# Add and manage chat users

A chat user is the username and password one person uses to sign in to Faustine Chat. Create one for each person. A new user reaches every gateway that is turned on for the chat.

## Before you begin

- Faustine Chat is set up for your workspace. See [Set up Faustine Chat for your team](https://docs.faustine.ai/apps/set-up-faustine-chat/).

## Add a chat user

To add a user:

1. In the portal, go to [**Faustine Chat**](https://auth.faustine.ai/go?to=%2Fapps%2Ffaustine-chat) and select **Configuration**.
2. Under **Access**, select [**Users**](https://auth.faustine.ai/go?to=%2Fapps%2Ffaustine-chat%2Fconfiguration%3Ftab%3Dusers).
3. Select **Add user**.
4. Enter a **Display name**. It is optional and appears in the app.
5. Check the **Username**. It is filled in from the display name and takes lowercase letters, digits, `.`, `_` and `-`.
6. Under **Password**, keep **Generate** for a random password of 20 characters, or select **Type one** and enter at least 12 characters.
7. Select **Create user**.

The **Chat user created** dialog shows the username and the password. Copy them and send them to the person, with the address of the app shown in the dialog. The password is not shown again.

## Reset a password

Resetting a password signs the user out everywhere.

1. On the user's row, open the actions menu and select **Reset password**.
2. Generate or type the new password.
3. Select **Reset password**.

The **Password reset** dialog shows the new password once.

## Let a locked user sign in

Five failed sign-ins in a row lock a user for 15 minutes, and the row shows a **Locked** badge. To let the user sign in before that, select **Unlock** on the row.

## Sign out, disable or delete a user

The other actions are in the actions menu on each row.

| Action | What it does |
| --- | --- |
| **Sign out everywhere** | Ends every active session of the user. The user can sign in again with the same password. The action appears when the user has an active session. |
| **Disable** | Refuses sign-in and ends the user's sessions. Nothing is deleted. **Enable** reverses it. |
| **Delete user** | Removes the user and ends every session. The user's conversations are not deleted. |

Each row shows the user's state (**Active**, **Locked** or **Disabled**), the gateways the user reaches, the number of active sessions and the last sign-in.

## Troubleshooting

| Symptom | Cause | Fix |
| --- | --- | --- |
| The **Users** tab warns "No gateway is enabled for the chat" | Users can sign in, and the assistant has no gateway to call. | Select **Go to Gateways** and turn on a gateway. |
| The user sees "Wrong username or password." | The password was reset, or it was mistyped. | Reset the password and send the new one. |
| The user sees "Too many attempts. Try again in … seconds." | 10 failed sign-ins in one minute from the same address or for the same username. | Wait for the time shown, which is 60 seconds at most. |

## Next steps

- [Give chat access to specific gateways](https://docs.faustine.ai/apps/chat-gateway-access/): limit what one user reaches with **Permissions**.
- [Read Faustine Chat logs and usage](https://docs.faustine.ai/apps/chat-logs-and-usage/): filter the conversations by user.
- [Faustine Chat](https://docs.faustine.ai/apps/faustine-chat/): the limits that apply to passwords and sessions.