Attribuer le rôle "Utilisateur du compte de service" pour les comptes de service d'exécution
Cette page liste les comptes principaux qui ont besoin du rôle Utilisateur du compte de service (roles/iam.serviceAccountUser) pour les modifications d'autorisation à venir, et explique comment l'accorder.
Qui a besoin du rôle Utilisateur du compte de service ?
Les comptes principaux suivants nécessitent le rôle "Utilisateur du compte de service" sur le compte de service indiqué :
| Principal | Compte de service |
|---|---|
| Utilisateurs qui publient ou testent l'intégration, y compris l'automatisation du déploiement. | Compte de service d'exécution de l'intégration |
| Utilisateurs et automatisation qui exécutent l'intégration via l'API ou la console Google Cloud , de manière synchrone ou asynchrone. | Compte de service d'exécution de l'intégration |
| Compte de service utilisé par un déclencheur pour démarrer l'intégration. Cela inclut l'adresse e-mail du compte de service d'un déclencheur Cloud Scheduler, ou le compte de service d'un déclencheur Cloud Pub/Sub, d'un déclencheur Eventarc ou d'un déclencheur d'événement Integration Connectors. Cette étape n'est pas nécessaire si le compte du déclencheur est le compte de service d'exécution lui-même. | Compte de service d'exécution de l'intégration |
| Utilisateurs qui approuvent ou reprennent une exécution suspendue. | Compte de service d'exécution de l'intégration |
| Le compte principal qui démarre une intégration qui appelle une sous-intégration à l'aide de la tâche Appeler l'intégration. Pour une intégration démarrée par un déclencheur avec un compte de service, il s'agit du compte de service du déclencheur. | Le compte de service d'exécution de la sous-intégration, en plus du compte de service d'exécution de l'intégration appelante |
| Le compte de service d'exécution de l'intégration appelante, lorsqu'il appelle une sous-intégration de manière asynchrone. Cela n'est pas nécessaire si les deux intégrations utilisent le même compte de service. | Compte de service d'exécution de la sous-intégration |
| Utilisateurs qui créent ou modifient un profil d'authentification de type Compte de service ou Jeton OIDC. | Le compte de service nommé dans le profil |
| Utilisateurs qui publient ou testent une intégration qui utilise ce profil, y compris l'automatisation du déploiement. | Le compte de service nommé dans le profil |
Compte principal qui exécute une intégration qui atteint une tâche à l'aide de ce profil.
Pour une exécution asynchrone ou planifiée, il s'agit du compte de service d'exécution de l'intégration ou de l'agent de service Application Integration, service-PROJECT_NUMBER@gcp-sa-integrations., si l'intégration n'en possède pas. Dans ce cas, il est recommandé de définir un compte de service d'exécution. |
Le compte de service nommé dans le profil |
L'enregistrement d'un brouillon ne nécessite pas le rôle Utilisateur du compte de service. Les vérifications d'autorisation lors de la publication, du test et de l'enregistrement des profils d'authentification s'appliquent actuellement. Les vérifications concernant l'exécution, l'approbation, l'appel de sous-intégrations et l'exécution de tâches qui utilisent un profil d'authentification prendront effet au fur et à mesure du déploiement. Accordez ces rôles de manière proactive pour vous assurer que vos intégrations continuent de s'exécuter correctement.
Attribuer le rôle
Pour attribuer le rôle à un compte principal, exécutez la commande suivante :
gcloud iam service-accounts add-iam-policy-binding SERVICE_ACCOUNT \
--project=SERVICE_ACCOUNT_PROJECT_ID \
--member='user:PRINCIPAL' \
--role='roles/iam.serviceAccountUser'
Remplacez les éléments suivants :
SERVICE_ACCOUNT: adresse e-mail du compte de service d'exécution ou du compte nommé dans un profil d'authentification.SERVICE_ACCOUNT_PROJECT_ID: ID du projet propriétaire du compte de service.PRINCIPAL: adresse e-mail de l'utilisateur.
Pour les autres types de comptes principaux, utilisez le préfixe --member correspondant :
- Groupes : utilisez
group:. Nous vous recommandons d'utiliser des groupes Google plutôt que des comptes utilisateur individuels pour simplifier la gestion des accès lorsque les membres de l'équipe changent. - Comptes de service : utilisez
serviceAccount:pour les processus automatisés, les applications et les comptes de service de déclencheur.
Pour attribuer le rôle dans la console Google Cloud :
- Accédez à IAM et administration > Comptes de service.
- Sélectionnez le compte de service.
- Cliquez sur Autorisations > Accorder l'accès.
Pour attribuer ce rôle, vous devez disposer du rôle roles/iam.serviceAccountAdmin sur le compte de service. Les propriétaires de projet disposent de cette autorisation par défaut. Pour en savoir plus, consultez Gérer l'accès aux comptes de service.
Étapes suivantes
- Définissez un compte de service d'exécution sur les intégrations qui s'exécutent sans identité utilisateur.
- Si une autorisation ne semble pas fonctionner, consultez Résoudre les erreurs d'autorisation.