Skip to content

Commit 90cbc00

Browse files
dcpenaranbel
andauthored
[ZT] Added how to change a team domain name (#23909)
* Added how to change a team domain name * add additional details --------- Co-authored-by: Ranbel Sun <[email protected]>
1 parent 61e6ff7 commit 90cbc00

File tree

3 files changed

+19
-9
lines changed

3 files changed

+19
-9
lines changed

src/content/docs/cloudflare-one/applications/configure-apps/dash-sso-apps.mdx

Lines changed: 17 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ sidebar:
55
order: 4
66
---
77

8-
import { FeatureTable, APIRequest } from "~/components";
8+
import { FeatureTable, APIRequest, GlossaryTooltip } from "~/components";
99

1010
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.
1111

@@ -214,3 +214,19 @@ curl --request PATCH \
214214
```
215215

216216
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"`.
217+
218+
## Change your team name
219+
220+
Cloudflare does not allow you to change your <GlossaryTooltip term="team name">team name</GlossaryTooltip> while dashboard SSO is enabled. To change your team name, you must first disable dashboard SSO.
221+
222+
:::caution
223+
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.
224+
:::
225+
226+
1. In [Zero Trust](https://one.dash.cloudflare.com/), go to **Settings** > **Authentication**.
227+
2. If SSO is enabled, turn off **Cloudflare dashboard SSO**. This action can only be performed by Super Administrators.
228+
3. Go to **Settings** > **Custom Pages**.
229+
4. Under **Team domain**, select **Edit** to enter the new team name. Select **Save**.
230+
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://<new-team-name>.cloudflareaccess.com/cdn-cgi/access/callback`.
231+
6. In Zero Trust, go to **Settings** > **Authentication**.
232+
7. Turn on **Cloudflare dashboard SSO** to re-enable SSO.

src/content/docs/cloudflare-one/faq/getting-started-faq.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@ Your team domain is a unique subdomain assigned to your Cloudflare account, for
2222
| ---------------- | --------------------------------------- |
2323
| `your-team-name` | `<your-team-name>.cloudflareaccess.com` |
2424

25-
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.
25+
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.
2626

2727
:::note
2828

src/content/glossary/cloudflare-one.yaml

Lines changed: 1 addition & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -233,13 +233,7 @@ entries:
233233
234234
- term: team name
235235
general_definition: |-
236-
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**.
237-
238-
| team domain | team name |
239-
| --------------------------------------- | ---------------- |
240-
| `<your-team-name>.cloudflareaccess.com` | `your-team-name` |
241-
242-
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).
236+
the customizable portion of your team domain (`<your-team-name>.cloudflareaccess.com`). You can view your team name in Zero Trust under **Settings** > **Custom Pages**.
243237
244238
- term: Terraform
245239
general_definition: |-

0 commit comments

Comments
 (0)