Skip to content

Commit 889ea6d

Browse files
[CF1] sso limitations update
1 parent 97a9871 commit 889ea6d

File tree

1 file changed

+17
-16
lines changed

1 file changed

+17
-16
lines changed

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

Lines changed: 17 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -3,20 +3,19 @@ pcx_content_type: how-to
33
title: Cloudflare dashboard SSO application
44
sidebar:
55
order: 4
6-
76
---
87

9-
import { FeatureTable } from "~/components"
8+
import { FeatureTable } from "~/components";
109

11-
By adding a 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.
10+
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.
1211

1312
## Availability
1413

1514
<FeatureTable id="account.single_sign_on" />
1615

1716
## Prerequisites
1817

19-
All users in your email domain must exist as a member in your Cloudflare account and IdP. To add users to your Cloudflare account, refer to [Manage Cloudflare account access](/fundamentals/setup/manage-members/).
18+
All users in your email domain must exist as a member in your Cloudflare account and IdP. To add users to your Cloudflare account, refer to [Manage Cloudflare account access](/fundamentals/setup/manage-members/).
2019

2120
## 1. Set up an IdP
2221

@@ -32,15 +31,15 @@ Once your SSO domain is approved, a new **SSO App** application will appear unde
3231

3332
### SSO domain requirements
3433

35-
* The email domain must belong to your organization. Public email providers such as `@gmail.com` are not allowed.
36-
* Every user with that email domain must be an employee in your organization. For example, university domains such as `@harvard.edu` are not allowed because they include student emails.
37-
* Your SSO domain can include multiple email domains.
34+
- The email domain must belong to your organization. Public email providers such as `@gmail.com` are not allowed.
35+
- Every user with that email domain must be an employee in your organization. For example, university domains such as `@harvard.edu` are not allowed because they include student emails.
36+
- Your SSO domain can include multiple email domains.
3837

3938
## 3. Enable dashboard SSO
4039

4140
:::note
4241

43-
We recommend noting down your [Global API key](/fundamentals/api/get-started/keys/) in case you need to [disable SSO](#option-2-disable-dashboard-sso) later.
42+
Cloudflare recommends noting down your [Global API key](/fundamentals/api/get-started/keys/) in case you need to [disable SSO](#option-2-disable-dashboard-sso) later.
4443
:::
4544

4645
1. In [Zero Trust](https://one.dash.cloudflare.com/), go to **Settings** > **Authentication**.
@@ -58,8 +57,10 @@ We recommend noting down your [Global API key](/fundamentals/api/get-started/key
5857

5958
Cloudflare dashboard SSO does not support:
6059

61-
* Users with plus-addressed emails, such as `[email protected]`. If you have users like this added to your Cloudflare organization, they will be unable to login with SSO.
62-
* IdP initiated logins (such as a tile in Okta). All login attempts must originate from `https://dash.cloudflare.com`. You can create a bookmark for this URL in your IdP to assist users.
60+
- Users with plus-addressed emails, such as `[email protected]`. If you have users like this added to your Cloudflare organization, they will be unable to login with SSO.
61+
- IdP initiated logins (such as a tile in Okta). All login attempts must originate from `https://dash.cloudflare.com`. You can create a bookmark for this URL in your IdP to assist users.
62+
- Adding a separate email-based policy to the SSO application that does not match your organization domain policy.
63+
- Deleting the auto-generated `allow email domain` policy. Deleting this policy would make the Cloudflare dashboard inaccessible for your organization.
6364

6465
## Bypass dashboard SSO
6566

@@ -163,12 +164,12 @@ curl --request PATCH \
163164

164165
```json title="Response"
165166
{
166-
"result": {
167-
"id": "2828"
168-
},
169-
"success": true,
170-
"errors": [],
171-
"messages": []
167+
"result": {
168+
"id": "2828"
169+
},
170+
"success": true,
171+
"errors": [],
172+
"messages": []
172173
}
173174
```
174175

0 commit comments

Comments
 (0)