REST Resource: projects.locations.tlsInspectionPolicies

Risorsa: TlsInspectionPolicy

La risorsa TlsInspectionPolicy contiene riferimenti ai pool di CA nel servizio Certificate Authority e ai metadati associati.

Rappresentazione JSON
{
  "name": string,
  "description": string,
  "createTime": string,
  "updateTime": string,
  "caPool": string,
  "trustConfig": string,
  "minTlsVersion": enum (TlsVersion),
  "tlsFeatureProfile": enum (Profile),
  "customTlsFeatures": [
    string
  ],
  "excludePublicCaSet": boolean
}
Campi
name

string

Obbligatorio. Nome della risorsa. Il nome è nel formato projects/{project}/locations/{location}/tlsEsaminaionPolicies/{tlsEsaminaionPolicy} tlsEsaminaionPolicy deve corrispondere al pattern:(^a-z?$).

description

string

Facoltativo. Descrizione in testo libero della risorsa.

createTime

string (Timestamp format)

Solo output. Timestamp di creazione della risorsa.

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

Solo output. Timestamp di aggiornamento della risorsa.

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

caPool

string

Obbligatorio. Una risorsa del pool di CA utilizzata per emettere certificati di intercettazione. La stringa del pool di CA ha un percorso della risorsa relativo nel seguente formato: "projects/{project}/locations/{location}/caPools/{caPool}".

trustConfig

string

Facoltativo. Una risorsa TrustConfig utilizzata per effettuare una connessione al server TLS. Questo è un percorso della risorsa relativo nel formato "projects/{project}/locations/{location}/trustConfigs/{trustConfig}". Questo è necessario per intercettare le connessioni TLS ai server con certificati firmati da una CA privata o certificati autofirmati. Tieni presente che Secure Web Proxy non rispetta ancora questo campo.

minTlsVersion

enum (TlsVersion)

Facoltativo. Versione TLS minima che il firewall deve utilizzare durante la negoziazione delle connessioni con client e server. Se non viene configurato, il valore predefinito consente il gruppo più ampio di client e server (TLS 1.0 o superiore). L'impostazione di valori più restrittivi può migliorare la sicurezza, ma potrebbe anche impedire al firewall di connettersi ad alcuni client o server. Tieni presente che Secure Web Proxy non rispetta ancora questo campo.

tlsFeatureProfile

enum (Profile)

Facoltativo. Il profilo selezionato. Se non viene configurato, il valore predefinito consente la più ampia gamma di client e server ("PROFILE_COMPATIBLE"). Impostando valori più restrittivi, la sicurezza potrebbe migliorare, ma il proxy di ispezione TLS potrebbe non riuscire a connettersi ad alcuni client o server. Tieni presente che Secure Web Proxy non rispetta ancora questo campo.

customTlsFeatures[]

string

Facoltativo. Elenco delle suite di crittografia TLS personalizzate selezionate. Questo campo è valido solo se il tlsFeatureProfile selezionato è CUSTOM. Il metodo [compute.SslPoliciesService.ListAvailableFeatures][] restituisce l'insieme di caratteristiche che possono essere specificate in questo elenco. Tieni presente che Secure Web Proxy non rispetta ancora questo campo.

excludePublicCaSet

boolean

Facoltativo. Se FALSE (il valore predefinito), utilizza il nostro insieme predefinito di CA pubbliche oltre a eventuali CA specificate in trustConfig. Queste CA pubbliche sono attualmente basate sul Mozilla Root Program e sono soggette a modifiche nel tempo. Se TRUE, non accettare il nostro insieme predefinito di CA pubbliche. Sono accettate solo le CA specificate in trustConfig. Il valore predefinito è FALSE (utilizza le CA pubbliche oltre a trustConfig) per la compatibilità con le versioni precedenti, ma la fiducia nelle CA radice pubbliche è sconsigliata, a meno che il traffico in questione non sia in uscita verso server web pubblici. Se possibile, è preferibile impostare questo valore su "false". e specificando in modo esplicito CA e certificati attendibili in un TrustConfig. Tieni presente che Secure Web Proxy non rispetta ancora questo campo.

TlsVersion

La versione minima del protocollo TLS che può essere utilizzata da client o server per stabilire una connessione con il proxy di ispezione TLS.

Enum
TLS_VERSION_UNSPECIFIED Indica che non è stata specificata alcuna versione TLS.
TLS_1_0 TLS 1.0
TLS_1_1 TLS 1.1
TLS_1_2 TLS 1.2
TLS_1_3 TLS 1.3

Profilo

Il profilo specifica l'insieme di suite di crittografia TLS (e potenzialmente altre funzionalità in futuro) che possono essere utilizzate dal firewall durante la negoziazione delle connessioni TLS con client e server. Il significato di questi campi è identico a quello dei bilanciatori del carico Risorsa SSLPolicy.

Enum
PROFILE_UNSPECIFIED Indica che non è stato specificato alcun profilo.
PROFILE_COMPATIBLE Profilo compatibile. Consente al set più ampio di client, anche quelli che supportano solo funzionalità SSL obsolete, di negoziare con il proxy di ispezione TLS.
PROFILE_MODERN Profilo moderno. Supporta un'ampia gamma di funzionalità SSL, consentendo ai client moderni di negoziare SSL con il proxy di ispezione TLS.
PROFILE_RESTRICTED Profilo con limitazioni. Supporta un insieme ridotto di funzionalità SSL, inteso a soddisfare requisiti di conformità più rigidi.
PROFILE_CUSTOM Profilo personalizzato. Consenti solo l'insieme di funzionalità SSL consentite specificate nel campo custom_features di SslPolicy.

Metodi

create

Crea un nuovo TlsInspectionPolicy in un determinato progetto e posizione.

delete

Elimina un singolo TlsstructionPolicy.

get

Recupera i dettagli di un singolo TlsInstanceionPolicy.

list

Elenca TlsInspectionPolicies in un determinato progetto e posizione.

patch

Aggiorna i parametri di un singolo TlsInspectionPolicy.