diff --git a/src/content/docs/cloudflare-one/applications/configure-apps/dash-sso-apps.mdx b/src/content/docs/cloudflare-one/applications/configure-apps/dash-sso-apps.mdx index 3477dea9ac6916..f220a46ef410d5 100644 --- a/src/content/docs/cloudflare-one/applications/configure-apps/dash-sso-apps.mdx +++ b/src/content/docs/cloudflare-one/applications/configure-apps/dash-sso-apps.mdx @@ -5,7 +5,7 @@ sidebar: order: 4 --- -import { FeatureTable, APIRequest } from "~/components"; +import { FeatureTable, APIRequest, GlossaryTooltip } from "~/components"; By adding a Cloudflare Dashboard SSO application to your Cloudflare Zero Trust account, you can enforce single sign-on (SSO) to the Cloudflare dashboard with the identity provider (IdP) of your choice. SSO will be enforced for every user in your email domain. @@ -214,3 +214,19 @@ curl --request PATCH \ ``` Users can now log in using their Cloudflare account email and password. To re-enable SSO, send a `PATCH` request with `"sso_connector_status" : "V"`. + +## Change your team name + +Cloudflare does not allow you to change your team name while dashboard SSO is enabled. To change your team name, you must first disable dashboard SSO. + +:::caution +Before disabling SSO, make sure you have access to your Cloudflare account email. This will allow you to reset your password in case you get logged out of the Cloudflare dashboard. +::: + +1. In [Zero Trust](https://one.dash.cloudflare.com/), go to **Settings** > **Authentication**. +2. If SSO is enabled, turn off **Cloudflare dashboard SSO**. This action can only be performed by Super Administrators. +3. Go to **Settings** > **Custom Pages**. +4. Under **Team domain**, select **Edit** to enter the new team name. Select **Save**. +5. In your identity provider, update your Cloudflare integration with the new team name. For example, if you are using a SAML IdP, you will need to update the Single Sign-on URL and Entity ID to `https://.cloudflareaccess.com/cdn-cgi/access/callback`. +6. In Zero Trust, go to **Settings** > **Authentication**. +7. Turn on **Cloudflare dashboard SSO** to re-enable SSO. \ No newline at end of file diff --git a/src/content/docs/cloudflare-one/faq/getting-started-faq.mdx b/src/content/docs/cloudflare-one/faq/getting-started-faq.mdx index 5fb066d0d5499a..0f2fa0dca0e61a 100644 --- a/src/content/docs/cloudflare-one/faq/getting-started-faq.mdx +++ b/src/content/docs/cloudflare-one/faq/getting-started-faq.mdx @@ -22,7 +22,7 @@ Your team domain is a unique subdomain assigned to your Cloudflare account, for | ---------------- | --------------------------------------- | | `your-team-name` | `.cloudflareaccess.com` | -You can change your team name at any time, unless you have the Cloudflare dashboard SSO feature enabled on your account. Cloudflare dashboard SSO does not currently support team name changes. +You can change your team name at any time, unless you have the Cloudflare dashboard SSO feature enabled on your account. If Cloudflare dashboard SSO is enabled, you must [turn off SSO](/cloudflare-one/applications/configure-apps/dash-sso-apps/#change-a-team-name) before changing your team name. :::caution[Warning] diff --git a/src/content/glossary/cloudflare-one.yaml b/src/content/glossary/cloudflare-one.yaml index 3908d1bbe1949c..93e497edd5881a 100644 --- a/src/content/glossary/cloudflare-one.yaml +++ b/src/content/glossary/cloudflare-one.yaml @@ -217,13 +217,7 @@ entries: - term: team name general_definition: |- - the customizable portion of your team domain, allowing you to personalize your Cloudflare Zero Trust configuration. You can view your team name in Zero Trust under **Settings** > **Custom Pages**. - - | team domain | team name | - | --------------------------------------- | ---------------- | - | `.cloudflareaccess.com` | `your-team-name` | - - To learn about the consequences of changing your team name, refer to the [FAQ](/cloudflare-one/faq/teams-getting-started-faq/#whats-a-team-domainteam-name). + the customizable portion of your team domain (`.cloudflareaccess.com`). You can view your team name in Zero Trust under **Settings** > **Custom Pages**. - term: Terraform general_definition: |-