REST Resource: projects.locations.serverTlsPolicies

Recurso: ServerTlsPolicy

ServerTlsPolicy é um recurso que especifica como um servidor deve autenticar as solicitações recebidas. Esse recurso em si não afeta a configuração, a menos que esteja anexado a um proxy HTTPS de destino ou recurso de seletor de configuração de endpoint.

O ServerTlsPolicy no formulário aceito pelos balanceadores de carga de aplicativo só pode ser anexado ao TargetHttpsProxy com um esquema de balanceamento de carga EXTERNAL, EXTERNAL_MANAGED ou INTERNAL_MANAGED. As ServerTlsPolicies compatíveis com o Traffic Director podem ser anexadas a EndpointPolicy e TargetHttpsProxy com o esquema de balanceamento de carga INTERNAL_SELF_MANAGED do Traffic Director.

Representação JSON 
{
  "name": string,
  "description": string,
  "createTime": string,
  "updateTime": string,
  "labels": {
    string: string,
    ...
  },
  "allowOpen": boolean,
  "serverCertificate": {
    object (CertificateProvider)
  },
  "mtlsPolicy": {
    object (MTLSPolicy)
  }
}
Campos
name

string

Obrigatório. Nome do recurso ServerTlsPolicy. Ele corresponde ao padrão projects/*/locations/{location}/serverTlsPolicies/{serverTlsPolicy}
description

string

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.

Usa o RFC 3339, em que a saída gerada é sempre normalizada em Z e usa dígitos fracionários 0, 3, 6 ou 9. Deslocamentos diferentes de "Z" também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

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

Usa o RFC 3339, em que a saída gerada é sempre normalizada em Z e usa dígitos fracionários 0, 3, 6 ou 9. Deslocamentos diferentes de "Z" também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
labels

map (key: string, value: string)

Conjunto de tags de rótulo associadas ao recurso.

Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
allowOpen

boolean

Este campo se aplica apenas às políticas do Traffic Director. Ele precisa ser definido como "false" para políticas do Application Load Balancer.

Determina se o servidor permite conexões de texto simples Se definido como "true", o servidor permite conexões de texto simples. Por padrão, ela é definida como falsa. Essa configuração não é exclusiva de outros modos de criptografia. Por exemplo, se allowOpen e mtlsPolicy estiverem definidos, o servidor permitirá conexões de texto simples e mTLS. Consulte a documentação de outros modos de criptografia para confirmar a compatibilidade.

Use essa opção se quiser fazer upgrade da sua implantação para TLS, mantendo o tráfego misto de TLS e não TLS que chega à porta 80.
serverCertificate

object (CertificateProvider)

Opcional se a política for usada com o Traffic Director. Para balanceadores de carga de aplicativos, precisa estar vazio.

Define um mecanismo para provisionar a identidade do servidor (chaves públicas e privadas). Não é possível combinar com allowOpen, porque não há suporte para um modo permissivo que permite texto simples e TLS.
mtlsPolicy

object (MTLSPolicy)

Este campo é obrigatório se a política for usada com balanceadores de carga de aplicativo. Esse campo pode ficar vazio no Traffic Director.

Define um mecanismo para provisionar certificados de validação de pares para autenticação de pares (TLS mútuo - mTLS). Se não for especificado, o certificado do cliente não será solicitado. A conexão é tratada como TLS, e não mTLS. Se allowOpen e mtlsPolicy estiverem definidos, o servidor permitirá conexões de texto simples e mTLS.

MTLSPolicy

Especificação da MTLSPolicy.

Representação JSON 
{
  "clientValidationMode": enum (ClientValidationMode),
  "clientValidationCa": [
    {
      object (ValidationCA)
    }
  ],
  "clientValidationTrustConfig": string,
  "tier": enum (Tier)
}
Campos
clientValidationMode

enum (ClientValidationMode)

Quando o cliente apresenta um certificado inválido ou nenhum certificado para o balanceador de carga, o clientValidationMode especifica como a conexão do cliente é processada.

Obrigatório se a política for usada com os balanceadores de carga de aplicativo. Para o Traffic Director, ele precisa estar vazio.
clientValidationCa[]

object (ValidationCA)

Obrigatório se a política for usada com o Traffic Director. Para balanceadores de carga de aplicativo, ele precisa estar vazio.

Define o mecanismo para conseguir o certificado da autoridade certificadora para validar o certificado do cliente.
clientValidationTrustConfig

string

Referência ao TrustConfig do namespace certificatemanager.googleapis.com.

Se especificado, a validação da cadeia será realizada em certificados configurados no TrustConfig.

Só é permitido se a política for usada com balanceadores de carga de aplicativo.
tier

enum (Tier)

Nível de TLS mútuo.

Só é permitido se a política for usada com balanceadores de carga de aplicativo.

ClientValidationMode

Modo de validação de certificado TLS mútuo.

Enums
CLIENT_VALIDATION_MODE_UNSPECIFIED Não permitido.
ALLOW_INVALID_OR_MISSING_CLIENT_CERT Permite a conexão mesmo que a validação da cadeia de certificados do certificado do cliente tenha falhado ou nenhum certificado do cliente tenha sido apresentado. O comprovante de posse da chave privada é sempre verificado se o certificado do cliente foi apresentado. Esse modo exige que o back-end implemente o processamento de dados extraídos de um certificado do cliente para autenticar o peer ou rejeitar conexões se a impressão digital do certificado do cliente estiver ausente.
REJECT_INVALID

Exigir um certificado de cliente e permitir a conexão com o back-end somente se a validação do certificado do cliente for bem-sucedida.

Se definido, exige uma referência a um TrustConfig não vazio especificado em clientValidationTrustConfig.

Nível

Nível TLS mútuo para XLB.

Enums
TIER_UNSPECIFIED Se o nível não for especificado na solicitação, o sistema vai escolher um valor padrão, atualmente o nível STANDARD.
STANDARD Nível padrão. Principalmente para provedores de software (comunicação de serviço para serviço/API).
ADVANCED Nível avançado. Para clientes em ambientes altamente regulamentados, especificando chaves mais longas, cadeias de certificados complexas.

Métodos

create

 Cria uma nova ServerTlsPolicy em um determinado projeto e local.

delete

 Exclui uma única ServerTlsPolicy.

get

 Recebe detalhes de uma única ServerTlsPolicy.

list

 Lista as políticas de ServerTls em um determinado projeto e local.

patch

 Atualiza os parâmetros de uma única ServerTlsPolicy.