资源:TlsInspectionPolicy
TlsInspectionPolicy 资源包含对 Certificate Authority Service 中的 CA 池和相关元数据的引用。
JSON 表示法 |
---|
{ "name": string, "description": string, "createTime": string, "updateTime": string, "caPool": string, "trustConfig": string, "minTlsVersion": enum ( |
字段 | |
---|---|
name |
必需。资源的名称。名称的格式为 projects/{project}/locations/{location}/tlsInspectionPolicies/{tlsInspectionPolicy},其中 tlsInspectionPolicy 应与模式“(^a-z?$)”匹配。 |
description |
可选。资源的自由文本说明。 |
createTime |
仅限输出。创建资源时的时间戳。 时间戳采用 RFC3339 世界协调时间(UTC,即“祖鲁时”)格式,精确到纳秒,最多九个小数位。示例: |
updateTime |
仅限输出。更新资源时的时间戳。 时间戳采用 RFC3339 世界协调时间(UTC,即“祖鲁时”)格式,精确到纳秒,最多九个小数位。示例: |
caPool |
必需。用于颁发拦截证书的 CA 池资源。CA 池字符串的相对资源路径采用以下格式:“projects/{project}/locations/{location}/caPools/{caPool}”。 |
trustConfig |
可选。与 TLS 服务器建立连接时使用的 TrustConfig 资源。这是一个采用以下格式的相对资源路径:“projects/{project}/locations/{location}/trustConfigs/{trustConfig}”。必须执行此操作,才能拦截使用由私有 CA 签名的证书或自签名证书的服务器的 TLS 连接。请注意,安全 Web 代理尚不支持此字段。 |
minTlsVersion |
可选。防火墙在与客户端和服务器协商连接时应使用的最低 TLS 版本。如果未设置此值,则默认值为允许最广泛的客户端和服务器(TLS 1.0 或更高版本)。将此值设置为更严格的值可能会提高安全性,但也可能会阻止防火墙连接到某些客户端或服务器。请注意,安全 Web 代理尚不支持此字段。 |
tlsFeatureProfile |
可选。所选个人资料。如果未设置此属性,则默认值为允许最广泛的客户端和服务器(“PROFILE_COMPATIBLE”)。将此值设置为更严格的值可能会提高安全性,但也可能会阻止 TLS 检查代理连接到某些客户端或服务器。请注意,安全 Web 代理尚不支持此字段。 |
customTlsFeatures[] |
可选。所选自定义 TLS 加密套件列表。只有当所选的 tlsFeatureProfile 为 CUSTOM 时,此字段才有效。[compute.SslPoliciesService.ListAvailableFeatures][] 方法会返回可在此列表中指定的一组功能。请注意,安全 Web 代理尚不支持此字段。 |
excludePublicCaSet |
可选。如果为 FALSE(默认值),除了 trustConfig 中指定的任何 CA 之外,还会使用我们的一组默认公共 CA。这些公共 CA 目前基于 Mozilla 根计划,可能会随时间推移而发生变化。如果为 TRUE,则不接受我们的默认公共 CA 组。仅接受 trustConfig 中指定的 CA。为实现向后兼容性,此值默认为 FALSE(除了 trustConfig 之外,还使用公共 CA),但不建议信任公共根 CA,除非相关流量是出站到公共网站服务器。请尽可能将其设置为“false”,并在 TrustConfig 中明确指定受信任的 CA 和证书。请注意,安全 Web 代理尚不支持此字段。 |
TlsVersion
客户端或服务器可用于与 TLS 检查代理建立连接的最低 TLS 协议版本。
枚举 | |
---|---|
TLS_VERSION_UNSPECIFIED |
表示未指定 TLS 版本。 |
TLS_1_0 |
TLS 1.0 |
TLS_1_1 |
TLS 1.1 |
TLS_1_2 |
TLS 1.2 |
TLS_1_3 |
TLS 1.3 |
个人资料
配置文件指定防火墙在与客户端和服务器协商 TLS 连接时可以使用的一组 TLS 加密套件(以及未来可能的其他功能)。这些字段的含义与负载平衡器的 SSLPolicy 资源相同。
枚举 | |
---|---|
PROFILE_UNSPECIFIED |
表示未指定任何配置文件。 |
PROFILE_COMPATIBLE |
兼容的配置文件。可让数量最多的客户端(即使是仅支持已过时的 SSL 功能的客户端)与 TLS 检查代理协商。 |
PROFILE_MODERN |
现代配置文件。支持大量 SSL 功能,允许新型客户端与 TLS 检查代理协商 SSL。 |
PROFILE_RESTRICTED |
受限个人资料。支持的 SSL 功能较少,旨在满足更严格的合规要求。 |
PROFILE_CUSTOM |
自定义配置文件。仅允许 SslPolicy 的 custom_features 字段中指定的一组允许的 SSL 功能。 |
方法 |
|
---|---|
|
在给定的项目和位置中创建一个新的 TlsInspectionPolicy。 |
|
删除单个 TlsInspectionPolicy。 |
|
获取单个 TlsInspectionPolicy 的详细信息。 |
|
列出给定项目和位置中的 TlsInspectionPolicy。 |
|
更新单个 TlsInspectionPolicy 的参数。 |