REST Resource: projects.locations.serverTlsPolicies

Recurso: ServerTlsPolicy

ServerTlsPolicy es un recurso que especifica cómo un servidor debe autenticar solicitudes entrantes. Este recurso no afecta la configuración, a menos que esté conectado a un proxy HTTPS de destino o a un recurso selector de configuración de extremo.

ServerTlsPolicy en el formato que aceptan los balanceadores de cargas de aplicaciones solo se puede adjuntar a TargetHttpsProxy con un esquema de balanceo de cargas EXTERNAL, EXTERNAL_MANAGED o INTERNAL_MANAGED. Las ServerTlsPolicies compatibles con Traffic Director se pueden adjuntar a EndpointPolicy y TargetHttpsProxy con el esquema de balanceo de cargas INTERNAL_SELF_MANAGED de Traffic Director.

Representación JSON 
{
  "name": string,
  "description": string,
  "createTime": string,
  "updateTime": string,
  "labels": {
    string: string,
    ...
  },
  "mtlsPolicy": {
    object (MTLSPolicy)
  }
}
Campos
name

string

Obligatorio. Es el nombre del recurso ServerTlsPolicy. Coincide con el patrón projects/*/locations/{location}/serverTlsPolicies/{serverTlsPolicy}
description

string

Es una descripción de texto libre del recurso.
createTime

string (Timestamp format)

Solo salida. Marca de tiempo cuando se creó el recurso.

Usa RFC 3339, en el que el resultado generado siempre se normalizará en Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan compensaciones distintas de "Z". Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Solo salida. La marca de tiempo cuando se creó el recurso.

Usa RFC 3339, en el que el resultado generado siempre se normalizará en Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan compensaciones distintas de "Z". Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
labels

map (key: string, value: string)

Es un conjunto de etiquetas asociadas con el recurso.

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
mtlsPolicy

object (MTLSPolicy)

Este campo es obligatorio si la política se usa con balanceadores de cargas de aplicaciones. Este campo puede estar vacío para Traffic Director.

Define un mecanismo para aprovisionar certificados de validación de pares para la autenticación de pares (TLS mutua - mTLS). Si no se especifica, no se solicitará el certificado de cliente. La conexión se considera TLS y no mTLS. Si se configuran allowOpen y mtlsPolicy, el servidor permite conexiones de texto simple y mTLS.

MTLSPolicy

Especificación de MTLSPolicy.

Representación JSON 
{
  "clientValidationMode": enum (ClientValidationMode),
  "clientValidationTrustConfig": string
}
Campos
clientValidationMode

enum (ClientValidationMode)

Cuando el cliente presenta un certificado no válido o ningún certificado al balanceador de cargas, clientValidationMode especifica cómo se maneja la conexión del cliente.

Obligatorio si la política se usará con los balanceadores de cargas de aplicaciones. Para Traffic Director, debe estar vacío.
clientValidationTrustConfig

string

Es una referencia a TrustConfig del espacio de nombres certificatemanager.googleapis.com.

Si se especifica, la validación de la cadena se realizará en los certificados configurados en la TrustConfig determinada.

Solo se permite si la política se usará con balanceadores de cargas de aplicaciones.

ClientValidationMode

Es el modo de validación de certificados de TLS mutua.

Enums
CLIENT_VALIDATION_MODE_UNSPECIFIED No se permite.
ALLOW_INVALID_OR_MISSING_CLIENT_CERT Permite la conexión incluso si la validación de la cadena de certificados del certificado de cliente falló o no se presentó ningún certificado de cliente. La prueba de posesión de la clave privada siempre se verifica si se presentó el certificado de cliente. Este modo requiere que el backend implemente el procesamiento de datos extraídos de un certificado de cliente para autenticar al par o rechazar las conexiones si falta la huella digital del certificado de cliente.
REJECT_INVALID

Exige un certificado de cliente y permite la conexión al backend solo si se aprobó la validación del certificado de cliente.

Si se establece, requiere una referencia a un TrustConfig no vacío especificado en clientValidationTrustConfig.

Métodos

create

 Crea una nueva ServerTlsPolicy en un proyecto y una ubicación determinados.

delete

 Borra una sola ServerTlsPolicy.

get

 Obtiene los detalles de una sola ServerTlsPolicy.

list

 Enumera ServerTlsPolicies en una ubicación y un proyecto determinados.

patch

 Actualiza los parámetros de un solo ServerTlsPolicy.