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.
- Téléchargez et installez la CLI gdcloud, si ce n'est pas déjà fait.
- Pour utiliser l'API avec
kubectl, une configuration supplémentaire est requise :
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
- Connectez-vous à la console GDC.
- 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.
- Dans le menu de navigation, cliquez sur Identité et accès > Accès.
- Cliquez sur Ajouter un membre.
- Choisissez si vous souhaitez ajouter des utilisateurs individuels ou des groupes.
- Dans la liste Fournisseur d'identité, sélectionnez un fournisseur d'identité.
- Dans le champ Nom d'utilisateur ou alias de groupe, saisissez le nom d'utilisateur, l'adresse e-mail ou l'alias.
- 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.
- Cliquez sur Ajouter.
Le membre apparaît dans la liste Membre autorisé.
gdcloud
Assurez-vous d'avoir installé la CLI gdcloud.
Connectez-vous à l'aide de la commande
gdcloud auth loginpour vous authentifier auprès de votre fournisseur d'identité. Pour en savoir plus, consultez Authentification de la CLI gdcloud.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=ROLERemplacez 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=ROLERemplacez 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
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_EMAILRemplacez 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,pauldepaul@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:platformpour 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).
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
- Connectez-vous à la console GDC.
- Dans le menu de navigation, cliquez sur Identité et accès > Accès.
- Dans la liste Membres autorisés, sélectionnez un membre.
- Cliquez sur Supprimer le membre.
- Lorsque vous y êtes invité, cliquez sur Supprimer le membre pour confirmer l'opération.
gdcloud
Assurez-vous d'avoir installé la CLI gdcloud.
Connectez-vous à l'aide de la commande
gdcloud auth loginpour vous authentifier auprès de votre fournisseur d'identité. Pour en savoir plus, consultez Authentification de la CLI gdcloud.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=ROLERemplacez 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=ROLERemplacez 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,pauldepaul@example.com). - ROLE_NAME : nom du rôle que vous souhaitez supprimer, par exemple
project-creator. - BINDING_NAMESPACE : remplacez par
platformpour 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 :
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 loginRemplacez
ZONE_URLpar 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.
Révoquez l'accès de l'utilisateur à la zone :
gdcloud admin auth revoke --accounts USER_EMAILRemplacez 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.comDans cet exemple, la variable NUMBER fait référence au nombre de sessions actives de l'utilisateur.
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.comRépétez les étapes précédentes pour chaque zone de votre univers.