REST Resource: projects.locations.serverTlsPolicies

Risorsa: ServerTlsPolicy

ServerTlsPolicy è una risorsa che specifica in che modo un server deve autenticare le richieste in entrata. Questa risorsa non influisce sulla configurazione, a meno che non venga collegata a un proxy HTTPS di destinazione o a una risorsa del selettore di configurazione degli endpoint.

ServerTlsPolicy nel formato accettato dai bilanciatori del carico delle applicazioni può essere collegato solo a TargetHttpsProxy con uno schema di bilanciamento del carico EXTERNAL, EXTERNAL_MANAGED o INTERNAL_MANAGED. I ServerTlsPolicy compatibili con Traffic Director possono essere collegati a EndpointPolicy e TargetHttpsProxy con lo schema di bilanciamento del carico INTERNAL_SELF_MANAGED di Traffic Director.

Rappresentazione JSON 
{
  "name": string,
  "description": string,
  "createTime": string,
  "updateTime": string,
  "labels": {
    string: string,
    ...
  },
  "mtlsPolicy": {
    object (MTLSPolicy)
  }
}
Campi
name

string

Obbligatorio. Nome della risorsa ServerTlsPolicy. Corrisponde al pattern projects/*/locations/{location}/serverTlsPolicies/{serverTlsPolicy}
description

string

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" }.
mtlsPolicy

object (MTLSPolicy)

Questo campo è obbligatorio se il criterio viene utilizzato con i bilanciatori del carico delle applicazioni. Questo campo può essere vuoto per Traffic Director.

Definisce un meccanismo per il provisioning dei certificati di convalida dei peer per l'autenticazione peer to peer (TLS reciproca - mTLS). Se non specificato, il certificato client non verrà richiesto. La connessione viene trattata come TLS e non mTLS. Se sono impostati allowOpen e mtlsPolicy, il server consente connessioni sia in testo normale che mTLS.

MTLSPolicy

Specifica di MTLSPolicy.

Rappresentazione JSON 
{
  "clientValidationMode": enum (ClientValidationMode),
  "clientValidationTrustConfig": string
}
Campi
clientValidationMode

enum (ClientValidationMode)

Se il client ha un certificato non valido o non ha nessun certificato per il bilanciatore del carico, clientValidationMode specifica come viene gestita la connessione del client.

Obbligatorio se il criterio deve essere utilizzato con i bilanciatori del carico delle applicazioni. Per Traffic Director deve essere vuoto.
clientValidationTrustConfig

string

Riferimento a TrustConfig dallo spazio dei nomi certificatemanager.googleapis.com.

Se specificato, la convalida della catena verrà eseguita in base ai certificati configurati in TrustConfig.

Consentito solo se il criterio deve essere utilizzato con i bilanciatori del carico delle applicazioni.

ClientValidationMode

Modalità di convalida del certificato TLS reciproco.

Enum
CLIENT_VALIDATION_MODE_UNSPECIFIED Non consentito.
ALLOW_INVALID_OR_MISSING_CLIENT_CERT Consenti la connessione anche se la convalida della catena di certificati del certificato client non è riuscita o non è stato presentato alcun certificato client. La prova della proprietà della chiave privata viene sempre verificata se è stato presentato il certificato client. Questa modalità richiede che il backend implementi l'elaborazione dei dati estratti da un certificato client per autenticare il peer o per rifiutare le connessioni se manca l'impronta del certificato client.
REJECT_INVALID

Richiedi un certificato client e consenti la connessione al backend solo se la convalida del certificato client è andata a buon fine.

Se impostato, richiede un riferimento a TrustConfig non vuoto specificato in clientValidationTrustConfig.

Metodi

create

 Crea un nuovo ServerTlsPolicy in un determinato progetto e posizione.

delete

 Consente di eliminare un singolo ServerTlsPolicy.

get

 Recupera i dettagli di un singolo ServerTlsPolicy.

list

 Elenca ServerTlsPolicies in un determinato progetto e posizione.

patch

 Aggiorna i parametri di un singolo ServerTlsPolicy.