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

添加基础设施应用程序

最后更新 查看 MarkdownAgent 设置

功能可用性

客户端模式 Zero Trust 方案 ↗
  • 流量与 DNS 模式
  • 仅流量模式
所有方案
系统 可用性
Windows ✅
macOS ✅
Linux ✅
iOS ✅
Android ✅
ChromeOS 系统 ✅

Access for Infrastructure 可让您细致控制用户如何访问各台服务器、集群或数据库。您可以配置用户如何对资源进行身份验证,并限制他们可使用的端口、协议和用户名。

您还可以使用标签组织目标,并定义按主机名、标签或两者匹配目标的应用程序。Access 日志和命令日志可帮助您审计访问并支持合规工作流程。

前提条件

1. 添加目标

目标代表您基础设施中的单个资源(例如服务器、Kubernetes 集群、数据库或容器),用户将通过 Cloudflare 连接到该资源。

目标与协议无关,这意味着无需为服务器上运行的每个协议定义新目标。要创建新目标:

  1. 在 Cloudflare 仪表板 ↗中,前往 Zero Trust > Access controls(访问控制) > Targets。
  2. 选择 Add a target(添加目标)。
  3. 在 Target hostname 中,为目标输入一个便于识别的名称。我们建议使用服务器主机名,例如 production-server。目标主机名不需要唯一,可以在多个目标中重复使用。主机名用于定义 Access 应用程序保护的目标;它们不用于 DNS 地址解析。

    Hostname format restrictions

    • 不区分大小写
    • 不超过 253 个字符
    • 仅包含字母数字字符、- 或 .(不允许空格)
    • 以字母数字字符开头和结尾
  4. 在 IP addresses 中,输入目标资源的 IPv4 和/或 IPv6 地址。只有输入完整 IP 地址后,下拉菜单才会显示内容。
  1. 在下拉菜单中,选择资源所在的 IP 地址和虚拟网络。此 IP 地址和虚拟网络配对现已分配给此目标,出于设计考虑,不能在另一个目标中重复使用。
  2. (可选)在 Tags(标签) 中添加键值标签来组织目标。例如,使用 environment、team 或 region 对目标分组,并在后续的目标条件中匹配它们。每个标签键在一个目标上只能出现一次。例如,一个目标可以包含 environment:production 或 environment:staging,但不能同时包含两者。
  3. 选择 Add target(添加目标)。

向 Infrastructure Access Targets 端点发出 POST 请求:

Create new targetbash
curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/infrastructure/targets" \
	--request POST \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
	--json '{
		"hostname": "infra-access-target",
		"ip": {
				"ipv4": {
						"ip_addr": "187.26.29.249",
						"virtual_network_id": "c77b744e-acc8-428f-9257-6878c046ed55"
				},
				"ipv6": {
						"ip_addr": "64c0:64e8:f0b4:8dbf:7104:72b0:ec8f:f5e0",
						"virtual_network_id": "c77b744e-acc8-428f-9257-6878c046ed55"
				}
		},
		"tags": {
				"environment": "production",
				"team": "platform"
		}
	}'

tags 字段是可选的。使用资源标签管理标签。每个键在每个目标上只能出现一次。

  1. 向您的 cloudflare_api_token ↗ 添加以下权限:

    • Zero Trust Write
  2. 配置 cloudflare_zero_trust_infrastructure_access_target ↗ 资源:

    resource "cloudflare_zero_trust_infrastructure_access_target" "infra-ssh-target" {
    	account_id = var.cloudflare_account_id
    		hostname   = "infra-access-target"
    		ip = {
    			ipv4 = {
    				ip_addr = "187.26.29.249"
    				virtual_network_id = "c77b744e-acc8-428f-9257-6878c046ed55"
    			}
    			ipv6 = {
    				ip_addr = "64c0:64e8:f0b4:8dbf:7104:72b0:ec8f:f5e0"
    				virtual_network_id = "c77b744e-acc8-428f-9257-6878c046ed55"
    			}
    		}
    }

    要通过 Terraform 管理标签,请使用 cloudflare_resource_tag ↗ 资源。

接下来,创建一个 Access 应用程序来保护该目标。

为目标添加标签

您可以为基础设施目标附加键值形式的资源标签,按环境、团队、区域或其他元数据组织目标。

然后,您可以定义自动覆盖所有匹配标签值的目标的基础设施应用程序。

您可以在创建或编辑目标时直接管理标签,也可以通过资源标签 API 管理。

每个标签键在一个目标上只能出现一次。例如,目标可以具有 environment:production 或 environment:staging,但不能同时具有两者。

按标签筛选和排序目标

您可以按标签值筛选目标并排序。

在 Cloudflare 仪表板 ↗中,前往 Zero Trust > Access controls > Targets。使用筛选和排序控件,按标签键或值缩小列表范围。

要按标签筛选目标,请添加一个或多个 tag 查询参数:

curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/infrastructure/targets?tag=environment:production&tag=team:platform" \
  -H "Authorization: Bearer $API_TOKEN"

在每个筛选条件中使用 : 分隔标签键和值。如果添加多个 tag 参数,Cloudflare 会应用 AND 逻辑。

要按标签键排序,请使用 order 和 direction 参数:

curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/infrastructure/targets?order=tag:environment&direction=asc" \
  -H "Authorization: Bearer $API_TOKEN"

排序参数在 order=tag:<key> 中也使用 :,用于指定要排序的标签字段。

2. 添加基础设施应用程序

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

  2. 选择 Create new application(创建新应用程序)。

  3. 选择 Infrastructure(基础设施)。

  4. 为该应用程序输入任意名称。

  5. (可选)从下拉菜单中选择会话持续时间。这会设置基础设施连接在自动关闭前可以保持打开状态的最长时间。默认值为 24 小时。

  6. 在 Target criteria(目标条件) 中,选择此应用涵盖哪些目标。按主机名、标签或两者匹配目标。使用 include 匹配任意值,使用 require 匹配所有值,使用 exclude 拒绝匹配的目标。

  7. 输入用于连接服务器的 Protocol 和 Port。

  8. (可选)如果某个协议运行在多个端口上,选择 Add new target criteria(添加新目标条件),使用不同的端口号重新配置相同目标条件和协议。

  9. 选择 Next(下一步)。

  10. 要保护您的目标,请配置一个策略来定义谁可以连接以及如何连接:

  11. 为您的策略输入任意名称。

  12. 创建一个规则,匹配允许访问目标的用户。有关更多信息,请参阅 Access 策略并查看基础设施策略选择器列表。

  13. 在 Connection context 中,配置以下设置:

    • SSH user(SSH 用户):输入用户可以登录的 UNIX 用户名(例如 root 或 ec2-user)。
    • Allow users to log in as their email alias:(可选)选中后,匹配您策略定义的用户将能够使用其小写电子邮件地址前缀访问目标。例如,[email protected] 可以以 jdoe 身份登录。
  14. 选择 Add application(添加应用程序)。

向 Access applications 端点发出 POST 请求:

以下示例使用基于运算符的目标条件格式,其中包含 include、require 和 exclude:

Required API token permissions

At least one of the following token permissions is required:
  • Access: Apps and Policies Write
Add an Access applicationbash
curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/access/apps" \
	--request POST \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
	--json '{
		"name": "Example infrastructure app",
		"type": "infrastructure",
		"session_duration": "24h",
		"target_criteria": [
				{
						"port": 22,
						"protocol": "SSH",
						"include": {
								"target_attributes": {
										"hostname": [
												"infra-access-target"
										]
								},
								"tags": {
										"environment": [
												"production",
												"staging"
										]
								}
						},
						"require": {
								"tags": {
										"team": [
												"platform"
										]
								}
						},
						"exclude": {
								"tags": {
										"lifecycle": [
												"decommissioned"
										]
								}
						}
				}
		],
		"policies": [
				{
						"name": "Allow a specific email",
						"decision": "allow",
						"include": [
								{
										"email": {
												"email": "[email protected]"
										}
								}
						],
						"connection_rules": {
								"ssh": {
										"usernames": [
												"root",
												"ec2-user"
										]
								}
						}
				}
		]
	}'

关于目标条件格式的更多信息,请参阅目标条件。

  1. 向您的 cloudflare_api_token ↗ 添加以下权限:

    • Access: Apps and Policies Write
  2. 使用 cloudflare_zero_trust_access_application ↗ 资源创建基础设施应用程序:

    resource "cloudflare_zero_trust_access_application" "infra-app" {
    	account_id       = var.cloudflare_account_id
    	name             = "Example infrastructure app"
    	type             = "infrastructure"
    	session_duration = "24h"
    
    	target_criteria {
    		port     = 22
    		protocol = "SSH"
    		target_attributes {
    			name = "hostname"
    			values = ["infra-access-target"]
    		}
    	}
    }

    要按标签匹配目标,请定义带有 tags 选择器的 include、require 或 exclude 块。

  3. 使用 cloudflare_zero_trust_access_policy ↗ 资源向应用程序添加基础设施策略:

    resource "cloudflare_zero_trust_access_policy" "infra-app-policy" {
    	application_id = cloudflare_zero_trust_access_application.infra-app.id
    	account_id = var.cloudflare_account_id
    	name       = "Allow a specific email"
    	decision   = "allow"
    	precedence = 1
    
    	include {
    		email = ["[email protected]"]
    	}
    
    	connection_rules {
    		ssh {
    			usernames = ["root", "ec2-user"]
    		}
    	}
    }

此应用程序中的目标现已受到您的基础设施策略保护。

3. (推荐) 修改 Gateway 中的优先级顺序

默认情况下,Cloudflare 会在评估所有 Gateway 网络策略后评估 Access 应用程序策略。要在特定 Gateway 策略之前或之后评估 Access 应用程序:

  1. 在 Cloudflare 仪表板 ↗中,前往 Zero Trust > 流量策略 > 防火墙策略。在 网络 中,使用以下配置创建网络策略:

    选择器 运算符 值 操作
    Access Infrastructure Target is(是) Present(存在) Allow(允许)
  2. 使用仪表板或 API 更新策略的优先级 顺序。

此 Gateway 策略将应用于所有 Access for Infrastructure 目标,包括 RDP 和 SSH。

4. (可选) 要求独立 MFA

您可以要求用户在通过 SSH 连接之前完成独立 MFA。应用程序配置可选择受支持的基础设施验证器:PIV 密钥(piv_key)、FIDO2 密钥(ssh_fido2_key)或两者。

应用级设置定义默认认证器和会话持续时间。策略可以为特定用户或用户名定义自定义设置。

有关设置说明,请参阅为基础设施应用程序强制执行 MFA。

5. 配置服务器

某些协议需要配置服务器以信任通过 Access for Infrastructure 建立的连接。欲了解更多信息,请参阅特定协议的教程:

对于 SSH,这包括信任 Cloudflare SSH CA;如果服务器限制证书主体,还需要授权您在目标上配置的 SSH 用户名。

6. 以用户身份连接

用户使用首选客户端软件连接到目标 IP 地址。用户必须在设备上登录 Cloudflare One 客户端,但无需进行其他系统配置。你可以选择配置专用 DNS 解析器,以允许连接到目标的专用主机名。

连接到不同的 VNET

要连接到位于不同 VNET 的目标,用户需要切换 Cloudflare One Client 中连接的虚拟网络。

显示可用目标

功能可用性

系统 可用性 最低客户端版本
Windows ✅ 2024.9.346.0
macOS ✅ 2024.9.346.0
Linux ✅ 2024.9.346.0
iOS ❌
Android ❌
ChromeOS 系统 ❌

用户可以使用 warp-cli 来显示他们可以访问的目标列表。在设备上,打开终端并运行以下命令:

warp-cli target list
╭──────────────────────────────────────┬──────────┬───────┬───────────────────────┬──────────────────────┬────────────╮
│ Target ID                            │ Protocol │ Port  │ Attributes            │ IP (Virtual Network) │ Usernames  │
├──────────────────────────────────────┼──────────┼───────┼───────────────────────┼──────────────────────┼────────────┤
│ 0193f22a-9df3-78e3-b5bb-7ab631903306 │ SSH      │ 22    │ hostname: do-target   │ 10.116.0.3 (a1net)   │ alice      │
├──────────────────────────────────────┼──────────┼───────┼───────────────────────┼──────────────────────┼────────────┤
│ 0193f22a-9df3-78e3-b5bb-7ab631903306 │ SSH      │ 23    │ hostname: do-target   │ 10.116.0.3 (a1net)   │ root       │
├──────────────────────────────────────┼──────────┼───────┼───────────────────────┼──────────────────────┼────────────┤
│ 01943cff-6130-7989-8bff-cbc02b59a2b1 │ SSH      │ 80    │ hostname: az-target   │ 172.16.0.0 (b1net)   │ alice, bob │
╰──────────────────────────────────────┴──────────┴───────┴───────────────────────┴──────────────────────┴────────────╯

可以选择添加标志来过滤输出。例如:

warp-cli target list --attribute hostname=do-target --username root

要查看所有可用过滤器,请输入 warp-cli target list --help。

撤销用户会话

要撤销用户对所有基础设施目标的访问权限,您可以在 Zero Trust 中撤销该用户或撤销其设备。Cloudflare 目前不支持撤销用户对特定目标的会话。

为目标添加标签

为目标附加键值形式的资源标签,以便组织和筛选目标,或为应用程序构建目标条件。

要为目标添加标签,需要具有 Zero Trust Write 权限的 API 令牌,无需额外的标签专属权限。

要向目标添加标签,请向 Infrastructure Access Targets 端点发送 PUT 请求,并包含 tags 对象:

Update targetbash
curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/infrastructure/targets/$TARGET_ID" \
	--request PUT \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
	--json '{
		"hostname": "infra-target-example",
		"ip": {
				"ipv4": {
						"ip_addr": "198.51.100.10",
						"virtual_network_id": "c77b744e-acc8-428f-9257-6878c046ed55"
				}
		},
		"tags": {
				"environment": "production",
				"team": "platform"
		}
	}'

每个目标的每个标签键只支持一个值。有关管理标签的更多信息,请参阅资源标签。

细粒度目标权限

基础设施 Access 通过 Cloudflare 基于角色的访问控制支持细粒度读取权限。管理员可以分配范围限于特定目标的只读角色,而不是授予账户范围的访问权限。当具有范围角色的用户调用 target 列表 API 时,响应会自动过滤为仅包含他们有权查看的目标。

这对于那些希望让团队了解自己的基础设施目标而不暴露完整目标清单的组织非常有用。

目标条件

使用目标条件定义基础设施应用程序覆盖哪些目标。每个目标条件条目都包含协议、端口,以及按主机名、标签或两者匹配目标的选择器。

无论使用旧格式还是基于运算符的格式,target_attributes 选择器都只支持 hostname。Cloudflare 会拒绝其他任何 target_attributes 键。

一个目标的每个标签键只能存储一个值。此限制不适用于目标条件。例如,应用程序可以在 include、require 或 exclude 中同时匹配 environment:production 和 environment:staging。

运算符

运算符 逻辑 描述
include 或(OR) 目标必须匹配至少一个包含的选择器。
require 与(AND) 目标必须匹配所有必需的选择器。
exclude 非或(NOT(OR)) 如果目标匹配任意排除的选择器,便会被拒绝。

组合评估方式:(任意 include)AND(所有 require)AND NOT(任意 exclude)。

旧版格式

现有仅按主机名匹配的应用程序可以继续使用扁平的 target_attributes 格式。只有通过 API 或 Terraform 管理应用程序时,这项选择才有影响。每个目标条件条目只能选择一种格式:扁平的 target_attributes,或基于运算符的 include、require 和 exclude。

基础设施策略选择器

以下 Access 策略选择器可用于保护基础设施应用程序:

  • 电子邮件 (Email)
  • 以...结尾的电子邮件 (Emails ending in)
  • SAML 组 (SAML group)
  • 国家/地区 (Country)
  • 身份验证方法 (Authentication method)
  • 设备状况 (Device posture)
  • Entra 组、GitHub 组织、Google Workspace 组、Okta 组 (Entra group, GitHub organization, Google Workspace group, Okta group)

这篇文档对您有帮助吗?