资源: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(默认值),请使用我们的默认公共 CA 集以及 trustConfig 中指定的所有 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 的参数。 |