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

强制执行 MFA

最后更新 查看 MarkdownAgent 设置

Cloudflare Access 支持两种强制执行多因素身份验证(MFA)的方法:

  • 基于身份提供商的 MFA — 要求使用身份提供商(IdP)报告的特定 MFA 方式。
  • 独立 MFA — 直接在 Access 中提示用户提供第二个验证因素,而无需依赖第三方身份提供商。

对于连接到基础设施应用程序的 SSH 会话,Access 还支持使用 PIV 和 FIDO2 密钥进行独立 MFA。

基于身份提供商的 MFA

您可以要求用户使用其身份提供商提供的特定 MFA 方法登录。例如,您可以创建只允许通过其 IdP 使用安全密钥进行身份验证的用户访问给定应用程序的规则。

仅以下身份提供商支持基于 IdP 的 MFA 强制执行:

要在应用程序上强制执行 IdP MFA 要求:

  1. 在 Cloudflare 仪表板 ↗中,转到 Zero Trust > Access controls(访问控制)> Applications(应用程序)。

  2. 找到您要强制执行 MFA 的应用程序,然后选择 Configure(配置)。或者,创建一个新应用程序。

  3. 转到 Policies(策略)。

  4. 如果您的应用程序已经包含有身份要求的策略,请找到它并选择 Configure(配置)。

  5. 在策略中添加以下规则:

    规则类型 选择器 值
    Require(要求) 身份验证方式 mfa - multiple-factor authentication
  6. 保存策略。

JWT 中的身份验证方法

当用户使用其身份提供商进行身份验证时,IdP 会与 Cloudflare Access 共享其用户名。Access 将该值写入为用户生成的 JSON Web Token(JWT)中。

某些身份提供商还会共享用户出示的 MFA 方法。Access 可以将这些值添加到 JWT 中。例如,如果用户使用其密码和安全密钥进行身份验证,IdP 可以向 Cloudflare Access 发送确认。Access 然后将该方法存储在发给用户的 JWT 中。

Cloudflare Access 遵循 RFC 8176 ↗(身份验证方法参考值,Authentication Method Reference Values)来定义身份验证方法。

独立 MFA

独立 MFA 直接在 Access 中提示用户输入第二因素。这使您能够强制执行 MFA 要求,而不依赖于您的 IdP 的 MFA 配置。

您可以在三个级别配置 MFA 要求:

级别 描述
组织 默认对您账户中的所有应用程序强制执行 MFA。
应用程序 为特定应用程序要求或关闭 MFA。
策略 为符合特定策略的用户要求或关闭 MFA。

MFA 设置按以下优先级生效:策略 > 应用程序 > 组织。

前提条件

在应用程序或策略上配置独立 MFA 之前,必须在组织级别开启独立 MFA。

为应用程序配置独立 MFA

每个应用程序有三个 MFA 选项:

选项 行为
Respect global enforcement setting(遵循全局强制执行设置) 使用组织级别的 MFA 配置。如果全局要求 MFA,则用户必须完成 MFA。如果全局不需要 MFA,则不提示用户。这是默认设置。
Custom MFA settings(自定义 MFA 设置) 使用特定于应用程序的允许身份验证器和会话持续时间覆盖组织设置。
Disable MFA(禁用 MFA) 访问此应用程序时,不会提示用户进行独立 MFA,即使全局要求 MFA 也是如此。

要为应用程序配置 MFA:

  1. 在 Cloudflare 仪表板 ↗中,转到 Zero Trust > Access controls(访问控制)> Applications(应用程序)。
  2. 找到您要配置的应用程序,然后选择 Configure(配置)。
  3. 向下滚动到 Authentication,然后选择 MFA 选项卡。
  4. 选择以下选项之一:
    • 要继承组织设置,请选择 Respect global enforcement setting(遵循全局强制执行设置)。
    • 要设置自定义要求,请选择 Custom MFA settings,然后配置允许的 MFA 方式和身份验证时长。
    • 要免除应用程序的 MFA,请选择 Disable MFA(禁用 MFA)。
  5. 选择 Save(保存)。

有关为基础设施应用程序配置 MFA 的方法,请参阅基础设施应用程序。

为策略配置独立 MFA

每项策略都有与为应用程序配置独立 MFA中所述相同的三个 MFA 选项。策略级设置会覆盖应用程序级设置。

  1. 在 Cloudflare 仪表板 ↗中,转到 Zero Trust > Access controls(访问控制)> Policies(策略)。
  2. 选择一项 Allow 策略,然后选择 Configure。
  3. 在 Multi-factor authentication (MFA) 下选择一个选项:
    • 要继承应用程序或组织设置,请选择 Respect global enforcement setting(遵循全局强制执行设置)。
    • 要为匹配此策略的用户设置自定义要求,请选择 Custom MFA settings,然后配置允许的 MFA 方式和身份验证时长。
    • 要使符合此策略的用户免除 MFA,请选择 Disable MFA(禁用 MFA)。
  4. 选择 Save(保存)。

有关为基础设施应用程序策略配置 MFA 的方法,请参阅基础设施应用程序。

MFA 会话持续时间

MFA 会话持续时间决定了成功进行 MFA 身份验证后其有效的时长。MFA 会话过期后,用户在下次登录 Cloudflare Access 时必须再次完成 MFA,此外还需完成 IdP 身份验证。您可以要求用户在每次 Access 登录时都完成 MFA,或设置自定义持续时间。MFA 会话持续时间仅在登录流程中检查,不会影响用户现有的会话。

Access 按从最具体到最不具体的顺序检查 MFA 会话:

  1. 策略 MFA 会话持续时间 — 如果设置,则适用于符合该策略的用户。
  2. 应用程序 MFA 会话持续时间 — 如果设置,则适用于访问该应用程序的所有用户。
  3. 全局 MFA 会话持续时间 — 未指定自身持续时间的所有应用程序的默认值。

每次登录都需要 MFA

要在用户每次登录应用程序时都要求 MFA,请将身份验证持续时间设置为 Require every login(每次登录都需要)。

  • 组织 — 前往 Zero Trust > Access controls > Access settings > Allow multi-factor authentication (MFA)。将 Authentication duration 设置为 Require every login。除非在应用程序或策略级别覆盖,否则此设置适用于所有应用程序。详情请参阅独立 MFA 设置。
  • 应用程序 — 前往 Zero Trust > Access controls > Applications > 选择应用程序 > Configure > Authentication > MFA 选项卡。选择 Custom MFA settings,并将 Authentication duration 设置为 Require every login。
  • 策略 — 前往 Zero Trust > Access controls > Policies > 选择策略 > Configure。在 Multi-factor authentication (MFA) 下选择 Custom MFA settings,并将 Authentication duration 设置为 Require every login。

要通过 API 为应用程序配置此项,请首先发送 GET 请求以检索完整的应用程序配置,然后发送包含已更新 mfa_config 的完整应用程序主体的 PUT 请求。将 session_duration 设置为 "0m":

curl --request PUT \
https://api.cloudflare.com/client/v4/accounts/{account_id}/access/apps/{app_id} \
--header "Authorization: Bearer <API_TOKEN>" \
--header "Content-Type: application/json" \
--data '{
  "mfa_config": {
    "mfa_disabled": false,
    "session_duration": "0m"
  }
}'

优先级示例

考虑以下配置:

flowchart TD
    subgraph org["Organization"]
        orgSettings["**Apply global MFA settings by default**, <br/>**MFA methods**: Authenticator app + Security key, <br/>**Authentication duration**: 24 hours"]
    end

    subgraph appA["Application A"]
        appASettings["**Respect global enforcement setting**<br/>(inherits organization settings)"]
        subgraph policies["Policies"]
            policy1["Policy 1<br/>**Custom MFA settings**,<br/>**MFA methods**: Security keys only,<br/>**Authentication duration**: 1 hour"]
            policy2["Policy 2<br/>**Disable MFA**"]
        end
    end

    subgraph appB["Application B"]
        appBSettings["**Disable MFA**"]
    end

    orgSettings --> appASettings
    orgSettings -.->|"overridden"| appBSettings
    appASettings -.->|"overridden by"| policy1
    appASettings -.->|"overridden by"| policy2

在此示例中:

  • 访问 Application A 且符合 Policy 1 的用户必须使用安全密钥且每小时重新进行身份验证。
  • 访问 Application A 且符合 Policy 2 的用户不会被提示进行 MFA。
  • 访问 Application A 且这两个策略都不符合的用户必须使用身份验证器应用程序或安全密钥,会话时间为 24 小时。
  • 访问 Application B 的用户不会被提示进行 MFA。

基础设施应用程序

使用 SSH 的基础设施应用程序支持两种专用 MFA 方式。piv_key 使用已注册的个人身份验证(PIV)密钥;ssh_fido2_key 使用已注册的 FIDO2 密钥。这两种方式均不适用于其他 Access 应用程序类型或浏览器中的 WebAuthn 身份验证。

您可以在应用程序级别或策略级别为基础设施应用程序配置 MFA。

为基础设施应用程序配置 MFA

配置自定义 MFA 时,选择 PIV 密钥、FIDO2 密钥或两者。对应的 API 数组分别是 ["piv_key"]、["ssh_fido2_key"] 和 ["piv_key", "ssh_fido2_key"]。

仪表板

  1. 在 Cloudflare 仪表板 ↗中,转到 Zero Trust > Access controls(访问控制)> Applications(应用程序)。
  2. 找到您的基础设施应用程序并选择 Configure(配置)。
  3. 打开 Authentication 选项卡,然后选择 MFA。
  4. 选择以下选项之一:
    • Respect global enforcement setting(遵循全局强制执行设置)— 使用组织级别的 MFA 配置。这是默认设置。
    • Custom MFA settings — 覆盖此应用程序的全局设置。选择 PIV key、FIDO2 key 或两者作为允许的验证器,然后设置自定义 MFA 会话时长。
    • Disable MFA(禁用 MFA)— 访问此应用程序时,不会提示用户进行 MFA。
  5. 选择 Save(保存)。

API

要更新基础设施应用程序的 MFA 设置,请首先发送 GET 请求以获取完整的应用程序配置,然后发送带有包含 mfa_config 对象的完整应用程序主体的 PUT 请求。PUT 请求必须包含 GET 返回的所有字段,以避免覆盖现有设置。

curl --request PUT \
https://api.cloudflare.com/client/v4/accounts/{account_id}/access/apps/{app_id} \
--header "Authorization: Bearer <API_TOKEN>" \
--header "Content-Type: application/json" \
--data '{
  "mfa_config": {
    "mfa_disabled": false,
    "session_duration": "12h",
    "allowed_authenticators": ["piv_key", "ssh_fido2_key"]
  }
}'
字段 类型 描述
mfa_disabled 布尔值 如果为 true,则此应用程序不需要 MFA,即使全局设置强制执行 MFA 也是如此。
session_duration 字符串 用户必须使用 MFA 重新进行身份验证之前的持续时间(例如,30m、1h、24h)。设置为 0m 以在每次 SSH 连接时都要求 MFA。
allowed_authenticators 数组 使用 ["piv_key"]、["ssh_fido2_key"] 或 ["piv_key", "ssh_fido2_key"]。

为基础设施策略配置 MFA

您可以通过在策略级别配置 MFA,为不同的 SSH 用户名设置不同的 MFA 要求。策略级别的 MFA 设置会覆盖应用程序级别的设置。

仪表板

  1. 在 Cloudflare 仪表板 ↗中,转到 Zero Trust > Access controls(访问控制)> Applications(应用程序)。
  2. 找到您的基础设施应用程序并选择 Configure(配置)。
  3. 前往 Policies 并选择要配置的策略。
  4. 在 Multi-factor authentication (MFA) 下选择一个选项:
    • Respect global enforcement setting(遵循全局强制执行设置) — 继承应用程序或组织设置。
    • Custom MFA settings — 选择 PIV key、FIDO2 key 或两者作为允许的验证器,并为匹配此策略的用户设置自定义 MFA 会话时长。
    • Disable MFA(禁用 MFA) — 符合此策略的用户不会被提示进行 MFA。
  5. 选择 Save(保存)。

API

要更新策略的 MFA 设置,请先发送 GET 请求获取完整策略配置,然后发送 PUT 请求,提交包含 mfa_config 对象的完整策略内容。mfa_config 对象使用与应用程序级配置相同的字段。

curl --request PUT \
https://api.cloudflare.com/client/v4/accounts/{account_id}/access/policies/{policy_id} \
--header "Authorization: Bearer <API_TOKEN>" \
--header "Content-Type: application/json" \
--data '{
  "name": "Require MFA for root",
  "decision": "allow",
  "include": [
    {
      "email": {
        "email": "[email protected]"
      }
    }
  ],
  "mfa_config": {
    "mfa_disabled": false,
    "session_duration": "1h",
    "allowed_authenticators": ["piv_key", "ssh_fido2_key"]
  },
  "connection_rules": {
    "ssh": {
      "usernames": ["root"],
      "allow_email_alias": false
    }
  }
}'

SSH 的 MFA 会话持续时间

MFA 会话时长决定用户在无需再次完成 MFA 的情况下可以建立新 SSH 连接的时间。将时长设置为 0m,可要求每次新建连接都完成 MFA。会话过期不会终止现有连接。

MFA 会话与用户设备绑定。如果用户切换到不同的设备,无论剩余会话持续时间如何,都必须重新进行身份验证。

会话持续时间按以下顺序进行评估:

  1. 策略级持续时间 — 如果设置,则适用于符合该策略的用户。
  2. 应用程序级持续时间 — 如果未设置策略级持续时间,则使用应用程序设置。
  3. 组织级持续时间 — 如果策略和应用程序均未定义持续时间,则使用全局设置。

当用户匹配多个各自定义了会话持续时间的策略时,Access 会使用所有匹配策略中最短 的持续时间。

优先级和冲突解决

MFA 配置按从最具体到最不具体的顺序评估:策略 > 应用程序 > 组织。

组织 MFA 应用程序 MFA 策略 MFA 结果
Required(要求) Required(要求) Required(要求) 要求 MFA
Required(要求) Required(要求) 已禁用 不要求 MFA(策略胜出)
Required(要求) 已禁用 (未设置) 不要求 MFA(应用程序胜出)
Required(要求) (未设置) (未设置) 要求 MFA(应用组织设置)

必须启用组织级 MFA,用户才能注册 PIV 密钥。较低级别(策略或应用程序)的明确设置会覆盖较高级别。如果某个级别不存在明确设置,则应用下一个较高级别。

这篇文档对您有帮助吗?