REST Resource: projects.locations.backendAuthenticationConfigs

Recurso: BackendAuthenticationConfig

El mensaje BackendAuthenticationConfig agrupa la TrustConfig junto con otros parámetros de configuración que controlan cómo el balanceador de cargas autentica y expresa su identidad al backend:

  • trustConfig es el TrustConfig adjunto.

  • wellKnownRoots indica si el balanceo de cargas debe confiar en los certificados de servidor de backend que emiten autoridades certificadoras públicas, además de los certificados que confía TrustConfig.

  • clientCertificate es un certificado de cliente que el balanceador de cargas usa para expresar su identidad al backend, si la conexión al backend usa mTLS.

Puedes adjuntar BackendAuthenticationConfig al BackendService del balanceador de cargas para determinar directamente cómo ese BackendService negocia TLS.

Representación JSON 
{
  "name": string,
  "description": string,
  "createTime": string,
  "updateTime": string,
  "labels": {
    string: string,
    ...
  },
  "clientCertificate": string,
  "trustConfig": string,
  "wellKnownRoots": enum (WellKnownRoots),
  "etag": string
}
Campos
name

string

Obligatorio. Es el nombre del recurso BackendAuthenticationConfig. Coincide con el patrón projects/*/locations/{location}/backendAuthenticationConfigs/{backendAuthenticationConfig}
description

string

Opcional. 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" }.
clientCertificate

string

Opcional. Es una referencia a un recurso de certificatemanager.googleapis.com.Certificate. Esta es una ruta de acceso de recurso relativa que sigue el formato "projects/{project}/locations/{location}/certificates/{certificate}".

Lo usa un BackendService para negociar mTLS cuando la conexión de backend usa TLS y el backend solicita un certificado de cliente. Debe tener un permiso CLIENT_AUTH.
trustConfig

string

Opcional. Es una referencia a un recurso TrustConfig del espacio de nombres certificatemanager.googleapis.com. Esta es una ruta de acceso de recursos relativa que sigue el formato "projects/{project}/locations/{location}/trustConfigs/{trustConfig}".

Un BackendService usa la cadena de confianza representada por esta TrustConfig, si se especifica, para validar los certificados de servidor que presenta el backend. Obligatorio, a menos que wellKnownRoots esté configurado como PUBLIC_ROOTS.
wellKnownRoots

enum (WellKnownRoots)

Raíces conocidas para usar en la validación de certificados de servidor.
etag

string

Solo salida. Etag del recurso.

WellKnownRoots

Es una enumeración para especificar las raíces conocidas que se usarán para la validación del certificado del servidor.

Enums
WELL_KNOWN_ROOTS_UNSPECIFIED Equivale a NONE.
NONE BackendService solo validará los certificados del servidor en función de las raíces especificadas en TrustConfig.
PUBLIC_ROOTS

BackendService usa un conjunto de raíces públicas conocidas, además de las raíces especificadas en el campo trustConfig, cuando valida los certificados de servidor que presenta el backend. La validación con estas raíces solo se considera cuando se configura el campo TlsSettings.sni en BackendService.

Las raíces conocidas son un conjunto de AC raíz administradas por Google. Las AC de este conjunto se pueden agregar o quitar sin previo aviso.

Métodos

create

 Crea un nuevo BackendAuthenticationConfig en un proyecto y una ubicación determinados.

delete

 Borra un solo BackendAuthenticationConfig a BackendAuthenticationConfig.

get

 Obtiene los detalles de un solo BackendAuthenticationConfig a BackendAuthenticationConfig.

list

 Muestra una lista de BackendAuthenticationConfigs en una ubicación y un proyecto determinados.

patch

 Actualiza los parámetros de un solo BackendAuthenticationConfig a BackendAuthenticationConfig.