Gérer les mappages de certificats

Un mappage de certificats référence une ou plusieurs entrées de mappage de certificats qui attribuent des certificats particuliers à des noms d'hôte spécifiques. Cette page explique comment créer et gérer des mappages de certificats.

Pour en savoir plus, consultez Mappages de certificats.

Créer un mappage de certificat

Vous pouvez créer un mappage de certificats pour faire référence à l'entrée de mappage de certificats associée à votre certificat.

Console

  1. Dans la console Google Cloud , accédez à la page Certificate Manager, puis cliquez sur l'onglet Mappages de certificats.

    Accéder à Certificate Manager

  2. Cliquez sur Créer un mappage de certificat.

  3. Dans le champ Nom, saisissez un nom pour le mappage de certificats, par exemple cert-map-8.

  4. Dans le champ Description, saisissez une description du mappage de certificats, par exemple My new certificate map.

  5. Pour créer une entrée de mappage de certificats et l'ajouter à votre mappage de certificats, cliquez sur Ajouter une entrée de mappage et suivez les étapes de la section suivante.

  6. Pour ajouter une étiquette et l'associer au mappage de certificats, cliquez sur Ajouter une étiquette, puis saisissez une clé et une valeur pour votre étiquette.

  7. Cliquez sur Créer.

gcloud

Pour créer un mappage de certificats, utilisez la commande gcloud certificate-manager maps create :

gcloud certificate-manager maps create CERTIFICATE_MAP_NAME

Remplacez les éléments suivants :

  • CERTIFICATE_MAP_NAME : nom du mappage de certificats

API

Pour créer un mappage de certificats, envoyez une requête POST à la méthode certificateMaps.create :

POST /v1/projects/PROJECT_ID/locations/global/certificateMaps?certificate_map_id=CERTIFICATE_MAP_NAME

Remplacez les éléments suivants :

  • PROJECT_ID : ID de votre projet Google Cloud
  • CERTIFICATE_MAP_NAME : nom du mappage de certificats

Terraform

Pour créer un mappage de certificats, utilisez une ressource google_certificate_manager_certificate_map :

resource "google_certificate_manager_certificate_map" "default" {
  name        = "${local.name}-certmap1-${random_id.tf_prefix.hex}"
  description = "${local.domain} certificate map"
  labels = {
    "terraform" : true
  }
}

Pour savoir comment appliquer ou supprimer une configuration Terraform, consultez Commandes Terraform de base.

Associer un mappage de certificats à un proxy

Après avoir créé et configuré un mappage de certificats avec des entrées de mappage de certificats, associez le mappage de certificats au proxy cible. Certificate Manager est compatible avec les proxys HTTPS cibles et les proxys SSL cibles de portée mondiale. Pour en savoir plus sur les différences entre ces types de proxys, consultez Utiliser des proxys cibles.

Si vous associez un certificat TLS (SSL) au proxy cible et que vous associez également des certificats via un mappage de certificats, le proxy utilise les certificats référencés dans le mappage de certificats et ignore le certificat directement associé.

Console

Si le proxy cible fait partie d'un équilibreur de charge existant, vous pouvez associer le mappage de certificats en modifiant la configuration de l'interface de l'équilibreur de charge.

  1. Dans la console Google Cloud , accédez à la page Équilibrage de charge.

    Accéder à la page Équilibrage de charge

  2. Cliquez sur le nom de l'équilibreur de charge que vous souhaitez mettre à jour, puis sur Modifier.

  3. Cliquez sur Configuration de l'interface, puis sélectionnez la configuration de l'adresse IP et du port de l'interface que vous souhaitez modifier.

  4. Si l'option Choisir un dépôt de certificats s'affiche, sélectionnez Utiliser un mappage de certificats.

  5. Dans la liste Sélectionner un mappage de certificats, sélectionnez votre mappage de certificats.

  6. Cliquez sur OK, puis sur Mettre à jour.

gcloud

Pour associer le mappage de certificats au proxy HTTPS cible, utilisez la commande gcloud compute target-https-proxies update :

gcloud compute target-https-proxies update PROXY_NAME \
    --certificate-map="CERTIFICATE_MAP_NAME"

Pour associer le mappage de certificats au proxy SSL cible, utilisez la commande gcloud compute target-ssl-proxies update :

gcloud compute target-ssl-proxies update PROXY_NAME \
    --certificate-map="CERTIFICATE_MAP_NAME"

Remplacez les éléments suivants :

  • PROXY_NAME : nom du proxy cible
  • CERTIFICATE_MAP_NAME : nom du mappage de certificats contenant les entrées de mappage qui référencent les certificats cibles

API

Pour associer le mappage de certificats au proxy HTTPS cible, envoyez une requête POST à la méthode targetHttpsProxies :

POST /projects/PROJECT_ID/global/targetHttpsProxies/PROXY_NAME/setCertificateMap
{
  certificateMap: "//certificatemanager.googleapis.com/projects/PROJECT_ID/locations/global/certificateMaps/CERTIFICATE_MAP_NAME",
}

Pour associer le mappage de certificats au proxy SSL cible, envoyez une requête POST à la méthode targetSslProxies :

POST /projects/PROJECT_ID/global/targetSslProxies/PROXY_NAME/setCertificateMap
{
  certificateMap: "//certificatemanager.googleapis.com/projects/PROJECT_ID/locations/global/certificateMaps/CERTIFICATE_MAP_NAME",
}

Remplacez les éléments suivants :

  • PROJECT_ID : ID de votre projet Google Cloud
  • PROXY_NAME : nom du proxy cible
  • CERTIFICATE_MAP_NAME : nom du mappage de certificats contenant les entrées de mappage qui référencent les certificats cibles

Dissocier un mappage de certificats d'un proxy

Avant de dissocier un mappage de certificats d'un proxy, tenez compte des points suivants :

  • Si des certificats TLS (SSL) sont associés directement au proxy, le fait de dissocier le mappage de certificats entraîne la reprise de leur utilisation par le proxy.

  • Si aucun certificat TLS (SSL) n'est associé directement au proxy, un mappage de certificats ne peut pas être dissocié. Associez au moins un certificat TLS directement au proxy avant de dissocier le mappage de certificats.

gcloud

Pour dissocier un mappage de certificats associé du proxy HTTPS cible, utilisez la commande gcloud compute target-https-proxies update :

gcloud compute target-https-proxies update PROXY_NAME \
    --clear-certificate-map

Pour dissocier un mappage de certificats associé du proxy SSL cible, utilisez la commande gcloud compute target-ssl-proxies update :

gcloud compute target-ssl-proxies update PROXY_NAME \
    --clear-certificate-map

Remplacez les éléments suivants :

  • PROXY_NAME : nom du proxy cible

API

Pour dissocier un mappage de certificats associé du proxy HTTPS cible, envoyez une requête POST à la méthode targetHttpsProxies :

POST /projects/PROJECT_ID/global/targetHttpsProxies/PROXY_NAME/setCertificateMap
{
  certificateMap: "",
}

Pour dissocier un mappage de certificats associé du proxy SSL cible, envoyez une requête POST à la méthode targetSslProxies :

POST /projects/PROJECT_ID/global/targetSslProxies/PROXY_NAME/setCertificateMap
{
  certificateMap: "",
}

Remplacez les éléments suivants :

  • PROJECT_ID : ID de votre projet Google Cloud
  • PROXY_NAME : nom du proxy cible

Mettre à jour un mappage de certificats

Vous pouvez mettre à jour la description et les étiquettes d'un mappage de certificats. Si vous utilisez la consoleGoogle Cloud , vous pouvez ajouter une entrée de mappage à un mappage de certificats, ou modifier ou supprimer une entrée de mappage associée à un mappage de certificats.

Console

  1. Dans la console Google Cloud , accédez à la page Certificate Manager, puis cliquez sur l'onglet Mappages de certificats.

    Accéder à Certificate Manager

  2. Dans la liste des mappages de certificats, cliquez sur le mappage de certificats requis. La page Détails du mappage de certificat s'ouvre.

  3. Cliquez sur Modifier (). La page Modifier le mappage de certificats s'ouvre.

  4. Dans le champ Description, saisissez une nouvelle description pour le mappage de certificats.

  5. Pour ajouter une entrée de mappage au mappage de certificats, cliquez sur Ajouter une entrée de mappage et suivez les étapes de la section Créer une entrée de mappage de certificats.

    Pour modifier une entrée de mappage, cliquez sur l'icône dans la colonne Actions de la ligne de l'entrée de mappage, sélectionnez Modifier, puis suivez les étapes de la section Mettre à jour une entrée de mappage de certificats.

    Pour supprimer une entrée de mappage, dans la colonne Actions de la ligne de l'entrée de mappage, cliquez sur l'icône , sélectionnez Supprimer, puis suivez les étapes mentionnées dans la section Supprimer une entrée de mappage de certificats.

  6. Vous pouvez ajouter, supprimer ou mettre à jour les étiquettes associées au mappage de certificats.

    Pour ajouter une étiquette, cliquez sur Ajouter une étiquette, puis spécifiez une clé et une valeur pour votre étiquette.

    Pour supprimer un libellé, cliquez sur Supprimer l'élément pour le libellé requis.

  7. Cliquez sur Enregistrer.

gcloud

Pour mettre à jour un mappage de certificats, utilisez la commande gcloud certificate-manager maps update :

gcloud certificate-manager maps update CERTIFICATE_MAP_NAME \
    --description="DESCRIPTION"
    --update-labels="LABELS"

Remplacez les éléments suivants :

  • CERTIFICATE_MAP_NAME : nom du mappage de certificats
  • DESCRIPTION : nouvelle description de ce mappage de certificats
  • LABELS : liste d'étiquettes séparées par une virgule appliquées à ce mappage de certificats

API

Pour mettre à jour un mappage de certificats, envoyez une requête PATCH à la méthode certificateMaps.patch :

PATCH /v1/projects/PROJECT_ID/locations/global/certificateMaps/CERTIFICATE_MAP_NAME?updateMask=labels,description
{
  "description": "DESCRIPTION",
  "labels": {
    "LABEL_KEY": "LABEL_VALUE",
  }
}

Remplacez les éléments suivants :

  • PROJECT_ID : ID de votre projet Google Cloud
  • CERTIFICATE_MAP_NAME : nom du mappage de certificats
  • DESCRIPTION : nouvelle description de ce mappage de certificats
  • LABEL_KEY : clé d'étiquette appliquée à ce mappage de certificats
  • LABEL_VALUE : libellé appliqué à ce mappage de certificats

Lister les mappages de certificats

Vous pouvez afficher, filtrer et trier la liste de tous les mappages de certificats que vous avez créés.

Console

  1. Dans la console Google Cloud , accédez à la page Certificate Manager.

    Accéder à Certificate Manager

  2. Cliquez sur l'onglet Mappages de certificats. Vous pouvez afficher, filtrer et configurer les colonnes d'affichage de tous les mappages de certificats du projet sélectionné.

gcloud

Pour lister les mappages de certificats, utilisez la commande gcloud certificate-manager maps list :

gcloud certificate-manager maps list \
    --filter="FILTER" \
    --page-size="PAGE_SIZE" \
    --limit="LIMIT" \
    --sort-by="SORT_BY"

Remplacez les éléments suivants :

  • FILTER : expression qui limite les résultats renvoyés à des valeurs spécifiques.

    Par exemple, pour filtrer les résultats par libellés et heure de création, vous pouvez spécifier : --filter='labels.key:value AND create_time > "2021-09-01T00:00:00Z"'.

    Pour obtenir d'autres exemples de filtrage que vous pouvez utiliser avec Certificate Manager, consultez Trier et filtrer les résultats de la liste dans la documentation de Cloud Key Management Service.

  • PAGE_SIZE : nombre de résultats que vous souhaitez renvoyer par page

  • LIMIT : nombre maximal de résultats que vous souhaitez renvoyer

  • SORT_BY : liste de champs name séparés par une virgule, selon lesquels les résultats renvoyés sont triés. L'ordre de tri par défaut est croissant. Pour un ordre de tri décroissant, ajoutez le préfixe ~ au champ.

API

Pour lister les mappages de certificats configurés, envoyez une requête LIST à la méthode certificateMaps.list :

GET /v1/projects/PROJECT_ID/locations/global/certificateMaps?filter=FILTER&pageSize=PAGE_SIZE&sortBy=SORT_BY

Remplacez les éléments suivants :

  • PROJECT_ID : ID de votre projet Google Cloud

  • FILTER : expression qui limite les résultats renvoyés à des valeurs spécifiques.

    Par exemple, pour filtrer les résultats par libellés et heure de création, vous pouvez spécifier : --filter='labels.key:value AND create_time > "2021-09-01T00:00:00Z"'

    Pour obtenir d'autres exemples de filtrage que vous pouvez utiliser avec Certificate Manager, consultez Trier et filtrer les résultats de la liste dans la documentation de Cloud Key Management Service.

  • PAGE_SIZE : nombre de résultats que vous souhaitez renvoyer par page

  • SORT_BY : liste de champs name séparés par une virgule, selon lesquels les résultats renvoyés sont triés. L'ordre de tri par défaut est croissant. Pour un ordre de tri décroissant, ajoutez le préfixe ~ au champ.

Afficher les détails d'un mappage de certificats

Vous pouvez afficher les détails d'un mappage de certificats existant, tels que sa date et son heure de création, sa date et son heure de dernière mise à jour, ainsi que sa description.

Console

  1. Dans la console Google Cloud , accédez à la page Certificate Manager, puis cliquez sur l'onglet Mappages de certificats.

    Accéder à Certificate Manager

  2. Dans la liste des mappages de certificats, cliquez sur le mappage de certificats requis. La page Détails du mappage de certificat s'ouvre et affiche des informations détaillées sur le mappage de certificat sélectionné.

gcloud

Pour afficher les détails d'un mappage de certificats, utilisez la commande gcloud certificate-manager maps describe :

gcloud certificate-manager maps describe CERTIFICATE_MAP_NAME

Remplacez les éléments suivants :

  • CERTIFICATE_MAP_NAME : nom du mappage de certificats

API

Pour afficher les détails du mappage de certificats, envoyez une requête GET à la méthode certificateMaps.get :

GET /v1/projects/PROJECT_ID/locations/global/certificateMaps/CERTIFICATE_MAP_NAME

Remplacez les éléments suivants :

  • PROJECT_ID : ID de votre projet Google Cloud
  • CERTIFICATE_MAP_NAME : nom du mappage de certificats

Supprimer un mappage de certificats

Avant de supprimer un mappage de certificats, procédez comme suit :

  • Dissociez le mappage de certificats du proxy cible.
  • Si des entrées de mappage de certificats sont attribuées au mappage, supprimez-les.

Console

  1. Dans la console Google Cloud , accédez à la page Certificate Manager, puis cliquez sur l'onglet Mappages de certificats.

    Accéder à Certificate Manager

  2. Dans la liste des mappages de certificats, cliquez sur le mappage de certificats requis. La page Détails du mappage de certificat s'ouvre.

  3. Cliquez sur Supprimer, puis sur Supprimer.

gcloud

Pour supprimer un mappage de certificats, utilisez la commande gcloud certificate-manager maps delete :

gcloud certificate-manager maps delete CERTIFICATE_MAP_NAME

Remplacez les éléments suivants :

  • CERTIFICATE_MAP_NAME : nom du mappage de certificats

API

Pour supprimer le mappage de certificats, envoyez une requête DELETE à la méthode certificateMaps.delete :

DELETE /v1/projects/PROJECT_ID/locations/global/certificateMaps/CERTIFICATE_MAP_NAME

Remplacez les éléments suivants :

  • PROJECT_ID : ID de votre projet Google Cloud
  • CERTIFICATE_MAP_NAME : nom du mappage de certificats

Étapes suivantes