Mit verwalteten Arbeitslastidentitäten für die Google Kubernetes Engine (GKE) können Sie X.509-Zertifikate für Arbeitslasten in von Flotten verwalteten Clustern bereitstellen, um eine gegenseitige TLS-Authentifizierung (mTLS) einzurichten. Nachdem Sie eine Zertifizierungsstelle konfiguriert haben, können Sie Arbeitslasten bereitstellen und deren Identitäten und Zertifikate prüfen.
Übersicht
Führen Sie die folgenden Schritte aus, um verwaltete Arbeitslastidentitäten für GKE einzurichten und zu verwenden:
Arbeitslasten mit verwalteten Arbeitslastidentitäten bereitstellen
Optional: Vertrauensföderation zwischen Workload Identity-Pools aktivieren
Von Google verwalteter Workload Identity-Pool
Wenn Sie GKE-Flotten Cluster hinzufügen, erstellt GKE automatisch einen von Google verwalteten Workload Identity-Pool, der als Root of Trust dient, auch als SPIFFE-Vertrauensdomäne für Ihre Arbeitslasten bezeichnet. Alle Arbeitslasten innerhalb der Vertrauensdomäne erhalten Zertifikate und Trust-Anker, die standardmäßig die Authentifizierung innerhalb der Vertrauensdomäne ermöglichen. Wenn Sie mehrere Vertrauensdomänen haben, können Sie die Vertrauensföderation zwischen ihnen aktivieren, um die Kommunikation zwischen Vertrauensdomänen zu ermöglichen.
Der von Google verwaltete Workload Identity-Pool hat die folgenden Merkmale:
Identitätsverwaltung: Google verwaltet den Pool vollständig. Sie können keine Unterressourcen wie Namespaces, Identitäten oder Identitätsanbieter erstellen.
Arbeitslastunterstützung: Sie können den Pool nur für GKE-Arbeitslasten verwenden. Sie können dem Pool keine anderen Arten von Arbeitslasten wie Compute Engine-VMs hinzufügen.
Flottenintegration: Alle Cluster im Pool unterliegen dem Standardmodell für die Gleichheit von Kubernetes-Namespaces. Das bedeutet, dass alle Cluster im Pool dieselben Berechtigungen haben und Arbeitslasten in jedem Cluster im Pool jede Identität in diesem Pool verwenden können.
Selbstverwalteter Workload Identity-Pool
In Umgebungen mit gemischtem Vertrauen, z. B. mehrmandantenfähigen Flotten, können Sie einen separaten selbstverwalteten Workload Identity-Pool für eine Teilmenge Ihrer Arbeitslasten und Cluster konfigurieren. Ein selbstverwalteter Workload Identity-Pool hat die folgenden Merkmale:
Identitätsverwaltung: Wenn Sie einen eigenen Workload Identity-Pool definieren, haben Sie die volle Kontrolle über die Identitätsverwaltung im Pool. Unter dem Pool können Sie Ihre eigene Identitätshierarchie definieren, z. B. Namespaces und Identitäten. Sie können Attestierungsrichtlinien definieren, um festzulegen, welche Arbeitslasten Identitäten im Pool oder in den Namespaces attestieren können.
Arbeitslastunterstützung: Alle Arbeitslasten (z. B. VMs, Container und serverlose Arbeitslasten) können im Pool platziert werden.
Flottenintegration: Für Arbeitslasten, die von GKE-Flotten verwaltet werden, bieten Flotten eine integrierte Schnittstelle zum Verwalten von Identitäten. Sie können Ihren Workload Identity-Pool als Mandantenpool für den Flottenbereich konfigurieren. Flotten erstellen automatisch Workload Identity-Pool-Namespaces, die den Flotten-Namespaces entsprechen, und weisen den Arbeitslasten Identitäten zu.
Wenn Sie einen selbstverwalteten Workload Identity-Pool verwenden möchten, müssen Sie Funktionen zur Verwaltung von Flottenteams wie Teambereiche und Flotten-Namespaces konfigurieren und den selbstverwalteten Pool als Pool für die Bereichsmandantenfähigkeit einrichten. Eine Anleitung zum Erstellen und Konfigurieren eines selbstverwalteten Pools finden Sie unter Bei Google Cloud -APIs von Flottenarbeitslasten mit gemischtem Vertrauen authentifizieren.
Konfiguration mehrerer Projekte
Google Cloud -Ressourcen, die Sie in diesem Dokument verwenden, z. B. GKE-Cluster, die Stamm-Zertifizierungsstelle und untergeordnete Zertifizierungsstellen, können in separaten Projekten vorhanden sein. Wenn Sie auf diese Ressourcen verweisen, verwenden Sie das Flag --project, um das richtige Projekt für jede Ressource anzugeben.
Hinweis
Erstellen oder wählen Sie ein Google Cloud -Projekt aus.
Erforderliche Rollen zum Auswählen oder Erstellen eines Projekts
- Projekt auswählen: Für die Auswahl eines Projekts ist keine bestimmte IAM-Rolle erforderlich. Sie können jedes Projekt auswählen, für das Ihnen eine Rolle zugewiesen wurde.
-
Projekt erstellen: Zum Erstellen eines Projekts benötigen Sie die Rolle „Project Creator“ (
roles/resourcemanager.projectCreator), die die Berechtigungresourcemanager.projects.createenthält. Informationen zum Zuweisen von Rollen
-
Erstellen Sie ein Projekt in Google Cloud :
gcloud projects create PROJECT_ID
Ersetzen Sie
PROJECT_IDdurch einen Namen für das Projekt in Google Cloud , das Sie erstellen. -
Wählen Sie das von Ihnen erstellte Projekt in Google Cloud aus:
gcloud config set project PROJECT_ID
Ersetzen Sie
PROJECT_IDdurch den Namen Ihres Projekts in Google Cloud .
Verwaltete Arbeitslastidentitäten verstehen.
Auf Ihren Clustern muss die Version 1.33.0-gke.2248000 oder höher ausgeführt werden.
Fügen Sie Ihre Cluster zu GKE-Flotten hinzu. Wenn es sich bei Ihrem Cluster um einen Autopilot-Cluster handelt, lassen Sie das Flag
--enable-workload-identityweg. Flotten erstellen automatisch einen von Google verwalteten Workload Identity-Pool, der als Vertrauensdomäne dient.Aktivieren Sie GKE-Flotten mit dem folgenden Befehl:
gcloud container clusters update CLUSTER_NAME \ --workload-pool=PROJECT_ID. \ --enable-fleet \ --fleet-project=PROJECT_ID
Ersetzen Sie diese Werte:
CLUSTER_NAME: der Name des GKE-Clusters, der bei der GKE-Flotte registriert werden sollPROJECT_ID: die Projekt-ID des Hostprojekts der GKE-Flotte
-
Aktivieren Sie die IAM API und die Certificate Authority Service API, falls sie noch nicht aktiviert sind.
Rollen, die zum Aktivieren von APIs erforderlich sind
Zum Aktivieren von APIs benötigen Sie die Berechtigung
serviceusage.services.enable. Wenn Sie das Projekt erstellt haben, haben Sie diese Berechtigung wahrscheinlich bereits über die Inhaberrolle (roles/owner). Andernfalls können Sie diese Berechtigung über die Rolle „Service Usage-Administrator“ (roles/serviceusage.serviceUsageAdmin) erhalten. Informationen zum Zuweisen von Rollen Konfigurieren Sie die Google Cloud CLI so, dass Ihr Abrechnungs- und Kontingentprojekt verwendet wird.
gcloud config set billing/quota_project PROJECT_ID
Ersetzen Sie PROJECT_ID durch die ID des Flottenprojekts.
Erforderliche Rollen
Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für das Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Erstellen verwalteter Arbeitslastidentitäten und zum Bereitstellen von Zertifikaten für verwaltete Arbeitslastidentitäten benötigen:
-
So erstellen und konfigurieren Sie verwaltete Arbeitslastidentitäten:
IAM Workload Identity Pool Admin (
roles/iam.workloadIdentityPoolAdmin) -
Zum Erstellen und Konfigurieren von CA-Pools: CA Service Admin (
roles/privateca.admin)
Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.
Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.
CA-Option auswählen
Wählen Sie zum Signieren Ihrer Arbeitslastzertifikate die Zertifizierungsstellenoption (CA) aus, die am besten zu Ihrem Anwendungsfall passt:
Von Google verwaltete Standard-CA: Verwenden Sie diese Option für eine vollständig verwaltete, kostenlose Lösung. Die Standardzertifizierungsstelle bietet eine gemeinsame Root of Trust für alleGoogle Cloud -Nutzer.
Benutzerdefinierte Zertifizierungsstelle: Verwenden Sie diese Option, um Ihre eigene Public-Key-Infrastruktur (PKI) über den Certificate Authority Service zu konfigurieren. Diese Option ist geeignet, wenn Sie eine benutzerdefinierte Root of Trust benötigen oder Signaturschlüssel in einem Hardware Security Module (HSM) speichern müssen, um Compliance-Anforderungen zu erfüllen. Der Certificate Authority Service wird separat von der verwalteten Arbeitslastidentität in Rechnung gestellt. Weitere Informationen finden Sie unter CA Service – Preise.
Zertifizierungsstelle konfigurieren
Standard-Zertifizierungsstelle
Wenn Sie die Standard-Zertifizierungsstelle an den Workload Identity-Pool binden möchten, aktualisieren Sie den Workload Identity-Pool mit dem Flag use-default-shared-ca.
gcloud iam workload-identity-pools update TRUST_DOMAIN_NAME \
--location="global" \
--use-default-shared-ca \
--project=PROJECT_ID
Ersetzen Sie Folgendes:
TRUST_DOMAIN_NAME:Der Name der Vertrauensdomäne. Formatieren Sie den Namen je nach Pooltyp so:
- Von Google verwalteter Pool:
PROJECT_ID. - Selbstverwalteter Pool:
POOL_NAME.global.POOL_HOST_PROJECT_NUMBER.workload.id.goog
- Von Google verwalteter Pool:
PROJECT_ID: Die Projekt-ID Ihres Flotten-Hostprojekts.
Benutzerdefinierte Zertifizierungsstelle
- CA Service so konfigurieren, dass Zertifikate für verwaltete Arbeitslastidentitäten ausgestellt werden
- Binden Sie die Zertifizierungsstellen an den Workload Identity-Pool.
- Verwaltete Arbeitslastidentitäten autorisieren, um Zertifikate vom CA-Pool anzufordern
CA Service so konfigurieren, dass Zertifikate für verwaltete Arbeitslastidentitäten ausgestellt werden
Wenn Sie verwaltete Arbeitslastidentitäten für die GKE konfigurieren möchten, müssen Sie zuerst eine Zertifizierungsstelle (CA) und eine oder mehrere untergeordnete CAs konfigurieren. Diese Konfiguration wird als Zertifizierungsstellenhierarchie bezeichnet.
Sie können CA Service-Pools verwenden, um diese Hierarchie einzurichten. In dieser Hierarchie stellt der untergeordnete CA-Pool die X.509-Workload Identity-Zertifikate für Ihre Arbeitslasten aus.
Die CA-Pools, die für die Ausstellung von Zertifikaten für Arbeitslasten mit verwalteten Arbeitslastidentitäten konfiguriert sind, müssen sich in derselben Region wie die Arbeitslast befinden. Wenn Sie eine multiregionale Architektur für Sicherheit gegen regionale Ausfälle entwerfen möchten, empfehlen wir, für jede Region, in der Sie Arbeitslasten ausführen, einen untergeordneten Certificate Authority Service-CA-Pool zu konfigurieren. Dadurch kann jede Ihrer Arbeitslasten auf einen untergeordneten Certificate Authority Service-CA-Pool in der Region verweisen.
Stamm-CA-Pool konfigurieren
So erstellen Sie den Root-CA-Pool:
Erstellen Sie den Root-CA-Pool in der Stufe Enterprise mit gcloud privateca pools create.
Diese Stufe ist für die Ausstellung langlebiger Zertifikate in geringem Umfang gedacht.
gcloud privateca pools create ROOT_CA_POOL_ID \
--location=REGION \
--project=CA_PROJECT_ID \
--tier=enterprise
Ersetzen Sie Folgendes:
ROOT_CA_POOL_ID: Eine eindeutige ID für den Root-CA-Pool. Die ID darf bis zu 64 Zeichen lang sein und darf nur alphanumerische Zeichen in Klein- und Großschreibung, Unterstriche oder Bindestriche enthalten. Die Pool-ID muss innerhalb der Region eindeutig sein.REGION: Die Region, in der sich der Stamm-CA-Pool befindet.CA_PROJECT_ID: Die Projekt-ID, in der Sie die Stamm-Zertifizierungsstelle erstellen möchten.
Weitere Informationen zu CA-Pools, ‑Stufen und ‑Regionen finden Sie unter CA-Pools erstellen.
Stamm-Zertifizierungsstelle konfigurieren
Erstellen Sie mit gcloud privateca roots create eine Stamm-Zertifizierungsstelle im CA-Pool.
Möglicherweise werden Sie aufgefordert, die Root-CA zu aktivieren, wenn dies die einzige CA im Root-CA-Pool ist.
Führen Sie den folgenden Befehl aus, um eine Root-Zertifizierungsstelle zu erstellen:
gcloud privateca roots create ROOT_CA_ID \
--pool=ROOT_CA_POOL_ID \
--subject="CN=ROOT_CA_CN, O=ROOT_CA_ORGANIZATION" \
--key-algorithm="KEY_ALGORITHM" \
--max-chain-length=1 \
--location=REGION \
--project=CA_PROJECT_ID \
--auto-enable
Ersetzen Sie Folgendes:
ROOT_CA_ID: Ein eindeutiger Name für die Stamm-CA. Der Name der Zertifizierungsstelle darf bis zu 64 Zeichen lang sein und darf nur alphanumerische Zeichen in Groß- und Kleinschreibung, Unterstriche oder Bindestriche enthalten. Der Name der Zertifizierungsstelle muss innerhalb der Region eindeutig sein.ROOT_CA_POOL_ID: Die ID des Stamm-CA-Pools.ROOT_CA_CN: Der Name der Stammzertifizierungsstelle.ROOT_CA_ORGANIZATION: Die Organisation der Stamm-Zertifizierungsstelle.KEY_ALGORITHM: Der Schlüsselalgorithmus, z. B.ec-p256-sha256.REGION: Die Region, in der sich der Stamm-CA-Pool befindet.CA_PROJECT_ID: Die Projekt-ID, unter der Sie die Stammzertifizierungsstelle erstellt haben.
Weitere Informationen zu den subject-Feldern für die Zertifizierungsstelle finden Sie unter Inhaber.
Optional können Sie zusätzliche Root-CAs in Ihrem Root-CA-Pool erstellen. Dies kann für die Rotation der Stammzertifizierungsstelle nützlich sein.
Untergeordnete Zertifizierungsstellen konfigurieren
Optional können Sie untergeordnete Zertifizierungsstellen konfigurieren. Die Konfiguration untergeordneter Zertifizierungsstellen kann bei Folgendem helfen:
Mehrere Szenarien für die Zertifikatsausstellung: Wenn Sie mehrere Szenarien für die Zertifikatsausstellung haben, können Sie für jedes Szenario eine untergeordnete Zertifizierungsstelle erstellen.
Besseres Load Balancing: Wenn Sie einem CA-Pool mehrere untergeordnete Zertifizierungsstellen hinzufügen, können Sie ein besseres Load Balancing von Zertifikatsanfragen erreichen.
So erstellen Sie einen untergeordneten CA-Pool und eine untergeordnete Zertifizierungsstelle:
Erstellen Sie den untergeordneten CA-Pool in der DevOps-Stufe, die für die Ausstellung von Zertifikaten mit hohem Volumen und kurzer Lebensdauer vorgesehen ist.
gcloud privateca pools create SUBORDINATE_CA_POOL_ID \ --location=REGION \ --project=CA_PROJECT_ID \ --tier=devopsErsetzen Sie Folgendes:
SUBORDINATE_CA_POOL_ID: Eine eindeutige ID für den untergeordneten CA-Pool. Die ID darf bis zu 64 Zeichen lang sein und darf nur alphanumerische Zeichen in Klein- und Großschreibung, Unterstriche oder Bindestriche enthalten. Die Pool-ID muss innerhalb der Region eindeutig sein.REGION: Die Region, in der der untergeordnete CA-Pool erstellt werden soll.CA_PROJECT_ID: Die ID des Projekts, in dem Sie die untergeordnete Zertifizierungsstelle erstellt haben.
Weitere Informationen finden Sie unter CA-Pools erstellen.
Erstellen Sie eine untergeordnete Zertifizierungsstelle im untergeordneten CA-Pool. Ändern Sie nicht den standardmäßigen konfigurationsbasierten Ausstellungsmodus.
gcloud privateca subordinates create SUBORDINATE_CA_ID \ --pool=SUBORDINATE_CA_POOL_ID \ --location=REGION \ --issuer-pool=ROOT_CA_POOL_ID \ --issuer-location=REGION \ --subject="CN=SUBORDINATE_CA_CN, O=SUBORDINATE_CA_ORGANIZATION" \ --key-algorithm="KEY_ALGORITHM" \ --use-preset-profile=subordinate_mtls_pathlen_0 \ --project=CA_PROJECT_ID \ --auto-enableErsetzen Sie Folgendes:
SUBORDINATE_CA_ID: Ein eindeutiger Name für die untergeordnete Zertifizierungsstelle. Der Name darf bis zu 64 Zeichen lang sein und darf nur alphanumerische Zeichen in Groß- und Kleinschreibung, Unterstriche oder Bindestriche enthalten. Der Poolname muss innerhalb der Region eindeutig sein.SUBORDINATE_CA_POOL_ID: Der Name des untergeordneten CA-Pools.REGION: Die Region, in der sich der untergeordnete CA-Pool befindet.ROOT_CA_POOL_ID: Die ID des Stamm-CA-Pools.REGION: Die Region des Stamm-CA-Pools.SUBORDINATE_CA_CN: Der Name der untergeordneten Zertifizierungsstelle.SUBORDINATE_CA_ORGANIZATION: Der Name der Organisation, die die untergeordnete Zertifizierungsstelle ausstellt.KEY_ALGORITHM: Der Schlüsselalgorithmus, z. B.ec-p256-sha256.CA_PROJECT_ID: Die ID des Projekts, in dem Sie die untergeordnete Zertifizierungsstelle erstellt haben.
Weitere Informationen zu den
subject-Feldern für die Zertifizierungsstelle finden Sie unter Inhaber.
Konfigurationsdatei für die Zertifikatsausstellung erstellen
Für das Binden von Zertifizierungsstellen an Workload Identity-Pools ist eine Konfiguration für die Zertifikatsausstellung erforderlich. Wenn sich Ihre Arbeitslasten über mehrere Vertrauensdomänen hinweg authentifizieren müssen, lesen Sie den Abschnitt Vertrauensföderation zwischen Workload Identity-Pools aktivieren (optional).
Zum Konfigurieren der Konfiguration der Zertifikatsausstellung erstellen Sie eine Konfigurationsdatei für die Zertifikatsausstellung mit dem Namen cic.json. Das Format der Datei sieht in etwa so aus:
{
"inlineCertificateIssuanceConfig": {
"caPools": {
"REGION1": "projects/CA_PROJECT_NUMBER1/locations/REGION1/caPools/SUBORDINATE_CA_POOL_ID1",
"REGION2": "projects/CA_PROJECT_NUMBER2/locations/REGION2/caPools/SUBORDINATE_CA_POOL_ID2"
},
"lifetime": "DURATION",
"rotationWindowPercentage": ROTATION_WINDOW_PERCENTAGE,
"keyAlgorithm": "ALGORITHM"
}
}
Ersetzen Sie Folgendes:
REGION: Die Regionen, in denen sich die Zertifizierungsstellen befinden.CA_PROJECT_NUMBER: Die Projektnummer des Projekts, in dem Sie den untergeordneten CA-Pool erstellt haben. Führen Sie den folgenden Befehl aus, um die Projektnummer aus dem Projekt CA_PROJECT_ID abzurufen:gcloud projects describe CA_PROJECT_ID --format="value(projectNumber)"
SUBORDINATE_CA_POOL_ID: Der Name des untergeordneten CA-Pools.ALGORITHM: Optional. Der Verschlüsselungsalgorithmus, der zum Generieren des privaten Schlüssels verwendet wird. Gültige Werte sindECDSA_P256,ECDSA_P384,RSA_2048,RSA_3072,RSA_4096. Wenn nicht angegeben, wirdECDSA_P256als Standardalgorithmus verwendet.DURATION: Optional. Die Gültigkeitsdauer des untergeordneten Zertifikats in Sekunden. Der Wert muss zwischen 86.400 (1 Tag) und 2.592.000 (30 Tage) liegen. Wenn keine Angabe erfolgt, wird der Standardwert 86400 (1 Tag) verwendet. Die tatsächliche Gültigkeit des ausgestellten Zertifikats hängt auch von der ausstellenden Zertifizierungsstelle ab, da sie die Lebensdauer des ausgestellten Zertifikats einschränken kann.ROTATION_WINDOW_PERCENTAGE(optional): Der Prozentsatz der Zertifikatslebensdauer, bei dem eine Verlängerung ausgelöst wird. Der Wert muss zwischen 50 und 80 liegen. Wenn keine Angabe erfolgt, wird 50 als Standardwert verwendet.
Zertifizierungsstellen an den Workload Identity-Pool binden
Nachdem Sie die CA-Hierarchie und die Konfigurationen für die Zertifikatsausstellung für jede CA erstellt haben, binden Sie die CAs an den Workload Identity-Pool. Wenn Sie eine Zertifizierungsstelle an den Workload Identity-Pool binden möchten, aktualisieren Sie den Workload Identity-Pool mit der Zertifikatsausstellungskonfiguration der Zertifizierungsstelle. Anschließend können Sie prüfen, ob der Pool aktualisiert wurde.
Workload Identity-Pool aktualisieren
Führen Sie den folgenden Befehl aus, um den Pool zu aktualisieren:
gcloud iam workload-identity-pools update TRUST_DOMAIN_NAME \
--location="global" \
--inline-certificate-issuance-config-file=CIC_JSON_FILE_PATH \
--project=PROJECT_ID
Ersetzen Sie Folgendes:
TRUST_DOMAIN_NAME: Der Name der Vertrauensdomäne. Formatieren Sie den Namen je nach Pooltyp so:- Von Google verwalteter Pool:
PROJECT_ID. - Selbstverwalteter Pool:
POOL_NAME.global.POOL_HOST_PROJECT_NUMBER.workload.id.goog
- Von Google verwalteter Pool:
CIC_JSON_FILE_PATH: Der Pfad zur JSON-formatierten Konfigurationsdatei für die Zertifikatsausstellung (cic.json), die Sie zuvor erstellt haben.
Prüfen, ob der Workload Identity-Pool aktualisiert wurde
Führen Sie den folgenden Befehl aus, um zu prüfen, ob Ihr Workload Identity-Pool mit der Konfiguration für die Zertifikatsausstellung aktualisiert wurde:
gcloud iam workload-identity-pools describe TRUST_DOMAIN_NAME \
--location="global" \
--project=PROJECT_ID
Ersetzen Sie TRUST_DOMAIN_NAME durch den Namen der Vertrauensdomäne, den Sie zuvor in diesem Dokument zum Aktualisieren des Workload Identity-Pools verwendet haben.
Die entsprechende Befehlsausgabe sieht etwa so aus:
inlineCertificateIssuanceConfig:
caPools:
REGION1: projects/PROJECT_NUMBER1/locations/REGION1/caPools/SUBORDINATE_CA_POOL_ID1,
REGION2: projects/PROJECT_NUMBER2/locations/REGION2/caPools/SUBORDINATE_CA_POOL_ID2
keyAlgorithm: ALGORITHM
lifetime: DURATION
rotationWindowPercentage: ROTATION_WINDOW_PERCENTAGE
mode: TRUST_DOMAIN
name: TRUST_DOMAIN_NAME
state: ACTIVE
Wenn inlineCertificateIssuanceConfig in der Befehlsausgabe nicht vorhanden ist, prüfen Sie, ob Sie die gcloud CLI korrekt konfiguriert haben, um das richtige Projekt für Abrechnung und Kontingent zu verwenden. Möglicherweise müssen Sie auf eine neuere Version der gcloud CLI aktualisieren.
Verwaltete Arbeitslastidentitäten autorisieren, um Zertifikate vom CA-Pool anzufordern
Nachdem Sie die Zertifizierungsstellen an den Workload Identity-Pool gebunden haben, autorisieren Sie verwaltete Arbeitslastidentitäten, Zertifikate vom CA-Pool anzufordern. So autorisieren Sie diese Identitäten:
Weisen Sie der Vertrauensdomäne die IAM-Rolle Anfragesteller des CA Service-Arbeitslastzertifikats (
roles/privateca.workloadCertificateRequester) für jeden untergeordneten CA-Pool zu. Mit dem folgendengcloud privateca pools add-iam-policy-binding-Befehl wird die Vertrauensdomäne autorisiert, Zertifikate von den CA Service-Zertifikatsketten anzufordern.gcloud privateca pools add-iam-policy-binding SUBORDINATE_CA_POOL_ID \ --location=REGION \ --role=roles/privateca.workloadCertificateRequester \ --member="principal://iam.googleapis.com/projects/PROJECT_NUMBER/name/locations/global/workloadIdentityPools/TRUST_DOMAIN_NAME" \ --project=CA_PROJECT_IDErsetzen Sie Folgendes:
SUBORDINATE_CA_POOL_ID: Die ID des Subordinate CA-Pools.REGION: Die Region des untergeordneten CA-Pools.PROJECT_NUMBER: Die Projektnummer des Projekts, das den GKE-Workload Identity-Pool enthält.Führen Sie den folgenden Befehl aus, um
PROJECT_NUMBERaus Ihrem Workload Identity-Poolprojekt abzurufen.gcloud projects describe WORKLOAD_IDENTITY_POOL_PROJECT_ID --format="value(projectNumber)"
WORKLOAD_IDENTITY_POOL_PROJECT_ID: Die Projekt-ID, die den Workload Identity-Pool enthält.TRUST_DOMAIN_NAME: Der Name der Vertrauensdomäne. Formatieren Sie den Namen je nach Pooltyp so:- Von Google verwalteter Pool:
PROJECT_ID. - Selbstverwalteter Pool:
POOL_NAME.global.POOL_HOST_PROJECT_NUMBER.workload.id.goog
- Von Google verwalteter Pool:
CA_PROJECT_ID: Die ID des Projekts, in dem Sie die untergeordnete Zertifizierungsstelle erstellt haben.
Weisen Sie der verwalteten Arbeitslastidentität die Rolle CA Service Pool Reader (
roles/privateca.poolReader) für die untergeordneten CA-Pools zu. Dadurch wird die verwaltete Arbeitslastidentität autorisiert, die signierten X.509-Zertifikate aus den Zertifikatsketten der Zertifizierungsstelle abzurufen.gcloud privateca pools add-iam-policy-binding SUBORDINATE_CA_POOL_ID \ --location=REGION \ --role=roles/privateca.poolReader \ --member="principal://iam.googleapis.com/projects/PROJECT_NUMBER/name/locations/global/workloadIdentityPools/TRUST_DOMAIN_NAME" \ --project=CA_PROJECT_IDErsetzen Sie Folgendes:
SUBORDINATE_CA_POOL_ID: Die ID des Subordinate CA-Pools.REGION: Die Region des untergeordneten CA-Pools.PROJECT_NUMBER: Die Projektnummer des Projekts, das den GKE-Workload Identity-Pool enthält.TRUST_DOMAIN_NAME: Der Name der Vertrauensdomäne. Formatieren Sie den Namen je nach Pooltyp so:- Von Google verwalteter Pool:
PROJECT_ID. - Selbstverwalteter Pool:
POOL_NAME.global.POOL_HOST_PROJECT_NUMBER.workload.id.goog
- Von Google verwalteter Pool:
CA_PROJECT_ID: Die ID des Projekts, in dem Sie die untergeordnete Zertifizierungsstelle erstellt haben.
Arbeitslasten mit verwalteten Arbeitslastidentitäten bereitstellen
Nachdem Sie Ihre CA-Pools so konfiguriert haben, dass sie Zertifikate für verwaltete Arbeitslastidentitäten ausstellen, können Sie Arbeitslasten mit verwalteten Arbeitslastidentitäten bereitstellen.
In diesem Abschnitt erfahren Sie, wie Sie eine Testarbeitslast mit einer verwalteten Arbeitslastidentität bereitstellen. Dazu stellen Sie einen Pod bereit, prüfen, ob Anmeldedaten generiert wurden, und rufen das Zertifikat und die SPIFFE-ID auf.
Pod bereitstellen
Sie können einen Pod bereitstellen, der seine verwaltete Arbeitslastidentität von einem von Google verwalteten Workload Identity-Pool oder einem selbstverwalteten Workload Identity-Pool erhält.
Von Google verwalteter Pool
So stellen Sie einen Test-Pod in Ihrem Cluster bereit:
Rufen Sie die Clusteranmeldedaten ab.
gcloud container clusters get-credentials CLUSTER_NAME \ --location=CLUSTER_ZONE \ --project=CLUSTER_PROJECT_IDErstellen Sie den Kubernetes-Namespace.
kubectl create namespace KUBERNETES_NAMESPACEStellen Sie eine Test-PodSpec bereit.
cat <<EOF | kubectl apply -f - apiVersion: v1 kind: Pod metadata: namespace: KUBERNETES_NAMESPACE name: example-pod spec: containers: - name: main image: debian command: ['sleep', 'infinity'] volumeMounts: - name: fleet-spiffe-credentials mountPath: /var/run/secrets/workload-spiffe-credentials readOnly: true nodeSelector: iam.gke.io/gke-metadata-server-enabled: "true" volumes: - name: fleet-spiffe-credentials csi: driver: podcertificate.gke.io volumeAttributes: signerName: spiffe.gke.io/fleet-svid trustDomain: fleet-project/ EOF
Selbstverwalteter Pool
So stellen Sie einen Test-Pod in Ihrem Cluster mit einem selbstverwalteten Workload Identity-Pool bereit:
Rufen Sie die Clusteranmeldedaten ab.
gcloud container clusters get-credentials CLUSTER_NAME \ --location=CLUSTER_ZONE \ --project=CLUSTER_PROJECT_IDErstellen Sie den Kubernetes-Namespace.
kubectl create namespace KUBERNETES_NAMESPACEStellen Sie eine Test-PodSpec bereit.
Mit der folgenden PodSpec wird das Volume-Attribut
trustDomainfür einen selbstverwalteten Workload Identity-Pool konfiguriert:cat <<EOF | kubectl apply -f - apiVersion: v1 kind: Pod metadata: namespace: KUBERNETES_NAMESPACE name: example-pod spec: containers: - name: main image: debian command: ['sleep', 'infinity'] volumeMounts: - name: fleet-spiffe-credentials mountPath: /var/run/secrets/workload-spiffe-credentials readOnly: true nodeSelector: iam.gke.io/gke-metadata-server-enabled: "true" volumes: - name: fleet-spiffe-credentials csi: driver: podcertificate.gke.io volumeAttributes: signerName: spiffe.gke.io/fleet-svid trustDomain: fleet-project/tenancy-scope EOF
Arbeitslast-Anmeldedaten auflisten
Führen Sie den folgenden Befehl aus, um die Arbeitslast-Anmeldedaten aufzulisten. Es kann einige Minuten dauern, bis die Anmeldedaten erstellt sind.
kubectl exec -it example-pod -n KUBERNETES_NAMESPACE -- ls /var/run/secrets/workload-spiffe-credentials
In der Befehlsausgabe werden die folgenden Dateien aufgeführt:
ca_certificates.pem: Enthält das Stamm-CA-Zertifikat, mit dem das Arbeitslastzertifikat signiert wird.certificates.pem: Enthält das X.509-Zertifikat der Arbeitslast.private_key.pem: Enthält den privaten Schlüssel der Arbeitslast.trust_bundles.json: Enthält eine Zuordnung von Vertrauensdomänen und CA-Zertifikaten, denen für die angegebene Arbeitslast vertraut werden soll. Jeder Eintrag enthält den String der Vertrauensdomäne als Schlüssel und die CA-Zertifikate, die dieser Vertrauensdomäne entsprechen.credential-bundle.pem: Enthält den privaten Schlüssel und das Zertifikat in verketteter Form, sodass eine einzelne Datei für mTLS-Anmeldedaten bereitgestellt wird. Diese Datei ist nur in GKE-Versionen nach 1.35.2-gke.1291000 verfügbar.
Zertifikat ansehen
So rufen Sie das Zertifikat auf:
Exportieren Sie das Zertifikat in eine Zertifikatsdatei.
kubectl exec -it example-pod --namespace=KUBERNETES_NAMESPACE -- cat /var/run/secrets/workload-spiffe-credentials/certificates.pem | openssl x509 -noout -text > certfileSehen Sie sich die Zertifikatsdatei an.
cat certfileIm Zertifikat sehen Sie im Attribut
X509v3 Subject Alternative Namedie SPIFFE-ID. Das Format hängt vom Typ des Workload Identity-Pools ab:- Von Google verwalteter Pool:
spiffe://PROJECT_ID./ns/KUBERNETES_NAMESPACE/sa/default - Selbstverwalteter Pool:
spiffe://POOL_NAME.global.POOL_HOST_PROJECT_NUMBER.workload.id.goog/ns/KUBERNETES_NAMESPACE/sa/default
defaultbezieht sich auf das Kubernetes-Standarddienstkonto.- Von Google verwalteter Pool:
Authentifizierung von Arbeitslast zu Arbeitslast testen
Informationen zum Testen der Authentifizierung zwischen Arbeitslasten finden Sie unter mTLS-Authentifizierung mit Go testen.
Der Beispielcode im Repository erstellt Client- und Server-Arbeitslasten. Sie können die gegenseitige Authentifizierung zwischen den Arbeitslasten mit den Zertifikaten testen, die Sie zuvor in diesem Dokument generiert haben.
Vertrauensföderation zwischen Workload Identity-Pools aktivieren (optional)
Wenn Sie die gegenseitige Authentifizierung für Arbeitslasten in verschiedenen Vertrauensdomänen aktivieren möchten, müssen Sie die Vertrauensföderation zwischen den Workload Identity-Pools konfigurieren. Dieser Schritt ist nur erforderlich, wenn sich Ihre Arbeitslasten bei Arbeitslasten in einem anderen Workload Identity-Pool authentifizieren müssen.
So aktivieren Sie die Vertrauensföderation:
- Konfigurationsdatei für die Vertrauensstellung erstellen
- Workload Identity-Pool mit Vertrauenskonfiguration aktualisieren
Konfigurationsdatei für die Vertrauensstellung erstellen
Erstellen Sie die Vertrauenskonfigurationsdatei mit einem inlineTrustConfig-Abschnitt, in dem die Zertifikate für jede Domain angegeben sind.
Die Konfigurationsdatei für die Vertrauensstellung enthält eine Reihe von Trust-Anchors, die von der verwalteten Arbeitslastidentität zum Validieren von Peer-Zertifikaten verwendet werden. In der Vertrauenskonfigurationsdatei wird die SPIFFE-Vertrauensdomäne CA-Zertifikaten zugeordnet.
Laden Sie für eine benutzerdefinierte Zertifizierungsstelle die Zertifikate für eine Vertrauensdomäne herunter, die eine benutzerdefinierte Zertifizierungsstelle verwendet.
gcloud privateca pools get-ca-certs ROOT_CA_POOL_ID \ --output-file=CERTIFICATE_PATH \ --location=REGIONErsetzen Sie Folgendes:
ROOT_CA_POOL_ID: Die ID des Stamm-CA-Pools.CERTIFICATE_PATH: Der Ausgabepfad für das PEM-codierte Zertifikat.REGION: Die Region des Stamm-CA-Pools.
Erstellen Sie eine Datei mit dem Namen
tc.json, die Ihre Inline-Vertrauenskonfiguration enthält. Wenn eine Domain die von Google verwaltete Standardzertifizierungsstelle verwendet, verwenden Sie das FeldtrustDefaultSharedCa. Wenn eine Domain eine benutzerdefinierte Zertifizierungsstelle verwendet, verwenden Sie die zuvor heruntergeladenen PEM-codierten Zertifikate.Die Datei sieht dann ungefähr so aus:
In diesem Beispiel verwendet TRUST_DOMAIN_A die von Google verwaltete Standard-CA und TRUSTED_DOMAIN_B eine benutzerdefinierte CA mit den heruntergeladenen Root-Zertifikaten.
{ "inlineTrustConfig": { "additionalTrustBundles": { "TRUST_DOMAIN_A": { "trustDefaultSharedCa": true }, "TRUSTED_DOMAIN_B": { "trustAnchors": [ { "pemCertificate": "-----BEGIN CERTIFICATE-----\nCERTIFICATE_MATERIAL1\n-----END CERTIFICATE-----" }, { "pemCertificate": "-----BEGIN CERTIFICATE-----\nCERTIFICATE_MATERIAL2\n-----END CERTIFICATE-----" } ] } } } }Ersetzen Sie Folgendes:
- TRUST_DOMAIN_A: Der Name der Vertrauensdomäne, die die von Google verwaltete Standard-Zertifizierungsstelle verwendet.
- TRUST_DOMAIN_B: Der Name der Vertrauensdomäne, die eine benutzerdefinierte Zertifizierungsstelle verwendet.
- CERTIFICATE_MATERIAL: Eine Reihe von CA-Zertifikaten im PEM-Format, denen bei der Ausstellung von Zertifikaten in der Vertrauensdomäne vertraut wird.
Workload Identity-Pool mit Vertrauenskonfiguration aktualisieren
gcloud iam workload-identity-pools update TRUST_DOMAIN_NAME \
--location="global" \
--inline-trust-config-file=TC_JSON_FILE_PATH \
--project=PROJECT_ID
Ersetzen Sie Folgendes:
- TRUST_DOMAIN_NAME: Der Name der Vertrauensdomäne.
- TC_JSON_FILE_PATH: Der Pfad zur von Ihnen erstellten JSON-formatierten Vertrauenskonfigurationsdatei (
tc.json). - PROJECT_ID: die Projekt-ID
Nächste Schritte
- Fehlerbehebung bei verwalteter Arbeitslastidentität für GKE
- Weitere Informationen zum Erstellen von CA-Pools.