GDC-Trust-Bundles abrufen

Ein Trust Bundle, auch als Vertrauensliste bezeichnet, ist eine Gruppe von Trust-Anchors, z. B. Entitäten, die von Natur aus vertrauenswürdig sind und deren Vertrauen nicht von einer anderen Entität (vertrauenswürdige Dritte) übertragen wird. Diese Trust-Anchors werden als Zertifikate von Zertifizierungsstellen (Certificate Authority, CA) bereitgestellt. Der Algorithmus zur Erstellung des Zertifizierungspfads verwendet diese CA-Zertifikate, um eine Kette zwischen einem Zertifikat, das eine Validierung erhält, und den Trust-Anchors herzustellen.

Dieses Dokument richtet sich an Zielgruppen innerhalb der Plattformadministratorgruppe, z. B. IT-Administratoren oder Sicherheitstechniker, die GDC-Trust-Bundles abrufen möchten. Weitere Informationen finden Sie unter Dokumentation zu Zielgruppen für GDC mit Air Gap.

Hinweis

Bevor Sie GDC-Trust-Bundles abrufen, müssen Sie ein erstes Vertrauen für neue Organisationen herstellen. Dieser Schritt ist sowohl für die Well-Known-Server- als auch für die kubectl-Methode erforderlich, aber nur, wenn Sie zum ersten Mal eine Verbindung zu einer neuen Organisation herstellen.

Für die bekannte Servermethode sind keine weiteren Voraussetzungen erforderlich. Für die Methode kubectl müssen Sie außerdem die Voraussetzungen für Berechtigungen und Tools erfüllen.

Anfängliches Vertrauen für neue Organisationen aufbauen

Wenn Sie zum ersten Mal eine Verbindung zu einer neuen GDC-Organisation herstellen, müssen Sie eine erste Vertrauensstellung einrichten. Dieser einmalige Vorgang sorgt für eine sichere Verbindung, indem der Zertifizierungsstelle der Organisation auf Ihrem Clientcomputer vertraut wird.

  1. Wenden Sie sich an ein Mitglied Ihrer IO-Gruppe (Infrastrukturbetreiber), um das erste Trust Bundle für die neue Organisation anzufordern. Der IO hat den erforderlichen Zugriff, um dieses Bundle abzurufen, das normalerweise aus dem Secret trust-store-root-ext im Infrastrukturcluster der Organisation stammt.

  2. Rufen Sie die erste Trust-Bundle-Datei von Ihrem IO über einen sicheren Kanal außerhalb von GDC ab, wie in den Sicherheitsrichtlinien Ihrer Organisation definiert.

  3. Installieren Sie das Trust Bundle im Trust Store Ihres Clientcomputers. Folgen Sie dazu den Standardverfahren Ihres Systems, um Root-CA-Zertifikaten zu vertrauen.

Wenn Sie Zugriff auf ServiceNow benötigen, rufen Sie auch das Trust Bundle für die Organisation gdchservices ab und installieren Sie es mit demselben Verfahren.

IAM-Rollen anfordern

Wenn Sie das Trust Bundle mit kubectl abrufen möchten, benötigen Sie die Berechtigung zum Aufrufen von Secrets. Wenden Sie sich an Ihren IAM-Admin der Organisation, um die Rolle Trust Store Viewer (trust-store-viewer) anzufordern.

Umgebung vorbereiten

Wenn Sie die Methode kubectl verwenden möchten, bereiten Sie Ihre lokale Umgebung vor:

Arten von Trust Bundles

Distributed Cloud bietet zwei Arten von verwalteten Trust Bundles für Plattformadministratoren:

  • trust-store-root-ext: enthält die interne Stamm-CA und die Web-TLS-CA. Der Inhalt unterscheidet sich je nach Speicherort, z. B. im Stammverzeichnis oder in der Mandantenorganisation. Verwenden Sie dieses Trust Bundle, um über Organisationsgrenzen hinweg zu kommunizieren oder auf Dienste wie Objektspeicher innerhalb der Organisation zuzugreifen.

  • trust-store-global-root-ext: verfügbar im globalen API-Server und im zonalen API-Server-Namespace platform. Wenn der globale API-Server bereit ist, füllt das Bundle alle anderen zonalen trust-store-root-ext-Daten, einschließlich lokaler Daten.

Trust-Bundle abrufen

Sie können Trust Bundles vom bekannten Serverendpunkt oder mit kubectl aus dem Cluster abrufen.

Vom bekannten Server abrufen

GDC bietet eine sichere Möglichkeit, über einen bekannten Serverendpunkt auf Trust Bundles zuzugreifen. Verwenden Sie diese Methode, wenn Sie das trust-store-global-root-ext-Bundle abrufen müssen, ohne direkt über kubectl mit dem Cluster zu interagieren.

Bevor Sie die Schritte in diesem Abschnitt ausführen, müssen Sie ein erstes Vertrauen zu den spezifischen Zertifizierungsstellen Ihrer Organisation hergestellt haben.

Linux

  1. Exportieren Sie die folgenden Umgebungsvariablen:

    export STORAGE=STORAGE
    export ORG_NAME=ORG_NAME
    export DNS_SUFFIX=DNS_SUFFIX
    

    Ersetzen Sie Folgendes:

    • STORAGE: der Verzeichnispfad, in dem Sie die Trust Bundle-Datei speichern möchten.
    • ORG_NAME: der Name Ihrer Organisation in GDC.
    • DNS_SUFFIX: Ihr DNS-Suffix. Wenn eine Ihrer Domains beispielsweise org-1.zone1.google.gdch.test ist, lautet Ihr DNS-Suffix zone1.google.gdch.test.
  2. Legen Sie die Umgebungsvariable WELL_KNOWN_URL fest:

    export WELL_KNOWN_URL="https://console.${ORG_NAME:?}.${DNS_SUFFIX:?}/.well-known/certificate-authority"
    
  3. Legen Sie die Umgebungsvariable GLOBAL_TRUST_BUNDLE_FILE fest. In dieser Datei wird das GDC-Trust-Bundle lokal am angegebenen $STORAGE-Speicherort gespeichert.

    export GLOBAL_TRUST_BUNDLE_FILE="${STORAGE:?}/global/ca-bundles/global-trust-bundle"
    
  4. Erstellen Sie das Verzeichnis für die Trust Bundle-Datei:

    mkdir -p "$(dirname "${GLOBAL_TRUST_BUNDLE_FILE:?}")"
    
  5. Rufen Sie das trust-store-global-root-ext-Trust-Bundle vom bekannten Server ab und speichern Sie es in der Datei, die durch die Umgebungsvariable GLOBAL_TRUST_BUNDLE_FILE angegeben ist:

    curl "${WELL_KNOWN_URL:?}" | sed '$a\' > "${GLOBAL_TRUST_BUNDLE_FILE:?}"
    

Windows

  1. Legen Sie die folgenden PowerShell-Variablen fest:

    $STORAGE = "STORAGE"
    $ORG_NAME = "ORG_NAME"
    $DNS_SUFFIX = "DNS_SUFFIX"
    

    Ersetzen Sie Folgendes:

    • STORAGE: der Verzeichnispfad, in dem Sie die Trust Bundle-Datei speichern möchten, z. B. C:\Users\username\bundles.
    • ORG_NAME: der Name Ihrer Organisation in GDC.
    • DNS_SUFFIX: Ihr DNS-Suffix. Wenn eine Ihrer Domains beispielsweise org-1.zone1.google.gdch.test ist, lautet Ihr DNS-Suffix zone1.google.gdch.test.
  2. Erstellen Sie das Verzeichnis für die Trust Bundle-Datei:

    New-Item -ItemType Directory -Force -Path (Split-Path -Path "STORAGE\global\ca-bundles\global-trust-bundle")
    
  3. Rufen Sie das trust-store-global-root-ext-Vertrauens-Bundle vom bekannten Server ab und speichern Sie es in der Vertrauens-Bundle-Datei:

    Invoke-WebRequest -Uri "https://console.ORG_NAME.DNS_SUFFIX/.well-known/certificate-authority" -OutFile "STORAGE\global\ca-bundles\global-trust-bundle"
    

Die abgerufene Trust Bundle-Datei enthält ein oder mehrere CA-Zertifikate. Die Ausgabe sieht etwa so aus:

   -----BEGIN CERTIFICATE-----
   MIIC8TCCAdmgAwIBAgIRAODQ/dOB39RBs8ZpN0RujIswDQYJKoZIhvcNAQELBQAw
   EjEQMA4GA1UEAxMHcm9vdC1jYTAeFw0yNTAxMDYwNzM3MzVaFw00ODEyMzEwNzM3
   MzVaMBIxEDAOBgNVBAMTB3Jvb3QtY2EwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAw
   ggEKAoIBAQC41U4+3M1EAHggUBw5ki97533zTvwHukmZyORwbQ3tlQ4GQDscoCEh
   nn+KCaG767VCaGDcQhq99hl6qa/nBoc1X6WQ3a/uhv5E2ztRD40PB5NFNdSulxTH
   gsitukSmv+DAx15UJnVkJtPP/FzxEWPu0piIiFZakTxT83VUSs54QRmTahxP80FI
   R0xZ0ohsu9jzA2CAyxTccJU0/xE2kDwN8c8kiYYuG+czMdNVdnT4Jm2ToSkzIDux
   Yi9MzNmarVGG/rtW5SlqnUMYzSsxtUYSmMRlCsFDVxkSzfmICmTRw2zmNkFA/3nz
   XneVSIsUHOA2NzvMN4eoLTVRgSFcHlZRAgMBAAGjQjBAMA4GA1UdDwEB/wQEAwIB
   hjAPBgNVHRMBAf8EBTADAQH/MB0GA1UdDgQWBBTEeB0EQwhc5p++GhwNymsBfN93
   WjANBgkqhkiG9w0BAQsFAAOCAQEAKBqn4AXjUWmhIUOrWQ5cetsmI76Wl+RBeSzU
   HxbqMBH8Dk1oJbGHtmQbu7EmWz1pKYge650s9N83hMgjFZD24t9GiQZ7YY+i+317
   D6HzJ8VIKPnxVtnUIQzCpkRTQoglDlb1f/7+fi2SYJoHdhnRI/3OaVQTnObjbW5T
   mBhsMxFKc0zGa3HIEm9SUH608V60xUPanl23YZ6X7W8nWAJfnzKvH+3q3Fz58u/S
   VR5t/FkbOktVtnU8AfcMKLof6KG2KhE2L7FAC+fp0ZsjV9vE2uqlZ+8mIQHyc3tM
   cbWxOx+SO/XUCenY9C1yrublln9aOEn4/s3aSURPguiSZOfDyQ==
   -----END CERTIFICATE-----

Mit kubectl vom Cluster abrufen

Sie können Trust Bundles mit dem kubectl-Befehlszeilentool direkt aus dem GDC-Cluster abrufen. Verwenden Sie diese Methode, wenn Sie direkten Zugriff auf den Cluster und seine Konfiguration haben und entweder die trust-store-root-ext- oder die trust-store-global-root-ext-Trust-Bundles abrufen müssen.

Bevor Sie die Schritte in diesem Abschnitt ausführen, müssen Sie ein erstes Vertrauen zu den spezifischen Zertifizierungsstellen Ihrer Organisation hergestellt haben.

Rufen Sie das Trust Bundle mit kubectl aus dem Cluster ab:

  1. Exportieren Sie die folgenden Umgebungsvariablen:

    export KUBECONFIG=MANAGEMENT_API_SERVER_KUBECONFIG
    export STORAGE=STORAGE
    export ZONE=ZONE
    

    Ersetzen Sie Folgendes:

    • MANAGEMENT_API_SERVER_KUBECONFIG: der Pfad zur kubeconfig-Datei des Management API-Servers.
    • STORAGE: der Verzeichnispfad, in dem Sie die Trust Bundle-Datei speichern möchten.
    • ZONE: der Name Ihrer GDC-Zone.
  2. Legen Sie die Umgebungsvariable TRUST_BUNDLE_FILE fest. In dieser Datei wird das GDC-Trust-Bundle lokal am angegebenen $STORAGE-Speicherort für Ihre GDC-$ZONE gespeichert:

    export TRUST_BUNDLE_FILE="${STORAGE:?}/${ZONE:?}/ca-bundles/trust-bundle"
    export GLOBAL_TRUST_BUNDLE_FILE="${STORAGE:?}/global/ca-bundles/global-trust-bundle"
    
  3. Legen Sie die Namespace-Umgebungsvariable NS für den Namespace fest:

    export NS=platform
    
  4. Erstellen Sie die Verzeichnisse für die Trust Bundle-Dateien:

    mkdir -p "$(dirname "${TRUST_BUNDLE_FILE:?}")"
    mkdir -p "$(dirname "${GLOBAL_TRUST_BUNDLE_FILE:?}")"
    
  5. Rufen Sie die Zertifizierungsstellen (CAs) ab und speichern Sie sie in den Dateien, die durch die Umgebungsvariablen TRUST_BUNDLE_FILE und GLOBAL_TRUST_BUNDLE_FILE angegeben sind:

    Für trust-store-root-ext:

    kubectl --kubeconfig ${KUBECONFIG:?} get secret trust-store-root-ext -n ${NS:?} -o go-template='{{ index .data "ca.crt" }}' | base64 -d | sed '$a\' > ${TRUST_BUNDLE_FILE:?}
    

    Für trust-store-global-root-ext:

    kubectl --kubeconfig ${KUBECONFIG:?} get secret trust-store-global-root-ext -n ${NS:?} -o go-template='{{ index .data "ca.crt" }}' | base64 -d | sed '$a\' > ${GLOBAL_TRUST_BUNDLE_FILE:?}
    

    Die abgerufene Trust Bundle-Datei enthält ein oder mehrere CA-Zertifikate. Die entsprechende Ausgabe sieht etwa so aus:

    -----BEGIN CERTIFICATE-----
    MIIC8TCCAdmgAwIBAgIRAODQ/dOB39RBs8ZpN0RujIswDQYJKoZIhvcNAQELBQAw
    EjEQMA4GA1UEAxMHcm9vdC1jYTAeFw0yNTAxMDYwNzM3MzVaFw00ODEyMzEwNzM3
    MzVaMBIxEDAOBgNVBAMTB3Jvb3QtY2EwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAw
    ggEKAoIBAQC41U4+3M1EAHggUBw5ki97533zTvwHukmZyORwbQ3tlQ4GQDscoCEh
    nn+KCaG767VCaGDcQhq99hl6qa/nBoc1X6WQ3a/uhv5E2ztRD40PB5NFNdSulxTH
    gsitukSmv+DAx15UJnVkJtPP/FzxEWPu0piIiFZakTxT83VUSs54QRmTahxP80FI
    R0xZ0ohsu9jzA2CAyxTccJU0/xE2kDwN8c8kiYYuG+czMdNVdnT4Jm2ToSkzIDux
    Yi9MzNmarVGG/rtW5SlqnUMYzSsxtUYSmMRlCsFDVxkSzfmICmTRw2zmNkFA/3nz
    XneVSIsUHOA2NzvMN4eoLTVRgSFcHlZRAgMBAAGjQjBAMA4GA1UdDwEB/wQEAwIB
    hjAPBgNVHRMBAf8EBTADAQH/MB0GA1UdDgQWBBTEeB0EQwhc5p++GhwNymsBfN93
    WjANBgkqhkiG9w0BAQsFAAOCAQEAKBqn4AXjUWmhIUOrWQ5cetsmI76Wl+RBeSzU
    HxbqMBH8Dk1oJbGHtmQbu7EmWz1pKYge650s9N83hMgjFZD24t9GiQZ7YY+i+317
    D6HzJ8VIKPnxVtnUIQzCpkRTQoglDlb1f/7+fi2SYJoHdhnRI/3OaVQTnObjbW5T
    mBhsMxFKc0zGa3HIEm9SUH608V60xUPanl23YZ6X7W8nWAJfnzKvH+3q3Fz58u/S
    VR5t/FkbOktVtnU8AfcMKLof6KG2KhE2L7FAC+fp0ZsjV9vE2uqlZ+8mIQHyc3tM
    cbWxOx+SO/XUCenY9C1yrublln9aOEn4/s3aSURPguiSZOfDyQ==
    -----END CERTIFICATE-----