Accorder et révoquer l'accès

Chaque sujet (un utilisateur ou un groupe) suit un processus en deux étapes pour accéder au serveur d'API global. Accordez à un sujet des autorisations dans le serveur d'API global à l'aide de IAMRoleBinding pour un IAMRole prédéfini. Tous les rôles et liaisons de rôles sont globaux.

Cette page s'adresse aux utilisateurs du groupe d'administrateurs de plate-forme qui gèrent les autorisations au sein de leur organisation. Pour en savoir plus, consultez la documentation sur les audiences pour GDC sous air gap.

Avant de commencer

Avant de gérer les liaisons de rôles ou de révoquer l'accès, vous devez demander les autorisations nécessaires et préparer votre environnement. Les rôles spécifiques requis dépendent de la gestion des liaisons de rôles ou de la révocation de l'accès utilisateur.

Demander des rôles IAM

Contactez l'administrateur de votre organisation IAM pour demander les rôles en fonction des tâches que vous devez effectuer :

  • Administrateur IAM de l'organisation (organization-iam-admin) : crée, met à jour et supprime des liaisons de rôles au niveau de l'organisation et du projet.
  • Administrateur de l'organisation de session (org-session-admin) : révoque les sessions actives et l'accès d'un utilisateur dans une zone spécifique.

Préparer votre environnement

Pour utiliser les outils de ligne de commande afin de gérer les liaisons de rôles ou de révoquer l'accès, effectuez la configuration suivante.

Configurer les liaisons de rôles

Vous pouvez configurer des liaisons de rôles qui permettent aux membres de l'équipe d'accéder aux ressources au niveau de l'organisation ou du projet.

Attribuez un rôle à un membre autorisé :

Console

  1. Connectez-vous à la console GDC.
  2. Sélectionnez une organisation ou un projet dans le sélecteur de champ d'application.
    • Pour configurer des liaisons de rôles pour une organisation, sélectionnez une organisation.
    • Pour configurer des liaisons de rôles pour un projet, sélectionnez un projet.
  3. Dans le menu de navigation, cliquez sur Identité et accès > Accès.
  4. Cliquez sur Ajouter un membre.
  5. Choisissez si vous souhaitez ajouter des utilisateurs individuels ou des groupes.
  6. Dans la liste Fournisseur d'identité, sélectionnez un fournisseur d'identité.
  7. Dans le champ Nom d'utilisateur ou alias de groupe, saisissez le nom d'utilisateur, l'adresse e-mail ou l'alias.
  8. Dans la liste Rôle, sélectionnez le rôle que vous souhaitez attribuer à l'utilisateur ou au groupe, par exemple Lecteur de l'organisation au niveau de l'organisation ou Créateur de projet au niveau du projet.
  9. Cliquez sur Ajouter.

Le membre apparaît dans la liste Membre autorisé.

gdcloud

  1. Assurez-vous d'avoir installé la CLI gdcloud.

  2. Connectez-vous à l'aide de la commande gdcloud auth login pour vous authentifier auprès de votre fournisseur d'identité. Pour en savoir plus, consultez Authentification de la CLI gdcloud.

  3. Configurez les liaisons de rôles.

    • Configurez les liaisons de rôles pour une organisation :

      gdcloud organizations add-iam-policy-binding ORGANIZATION \
        --member=USER_ACCOUNT \
        --role=ROLE
      

      Remplacez les variables suivantes :

      • ORGANIZATION : nom de l'organisation pour laquelle vous configurez la liaison de rôle.
      • USER_ACCOUNT : compte utilisateur auquel vous souhaitez attribuer le rôle. Cette option accepte une adresse e-mail d'utilisateur avec le préfixe du fournisseur d'identité (user:idpprefix-user@example.com) ou un nom de compte de service avec le projet de compte de service (serviceAccount:projectName:serviceAccountName).
      • ROLE : nom du rôle prédéfini ou personnalisé que vous souhaitez attribuer à l'utilisateur.
    • Configurez les liaisons de rôles pour un projet :

      gdcloud projects add-iam-policy-binding PROJECT \
        --member=USER_ACCOUNT \
        --role=ROLE
      

      Remplacez les variables suivantes :

      • PROJECT : nom du projet pour lequel vous configurez la liaison de rôle.
      • USER_ACCOUNT : compte utilisateur auquel vous souhaitez attribuer le rôle. Cette option accepte une adresse e-mail d'utilisateur avec le préfixe du fournisseur d'identité (user:idpprefix-user@example.com) ou un nom de compte de service avec le projet de compte de service (serviceAccount:projectName:serviceAccountName).
      • ROLE : nom du rôle prédéfini ou personnalisé que vous souhaitez attribuer à l'utilisateur.

API

  1. Exportez les variables d'environnement pour la liaison de rôle :

    export GLOBAL_API_SERVER_KUBECONFIG=GLOBAL_API_SERVER_KUBECONFIG
    export USERNAME=IDP_PREFIX-USERNAME
    export ROLE_NAME=ROLE_NAME
    export BINDING_NAMESPACE=BINDING_NAMESPACE
    export USER_EMAIL=IDP_PREFIX-USER_EMAIL
    

    Remplacez les éléments suivants :

    • GLOBAL_API_SERVER_KUBECONFIG : chemin d'accès au fichier kubeconfig du serveur d'API global.
    • IDP_PREFIX : préfixe du fournisseur d'identité.
    • USERNAME : partie du nom d'utilisateur de l'adresse e-mail de l'utilisateur avant le symbole @ (par exemple, paul de paul@example.com).
    • ROLE_NAME : nom du rôle dont l'utilisateur a besoin (par exemple, project-creator). Consultez Définitions des rôles pour obtenir la liste des rôles et leur champ d'application.
    • BINDING_NAMESPACE : platform pour les rôles limités à l'organisation, ou nom de l'espace de noms du projet cible pour les rôles limités au projet.
    • USER_EMAIL : adresse e-mail du compte utilisateur auquel vous souhaitez attribuer le rôle (par exemple, paul@example.com).
  2. Créez et appliquez une ressource personnalisée IAMRoleBinding :

    cat <<EOF | kubectl --kubeconfig ${GLOBAL_API_SERVER_KUBECONFIG} apply -f -
    apiVersion: iam.global.gdc.goog/v1
    kind: IAMRoleBinding
    metadata:
      name: ${USERNAME}-${ROLE_NAME}-binding
      namespace: ${BINDING_NAMESPACE}
    spec:
      roleRef:
        apiGroup: iam.global.gdc.goog
        kind: IAMRole
        name: ${ROLE_NAME}
      subjects:
      - apiGroup: rbac.authorization.k8s.io
        kind: User
        name: ${USER_EMAIL}
    EOF
    

Supprimer des liaisons de rôle

Lorsque l'accès n'est plus nécessaire, supprimez un membre ainsi que les rôles, autorisations et accès qui lui sont associés.

Pour supprimer des membres, procédez comme suit :

Console

  1. Connectez-vous à la console GDC.
  2. Dans le menu de navigation, cliquez sur Identité et accès > Accès.
  3. Dans la liste Membres autorisés, sélectionnez un membre.
  4. Cliquez sur Supprimer le membre.
  5. Lorsque vous y êtes invité, cliquez sur Supprimer le membre pour confirmer l'opération.

gdcloud

  1. Assurez-vous d'avoir installé la CLI gdcloud.

  2. Connectez-vous à l'aide de la commande gdcloud auth login pour vous authentifier auprès de votre fournisseur d'identité. Pour en savoir plus, consultez Authentification de la CLI gdcloud.

  3. Supprimer des liaisons de rôle.

    • Supprimez les liaisons de rôle pour une organisation :

      gdcloud organizations remove-iam-policy-binding ORGANIZATION \
        --member=USER_ACCOUNT \
        --role=ROLE
      

      Remplacez les variables suivantes :

      • ORGANIZATION : nom de l'organisation de laquelle vous supprimez la liaison de rôle.
      • USER_ACCOUNT : compte utilisateur pour lequel vous souhaitez supprimer le rôle. Cette option accepte une adresse e-mail d'utilisateur avec le préfixe du fournisseur d'identité (user:idpprefix-user@example.com) ou un nom de compte de service avec le projet de compte de service (serviceAccount:projectName:serviceAccountName).
      • ROLE : nom du rôle prédéfini ou personnalisé que vous souhaitez supprimer du compte utilisateur.
    • Supprimez les liaisons de rôle d'un projet :

      gdcloud projects remove-iam-policy-binding PROJECT \
        --member=USER_ACCOUNT \
        --role=ROLE
      

      Remplacez les variables suivantes :

      • PROJECT : nom du projet duquel vous supprimez la liaison de rôle.
      • USER_ACCOUNT : compte utilisateur pour lequel vous souhaitez supprimer le rôle. Cette option accepte une adresse e-mail d'utilisateur avec le préfixe du fournisseur d'identité (user:idpprefix-user@example.com) ou un nom de compte de service avec le projet de compte de service (serviceAccount:projectName:serviceAccountName).
      • ROLE : nom du rôle prédéfini ou personnalisé que vous souhaitez supprimer du compte utilisateur.

kubectl

Supprimez le IAMRoleBinding pour révoquer l'autorisation accordée au compte PA :

kubectl --kubeconfig GLOBAL_API_SERVER_KUBECONFIG \
delete iamrolebinding IDP_PREFIX-USERNAME-ROLE_NAME-binding -n BINDING_NAMESPACE

Remplacez les éléments suivants :

  • GLOBAL_API_SERVER_KUBECONFIG : chemin d'accès au fichier kubeconfig du serveur d'API global.
  • IDP_PREFIX : préfixe du fournisseur d'identité.
  • USERNAME : partie du nom d'utilisateur de l'adresse e-mail de l'utilisateur avant le symbole @ (par exemple, paul de paul@example.com).
  • ROLE_NAME : nom du rôle que vous souhaitez supprimer, par exemple project-creator.
  • BINDING_NAMESPACE : remplacez par platform pour les rôles limités à l'organisation, ou par le nom de l'espace de noms du projet cible pour les rôles limités au projet.

Révoquer l'accès d'un utilisateur

Si un membre quitte votre organisation ou votre équipe, vous pouvez révoquer son accès à Google Distributed Cloud (GDC) air gap. La révocation de l'accès d'un utilisateur le déconnecte de Distributed Cloud et supprime ses rôles et ses autorisations. Vous pouvez également lister l'activité et les sessions de l'utilisateur à partir de leur heure de début et de fin.

Pour révoquer l'accès d'un utilisateur à un univers GDC, vous devez révoquer l'accès pour chaque zone individuellement. Pour chaque zone, procédez comme suit :

  1. Assurez-vous d'être connecté à la zone pour laquelle vous souhaitez révoquer l'accès. Par exemple, définissez la configuration de l'URL zonale pour la CLI gdcloud, puis connectez-vous :

    gdcloud config set organization_console_url ZONE_URL
    gdcloud auth login
    

    Remplacez ZONE_URL par l'URL de la console GDC de la zone pour laquelle vous souhaitez révoquer l'accès utilisateur, qui ressemble à https://console.ORG_NAME.ZONE_NAME.ORG_SUFFIX.

    Pour en savoir plus sur le changement de contexte zonal, consultez Accéder aux zones avec vos outils.

  2. Révoquez l'accès de l'utilisateur à la zone :

    gdcloud admin auth revoke --accounts USER_EMAIL
    

    Remplacez USER_EMAIL par l'adresse e-mail de l'utilisateur dont vous souhaitez révoquer l'accès.

    Une fois la commande exécutée, un résultat semblable aux lignes suivantes s'affiche : Cet exemple révoque l'accès de l'utilisateur ariel@example.com :

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

    Dans cet exemple, la variable NUMBER fait référence au nombre de sessions actives de l'utilisateur.

  3. Confirmez que vous avez révoqué l'accès de l'utilisateur en exécutant à nouveau la commande gdcloud admin auth revoke. Si l'opération réussit, vous obtenez le résultat suivant :

    No sessions found for account: ariel@example.com
    
  4. Répétez les étapes précédentes pour chaque zone de votre univers.