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.

A ServerTlsPolicy no formato aceito pelos balanceadores de carga de aplicativo só pode ser anexada 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 de texto livre do recurso.
createTime

string (Timestamp format)

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

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes 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 padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de "Z", outros ajustes 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 falso para políticas de balanceador de carga de aplicativo.

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 vai permitir conexões de texto simples e mTLS. Consulte a documentação de outros modos de criptografia para confirmar a compatibilidade.

Considere usá-lo se quiser fazer upgrade da implantação para o TLS enquanto o tráfego TLS e não TLS chega à porta :80.
serverCertificate

object (CertificateProvider)

Opcional se a política for usada com o Traffic Director. Para balanceadores de carga de aplicativo, 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 um modo permissivo que permite texto simples e TLS não é compatível.
mtlsPolicy

object (MTLSPolicy)

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

Define um mecanismo para provisionar certificados de validação de peering para autenticação de peering (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 vai 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 receber 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 relação aos certificados configurados no TrustConfig fornecido.

Permitido somente se a política for usada com balanceadores de carga de aplicativo.
tier

enum (Tier)

Nível de TLS mútuo.

Permitido somente se a política for usada com balanceadores de carga de aplicativo.

ClientValidationMode

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

Tipos enumerados
CLIENT_VALIDATION_MODE_UNSPECIFIED Não é permitido.
ALLOW_INVALID_OR_MISSING_CLIENT_CERT Permitir a conexão mesmo que a validação da cadeia de certificados 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 a extração de dados 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 do cliente e permitir a conexão com o back-end somente se a validação do certificado do cliente for aprovada.

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

Nível

Nível de TLS mútuo para XLB.

Tipos enumerados
TIER_UNSPECIFIED Se o nível não for especificado na solicitação, o sistema vai escolher um valor padrão, que 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 Advanced. Para clientes em ambientes altamente regulamentados, especificando chaves mais longas e cadeias de certificados complexas.

Métodos

create

 Cria uma ServerTlsPolicy em determinado projeto e local.

delete

 Exclui uma única ServerTlsPolicy.

get

 Recebe detalhes de uma única ServerTlsPolicy.

list

 Lista as ServerTlsPolicies em determinado projeto e local.

patch

 Atualiza os parâmetros de uma única ServerTlsPolicy.