IAM-Richtlinien konfigurieren
Auf dieser Seite wird beschrieben, wie Sie IAM-Richtlinien (Identity and Access Management) konfigurieren, mit denen Mitglieder Ressourcen des Certificate Authority Service erstellen und verwalten können. Weitere Informationen zu IAM finden Sie in der IAM-Übersicht.
Allgemeine IAM-Richtlinien
Im CA-Dienst gewähren Sie Nutzern oder Dienstkonten IAM-Rollen zum Erstellen und Verwalten von CA-Dienstressourcen. Sie können diese Rollenbindungen auf den folgenden Ebenen hinzufügen:
- CA-Poolebene zum Verwalten des Zugriffs für einen bestimmten CA-Pool und für die CAs in diesem CA-Pool.
- Projektebene oder Organisationsebene, um Zugriff auf alle CA-Pools in diesem Umfang zu gewähren.
Rollen werden übernommen, wenn sie auf einer höheren Ressourcenebene gewährt werden. Ein Nutzer, dem die Rolle „Auditor“ (roles/privateca.auditor
) auf Projektebene zugewiesen ist, kann sich beispielsweise alle Ressourcen im Projekt ansehen. IAM-Richtlinien, die für einen CA-Pool (Certificate Authority) festgelegt sind, werden von allen CAs in diesem CA-Pool übernommen.
IAM-Rollen können nicht für Zertifikate und CA-Ressourcen gewährt werden.
Bedingte IAM-Richtlinien
Wenn Sie einen freigegebenen Zertifizierungsstellenpool haben, der von mehreren Nutzern verwendet werden kann, die berechtigt sind, verschiedene Arten von Zertifikaten anzufordern, können Sie IAM-Bedingungen definieren, um den attributbasierten Zugriff auf bestimmte Vorgänge für einen Zertifizierungsstellenpool zu erzwingen.
Mit bedingten IAM-Rollenbindungen können Sie Hauptkonten nur dann Zugriff gewähren, wenn die angegebenen Bedingungen erfüllt sind. Wenn die Rolle Zertifikatanfragesteller beispielsweise an den Nutzer alice@example.com
in einem CA-Pool gebunden ist, wobei die angeforderten DNS-SANs eine Teilmenge von ['alice@example.com', 'bob@example.com']
sind, kann dieser Nutzer nur dann Zertifikate aus demselben CA-Pool anfordern, wenn das angeforderte SAN einer dieser beiden zulässigen Werte ist. Sie können Bedingungen für IAM-Bindungen mit Common Expression Language (CEL)-Ausdrücken festlegen. Mit diesen Bedingungen können Sie die Art der Zertifikate, die ein Nutzer anfordern kann, weiter einschränken. Informationen zur Verwendung von CEL-Ausdrücken für IAM-Bedingungen finden Sie unter Common Expression Language (CEL)-Dialekt für IAM-Richtlinien.
Hinweise
- API aktivieren.
- Folgen Sie der Anleitung in einem der Quickstarts, um eine Zertifizierungsstelle und einen CA-Pool zu erstellen.
- IAM, die für den Certificate Authority Service verfügbar sind
IAM-Richtlinienbindungen auf Projektebene konfigurieren
In den folgenden Szenarien wird beschrieben, wie Sie Nutzern auf Projektebene Zugriff auf CA-Dienstressourcen gewähren können.
Ressourcen verwalten
Ein CA Service Admin (roles/privateca.admin
) hat die Berechtigungen zum Verwalten aller CA Service-Ressourcen und zum Festlegen von IAM-Richtlinien für CA-Pools und Zertifikatvorlagen.
So weisen Sie einem Nutzer auf Projektebene die Rolle „CA-Dienstadministrator“ (roles/privateca.admin
) zu:
Console
Öffnen Sie in der Google Cloud Console die Seite IAM.
Wählen Sie das Projekt aus.
Klicken Sie auf
Zugriff erlauben.Geben Sie im Feld Neue Hauptkonten die E-Mail-Adresse oder eine andere Kennung des Hauptkontos ein.
Wählen Sie in der Liste Rolle auswählen die Rolle CA-Dienstadministrator aus.
Klicken Sie auf Speichern.
gcloud
gcloud projects add-iam-policy-binding PROJECT_ID \
--member=MEMBER \
--role=roles/privateca.admin
Ersetzen Sie Folgendes:
- PROJECT_ID: die eindeutige Kennung des Projekts.
- MEMBER: Das Nutzer- oder Dienstkonto, dem Sie die Rolle „CA-Dienstadministrator“ zuweisen möchten.
Für das Flag --role
wird die IAM-Rolle verwendet, die Sie dem Mitglied zuweisen möchten.
Ressourcen erstellen
Ein Operation Manager für CA Service (roles/privateca.caManager
) kann CA-Pools und CAs erstellen, aktualisieren und löschen. Mit dieser Rolle kann der Aufrufer auch Zertifikate widerrufen, die von den Zertifizierungsstellen im CA-Pool ausgestellt wurden.
So weisen Sie einem Nutzer auf Projektebene die Rolle „CA Service Operation Manager“ (roles/privateca.caManager
) zu:
Console
Öffnen Sie in der Google Cloud Console die Seite IAM.
Wählen Sie das Projekt aus.
Klicken Sie auf
Zugriff erlauben.Geben Sie im Feld Neue Hauptkonten die E-Mail-Adresse oder eine andere Kennung des Hauptkontos ein.
Wählen Sie in der Liste Rolle auswählen die Rolle CA Service Operation Manager aus.
Klicken Sie auf Speichern.
gcloud
gcloud projects add-iam-policy-binding PROJECT_ID \
--member=MEMBER \
--role=roles/privateca.caManager
Ersetzen Sie Folgendes:
- PROJECT_ID: die eindeutige Kennung des Projekts.
- MEMBER: Das Nutzer- oder Dienstkonto, dem Sie die IAM-Rolle hinzufügen möchten.
Für das Flag --role
wird die IAM-Rolle verwendet, die Sie dem Mitglied zuweisen möchten.
Weitere Informationen zum Befehl gcloud projects add-iam-policy-binding
finden Sie unter gcloud projects add-iam-policy-binding.
Optional muss der Aufrufer auch Administrator für den Cloud KMS-Schlüssel sein, wenn er eine Zertifizierungsstelle mit einem vorhandenen Cloud KMS-Schlüssel erstellen möchte.
Der Cloud KMS-Administrator (roles/cloudkms.admin
) hat vollständigen Zugriff auf alle Cloud KMS-Ressourcen mit Ausnahme der Verschlüsselungs- und Entschlüsselungsvorgänge. Weitere Informationen zu IAM-Rollen für Cloud KMS finden Sie unter Cloud KMS: Berechtigungen und Rollen.
So gewähren Sie einem Nutzer die Rolle „Cloud KMS-Administrator“ (roles/cloudkms.admin
):
Console
Rufen Sie in der Google Cloud Console die Seite Cloud Key Management Service auf.
Klicken Sie unter Schlüsselbunde auf den Schlüsselbund, der den Signaturschlüssel der Zertifizierungsstelle enthält.
Klicken Sie auf den Schlüssel, der der Signaturschlüssel der Zertifizierungsstelle ist.
Wenn das Infofeld nicht sichtbar ist, klicken Sie auf Infofeld ansehen. Klicken Sie dann auf Berechtigungen.
Klicken Sie auf
Hauptkonto hinzufügen.Geben Sie im Feld Neue Hauptkonten die E-Mail-Adresse oder eine andere Kennung des Hauptkontos ein.
Wählen Sie in der Liste Rolle auswählen die Rolle Cloud KMS Admin aus.
Klicken Sie auf Speichern.
gcloud
gcloud kms keys add-iam-policy-binding KEY \
--keyring=KEYRING --location=LOCATION \
--member=MEMBER \
--role=roles/cloudkms.admin
Ersetzen Sie Folgendes:
- KEY: die eindeutige Kennung des Schlüssels.
- KEYRING: Der Schlüsselbund, der den Schlüssel enthält. Weitere Informationen zu Schlüsselanhängern finden Sie unter Schlüsselanhänger.
- MEMBER: Der Nutzer oder das Dienstkonto, dem Sie die IAM-Bindung hinzufügen möchten.
Für das Flag --role
wird die IAM-Rolle verwendet, die Sie dem Mitglied zuweisen möchten.
Weitere Informationen zum Befehl gcloud kms keys add-iam-policy-binding
finden Sie unter gcloud kms keys add-iam-policy-binding.
Ressourcen prüfen
Ein CA Service-Auditor (roles/privateca.auditor
) hat Lesezugriff auf alle Ressourcen im CA-Dienst. Wenn er für einen bestimmten CA-Pool gewährt wird, gewährt er Lesezugriff auf den CA-Pool. Wenn sich der CA-Pool in der Enterprise-Stufe befindet, kann der Nutzer mit dieser Rolle auch Zertifikate und CRLs aufrufen, die von den Zertifizierungsstellen im CA-Pool ausgestellt wurden. Weisen Sie diese Rolle Personen zu, die für die Validierung der Sicherheit und des Betriebs des CA-Pools verantwortlich sind.
So weisen Sie einem Nutzer die Rolle „CA-Dienstrevisor“ (roles/privateca.auditor
) auf Projektebene zu:
Console
Öffnen Sie in der Google Cloud Console die Seite IAM.
Wählen Sie das Projekt aus.
Klicken Sie auf
Zugriff erlauben.Geben Sie im Feld Neue Hauptkonten die E-Mail-Adresse oder eine andere Kennung des Hauptkontos ein.
Wählen Sie in der Liste Rolle auswählen die Rolle CA Service Auditor aus.
Klicken Sie auf Speichern.
gcloud
gcloud projects add-iam-policy-binding PROJECT_ID \
--member=MEMBER \
--role=roles/privateca.auditor
Ersetzen Sie Folgendes:
- PROJECT_ID: die eindeutige Kennung des Projekts.
- MEMBER: Die eindeutige Kennung des Nutzers, dem Sie die Rolle „CA Service Auditor“ (
roles/privateca.auditor
) zuweisen möchten.
Für das Flag --role
wird die IAM-Rolle verwendet, die Sie dem Mitglied zuweisen möchten.
IAM-Richtlinienbindungen auf Ressourcenebene konfigurieren
In diesem Abschnitt wird beschrieben, wie Sie IAM-Richtlinienbindungen für eine bestimmte Ressource im CA-Dienst konfigurieren.
CA-Pools verwalten
Sie können die Rolle „CA Service Admin“ (roles/privateca.admin
) auf Ressourcenebene gewähren, um einen bestimmten CA-Pool oder eine bestimmte Zertifikatsvorlage zu verwalten.
Console
Rufen Sie in der Google Cloud Console die Seite Certificate Authority Service auf.
Klicken Sie auf den Tab CA-Poolmanager und wählen Sie den CA-Pool aus, für den Sie Berechtigungen gewähren möchten.
Wenn das Infofeld nicht sichtbar ist, klicken Sie auf Infofeld ansehen. Klicken Sie dann auf Berechtigungen.
Klicken Sie auf
Hauptkonto hinzufügen.Geben Sie in das Feld Neue Hauptkonten die E-Mail-Adresse oder die andere Kennung des Hauptkontos ein.
Wählen Sie in der Liste Rolle auswählen die Rolle CA-Dienstadministrator aus.
Klicken Sie auf Speichern. Dem Hauptkonto wird die ausgewählte Rolle für die CA-Pool-Ressource zugewiesen.
gcloud
Führen Sie den folgenden Befehl aus, um die IAM-Richtlinie festzulegen:
gcloud privateca pools add-iam-policy-binding POOL_ID \
--location LOCATION \
--member MEMBER \
--role roles/privateca.admin
Ersetzen Sie Folgendes:
- POOL_ID: Die eindeutige Kennung des CA-Pools, für den Sie die IAM-Richtlinie festlegen möchten.
- LOCATION: der Standort des CA-Pools. Eine vollständige Liste der Standorte finden Sie unter Standorte.
- MEMBER: Der Nutzer oder das Dienstkonto, dem Sie die IAM-Rolle zuweisen möchten.
Für das Flag --role
wird die IAM-Rolle verwendet, die Sie dem Mitglied zuweisen möchten.
Weitere Informationen zum Befehl gcloud privateca pools add-iam-policy-binding
finden Sie unter gcloud privateca pools add-iam-policy-binding.
Führen Sie dieselben Schritte aus, um der Rolle CA-Dienstadministrator eine Zertifikatvorlage zuzuweisen.
Sie können auch die Rolle „Operation Manager für CA Service“ (roles/privateca.caManager
) für einen bestimmten CA-Pool gewähren. Mit dieser Rolle kann der Aufrufer Zertifikate widerrufen, die von Zertifizierungsstellen in diesem CA-Pool ausgestellt wurden.
Console
Rufen Sie in der Google Cloud Console die Seite Certificate Authority Service auf.
Klicken Sie auf den Tab CA-Poolmanager und wählen Sie den CA-Pool aus, für den Sie Berechtigungen gewähren möchten.
Wenn das Infofeld nicht sichtbar ist, klicken Sie auf Infofeld ansehen. Klicken Sie dann auf Berechtigungen.
Klicken Sie auf
Hauptkonto hinzufügen.Geben Sie in das Feld Neue Hauptkonten die E-Mail-Adresse oder die andere Kennung des Hauptkontos ein.
Wählen Sie in der Liste Rolle auswählen die Rolle CA Service Operation Manager aus.
Klicken Sie auf Speichern. Dem Hauptkonto wird die ausgewählte Rolle für die CA-Poolressource zugewiesen, zu der die Zertifizierungsstelle gehört.
gcloud
Führen Sie den folgenden gcloud
-Befehl aus, um die Rolle für einen bestimmten CA-Pool zu gewähren:
gcloud privateca pools add-iam-policy-binding POOL_ID \
--location LOCATION \
--member MEMBER \
--role roles/privateca.caManager
Ersetzen Sie Folgendes:
- POOL_ID: die eindeutige Kennung des CA-Pools.
- LOCATION: der Standort des CA-Pools. Eine vollständige Liste der Standorte finden Sie unter Standorte.
- MEMBER: Die eindeutige Kennung des Nutzers, dem Sie die Rolle „CA Service Operation Manager (
roles/privateca.caManager
)“ zuweisen möchten.
Für das Flag --role
wird die IAM-Rolle verwendet, die Sie dem Mitglied zuweisen möchten.
Weitere Informationen zum Befehl gcloud privateca pools add-iam-policy-binding
finden Sie unter gcloud privateca pools add-iam-policy-binding.
Zertifikate erstellen
Weisen Sie Nutzern die Rolle „Zertifikatverwalter für CA Service“ (roles/privateca.certificateManager
) zu, damit sie Anfragen zur Zertifikatsausstellung an einen CA-Pool senden können. Diese Rolle gewährt außerdem Lesezugriff auf CA Service-Ressourcen. Wenn Sie nur die Erstellung von Zertifikaten ohne Lesezugriff zulassen möchten, weisen Sie die Rolle „CA Service-Zertifikatsanfragesteller“ (roles/privateca.certificateRequester
) zu. Weitere Informationen zu IAM-Rollen für den CA-Dienst finden Sie unter Zugriffssteuerung mit IAM.
So gewähren Sie dem Nutzer Zugriff zum Erstellen von Zertifikaten für eine bestimmte Zertifizierungsstelle:
Console
Rufen Sie in der Google Cloud Console die Seite Certificate Authority Service auf.
Klicken Sie auf CA-Poolmanager und wählen Sie den CA-Pool aus, für den Sie Berechtigungen gewähren möchten.
Wenn das Infofeld nicht sichtbar ist, klicken Sie auf Infofeld ansehen. Klicken Sie dann auf Berechtigungen.
Klicken Sie auf
Hauptkonto hinzufügen.Geben Sie in das Feld Neue Hauptkonten die E-Mail-Adresse oder die andere Kennung des Hauptkontos ein.
Wählen Sie in der Liste Rolle auswählen die Rolle CA Service Certificate Manager aus.
Klicken Sie auf Speichern. Dem Hauptkonto wird die ausgewählte Rolle für die CA-Poolressource zugewiesen, zu der die Zertifizierungsstelle gehört.
gcloud
gcloud privateca pools add-iam-policy-binding 'POOL_ID' \
--location LOCATION \
--member MEMBER \
--role roles/privateca.certificateManager
Ersetzen Sie Folgendes:
- POOL_ID: die eindeutige Kennung des CA-Pools.
- LOCATION: der Standort des CA-Pools. Eine vollständige Liste der Standorte finden Sie unter Standorte.
- MEMBER: Die eindeutige Kennung des Nutzers, dem Sie die Rolle „Zertifikatverwalter für CA Service“ (
roles/privateca.certificateManager
) zuweisen möchten.
Für das Flag --role
wird die IAM-Rolle verwendet, die Sie dem Mitglied zuweisen möchten.
IAM-Richtlinienbindungen zu einer Zertifikatvorlage hinzufügen
So fügen Sie einer bestimmten Zertifikatvorlage eine IAM-Richtlinie hinzu:
Console
Rufen Sie in der Google Cloud Console die Seite Certificate Authority Service auf.
Klicken Sie auf den Tab Vorlagenmanager und wählen Sie die Zertifikatvorlage aus, für die Sie Berechtigungen gewähren möchten.
Wenn das Infofeld nicht sichtbar ist, klicken Sie auf Infofeld ansehen. Klicken Sie dann auf Berechtigungen.
Klicken Sie auf
Hauptkonto hinzufügen.Geben Sie in das Feld Neue Hauptkonten die E-Mail-Adresse oder die andere Kennung des Hauptkontos ein.
Wählen Sie in der Drop-down-Liste Rolle auswählen eine Rolle aus.
Klicken Sie auf Speichern.
gcloud
gcloud privateca templates add-iam-policy-binding TEMPLATE_ID \
--location=LOCATION \
--member=MEMBER \
--role=ROLE
Ersetzen Sie Folgendes:
- LOCATION: der Speicherort der Zertifikatsvorlage. Eine vollständige Liste der Standorte finden Sie unter Standorte.
- MEMBER: Der Nutzer oder das Dienstkonto, dem Sie die IAM-Richtlinienbindung hinzufügen möchten.
- ROLE: die Rolle, die Sie dem Mitglied zuweisen möchten.
Weitere Informationen zum Befehl gcloud privateca templates add-iam-policy-binding
finden Sie unter gcloud privateca templates add-iam-policy-binding.
Weitere Informationen zum Ändern der IAM-Rolle eines Nutzers finden Sie unter Zugriff gewähren.
IAM-Richtlinienbindungen entfernen
Sie können eine vorhandene IAM-Richtlinienbindung mit dem Befehl remove-iam-policy-binding
der Google Cloud CLI entfernen.
Verwenden Sie den folgenden gcloud
-Befehl, um eine IAM-Richtlinie für einen bestimmten CA-Pool zu entfernen:
gcloud
gcloud privateca pools remove-iam-policy-binding POOL_ID \
--location=LOCATION \
--member=MEMBER \
--role=ROLE
Ersetzen Sie Folgendes:
- LOCATION: der Standort des CA-Pools. Eine vollständige Liste der Standorte finden Sie unter Standorte.
- MEMBER: Der Nutzer oder das Dienstkonto, für das Sie die IAM-Richtlinienbindung entfernen möchten.
- ROLE: die Rolle, die Sie für das Mitglied entfernen möchten.
Weitere Informationen zum Befehl gcloud privateca pools remove-iam-policy-binding
finden Sie unter gcloud privateca pools remove-iam-policy-binding.
Verwenden Sie den folgenden gcloud
-Befehl, um eine IAM-Richtlinie für eine bestimmte Zertifikatvorlage zu entfernen:
gcloud
gcloud privateca templates remove-iam-policy-binding TEMPLATE_ID \
--location=LOCATION \
--member=MEMBER \
--role=ROLE
Ersetzen Sie Folgendes:
- LOCATION: der Speicherort der Zertifikatsvorlage. Eine vollständige Liste der Standorte finden Sie unter Standorte.
- MEMBER: Der Nutzer oder das Dienstkonto, für das Sie die IAM-Richtlinienbindung entfernen möchten.
- ROLE: die Rolle, die Sie für das Mitglied entfernen möchten.
Weitere Informationen zum Befehl gcloud privateca templates remove-iam-policy-binding
finden Sie unter gcloud privateca templates remove-iam-policy-binding.
Weitere Informationen zum Entfernen der IAM-Rolle eines Nutzers finden Sie unter Zugriff widerrufen.
Nächste Schritte
- Sehen Sie sich die IAM-Rollen für den CA-Dienst und die zugehörigen Berechtigungen an.
- Weitere Informationen zu Vorlagen und Richtlinien für die Ausstellung
- Informationen zum Verwalten von Richtliniensteuerungen