REST Resource: projects.locations.backendAuthenticationConfigs

Risorsa: BackendAuthenticationConfig

Il messaggio BackendAuthenticationConfig raggruppa TrustConfig con altre impostazioni che controllano il modo in cui il bilanciatore del carico autentica e esprime la propria identità al backend:

  • trustConfig è la configurazione dell'attendibilità allegata.

  • wellKnownRoots indica se il bilanciamento del carico deve considerare attendibili i certificati del server di backend emessi da autorità di certificazione pubbliche, oltre ai certificati considerati attendibili da TrustConfig.

  • clientCertificate è un certificato client utilizzato dal bilanciatore del carico per esprimere la propria identità al backend, se la connessione al backend utilizza mTLS.

Puoi associare BackendAuthenticationConfig al servizio Backend del bilanciatore del carico determinando direttamente in che modo il servizio negozia TLS.

Rappresentazione JSON
{
  "name": string,
  "description": string,
  "createTime": string,
  "updateTime": string,
  "labels": {
    string: string,
    ...
  },
  "clientCertificate": string,
  "trustConfig": string,
  "wellKnownRoots": enum (WellKnownRoots),
  "etag": string
}
Campi
name

string

Obbligatorio. Nome della risorsa BackendAuthenticationConfig. Corrisponde al pattern projects/*/locations/{location}/backendAuthenticationConfigs/{backendAuthenticationConfig}

description

string

Facoltativo. Descrizione in formato libero della risorsa.

createTime

string (Timestamp format)

Solo output. Timestamp di creazione della risorsa.

Utilizza RFC 3339, in cui l'output generato sarà sempre normalizzato in base a Z e utilizza 0, 3, 6 o 9 cifre decimali. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

updateTime

string (Timestamp format)

Solo output. Timestamp dell'aggiornamento della risorsa.

Utilizza RFC 3339, in cui l'output generato sarà sempre normalizzato in base a Z e utilizza 0, 3, 6 o 9 cifre decimali. Sono accettati anche offset diversi da "Z". Esempi: "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)

Set di tag etichetta associati alla risorsa.

Un oggetto contenente un elenco di coppie "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

clientCertificate

string

Facoltativo. Un riferimento a una risorsa certificatemanager.googleapis.com.Certificate. Si tratta di un percorso della risorsa relativo che segue il formato "projects/{project}/locations/{location}/certificates/{certificate}".

Utilizzato da un BackendService per negoziare mTLS quando la connessione al backend utilizza TLS e il backend richiede un certificato client. Deve avere un ambito CLIENT_AUTH.

trustConfig

string

Facoltativo. Un riferimento a una risorsa TrustConfig dallo spazio dei nomi certificatemanager.googleapis.com. Si tratta di un percorso della risorsa relativo che segue il formato "projects/{project}/locations/{location}/trustConfigs/{trustConfig}".

Un BackendService utilizza la catena di attendibilità rappresentata da questa configurazione dell'attendibilità, se specificata, per convalidare i certificati del server presentati dal backend. Obbligatorio, a meno che wellKnownRoots non sia impostato su PUBLIC_ROOTS.

wellKnownRoots

enum (WellKnownRoots)

Root noti da utilizzare per la convalida dei certificati del server.

etag

string

Solo output. ETag della risorsa.

WellKnownRoots

Enum per specificare le radici ben note da utilizzare per la convalida dei certificati del server.

Enum
WELL_KNOWN_ROOTS_UNSPECIFIED Equivalente a NESSUNO.
NONE BackendService convaliderà i certificati del server solo in base alle radici specificate in TrustConfig.
PUBLIC_ROOTS

Il servizio Backend utilizza un insieme di radici pubbliche ben note, oltre a eventuali radici specificate nel campo trustConfig, per convalidare i certificati del server presentati dal backend. La convalida con queste radici viene presa in considerazione solo quando il campo TlsSettings.sni in BackendService è impostato.

Le radici note sono un insieme di CA radice gestite da Google. Le CA in questo set possono essere aggiunte o rimosse senza preavviso.

Metodi

create

Crea un nuovo BackendAuthenticationConfig in un determinato progetto e posizione.

delete

Consente di eliminare un singolo elemento BackendAuthenticationConfig.

get

Recupera i dettagli di un singolo BackendAuthenticationConfig in BackendAuthenticationConfig.

list

Elenca BackendAuthenticationConfigs in un determinato progetto e località.

patch

Aggiorna i parametri di un singolo BackendAuthenticationConfig in BackendAuthenticationConfig.