您可以将 Google Workspace(前称 G Suite)账户与 Cloudflare Access 集成。与通用 Google 身份验证说明不同,以下步骤还允许您从 Google Workspace 账户获取群组成员信息。
集成后,用户可以使用 Google Workspace 凭据登录,访问受 Cloudflare Access 保护的资源,或将设备注册到 Cloudflare Gateway。
您无需成为 Google Cloud Platform 用户,也能将 Google Workspace 作为身份提供商与 Cloudflare One 集成。仅需打开 Google Cloud Platform,配置 IdP 集成设置。
-
登录 Google Cloud Platform 控制台 ↗。该控制台与 Google Workspace 控制台不同。
-
启用 Google Workspace API 需要一个 Google Cloud 项目。如果尚无项目,请前往 IAM & Admin > Create Project,为项目命名,然后选择 Create。
-
前往 APIs & Services 并选择 Enable APIs and Services。系统会加载 API Library。
-
在 API Library 中搜索
admin,然后选择 Admin SDK API。 -
启用 Admin SDK API。
-
返回 APIs & Services 页面,前往 Credentials。
-
选择 Configure Consent Screen。

-
要配置同意屏幕:
- 选择 Get Started。
- 输入 App name 和 User support email。
- 将 Audience Type 设为 Internal。这样只允许 Google Workspace 中的用户发出授权请求,并阻止普通 Gmail 地址的用户。
- 输入 Contact Information。Google Cloud Platform 要求账户中提供电子邮件地址。
- 同意 Google 的用户数据政策,然后选择 Continue。
- 选择 Create(创建)。
-
系统会加载 OAuth 概览页面。选择 Create OAuth Client。

-
将 Application type 设为 Web application,并为 OAuth Client ID 命名。
-
在 Authorized JavaScript origins 下的 URIs 字段中,输入团队域名:
https://<your-team-name>.cloudflareaccess.com您可以在 Cloudflare 仪表板 ↗ 的 Settings(设置)> Team name and domain(团队名称和域名)> Team name(团队名称) 下找到您的团队名称。
-
在 Authorized redirect URIs 下的 URIs 字段中,输入以下 URL:
https://<your-team-name>.cloudflareaccess.com/cdn-cgi/access/callback -
创建 OAuth 客户端后,选择刚创建的客户端。Google 会显示 OAuth Client ID 和 Client secret 的值。客户端密钥相当于密码,不应分享。请复制 OAuth Client ID 和 Client secret 的值。
-
在 Google 管理控制台 ↗中,前往 Security > Access and data control > API controls。
-
在 API Controls 中,选择 Settings。
-
选择 Internal apps,勾选 Trust internal apps 以启用此选项。默认情况下 Trust internal apps 处于关闭状态,必须启用,Cloudflare Access 才能正常工作。

- 在 Cloudflare 仪表板 ↗中,前往 Zero Trust > Integrations > Identity providers。
- 选择 Add new identity provider,再选择 Google Workspace。
- 输入先前生成的 Client ID(在 Cloudflare 仪表板中称为 App ID)和 Client Secret,并输入 Google Workspace 账户的域名。
- (可选)启用代码交换证明密钥(PKCE) ↗。所有登录尝试都会执行 PKCE。
- (可选)在 Optional configurations 下,输入要加入用户身份信息的自定义 OIDC 声明。
- (可选)在 Authentication options 下,选择 Google prompt,并启用 Use previous email as a login hint。
- 选择 Save。要完成设置,必须访问生成的链接。如果您不是 Google Workspace 管理员,请将链接分享给管理员。
- 生成的链接会提示您登录 Google 管理员账户,并授权 Cloudflare Access 查看群组信息。授予权限后,您会看到 Cloudflare Access 的成功页面。
要测试连接是否正常,请前往 Integrations > Identity providers,并选择 Google Workspace 旁的 Test。页面应返回您的用户身份和群组成员信息。
你可以控制 Google 处理每个身份验证请求的方式。请在仪表板中或通过 API 配置这些选项。
Google prompt 设置支持以下选项:
| 仪表板选项 | API prompt 值 |
行为 |
|---|---|---|
| Google 默认值 | 省略 prompt |
Google 根据当前浏览器会话决定是否显示提示。 |
| 不显示提示 | none |
Google 尝试在不显示提示的情况下进行身份验证。如果 Google 无法完成静默身份验证,Access 会使用 Google 默认行为重试一次。 |
| 同意 | consent |
Google 会请求用户同意。 |
| 选择账户 | select_account |
Google 会显示账户选择器。Access 不会发送登录提示。 |
要复用之前的电子邮件,请启用 Use previous email as a login hint。Access 会检查同一设备上之前 Access 登录使用的电子邮件。当恰好有一个电子邮件与配置的 Google Workspace 域匹配时,它会发送 login_hint。
当多个电子邮件匹配时,Access 不会发送提示。对于账户选择和安全重新提示,它也会跳过提示。登录提示不会强制 Google 显示账户选择器。
有关这些值的详细信息,请参阅 Google 的身份验证请求参数 ↗。
首先,从 Access 身份提供商端点获取当前身份提供商配置。然后,将完整配置发送到更新身份提供商端点。
将 prompt 和 use_login_hint 添加到 config 对象:
{
"config": {
"client_id": "<YOUR_CLIENT_ID>",
"client_secret": "<YOUR_CLIENT_SECRET>",
"apps_domain": "example.com",
"prompt": "select_account",
"use_login_hint": true
},
"type": "google-apps",
"name": "Google Workspace"
}如果您在 Google 中删除了 OAuth 客户端(或 OAuth 客户端已过期),您将收到 Error 401: deleted_client 授权错误。
要解决此问题,请完成 Google 指南中的步骤 6 至 12,以及 Google Workspace 指南中的步骤 9 至 15。
如果将 Google Workspace 用作身份提供商,同时使用 Access 策略保护 Google 托管的应用程序,就会形成循环重定向:Access 将用户发送到 Google 进行身份验证,但 Google 又要求用户先通过 Access 身份验证。
如果需要保护 Google 托管的应用程序,同时将 Google Workspace 用作其他应用程序的 IdP,请专门为保护该 Google 托管应用的 Access 应用程序配置第二个身份提供商(例如 Okta 或 Microsoft Entra ID)。其他应用程序仍使用 Google Workspace 作为 IdP。
Google Workspace 的群组成员变更不会立即同步到 Cloudflare Access。需要注意以下两种延迟:
Google Workspace 可能需要最多 24 小时,才能通过 Admin SDK API 反映群组变更。此外,Cloudflare 会在用户活跃会话期间缓存身份信息,因此加入或移出群组的用户,只有在会话过期或重新验证身份后才会看到策略变化。
要强制立即更新特定用户,请前往 Zero Trust > Team & Resources > Users,选择用户,再选择 Action > Revoke 并确认。这会使用户的 Access 会话令牌失效,强制其重新验证身份并刷新群组成员信息。
如果组织有一个主要 Google Workspace 域名和一个或多个辅助域名(例如 example.com 和 example.co.uk),所有用户都通过同一个 Google Workspace 组织进行身份验证。无需为每个域名单独添加身份提供商。
构建 Access 策略时,可以使用群组成员选择器而非电子邮件域名选择器,覆盖所有域名的用户。也可以使用 Emails ending in 选择器,将每个域名作为通过 OR 逻辑连接的单独策略规则。
如果有多个独立的 Google Workspace 组织(而非一个组织内的多个域名),必须在 Cloudflare Zero Trust 中将每个组织分别添加为 Google Workspace 身份提供商。