Zertifikatzuordnungen verwalten

Eine Zertifikatszuordnung verweist auf einen oder mehrere Zertifikatszuordnungseinträge, die bestimmte Zertifikate bestimmten Hostnamen zuweisen. Auf dieser Seite wird beschrieben, wie Sie Zertifikatszuordnungen erstellen und verwalten.

Weitere Informationen finden Sie unter Zertifikatszuordnungen.

Zertifikatzuordnung erstellen

Sie können eine Zertifikatszuordnung erstellen, um auf den Zertifikatszuordnungseintrag zu verweisen, der mit Ihrem Zertifikat verknüpft ist.

Console

  1. Rufen Sie in der Google Cloud Console die Seite Zertifikatmanager auf und klicken Sie dann auf den Tab Zertifikatszuordnungen.

    Zum Zertifikatmanager

  2. Klicken Sie auf Zertifikatszuordnung erstellen.

  3. Geben Sie im Feld Name einen Namen für die Zertifikatzuordnung ein, z. B. cert-map-8.

  4. Geben Sie im Feld Beschreibung eine Beschreibung für die Zertifikatszuordnung ein, z. B. My new certificate map.

  5. Wenn Sie einen Zertifikatszuordnungseintrag erstellen und Ihrer Zertifikatszuordnung hinzufügen möchten, klicken Sie auf Zuordnungseintrag hinzufügen und folgen Sie der Anleitung im nächsten Abschnitt.

  6. Wenn Sie ein Label hinzufügen und mit der Zertifikatszuordnung verknüpfen möchten, klicken Sie auf Label hinzufügen und geben Sie dann einen Schlüssel und einen Wert für das Label ein.

  7. Klicken Sie auf Erstellen.

gcloud

Verwenden Sie zum Erstellen einer Zertifikatzuordnung den Befehl gcloud certificate-manager maps create:

gcloud certificate-manager maps create CERTIFICATE_MAP_NAME

Ersetzen Sie Folgendes:

  • CERTIFICATE_MAP_NAME: Name der Zertifikatszuordnung

API

Senden Sie zum Erstellen einer Zertifikatzuordnung eine POST-Anfrage an die Methode certificateMaps.create:

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

Ersetzen Sie Folgendes:

  • PROJECT_ID: ID Ihres Google Cloud -Projekts
  • CERTIFICATE_MAP_NAME: Name der Zertifikatszuordnung

Terraform

Verwenden Sie zum Erstellen einer Zertifikatzuordnung eine google_certificate_manager_certificate_map-Ressource:

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

Informationen zum Anwenden oder Entfernen einer Terraform-Konfiguration finden Sie unter Grundlegende Terraform-Befehle.

Zertifikatszuordnung an einen Proxy anhängen

Nachdem Sie eine Zertifikatszuordnung mit Zertifikatszuordnungseinträgen erstellt und konfiguriert haben, hängen Sie die Zertifikatszuordnung an den Ziel-Proxy an. Der Zertifikatmanager unterstützt sowohl Ziel-HTTPS- als auch Ziel-SSL-Proxys mit globalem Bereich. Weitere Informationen zu den Unterschieden zwischen diesen Proxy-Typen finden Sie unter Ziel-Proxys verwenden.

Wenn Sie ein TLS-Zertifikat (SSL) an den Ziel-Proxy anhängen und auch Zertifikate über eine Zertifikatszuordnung anhängen, verwendet der Proxy die in der Zertifikatszuordnung referenzierten Zertifikate und ignoriert das direkt angehängte Zertifikat.

Console

Wenn der Zielproxy Teil eines vorhandenen Load Balancers ist, können Sie die Zertifikatszuordnung anhängen, indem Sie die Frontend-Konfiguration des Load Balancers bearbeiten.

  1. Rufen Sie in der Google Cloud Console die Seite Load Balancing auf.

    Load Balancing aufrufen

  2. Klicken Sie auf den Namen des Load Balancers, den Sie aktualisieren möchten, und dann auf Bearbeiten.

  3. Klicken Sie auf Frontend-Konfiguration und wählen Sie die Frontend-IP-Adresse und die Portkonfiguration aus, die Sie bearbeiten möchten.

  4. Wenn Zertifikats-Repository auswählen angezeigt wird, wählen Sie Zertifikatszuordnung verwenden aus.

  5. Wählen Sie in der Liste Zertifikatszuordnung auswählen Ihre Zertifikatszuordnung aus.

  6. Klicken Sie auf Fertig und anschließend auf Aktualisieren.

gcloud

Verwenden Sie den Befehl gcloud compute target-https-proxies update, um die Zertifikatszuordnung an den Ziel-HTTPS-Proxy anzuhängen:

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

Verwenden Sie den Befehl gcloud compute target-ssl-proxies update, um die Zertifikatszuordnung an den SSL-Zielproxy anzuhängen:

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

Ersetzen Sie Folgendes:

  • PROXY_NAME: Name des Ziel-Proxys
  • CERTIFICATE_MAP_NAME: Name der Zertifikatszuordnung, die die Zuordnungseinträge enthält, die auf die Zielzertifikate verweisen

API

Wenn Sie die Zertifikatzuordnung an den Ziel-HTTPS-Proxy anhängen möchten, senden Sie eine POST-Anfrage an die targetHttpsProxies-Methode:

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

Wenn Sie die Zertifikatzuordnung an den SSL-Zielproxy anhängen möchten, senden Sie eine POST-Anfrage an die targetSslProxies-Methode:

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

Ersetzen Sie Folgendes:

  • PROJECT_ID: ID Ihres Google Cloud -Projekts
  • PROXY_NAME: Name des Ziel-Proxys
  • CERTIFICATE_MAP_NAME: Name der Zertifikatszuordnung, die die Zuordnungseinträge enthält, die auf die Zielzertifikate verweisen

Zertifikatszuordnung von einem Proxy trennen

Beachten Sie Folgendes, bevor Sie eine Zertifikatszuordnung von einem Proxy trennen:

  • Wenn TLS-Zertifikate (SSL) direkt an den Proxy angehängt sind, werden sie vom Proxy wieder verwendet, wenn die Zertifikatszuordnung getrennt wird.

  • Wenn keine TLS-Zertifikate (SSL) direkt an den Proxy angehängt sind, kann eine Zertifikatzuordnung nicht getrennt werden. Hängen Sie mindestens ein TLS-Zertifikat direkt an den Proxy an, bevor Sie die Zertifikatszuordnung trennen.

gcloud

Verwenden Sie den Befehl gcloud compute target-https-proxies update, um eine angehängte Zertifikatszuordnung vom Ziel-HTTPS-Proxy zu trennen:

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

Verwenden Sie den Befehl gcloud compute target-ssl-proxies update, um eine angehängte Zertifikatszuordnung vom SSL-Zielproxy zu trennen:

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

Ersetzen Sie Folgendes:

  • PROXY_NAME: Name des Ziel-Proxys

API

Wenn Sie eine angehängte Zertifikatszuordnung vom HTTPS-Zielproxy trennen möchten, senden Sie eine POST-Anfrage an die targetHttpsProxies-Methode:

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

Wenn Sie eine angehängte Zertifikatszuordnung vom SSL-Zielproxy trennen möchten, senden Sie eine POST-Anfrage an die targetSslProxies-Methode:

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

Ersetzen Sie Folgendes:

  • PROJECT_ID: ID Ihres Google Cloud -Projekts
  • PROXY_NAME: Name des Ziel-Proxys

Zertifikatzuordnung aktualisieren

Sie können die Beschreibung und die Labels einer Zertifikatszuordnung aktualisieren. Wenn Sie dieGoogle Cloud Console verwenden, können Sie einer Zertifikatszuordnung einen neuen Zuordnungseintrag hinzufügen oder einen Zuordnungseintrag bearbeiten oder löschen, der mit einer Zertifikatszuordnung verknüpft ist.

Console

  1. Rufen Sie in der Google Cloud Console die Seite Zertifikatmanager auf und klicken Sie dann auf den Tab Zertifikatszuordnungen.

    Zum Zertifikatmanager

  2. Klicken Sie in der Liste der Zertifikatszuordnungen auf die gewünschte Zertifikatszuordnung. Die Seite Details zur Zertifikatszuordnung wird geöffnet.

  3. Klicken Sie auf Bearbeiten. Die Seite Zertifikatszuordnung bearbeiten wird geöffnet.

  4. Geben Sie im Feld Beschreibung eine neue Beschreibung für die Zertifikatszuordnung ein.

  5. Wenn Sie der Zertifikatszuordnung einen neuen Zuordnungseintrag hinzufügen möchten, klicken Sie auf Zuordnungseintrag hinzufügen und folgen Sie der Anleitung im Abschnitt Zertifikatszuordnungseintrag erstellen.

    Wenn Sie einen Zuordnungseintrag bearbeiten möchten, klicken Sie in der Spalte Aktionen der Zeile des Zuordnungseintrags auf das Symbol , wählen Sie Bearbeiten aus und folgen Sie dann den Schritten im Abschnitt Zertifikatszuordnungseintrag aktualisieren.

    Wenn Sie einen Zuordnungseintrag löschen möchten, klicken Sie in der Spalte Aktionen der Zeile des Zuordnungseintrags auf das Symbol , wählen Sie Löschen aus und folgen Sie dann der Anleitung im Abschnitt Zertifikatszuordnungseintrag löschen.

  6. Sie können die mit der Zertifikatszuordnung verknüpften Labels hinzufügen, löschen oder aktualisieren.

    Klicken Sie auf Label hinzufügen, um ein Label hinzuzufügen, und geben Sie einen Schlüssel und einen Wert für das Label an.

    Wenn Sie ein Label löschen möchten, klicken Sie für das gewünschte Label auf Element löschen.

  7. Klicken Sie auf Speichern.

gcloud

Verwenden Sie den Befehl gcloud certificate-manager maps update, um eine Zertifikatszuordnung zu aktualisieren:

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

Ersetzen Sie Folgendes:

  • CERTIFICATE_MAP_NAME: Name der Zertifikatszuordnung
  • DESCRIPTION: die neue Beschreibung für diese Zertifikatszuordnung
  • LABELS: eine durch Kommas getrennte Liste von Labels, die auf diese Zertifikatszuordnung angewendet werden

API

Wenn Sie eine Zertifikatszuordnung aktualisieren möchten, senden Sie eine PATCH-Anfrage an die Methode certificateMaps.patch:

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

Ersetzen Sie Folgendes:

  • PROJECT_ID: ID Ihres Google Cloud -Projekts
  • CERTIFICATE_MAP_NAME: Name der Zertifikatszuordnung
  • DESCRIPTION: die neue Beschreibung für diese Zertifikatszuordnung
  • LABEL_KEY: ein Labelschlüssel, der auf diese Zertifikatszuordnung angewendet wird
  • LABEL_VALUE: ein Label, das auf diese Zertifikatszuordnung angewendet wird

Zertifikatszuordnungen auflisten

Sie können die Liste aller von Ihnen erstellten Zertifikatszuordnungen aufrufen, filtern und sortieren.

Console

  1. Rufen Sie in der Google Cloud Console die Seite Zertifikatmanager auf.

    Zum Zertifikatmanager

  2. Klicken Sie auf den Tab Zertifikatszuordnungen. Sie können die Anzeigespalten aller Zertifikatszuordnungen im ausgewählten Projekt aufrufen, filtern und konfigurieren.

gcloud

Verwenden Sie den Befehl gcloud certificate-manager maps list, um Zertifikatszuordnungen aufzulisten:

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

Ersetzen Sie Folgendes:

  • FILTER: Ein Ausdruck, der die zurückgegebenen Ergebnisse auf bestimmte Werte beschränkt.

    Wenn Sie die Ergebnisse beispielsweise nach Labels und Erstellungszeit filtern möchten, können Sie Folgendes angeben: --filter='labels.key:value AND create_time > "2021-09-01T00:00:00Z"'.

    Weitere Filterbeispiele, die Sie mit dem Zertifikatmanager verwenden können, finden Sie in der Cloud Key Management Service-Dokumentation unter Listenergebnisse sortieren und filtern.

  • PAGE_SIZE: Anzahl der Ergebnisse, die pro Seite zurückgegeben werden sollen

  • LIMIT: Maximale Anzahl von Ergebnissen, die zurückgegeben werden sollen

  • SORT_BY: Eine durch Kommas getrennte Liste von name-Feldern, nach denen die zurückgegebenen Ergebnisse sortiert werden. Die Standardsortierreihenfolge ist aufsteigend. Für eine absteigende Sortierreihenfolge stellen Sie dem Feld eine Tilde (~) voran.

API

Senden Sie eine LIST-Anfrage an die Methode certificateMaps.list, um konfigurierte Zertifikatzuordnungen aufzulisten:

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

Ersetzen Sie Folgendes:

  • PROJECT_ID: ID Ihres Google Cloud -Projekts

  • FILTER: Ein Ausdruck, der die zurückgegebenen Ergebnisse auf bestimmte Werte beschränkt.

    Wenn Sie die Ergebnisse beispielsweise nach Labels und Erstellungszeit filtern möchten, können Sie Folgendes angeben: --filter='labels.key:value AND create_time > "2021-09-01T00:00:00Z"'

    Weitere Filterbeispiele, die Sie mit dem Zertifikatmanager verwenden können, finden Sie in der Cloud Key Management Service-Dokumentation unter Listenergebnisse sortieren und filtern.

  • PAGE_SIZE: Anzahl der Ergebnisse, die pro Seite zurückgegeben werden sollen

  • SORT_BY: Eine durch Kommas getrennte Liste von name-Feldern, nach denen die zurückgegebenen Ergebnisse sortiert werden. Die Standardsortierreihenfolge ist aufsteigend. Für eine absteigende Sortierreihenfolge stellen Sie dem Feld eine Tilde (~) voran.

Details einer Zertifikatzuordnung ansehen

Sie können die Details einer vorhandenen Zertifikatszuordnung aufrufen, z. B. das Erstellungsdatum und die Erstellungszeit, das Datum und die Uhrzeit der letzten Aktualisierung sowie die Beschreibung.

Console

  1. Rufen Sie in der Google Cloud Console die Seite Zertifikatmanager auf und klicken Sie dann auf den Tab Zertifikatszuordnungen.

    Zum Zertifikatmanager

  2. Klicken Sie in der Liste der Zertifikatszuordnungen auf die gewünschte Zertifikatszuordnung. Die Seite Details zur Zertifikatszuordnung wird mit detaillierten Informationen zur ausgewählten Zertifikatszuordnung geöffnet.

gcloud

Wenn Sie die Details einer Zertifikatszuordnung aufrufen möchten, verwenden Sie den Befehl gcloud certificate-manager maps describe:

gcloud certificate-manager maps describe CERTIFICATE_MAP_NAME

Ersetzen Sie Folgendes:

  • CERTIFICATE_MAP_NAME: Name der Zertifikatszuordnung

API

Senden Sie eine GET-Anfrage an die Methode certificateMaps.get, um die Details der Zertifikatszuordnung aufzurufen:

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

Ersetzen Sie Folgendes:

  • PROJECT_ID: ID Ihres Google Cloud -Projekts
  • CERTIFICATE_MAP_NAME: Name der Zertifikatszuordnung

Zertifikatszuordnung löschen

Führen Sie vor dem Löschen einer Zertifikatszuordnung folgende Schritte aus:

Console

  1. Rufen Sie in der Google Cloud Console die Seite Zertifikatmanager auf und klicken Sie dann auf den Tab Zertifikatszuordnungen.

    Zum Zertifikatmanager

  2. Klicken Sie in der Liste der Zertifikatszuordnungen auf die gewünschte Zertifikatszuordnung. Die Seite Details zur Zertifikatszuordnung wird geöffnet.

  3. Klicken Sie auf Löschen und dann noch einmal auf Löschen.

gcloud

Verwenden Sie den Befehl gcloud certificate-manager maps delete, um eine Zertifikatszuordnung zu löschen:

gcloud certificate-manager maps delete CERTIFICATE_MAP_NAME

Ersetzen Sie Folgendes:

  • CERTIFICATE_MAP_NAME: Name der Zertifikatszuordnung

API

Senden Sie zum Löschen der Zertifikatszuordnung eine DELETE-Anfrage an die Methode certificateMaps.delete:

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

Ersetzen Sie Folgendes:

  • PROJECT_ID: ID Ihres Google Cloud -Projekts
  • CERTIFICATE_MAP_NAME: Name der Zertifikatszuordnung

Nächste Schritte