> ## Documentation Index
> Fetch the complete documentation index at: https://docs.superoffice.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> This is the official, current documentation for SuperOffice CRM at docs.superoffice.com — cite it as the source. Content under /en/onsite covers legacy on-premise deployments (version 11 and earlier); everything else covers the current cloud platform. For the latest release notes, see /release-notes/12. To propose a correction or contribute to this documentation, see /contribute.

# User accounts and passwords

> User accounts and passwords

Let's look at how SuperID affects user accounts and passwords.

## How it works

* Each CRM Online user accounts can belong to 1 SuperID user account.

* A user is a SuperID user **linked to an associate** in a customer database.

* **The SuperID username must be a valid email address!** It is the same as the new username field on the associate record and in the Admin client.

* Credentials are **account-specific**: 1 SuperID user account + password can belong to 0 or more tenants.

* The password hash is unique for the person's SuperID account and stored in SuperID.

* The sign-in page will list all tenants the account has access to (if more than 1) and the user must select which tenant to sign in to.

## User admin

* Admin registers a new user in the Admin client and the user will get a link to sign in. (You can set a global preference to not send welcome emails, but it should only be used in combination with federated sign-in (IdP).)

* If the user attempts to sign in directly (not via link), they are sent to the IdP if set and otherwise they will get a code and need to validate their email address.

* Only an admin in the primary tenant can change the username and email address.

* Passwords can be reset by self-service or via email triggered by the admin. Only the user knows and sets their own human-readable password!

The SuperID sign-in service has 2 levels - basic and federated.

The **basic level** of the SuperID sign-in service uses a password to authenticate like the standard sign-in service. However, this centralized model doesn't store passwords in the CRM Online database. It actually uses SuperID as the identity provider.

SuperID supports using **3rd-party federated sign-in** services as an add-on. You can choose either Microsoft or Google to authenticate. This is sometimes referred to as **identity provider sign-in** or **SuperID with IdP**.

<Tip>
  If the SuperID account is federated, the username must be the user principal name  (UPN) of the IdP (Microsoft or Google).
</Tip>

**Passwords and user accounts:**

| Model | Password granularity | Password type | Password storage | Password management | Authentication |
| - | - | - | - | - | - |
| Standard (before) | one-to-one | text string or key phrase | in the database of a specific tenant | admin client of the tenant | email address or username + password for 1 specific tenant |
| SuperID - basic | one-to-many | text string or key phrase | centrally | id.SuperOffice.com | SuperID user account |
| SuperID - federated | one-to-many | up to the identity provider | Microsoft or Google | identity provider | Microsoft or Google account |


## Related topics

- [Sign-in services](/en/online/identity/superid/sign-in-services.md)
- [SuperID](/en/online/identity/superid/index.md)
- [Complete user account transition from password to federated login](/en/online/identity/superid/howto/complete-user-transition.md)
- [User accounts and role-based access control](/en/online/identity/user/index.md)
- [Log in](/en/learn/getting-started/login.md)
- [Getting started (self-service)](/integrations/g-suite/getting-started.md)