REST Resource: projects.locations.tlsInspectionPolicies

Recurso: TlsInspectionPolicy

O recurso TlsInspectionPolicy contém referências a pools de CA no Certificate Authority Service e nos metadados associados.

Representação JSON 
{
  "name": string,
  "description": string,
  "createTime": string,
  "updateTime": string,
  "caPool": string,
  "trustConfig": string,
  "minTlsVersion": enum (TlsVersion),
  "tlsFeatureProfile": enum (Profile),
  "customTlsFeatures": [
    string
  ],
  "excludePublicCaSet": boolean
}
Campos
name

string

Obrigatório. Nome do recurso. O nome tem o formato projects/{project}/locations/{location}/tlsInspectionPolicies/{tlsInspectionPolicy} tlsInspectionPolicy precisa corresponder ao padrão:(^a-z?$).
description

string

Opcional. Descrição em texto livre do recurso.
createTime

string (Timestamp format)

Apenas saída. O carimbo de data/hora em que o recurso foi criado.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

Apenas saída. O carimbo de data/hora em que o recurso foi atualizado.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
caPool

string

Obrigatório. Um recurso de pool de CAs usado para emitir certificados de interceptação. A string do pool de CA tem um caminho de recurso relativo seguindo o formato "projects/{project}/locations/{location}/caPools/{caPool}".
trustConfig

string

Opcional. Um recurso TrustConfig usado ao fazer uma conexão com o servidor TLS. Esse é um caminho de recurso relativo seguindo o formato "projects/{project}/locations/{location}/trustConfigs/{trustConfig}". Isso é necessário para interceptar conexões TLS para servidores com certificados assinados por uma CA particular ou certificados autoassinados. Observe que o Secure Web Proxy ainda não respeita este campo.
minTlsVersion

enum (TlsVersion)

Opcional. Versão de TLS mínima que o firewall deve usar ao negociar conexões com clientes e servidores. Se essa política não for definida, o valor padrão será permitir o maior conjunto de clientes e servidores (TLS 1.0 ou superior). Definir como valores mais restritivos pode melhorar a segurança, mas também pode impedir que o firewall se conecte a alguns clientes ou servidores. Observe que o Secure Web Proxy ainda não respeita este campo.
tlsFeatureProfile

enum (Profile)

Opcional. O perfil selecionado. Se esse parâmetro não for definido, o valor padrão será permitir o maior conjunto de clientes e servidores ("PROFILE_COMPATIBLE"). Definir como valores mais restritivos pode melhorar a segurança, mas também pode impedir que o proxy de inspeção TLS se conecte a alguns clientes ou servidores. Observe que o Secure Web Proxy ainda não respeita este campo.
customTlsFeatures[]

string

Opcional. Lista de conjuntos de criptografia TLS personalizados selecionados. Este campo só será válido se o tlsFeatureProfile selecionado for PERSONALIZADO. O método [compute.SslPoliciesService.ListAvailableFeatures][] retorna o conjunto de atributos que pode ser especificado na lista. Observe que o Secure Web Proxy ainda não respeita este campo.
excludePublicCaSet

boolean

Opcional. Se FALSO (o padrão), use nosso conjunto padrão de ACs públicas, além de todas as ACs especificadas em trustConfig. Essas CAs públicas atualmente se baseiam no Programa Mozilla Root e estão sujeitas a mudanças ao longo do tempo. Se VERDADEIRO, não aceite nosso conjunto padrão de CAs públicas. Somente CAs especificadas em trustConfig serão aceitas. O padrão é FALSE (use CAs públicas além de trustConfig) para compatibilidade com versões anteriores. No entanto, confiar em CAs raiz públicas não é recomendado a menos que o tráfego em questão vá para servidores da Web públicos. Quando possível, prefira definir esse campo como "falso" e especificar explicitamente CAs e certificados confiáveis em um TrustConfig. Observe que o Secure Web Proxy ainda não respeita este campo.

TlsVersion

A versão mínima do protocolo TLS que pode ser usada por clientes ou servidores para estabelecer uma conexão com o proxy de inspeção TLS.

Tipos enumerados
TLS_VERSION_UNSPECIFIED Indica que nenhuma versão do TLS foi especificada.
TLS_1_0 TLS 1.0
TLS_1_1 TLS 1.1
TLS_1_2 TLS 1.2
TLS_1_3 TLS 1.3

Perfil

O perfil especifica o conjunto de conjuntos de criptografia TLS (e possivelmente outros recursos no futuro) que pode ser usado pelo firewall ao negociar conexões TLS com clientes e servidores. O significado desses campos é idêntico ao recurso SSLPolicy dos balanceadores de carga.

Tipos enumerados
PROFILE_UNSPECIFIED Indica que nenhum perfil foi especificado.
PROFILE_COMPATIBLE Perfil compatível. Permite que o maior conjunto de clientes, mesmo aqueles que suportam apenas recursos SSL desatualizados, negociem com o proxy de inspeção TLS.
PROFILE_MODERN Perfil moderno. dá suporte a um amplo conjunto de recursos de SSL, o que permite que clientes modernos negociem o protocolo com o proxy de inspeção TLS.
PROFILE_RESTRICTED Perfil restrito. Dá suporte a menos recursos de SSL para cumprir requisitos de compliance mais rigorosos.
PROFILE_CUSTOM Perfil personalizado. Permitir apenas o conjunto de recursos SSL permitidos especificados no campo custom_features de SslPolicy.

Métodos

create

 Cria uma nova TlsInspectionPolicy em um determinado projeto e local.

delete

 Exclui uma única TlsInspectionPolicy.

get

 Recebe detalhes de uma única TlsInspectionPolicy.

list

 Lista TlsInspectionPolicies em um determinado projeto e local.

patch

 Atualiza os parâmetros de uma única TlsInspectionPolicy.