Jedes Subjekt – ein Nutzer oder eine Gruppe – durchläuft einen zweistufigen Prozess, um Zugriff auf den Management API-Server und den Kubernetes-Cluster zu erhalten:
Zugriff auf den Management API-Server: Gewähren Sie einem Subjekt mit Berechtigungen auf dem Management API-Server über
ClusterRoleBindingoderRoleBindingZugriff auf eine vordefinierteClusterRole.Kubernetes-Clusterzugriff:Gewähren Sie namespace- oder clusterweiten Zugriff.
Namespace-spezifischer Zugriff:Wenn Sie Zugriff auf den Namespace eines bestimmten Projekts im Cluster gewähren möchten, erstellen Sie eine
ProjectRoleund die entsprechendeProjectRoleBinding. Bei diesem Prozess wird ein Kubernetes-RoleundRoleBindingan ein Kubernetes-Namespaceim Cluster weitergegeben, das demProjectentspricht, dem dasProjectRoleundProjectRoleBindingzugeordnet sind.Clusterweiter Zugriff:Wenn Sie Zugriff auf alle Namespaces im Cluster gewähren möchten, erstellen Sie eine
OrganizationRoleund die entsprechendeOrganizationRoleBinding. Bei diesem Vorgang werden ein Kubernetes-ClusterRoleund einClusterRoleBindingauf den gesamten Kubernetes-Cluster übertragen.
Diese Seite richtet sich an Nutzer in der Gruppe der Plattformadministratoren, die Berechtigungen in ihrer Organisation verwalten.
Sowohl der Organisations-IAM-Administrator als auch der Projekt-IAM-Administrator können weitere Projektrollen und Projektrollenbindungen erstellen, um zusätzliche projektspezifische Berechtigungen zu gewähren. IAM-Administratoren der Organisation können jedoch Projektrollen und Projektrollenzuweisungen für jedes Projekt erstellen. Projekt-IAM-Administratoren können hingegen nur Projektrollen und Projektrollenzuweisungen für Projekte erstellen, auf die sie Zugriff haben.
Hinweis
Bevor Sie Rollenbindungen verwalten oder den Zugriff widerrufen können, müssen Sie die erforderlichen Berechtigungen anfordern und Ihre Umgebung vorbereiten. Die erforderlichen Rollen hängen davon ab, ob Sie Rollenbindungen verwalten oder den Nutzerzugriff widerrufen.
IAM-Rollen anfordern
Wenden Sie sich an Ihren IAM-Administrator der Organisation, um die Rollen anzufordern, die Sie für die Ausführung der Aufgaben benötigen:
- Organisations-IAM-Administrator (
organization-iam-admin): Er kann Rollenbindungen auf Organisations- und Projektebene erstellen, aktualisieren und löschen. - Org Session Admin (
org-session-admin): Aktive Sitzungen und den Zugriff eines Nutzers in einer bestimmten Zone widerrufen.
Umgebung vorbereiten
Wenn Sie die Befehlszeilentools zum Verwalten von Rollenbindungen oder zum Widerrufen des Zugriffs verwenden möchten, führen Sie die folgenden Schritte aus.
- Laden Sie die gcloud CLI herunter und installieren Sie sie, falls noch nicht geschehen.
- Wenn Sie die API mit
kubectlverwenden möchten, ist eine zusätzliche Einrichtung erforderlich:
Rollenbindungen einrichten
Sie können Rollenbindungen einrichten, die Teammitgliedern Zugriff auf Ressourcen auf Organisations- oder Projektebene gewähren.
Bitten Sie Ihren Organisations-IAM-Administrator, Ihnen die Rolle „Organisations-IAM-Administrator“ zuzuweisen, damit Sie die Berechtigungen erhalten, die Sie zum Einrichten von Rollenbindungen benötigen.
So weisen Sie einem autorisierten Mitglied eine Rolle zu:
Console
- Melden Sie sich in der GDC-Konsole an.
- Klicken Sie auf Projekt auswählen, um eine Organisation oder ein Projekt auszuwählen.
- Wenn Sie Rollenbindungen für eine Organisation einrichten möchten, wählen Sie eine Organisation aus.
- Wählen Sie ein Projekt aus, um Rollenbindungen für ein Projekt einzurichten.
- Klicken Sie im Navigationsmenü auf Identität und Zugriff > Zugriff.
- Klicken Sie auf Mitglied hinzufügen.
- Wählen Sie in der Liste Identitätsanbieter einen Identitätsanbieter aus.
- Wählen Sie aus, ob Sie einzelne Nutzer oder Gruppen hinzufügen möchten.
- Geben Sie im Feld Nutzername oder Gruppenalias den Nutzernamen, die E-Mail-Adresse oder den Alias ein.
- Wählen Sie in der Liste Rolle die Rolle aus, die Sie dem Nutzer oder der Gruppe zuweisen möchten, z. B. Organisationsbetrachter auf Organisationsebene oder Projektersteller auf Projektebene.
- Klicken Sie auf Hinzufügen.
Das Mitglied wird in der Liste Autorisiertes Mitglied angezeigt.
gdcloud
Prüfen Sie, ob die gcloud CLI installiert ist.
Melden Sie sich mit dem Befehl
gdcloud auth loginan, um sich bei Ihrem Identitätsanbieter zu authentifizieren. Weitere Informationen finden Sie unter gdcloud CLI-Authentifizierung.Rollenbindungen einrichten
Rollenbindungen für eine Organisation einrichten:
gdcloud organizations add-iam-policy-binding root \ --member=USER_ACCOUNT \ --role=ROLE_TYPE/ROLEErsetzen Sie die folgenden Variablen:
USER_ACCOUNT: Das Nutzerkonto, dem Sie die Rolle zuweisen möchten. Dieses Flag akzeptiert entweder eine Nutzer-E-Mail-Adresse mit dem Identitätsanbieterpräfix (user:idpprefix-user@example.com) oder einen Dienstkontonamen mit dem Dienstkontoprojekt (serviceAccount:projectName:serviceAccountName).ROLE_TYPE: dieClusterRole,RoleoderOrganizationRole, für die Sie die Rollenbindung einrichten.ROLE: der Name der vordefinierten oder benutzerdefinierten Rolle, die Sie dem Nutzer zuweisen möchten, z. B.project-creator.
Rollenbindungen für ein Projekt einrichten:
gdcloud projects add-iam-policy-binding PROJECT \ --member=USER_ACCOUNT \ --role=ROLE_TYPE/ROLEErsetzen Sie die folgenden Variablen:
PROJECT: der Name des Projekts, für das Sie die Rollenbindung einrichten.USER_ACCOUNT: Das Nutzerkonto, dem Sie die Rolle zuweisen möchten. Dieses Flag akzeptiert entweder eine Nutzer-E-Mail-Adresse mit dem Identitätsanbieterpräfix (user:idpprefix-user@example.com) oder einen Dienstkontonamen mit dem Dienstkontoprojekt (serviceAccount:projectName:serviceAccountName).ROLE_TYPE: dieRoleoderProjectRole, für die Sie die Rollenbindung einrichten.ROLE: der Name der vordefinierten oder benutzerdefinierten Rolle, die Sie dem Nutzer zuweisen möchten, z. B.project-viewer.
API
Exportieren Sie die Umgebungsvariablen für die Rollenbindung:
export YOUR_IAM_ADMIN_KUBECONFIG=YOUR_IAM_ADMIN_KUBECONFIG export USERNAME=IDP_PREFIX-USERNAME export ROLE_NAME=ROLE_NAME export USER_EMAIL=IDP_PREFIX-USER_EMAILErsetzen Sie Folgendes:
YOUR_IAM_ADMIN_KUBECONFIG: der Pfad zur kubeconfig-Datei für den IAM-Administrator.IDP_PREFIX: das Präfix des Identitätsanbieters.USERNAME: Der Nutzername der E-Mail-Adresse des Nutzers vor dem Symbol@(z. B.paulauspaul@example.com).ROLE_NAME: Der Name der Rolle, die der Nutzer benötigt, z. B.project-creator. Weitere Informationen zur Rolle finden Sie unter Rollendefinitionen.USER_EMAIL: Die E-Mail-Adresse des Nutzerkontos, dem Sie die Rolle zuweisen möchten, z. B.paul@example.com.
Weisen Sie einem Nutzer eine
ClusterRole,Role,ProjectRoleoderOrganizationRolezu:So weisen Sie einem Nutzer eine
ClusterRolezu:kubectl create --kubeconfig ${YOUR_IAM_ADMIN_KUBECONFIG} \ clusterrolebinding ${USERNAME}-${ROLE_NAME}-binding \ --clusterrole=${ROLE_NAME} --user=${USER_EMAIL}Wenn für eine
ClusterRoleanstelle einerClusterRoleBindingeineRoleBindingerforderlich ist, finden Sie in den Rollendefinitionen heraus, welcher Bindungstyp für die Rolle erforderlich ist. Erstellen Sie dann eine RoleBinding im Namespacegpc-system:kubectl create --kubeconfig ${YOUR_IAM_ADMIN_KUBECONFIG} \ rolebinding ${USERNAME}-${ROLE_NAME}-binding \ --clusterrole=${ROLE_NAME} --user=${USER_EMAIL} --namespace=gpc-systemSo weisen Sie einem Nutzer eine
Rolezu:Exportieren Sie den Namespace, in dem die Bindung erstellt werden muss:
export BINDING_NAMESPACE=BINDING_NAMESPACEFühren Sie die folgenden Befehle aus, um eine
RoleBindingzu erstellen:kubectl create --kubeconfig ${YOUR_IAM_ADMIN_KUBECONFIG} \ rolebinding ${USERNAME}-${ROLE_NAME}-binding \ --role=${ROLE_NAME} --user=${USER_EMAIL} --namespace=${BINDING_NAMESPACE}
So weisen Sie einem Nutzer eine
ProjectRolezu:projectrolebinding.yaml-Datei erstellen:apiVersion: resourcemanager.gdc.goog/v1 kind: ProjectRoleBinding metadata: name: BINDING_NAME namespace: PROJECT_NAME spec: roleRef: apiGroup: resourcemanager.gdc.goog kind: ProjectRole name: ROLE_NAME subjects: - apiGroup: rbac.authorization.k8s.io kind: USER_KIND name: IDP_PREFIX-USER_EMAILErsetzen Sie Folgendes:
BINDING_NAME: Ein Name für die Bindung, den der Nutzer anpassen kann, z. B.user-project-creator-binding.PROJECT_NAME: der Name des Projekts, dem Sie die Rolle zuweisen.ROLE_NAME: der Name derProjectRole, die Sie dem Nutzer zuweisen.USER_KIND: die Art des Nutzers, dieUser,GroupoderServiceAccountsein kann.IDP_PREFIX: das Präfix des Identitätsanbieters.USER_EMAIL: Die E-Mail-Adresse des Nutzerkontos, dem Sie die Rolle zuweisen möchten (z. B.paul@example.com).
Wenden Sie die Datei
projectrolebinding.yamlan:kubectl create -f projectrolebinding.yaml
So weisen Sie einem
OrganizationRoleeinen Nutzer zu:Erstellen Sie eine
organizationrolebinding.yaml-Datei:apiVersion: resourcemanager.gdc.goog/v1 kind: OrganizationRoleBinding metadata: name: BINDING_NAME namespace: gpc-system spec: roleRef: apiGroup: resourcemanager.gdc.goog kind: OrganizationRole name: ROLE_NAME subjects: - apiGroup: rbac.authorization.k8s.io kind: USER_KIND name: IDP_PREFIX-USER_EMAILErsetzen Sie Folgendes:
BINDING_NAME: Ein Name für die Bindung, den der Nutzer anpassen kann, z. B.user-organization-creator-binding.ROLE_NAME: der Name derOrganizationRole, die Sie dem Nutzer zuweisen.USER_KIND: die Art des Nutzers, dieUser,GroupoderServiceAccountsein kann.IDP_PREFIX: das Präfix des Identitätsanbieters.USER_EMAIL: Die E-Mail-Adresse des Nutzerkontos, dem Sie die Rolle zuweisen möchten (z. B.paul@example.com).
Wenden Sie die
organizationrolebinding.yaml-YAML-Datei an:kubectl create -f organizationrolebinding.yaml
Rollenbindungen entfernen
Wenn der Zugriff nicht mehr erforderlich ist, entfernen Sie das Mitglied und die zugehörigen Rollen, Berechtigungen und den Zugriff.
So entfernst du Mitglieder:
Console
- Melden Sie sich in der GDC-Konsole an.
- Klicken Sie im Navigationsmenü auf Identität und Zugriff > Zugriff.
- Wählen Sie in der Liste Autorisierte Mitglieder ein Mitglied aus.
- Klicken Sie auf Mitglied entfernen.
- Klicken Sie zur Bestätigung auf Mitglied entfernen.
gdcloud
Prüfen Sie, ob die gcloud CLI installiert ist.
Melden Sie sich mit dem Befehl
gdcloud auth loginan, um sich bei Ihrem Identitätsanbieter zu authentifizieren. Weitere Informationen finden Sie unter gdcloud CLI-Authentifizierung.Entfernen Sie Rollenbindungen.
So entfernen Sie Rollenbindungen für eine Organisation:
gdcloud organizations remove-iam-policy-binding root \ --member=USER_ACCOUNT \ --role=ROLE_TYPE/ROLEErsetzen Sie die folgenden Variablen:
USER_ACCOUNT: Das Nutzerkonto, aus dem Sie die Rolle entfernen möchten. Dieses Flag akzeptiert entweder eine Nutzer-E-Mail-Adresse mit dem Identitätsanbieterpräfix (user:idpprefix-user@example.com) oder einen Dienstkontonamen mit dem Dienstkontoprojekt (serviceAccount:projectName:serviceAccountName).ROLE_TYPE: dieClusterRole,RoleoderOrganizationRole, für die Sie die Rollenbindung entfernen.ROLE: Der Name der vordefinierten oder benutzerdefinierten Rolle, die Sie aus dem Nutzerkonto entfernen möchten, z. B.project-creator.
Rollenbindungen für ein Projekt entfernen:
gdcloud projects remove-iam-policy-binding PROJECT \ --member=USER_ACCOUNT \ --role=ROLE_TYPE/ROLEErsetzen Sie die folgenden Variablen:
PROJECT: der Name des Projekts, aus dem Sie die Rollenbindung entfernen.USER_ACCOUNT: Das Nutzerkonto, aus dem Sie die Rolle entfernen möchten. Dieses Flag akzeptiert entweder eine Nutzer-E-Mail-Adresse mit dem Identitätsanbieterpräfix (user:idpprefix-user@example.com) oder einen Dienstkontonamen mit dem Dienstkontoprojekt (serviceAccount:projectName:serviceAccountName).ROLE_TYPE: dieRoleoderProjectRole, für die Sie die Rollenbindung entfernen.ROLE: Der Name der vordefinierten oder benutzerdefinierten Rolle, die Sie aus dem Nutzerkonto entfernen möchten, z. B.project-viewer.
API
Exportieren Sie die Umgebungsvariablen für die Rollenbindung:
export YOUR_IAM_ADMIN_KUBECONFIG=YOUR_IAM_ADMIN_KUBECONFIG export USERNAME=IDP_PREFIX-USERNAME export BINDING_NAMESPACE=BINDING_NAMESPACEErsetzen Sie Folgendes:
YOUR_IAM_ADMIN_KUBECONFIG: der Pfad zur kubeconfig-Datei für den IAM-Administrator.IDP_PREFIX: das Präfix des Identitätsanbieters.USERNAME: Der Nutzername der E-Mail-Adresse des Nutzers vor dem Symbol@(z. B.paulauspaul@example.com).BINDING_NAMESPACE: der Namespace, in dem die Bindung entfernt wird.
Löschen Sie
ClusterRoleBinding,RoleBinding,ProjectRoleBindingoderOrganizationRoleBinding, um die dem Nutzerkonto gewährte Berechtigung zu widerrufen:So entfernen Sie die
ClusterRoleBindingaus einem Nutzerkonto:kubectl --kubeconfig ${YOUR_IAM_ADMIN_KUBECONFIG} \ delete clusterrolebinding ${USERNAME}-paSo entfernen Sie die
RoleBindingaus einem Nutzerkonto:kubectl --kubeconfig ${YOUR_IAM_ADMIN_KUBECONFIG} \ delete rolebinding ${USERNAME}-pa \ --namespace=${BINDING_NAMESPACE}So entfernen Sie die
ProjectRoleBindingaus einem Nutzerkonto:kubectl --kubeconfig ${YOUR_IAM_ADMIN_KUBECONFIG} \ delete projectrolebinding ${USERNAME}-pa \ --namespace=${BINDING_NAMESPACE}So entfernen Sie die
OrganizationRoleBindingaus einem Nutzerkonto:kubectl --kubeconfig ${YOUR_IAM_ADMIN_KUBECONFIG} \ delete organizationrolebinding ${USERNAME}-pa \ --namespace=gpc-system
Nutzerzugriff widerrufen
Wenn ein Mitglied Ihre Organisation oder Ihr Team verlässt, können Sie den Zugriff auf die Air-Gap-Appliance von Google Distributed Cloud (GDC) widerrufen. Wenn Sie den Zugriff eines Nutzers widerrufen, wird er von der GDC mit Air Gap-Appliance abgemeldet und seine Rollen und Berechtigungen werden entfernt. Sie können auch die Aktivitäten und Sitzungen des Nutzers nach Start- und Endzeit auflisten.
So widerrufen Sie den Zugriff eines Nutzers:
Rufen Sie die Berechtigungen ab, die Sie zum Widerrufen von Nutzern benötigen. Bitten Sie Ihren IAM-Administrator der Organisation, Ihnen die Rolle „Org Session Admin“ (
org-session-admin) zuzuweisen.Widerrufen Sie den Zugriff des Nutzers:
gdcloud admin auth revoke --accounts USER_EMAILErsetzen Sie USER_EMAIL durch die E-Mail-Adresse des Nutzers, dessen Zugriff Sie widerrufen möchten.
Nach der Ausführung des Befehls wird eine Ausgabe angezeigt, die in etwa so aussieht. In diesem Beispiel wird der Zugriff des Nutzers
ariel@example.comwiderrufen:Success: NUMBER of sessions revoked for user ariel@example.comIn diesem Beispiel bezieht sich die Variable NUMBER auf die Anzahl der aktiven Sitzungen des Nutzers.
Prüfen Sie, ob Sie den Zugriff des Nutzers widerrufen haben. Führen Sie dazu den Befehl
gdcloud admin auth revokenoch einmal aus. Bei Erfolg wird Folgendes angezeigt:No sessions found for account: ariel@example.com
Alle widerrufenen Nutzer auflisten
So rufen Sie alle gesperrten Nutzer sowie ihre Aktivitäten und Sitzungen auf:
Liste aller Nutzer, deren Zugriff widerrufen wurde, mit Start- und Endzeit:
gdcloud admin auth list --format="csv(ACCOUNT, IDENTITY_PROVIDER, CREATION_TIME, EXPIRATION_TIME)"Bei erfolgreicher Ausführung erhalten Sie eine Ausgabe ähnlich der folgenden:
account,identity_provider,creation_time,expiration_time ariel@example.com,example-idp,2023-02-15 22:10:52,2023-02-15 23:10:52