Skip to content
Snippets Groups Projects
Unverified Commit 4e8bc850 authored by Natalie's avatar Natalie Committed by GitHub
Browse files

docs - update disabling password logins (#29244)

parent 28c94fc7
No related branches found
No related tags found
No related merge requests found
......@@ -64,9 +64,11 @@ You can use your JWT to assign Metabase users to custom groups by following thes
2. In the Admin Panel in Metabase, go to the Authentication tab of the Settings section and click the Configure button on JWT. On this screen, turn on the toggle under "SYNCHRONIZE GROUP MEMBERSHIPS".
3. Next, click Edit Mappings. In this modal, type in the name of one of your groups as defined in the JWT, then click Add. In the row that appears, click the dropdown to pick the Metabase group that this should map to. Repeat this for each of the groups you want to map.
## Disabling password login
## Disabling password logins
Once you have set up your JWT authentication and confirmed that it's working, if you want to disable the option for users to log in via username and password, return to **Admin** > **Settings** > **Authentication** and scroll to the bottom. A toggle should now be visible that allows you disable password authentication.
> **Avoid locking yourself out of your Metabase!** This setting will apply to all Metabase accounts, _including your Metabase admin account_. We recommend that you keep password authentication **enabled**. This will safeguard you from getting locked out of Metabase in case of any problems with SSO.
To require people to log in with SSO, disable password authentication from **Admin settings** > **Authentication**.
![Password disable](images/password-disable.png)
......
......@@ -151,9 +151,11 @@ After that, type in the name of the user attribute you added in your SAML provid
![Group schema](images/saml-group-schema.png)
## Disabling password log-in
## Disabling password logins
Once you have configured SAML authentication, you can choose to disable the option for users to log in via email and password. To do this, return to the main Authentication settings page and scroll to the bottom. A toggle will now be visible allowing you to disable password authentication.
> **Avoid locking yourself out of your Metabase!** This setting will apply to all Metabase accounts, _including your Metabase admin account_. We recommend that you keep password authentication **enabled**. This will safeguard you from getting locked out of Metabase in case of any problems with SSO.
To require people to log in with SSO, disable password authentication from **Admin settings** > **Authentication**.
![Password disable](images/password-disable.png)
......
......@@ -113,14 +113,11 @@ You can manage [user attributes][user-attributes-def] such as names, emails, and
User attributes can't be synced with regular Google Sign-In. You'll need to set up [Google SAML][google-saml-docs] or [JWT][jwt-docs] instead.
## Changing an account's login method from email to SSO
## Disabling password logins
Once a person creates an account, you cannot change the authentication method for that account. However, you can:
> **Avoid locking yourself out of your Metabase!** This setting will apply to all Metabase accounts, _including your Metabase admin account_. We recommend that you keep password authentication **enabled**. This will safeguard you from getting locked out of Metabase in case of any problems with SSO.
- Deactivate password authentication for all users from **Admin settings** > **Authentication**. You'll need to ask people to sign in with Google (if they haven't already).
- Manually update the account's login method in the Metabase application database. This option is not recommended unless you're familiar with making changes to the application database.
Note that you must have at least one account with email and password login. This account safeguards you from getting locked out of your Metabase if there are any problems with your SSO provider.
To require people to log in with SSO, disable password authentication from **Admin settings** > **Authentication**.
## Troubleshooting login issues
......
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment