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.
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-extim Infrastrukturcluster der Organisation stammt.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.
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:
Laden Sie die gdcloud CLI herunter und installieren Sie sie, falls noch nicht geschehen.
Generieren Sie eine kubeconfig-Datei für den Management API-Server in der Zielzone. Sie benötigen den Pfad zur kubeconfig-Datei, um
MANAGEMENT_API_SERVER_KUBECONFIGin denkubectl-Befehlen zu ersetzen.
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-Namespaceplatform. Wenn der globale API-Server bereit ist, füllt das Bundle alle anderen zonalentrust-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
Exportieren Sie die folgenden Umgebungsvariablen:
export STORAGE=STORAGE export ORG_NAME=ORG_NAME export DNS_SUFFIX=DNS_SUFFIXErsetzen 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 beispielsweiseorg-1.zone1.google.gdch.testist, lautet Ihr DNS-Suffixzone1.google.gdch.test.
Legen Sie die Umgebungsvariable
WELL_KNOWN_URLfest:export WELL_KNOWN_URL="https://console.${ORG_NAME:?}.${DNS_SUFFIX:?}/.well-known/certificate-authority"Legen Sie die Umgebungsvariable
GLOBAL_TRUST_BUNDLE_FILEfest. 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"Erstellen Sie das Verzeichnis für die Trust Bundle-Datei:
mkdir -p "$(dirname "${GLOBAL_TRUST_BUNDLE_FILE:?}")"Rufen Sie das
trust-store-global-root-ext-Trust-Bundle vom bekannten Server ab und speichern Sie es in der Datei, die durch die UmgebungsvariableGLOBAL_TRUST_BUNDLE_FILEangegeben ist:curl "${WELL_KNOWN_URL:?}" | sed '$a\' > "${GLOBAL_TRUST_BUNDLE_FILE:?}"
Windows
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 beispielsweiseorg-1.zone1.google.gdch.testist, lautet Ihr DNS-Suffixzone1.google.gdch.test.
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")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:
Exportieren Sie die folgenden Umgebungsvariablen:
export KUBECONFIG=MANAGEMENT_API_SERVER_KUBECONFIG export STORAGE=STORAGE export ZONE=ZONEErsetzen 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.
Legen Sie die Umgebungsvariable
TRUST_BUNDLE_FILEfest. In dieser Datei wird das GDC-Trust-Bundle lokal am angegebenen$STORAGE-Speicherort für Ihre GDC-$ZONEgespeichert:export TRUST_BUNDLE_FILE="${STORAGE:?}/${ZONE:?}/ca-bundles/trust-bundle" export GLOBAL_TRUST_BUNDLE_FILE="${STORAGE:?}/global/ca-bundles/global-trust-bundle"Legen Sie die Namespace-Umgebungsvariable
NSfür den Namespace fest:export NS=platformErstellen Sie die Verzeichnisse für die Trust Bundle-Dateien:
mkdir -p "$(dirname "${TRUST_BUNDLE_FILE:?}")" mkdir -p "$(dirname "${GLOBAL_TRUST_BUNDLE_FILE:?}")"Rufen Sie die Zertifizierungsstellen (CAs) ab und speichern Sie sie in den Dateien, die durch die Umgebungsvariablen
TRUST_BUNDLE_FILEundGLOBAL_TRUST_BUNDLE_FILEangegeben 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-----