Resource: TlsInspectionPolicy
The TlsInspectionPolicy resource contains references to CA pools in Certificate Authority Service and associated metadata.
JSON representation |
---|
{ "name": string, "description": string, "createTime": string, "updateTime": string, "caPool": string, "trustConfig": string, "minTlsVersion": enum ( |
Fields | |
---|---|
name |
Required. Name of the resource. Name is of the form projects/{project}/locations/{location}/tlsInspectionPolicies/{tlsInspectionPolicy} tlsInspectionPolicy should match the pattern:(^a-z?$). |
description |
Optional. Free-text description of the resource. |
createTime |
Output only. The timestamp when the resource was created. A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: |
updateTime |
Output only. The timestamp when the resource was updated. A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: |
caPool |
Required. A CA pool resource used to issue interception certificates. The CA pool string has a relative resource path following the form "projects/{project}/locations/{location}/caPools/{caPool}". |
trustConfig |
Optional. A TrustConfig resource used when making a connection to the TLS server. This is a relative resource path following the form "projects/{project}/locations/{location}/trustConfigs/{trustConfig}". This is necessary to intercept TLS connections to servers with certificates signed by a private CA or self-signed certificates. Note that Secure Web Proxy does not yet honor this field. |
minTlsVersion |
Optional. Minimum TLS version that the firewall should use when negotiating connections with both clients and servers. If this is not set, then the default value is to allow the broadest set of clients and servers (TLS 1.0 or higher). Setting this to more restrictive values may improve security, but may also prevent the firewall from connecting to some clients or servers. Note that Secure Web Proxy does not yet honor this field. |
tlsFeatureProfile |
Optional. The selected Profile. If this is not set, then the default value is to allow the broadest set of clients and servers ("PROFILE_COMPATIBLE"). Setting this to more restrictive values may improve security, but may also prevent the TLS inspection proxy from connecting to some clients or servers. Note that Secure Web Proxy does not yet honor this field. |
customTlsFeatures[] |
Optional. List of custom TLS cipher suites selected. This field is valid only if the selected tlsFeatureProfile is CUSTOM. The [compute.SslPoliciesService.ListAvailableFeatures][] method returns the set of features that can be specified in this list. Note that Secure Web Proxy does not yet honor this field. |
excludePublicCaSet |
Optional. If FALSE (the default), use our default set of public CAs in addition to any CAs specified in trustConfig. These public CAs are currently based on the Mozilla Root Program and are subject to change over time. If TRUE, do not accept our default set of public CAs. Only CAs specified in trustConfig will be accepted. This defaults to FALSE (use public CAs in addition to trustConfig) for backwards compatibility, but trusting public root CAs is not recommended unless the traffic in question is outbound to public web servers. When possible, prefer setting this to "false" and explicitly specifying trusted CAs and certificates in a TrustConfig. Note that Secure Web Proxy does not yet honor this field. |
TlsVersion
The minimum version of TLS protocol that can be used by clients or servers to establish a connection with the TLS inspection proxy.
Enums | |
---|---|
TLS_VERSION_UNSPECIFIED |
Indicates no TLS version was specified. |
TLS_1_0 |
TLS 1.0 |
TLS_1_1 |
TLS 1.1 |
TLS_1_2 |
TLS 1.2 |
TLS_1_3 |
TLS 1.3 |
Profile
Profile specifies the set of TLS cipher suites (and possibly other features in the future) that can be used by the firewall when negotiating TLS connections with clients and servers. The meaning of these fields is identical to the load balancers' SSLPolicy resource.
Enums | |
---|---|
PROFILE_UNSPECIFIED |
Indicates no profile was specified. |
PROFILE_COMPATIBLE |
Compatible profile. Allows the broadest set of clients, even those which support only out-of-date SSL features to negotiate with the TLS inspection proxy. |
PROFILE_MODERN |
Modern profile. Supports a wide set of SSL features, allowing modern clients to negotiate SSL with the TLS inspection proxy. |
PROFILE_RESTRICTED |
Restricted profile. Supports a reduced set of SSL features, intended to meet stricter compliance requirements. |
PROFILE_CUSTOM |
Custom profile. Allow only the set of allowed SSL features specified in the custom_features field of SslPolicy. |
Methods |
|
---|---|
|
Creates a new TlsInspectionPolicy in a given project and location. |
|
Deletes a single TlsInspectionPolicy. |
|
Gets details of a single TlsInspectionPolicy. |
|
Lists TlsInspectionPolicies in a given project and location. |
|
Updates the parameters of a single TlsInspectionPolicy. |