REST Resource: projects.locations.serverTlsPolicies

Ressource : ServerTlsPolicy

ServerTlsPolicy est une ressource qui spécifie la manière dont un serveur doit authentifier les requêtes entrantes. Cette ressource elle-même n'affecte pas la configuration, sauf si elle est associée à un proxy HTTPS cible ou à une ressource de sélecteur de configuration de point de terminaison.

La ressource ServerTlsPolicy au format accepté par les équilibreurs de charge d'application ne peut être associée qu'à TargetHttpsProxy avec un EXTERNAL, EXTERNAL_MANAGED ou INTERNAL_MANAGED schéma d'équilibrage de charge. Les ressources ServerTlsPolicy compatibles avec Traffic Director peuvent être associées à EndpointPolicy et TargetHttpsProxy avec le schéma d'équilibrage de charge INTERNAL_SELF_MANAGED de Traffic Director.

Représentation JSON 
{
  "name": string,
  "description": string,
  "createTime": string,
  "updateTime": string,
  "labels": {
    string: string,
    ...
  },
  "allowOpen": boolean,
  "serverCertificate": {
    object (CertificateProvider)
  },
  "mtlsPolicy": {
    object (MTLSPolicy)
  }
}
Champs
name

string

Obligatoire. Nom de la ressource ServerTlsPolicy. Il correspond au modèle projects/*/locations/{location}/serverTlsPolicies/{serverTlsPolicy}.
description

string

Description en texte libre de la ressource.
createTime

string (Timestamp format)

Uniquement en sortie. Code temporel de la création de la ressource.

Utilise la norme RFC 3339, où le résultat généré se sert toujours du format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Uniquement en sortie. Code temporel de la mise à jour de la ressource.

Utilise la norme RFC 3339, où le résultat généré se sert toujours du format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
labels

map (key: string, value: string)

Ensemble de tags d'étiquette associés à la ressource.

Objet contenant une liste de "key": value paires. Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" }.
allowOpen

boolean

Ce champ ne s'applique qu'aux règles Traffic Director. Il doit être défini sur "false" pour les règles d'équilibreur de charge d'application.

Détermine si le serveur autorise les connexions en texte brut. Si la valeur est "true", le serveur autorise les connexions en texte brut. Par défaut, la valeur est "false". Ce paramètre n'est pas exclusif des autres modes de chiffrement. Par exemple, si allowOpen et mtlsPolicy sont définis, le serveur autorise les connexions en texte brut et mTLS. Consultez la documentation des autres modes de chiffrement pour vérifier la compatibilité.

Envisagez d'utiliser ce paramètre si vous souhaitez mettre à niveau votre déploiement vers TLS sur place tout en ayant un trafic mixte TLS et non TLS atteignant le port :80.
serverCertificate

object (CertificateProvider)

Facultatif si la règle doit être utilisée avec Traffic Director. Pour les équilibreurs de charge d'application, ce champ doit être vide.

Définit un mécanisme permettant de provisionner l'identité du serveur (clés publiques et privées). Ne peut pas être combiné avec allowOpen, car un mode permissif qui autorise à la fois le texte brut et TLS n'est pas compatible.
mtlsPolicy

object (MTLSPolicy)

Ce champ est obligatoire si la règle est utilisée avec des équilibreurs de charge d'application. Ce champ peut être vide pour Traffic Director.

Définit un mécanisme permettant de provisionner des certificats de validation pair à pair pour l'authentification pair à pair (TLS mutuelle, mTLS). Si aucune valeur n'est spécifiée, aucun certificat client n'est demandé. La connexion est traitée comme TLS et non mTLS. Si allowOpen et mtlsPolicy sont définis, le serveur autorise les connexions en texte brut et mTLS.

MTLSPolicy

Spécification de MTLSPolicy.

Représentation JSON 
{
  "clientValidationMode": enum (ClientValidationMode),
  "clientValidationCa": [
    {
      object (ValidationCA)
    }
  ],
  "clientValidationTrustConfig": string,
  "tier": enum (Tier)
}
Champs
clientValidationMode

enum (ClientValidationMode)

Lorsque le client présente un certificat non valide ou aucun certificat à l'équilibreur de charge, clientValidationMode spécifie la manière dont la connexion client est gérée.

Obligatoire si la règle doit être utilisée avec les équilibreurs de charge d'application. Pour Traffic Director, ce champ doit être vide.
clientValidationCa[]

object (ValidationCA)

Obligatoire si la règle doit être utilisée avec Traffic Director. Pour les équilibreurs de charge d'application, ce champ doit être vide.

Définit le mécanisme permettant d'obtenir le certificat de l'autorité de certification pour valider le certificat client.
clientValidationTrustConfig

string

Référence à TrustConfig à partir de l'espace de noms certificatemanager.googleapis.com.

Si elle est spécifiée, la validation de la chaîne est effectuée par rapport aux certificats configurés dans la TrustConfig donnée.

Autorisé uniquement si la règle doit être utilisée avec des équilibreurs de charge d'application.
tier

enum (Tier)

Niveau TLS mutuel.

Autorisé uniquement si la règle doit être utilisée avec des équilibreurs de charge d'application.

ClientValidationMode

Mode de validation des certificats TLS mutuels.

Enums
CLIENT_VALIDATION_MODE_UNSPECIFIED Non autorisé.
ALLOW_INVALID_OR_MISSING_CLIENT_CERT Autoriser la connexion même si la validation de la chaîne de certificats du certificat client a échoué ou si aucun certificat client n'a été présenté. La preuve de possession de la clé privée est toujours vérifiée si un certificat client a été présenté. Ce mode nécessite que le backend implémente le traitement des données extraites d'un certificat client pour authentifier le pair ou rejeter les connexions si l'empreinte du certificat client est manquante.
REJECT_INVALID

Exiger un certificat client et autoriser la connexion au backend uniquement si la validation du certificat client a réussi.

Si cette option est définie, une référence à une TrustConfig non vide spécifiée dans clientValidationTrustConfig est requise.

Niveau

Niveau TLS mutuel pour XLB.

Enums
TIER_UNSPECIFIED Si aucun niveau n'est spécifié dans la requête, le système choisit une valeur par défaut. Actuellement, il s'agit du niveau STANDARD.
STANDARD Niveau par défaut. Principalement destiné aux fournisseurs de logiciels (communication de service à service/API).
ADVANCED Niveau avancé. Pour les clients dans des environnements fortement réglementés, spécifiant des clés plus longues et des chaînes de certificats complexes.

Méthodes

create

 Crée une ressource ServerTlsPolicy dans un projet et un emplacement donnés.

delete

 Supprime une seule ressource ServerTlsPolicy.

get

 Récupère les détails d'une seule ressource ServerTlsPolicy.

list

 Liste les ressources ServerTlsPolicies d'un projet et d'un emplacement donnés.

patch

 Met à jour les paramètres d'une seule ressource ServerTlsPolicy.