Cloudflare Access 可以向获准的电子邮件地址发送一次性 PIN(OTP),作为集成身份提供商以外的登录方式。你也可以同时配置 OTP 登录和所选身份提供商,让用户自行选择身份验证方法。
新的 Zero Trust 组织默认使用 Cloudflare 身份提供商登录。OTP 不再自动添加,但你可以随时按照以下步骤设置。
例如,如果你的团队使用 Okta,但需要与组织外部人员协作,可以使用 OTP 授予访客访问权限。
- 在 Cloudflare 仪表板 ↗中,前往 Zero Trust > Integrations > Identity providers。
- 在 Your identity providers(您的身份提供商) 下,选择 Add new identity provider(添加新的身份提供商)。
- 选择 One-time PIN。
向身份提供商端点发送 POST 请求:
Required API token permissions
At least one of the following token permissions is required:Access: Organizations, Identity Providers, and Groups Write
curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/access/identity_providers" \
--request POST \
--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
--json '{
"name": "One-time PIN login",
"type": "onetimepin",
"config": {}
}'-
为
cloudflare_api_token↗ 添加以下权限:Access: Organizations, Identity Providers, and Groups Write
-
配置
cloudflare_zero_trust_access_identity_provider↗ 资源:resource "cloudflare_zero_trust_access_identity_provider" "onetimepin_login" { account_id = var.cloudflare_account_id name = "One-time PIN login" type = "onetimepin" config = {} }
要授予用户访问应用程序的权限,只需将其电子邮件地址添加到 Access 策略。
如果邮件网关会封锁、限制速率或扫描 OTP 邮件,请将发件域名 notify.cloudflare.com、发件地址 [email protected] 以及以下 IP 地址加入允许列表:
104.30.16.2104.30.16.3104.30.16.4104.30.16.5104.30.16.6104.30.16.7
要使用一次性 PIN 登录 Access:
- 打开受 Access 保护的应用程序。
- 在 Access 登录页面输入电子邮件地址,然后选择 Send login code。

- 如果 Access 策略允许该电子邮件地址,你会在收件箱中收到 PIN。此安全 PIN 在首次请求后 10 分钟过期。
- 将 PIN 粘贴到 Access 登录页面,然后选择 Sign in。
- 如果代码有效,你会被重定向到应用程序。
- 如果代码无效,你会看到 That account does not have access.
- 如果看到 This One-Time PIN has already been used,表示代码已被使用。通常是因为网络中的邮件安全工具在你输入代码之前自动扫描邮件并访问了链接。请选择 Request new code,然后重试。
排查 OTP 登录问题时,请注意以下行为:
- 每个 PIN 只能使用一次。
- 请求新的 PIN 会使之前的 PIN 失效。
- 只有 Access 策略允许该用户时,Cloudflare 才会发送邮件。
- 第三方邮件安全工具可能先于用户访问链接,导致代码显示为已使用。
如果用户反复登录失败,请请求新代码,并确认邮件过滤或链接扫描产品已将 [email protected] 加入允许列表。