Zugriff gewähren und widerrufen

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 ClusterRoleBinding oder RoleBinding Zugriff auf eine vordefinierte ClusterRole.

  • 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 ProjectRole und die entsprechende ProjectRoleBinding. Bei diesem Prozess wird ein Kubernetes-Role und RoleBinding an ein Kubernetes-Namespace im Cluster weitergegeben, das dem Project entspricht, dem das ProjectRole und ProjectRoleBinding zugeordnet sind.

    • Clusterweiter Zugriff:Wenn Sie Zugriff auf alle Namespaces im Cluster gewähren möchten, erstellen Sie eine OrganizationRole und die entsprechende OrganizationRoleBinding. Bei diesem Vorgang werden ein Kubernetes-ClusterRole und ein ClusterRoleBinding auf 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.

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

  1. Melden Sie sich in der GDC-Konsole an.
  2. 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.
  3. Klicken Sie im Navigationsmenü auf Identität und Zugriff > Zugriff.
  4. Klicken Sie auf Mitglied hinzufügen.
  5. Wählen Sie in der Liste Identitätsanbieter einen Identitätsanbieter aus.
  6. Wählen Sie aus, ob Sie einzelne Nutzer oder Gruppen hinzufügen möchten.
  7. Geben Sie im Feld Nutzername oder Gruppenalias den Nutzernamen, die E-Mail-Adresse oder den Alias ein.
  8. 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.
  9. Klicken Sie auf Hinzufügen.

Das Mitglied wird in der Liste Autorisiertes Mitglied angezeigt.

gdcloud

  1. Prüfen Sie, ob die gcloud CLI installiert ist.

  2. Melden Sie sich mit dem Befehl gdcloud auth login an, um sich bei Ihrem Identitätsanbieter zu authentifizieren. Weitere Informationen finden Sie unter gdcloud CLI-Authentifizierung.

  3. Rollenbindungen einrichten

    • Rollenbindungen für eine Organisation einrichten:

      gdcloud organizations add-iam-policy-binding root \
        --member=USER_ACCOUNT \
        --role=ROLE_TYPE/ROLE
      

      Ersetzen 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: die ClusterRole, Role oder OrganizationRole, 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/ROLE
      

      Ersetzen 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: die Role oder ProjectRole, 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

  1. 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_EMAIL
    

    Ersetzen 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. paul aus paul@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.
  2. Weisen Sie einem Nutzer eine ClusterRole, Role, ProjectRole oder OrganizationRole zu:

    • So weisen Sie einem Nutzer eine ClusterRole zu:

      kubectl create --kubeconfig ${YOUR_IAM_ADMIN_KUBECONFIG} \
      clusterrolebinding ${USERNAME}-${ROLE_NAME}-binding \
      --clusterrole=${ROLE_NAME} --user=${USER_EMAIL}
      

      Wenn für eine ClusterRole anstelle einer ClusterRoleBinding eine RoleBinding erforderlich ist, finden Sie in den Rollendefinitionen heraus, welcher Bindungstyp für die Rolle erforderlich ist. Erstellen Sie dann eine RoleBinding im Namespace gpc-system:

      kubectl create --kubeconfig ${YOUR_IAM_ADMIN_KUBECONFIG} \
      rolebinding ${USERNAME}-${ROLE_NAME}-binding \
      --clusterrole=${ROLE_NAME} --user=${USER_EMAIL} --namespace=gpc-system
      
    • So weisen Sie einem Nutzer eine Role zu:

      1. Exportieren Sie den Namespace, in dem die Bindung erstellt werden muss:

        export BINDING_NAMESPACE=BINDING_NAMESPACE
        
      2. Führen Sie die folgenden Befehle aus, um eine RoleBinding zu 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 ProjectRole zu:

      1. 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_EMAIL
        

        Ersetzen 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 der ProjectRole, die Sie dem Nutzer zuweisen.
        • USER_KIND: die Art des Nutzers, die User, Group oder ServiceAccount sein 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).
      2. Wenden Sie die Datei projectrolebinding.yaml an:

        kubectl create -f projectrolebinding.yaml
        
    • So weisen Sie einem OrganizationRole einen Nutzer zu:

      1. 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_EMAIL
        

        Ersetzen 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 der OrganizationRole, die Sie dem Nutzer zuweisen.
        • USER_KIND: die Art des Nutzers, die User, Group oder ServiceAccount sein 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).
      2. 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

  1. Melden Sie sich in der GDC-Konsole an.
  2. Klicken Sie im Navigationsmenü auf Identität und Zugriff > Zugriff.
  3. Wählen Sie in der Liste Autorisierte Mitglieder ein Mitglied aus.
  4. Klicken Sie auf Mitglied entfernen.
  5. Klicken Sie zur Bestätigung auf Mitglied entfernen.

gdcloud

  1. Prüfen Sie, ob die gcloud CLI installiert ist.

  2. Melden Sie sich mit dem Befehl gdcloud auth login an, um sich bei Ihrem Identitätsanbieter zu authentifizieren. Weitere Informationen finden Sie unter gdcloud CLI-Authentifizierung.

  3. Entfernen Sie Rollenbindungen.

    • So entfernen Sie Rollenbindungen für eine Organisation:

      gdcloud organizations remove-iam-policy-binding root \
        --member=USER_ACCOUNT \
        --role=ROLE_TYPE/ROLE
      

      Ersetzen 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: die ClusterRole, Role oder OrganizationRole, 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/ROLE
      

      Ersetzen 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: die Role oder ProjectRole, 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

  1. 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_NAMESPACE
    

    Ersetzen 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. paul aus paul@example.com).
    • BINDING_NAMESPACE: der Namespace, in dem die Bindung entfernt wird.
  2. Löschen Sie ClusterRoleBinding, RoleBinding, ProjectRoleBinding oder OrganizationRoleBinding, um die dem Nutzerkonto gewährte Berechtigung zu widerrufen:

    • So entfernen Sie die ClusterRoleBinding aus einem Nutzerkonto:

      kubectl --kubeconfig ${YOUR_IAM_ADMIN_KUBECONFIG} \
      delete clusterrolebinding ${USERNAME}-pa
      
    • So entfernen Sie die RoleBinding aus einem Nutzerkonto:

      kubectl --kubeconfig ${YOUR_IAM_ADMIN_KUBECONFIG} \
      delete rolebinding ${USERNAME}-pa \
      --namespace=${BINDING_NAMESPACE}
      
    • So entfernen Sie die ProjectRoleBinding aus einem Nutzerkonto:

      kubectl --kubeconfig ${YOUR_IAM_ADMIN_KUBECONFIG} \
      delete projectrolebinding ${USERNAME}-pa \
      --namespace=${BINDING_NAMESPACE}
      
    • So entfernen Sie die OrganizationRoleBinding aus 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:

  1. 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.

  2. Widerrufen Sie den Zugriff des Nutzers:

    gdcloud admin auth revoke --accounts USER_EMAIL
    

    Ersetzen 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.com widerrufen:

    Success: NUMBER of sessions revoked for user ariel@example.com
    

    In diesem Beispiel bezieht sich die Variable NUMBER auf die Anzahl der aktiven Sitzungen des Nutzers.

  3. Prüfen Sie, ob Sie den Zugriff des Nutzers widerrufen haben. Führen Sie dazu den Befehl gdcloud admin auth revoke noch 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