跳转到内容
本站为社区维护的非官方中文翻译,与 Cloudflare, Inc. 无关联。本站不提供账户登录,请勿在任何非官方站点输入您的 Cloudflare 账户信息。官方文档:developers.cloudflare.com

一次性 PIN 登录

最后更新 查看 MarkdownAgent 设置

Cloudflare Access 可以向获准的电子邮件地址发送一次性 PIN(OTP),作为集成身份提供商以外的登录方式。你也可以同时配置 OTP 登录和所选身份提供商,让用户自行选择身份验证方法。

新的 Zero Trust 组织默认使用 Cloudflare 身份提供商登录。OTP 不再自动添加,但你可以随时按照以下步骤设置。

例如,如果你的团队使用 Okta,但需要与组织外部人员协作,可以使用 OTP 授予访客访问权限。

设置 OTP

  1. 在 Cloudflare 仪表板 ↗中,前往 Zero Trust > Integrations > Identity providers。
  2. 在 Your identity providers(您的身份提供商) 下,选择 Add new identity provider(添加新的身份提供商)。
  3. 选择 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
Add an Access identity providerbash
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": {}
	}'
  1. 为 cloudflare_api_token ↗ 添加以下权限:

    • Access: Organizations, Identity Providers, and Groups Write
  2. 配置 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 邮件通过邮件网关

如果邮件网关会封锁、限制速率或扫描 OTP 邮件,请将发件域名 notify.cloudflare.com、发件地址 [email protected] 以及以下 IP 地址加入允许列表:

  • 104.30.16.2
  • 104.30.16.3
  • 104.30.16.4
  • 104.30.16.5
  • 104.30.16.6
  • 104.30.16.7

使用 OTP 登录

要使用一次性 PIN 登录 Access:

  1. 打开受 Access 保护的应用程序。
  2. 在 Access 登录页面输入电子邮件地址,然后选择 Send login code。 输入电子邮件地址以使用 OTP 登录。
  3. 如果 Access 策略允许该电子邮件地址,你会在收件箱中收到 PIN。此安全 PIN 在首次请求后 10 分钟过期。
  1. 将 PIN 粘贴到 Access 登录页面,然后选择 Sign in。 输入 PIN 以登录。
    • 如果代码有效,你会被重定向到应用程序。
    • 如果代码无效,你会看到 That account does not have access.
    • 如果看到 This One-Time PIN has already been used,表示代码已被使用。通常是因为网络中的邮件安全工具在你输入代码之前自动扫描邮件并访问了链接。请选择 Request new code,然后重试。

OTP 行为和限制

排查 OTP 登录问题时,请注意以下行为:

  • 每个 PIN 只能使用一次。
  • 请求新的 PIN 会使之前的 PIN 失效。
  • 只有 Access 策略允许该用户时,Cloudflare 才会发送邮件。
  • 第三方邮件安全工具可能先于用户访问链接,导致代码显示为已使用。

如果用户反复登录失败,请请求新代码,并确认邮件过滤或链接扫描产品已将 [email protected] 加入允许列表。

这篇文档对您有帮助吗?