Utilisation des rôles liés aux services pour AWS CodeConnections - Console Outils pour développeur

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Utilisation des rôles liés aux services pour AWS CodeConnections

AWS CodeConnections utilise des AWS Identity and Access Management rôles liés à un service (IAM). Un rôle lié à un service est un type unique de rôle IAM directement lié à. AWS CodeConnections Les rôles liés au service sont prédéfinis par AWS CodeConnections et incluent toutes les autorisations dont le service a besoin pour appeler d'autres AWS services en votre nom. Ce rôle est créé pour vous la première fois que vous créez une connexion. Vous n'avez donc pas à créer le rôle.

Un rôle lié à un service facilite la configuration AWS CodeConnections car il n'est pas nécessaire d'ajouter des autorisations manuellement. AWS CodeConnections définit les autorisations associées à ses rôles liés aux services et, sauf indication contraire, seul AWS CodeConnections peut assumer ses rôles. Les autorisations définies comprennent la politique d’approbation et la politique d’autorisation. De plus, cette politique d’autorisation ne peut pas être attachée à une autre entité IAM.

Pour supprimer un rôle lié à un service, vous devez d'abord supprimer ses ressources associées. Cela protège vos AWS CodeConnections ressources car vous ne pouvez pas supprimer par inadvertance l'autorisation d'accès aux ressources.

Pour obtenir des informations sur les autres services qui prennent en charge les rôles liés à un service, consultez Services AWS qui fonctionnent avec IAM.

Note

Les actions pour les ressources créées sous le nouveau préfixe de service codeconnections sont disponibles. La création d'une ressource sous le nouveau préfixe de service sera utilisée codeconnections dans l'ARN de la ressource. Les actions et les ressources relatives au préfixe de codestar-connections service restent disponibles. Lorsque vous spécifiez une ressource dans la politique IAM, le préfixe de service doit correspondre à celui de la ressource.

Autorisations de rôle liées à un service pour AWS CodeConnections

AWS CodeConnections utilise le rôle AWSServiceRoleForGitSync lié au service pour utiliser Git sync avec les référentiels Git connectés.

Le rôle AWSServiceRoleForGitSync lié à un service fait confiance aux services suivants pour assumer le rôle :

  • repository.sync.codeconnections.amazonaws.com

La politique d'autorisations de rôle nommée AWSGitSyncServiceRolePolicy AWS CodeConnections permet d'effectuer les actions suivantes sur les ressources spécifiées :

  • Action : accorde des autorisations permettant aux utilisateurs de créer des connexions vers des référentiels basés sur Git externes et d'utiliser la synchronisation Git avec ces référentiels.

Vous devez configurer les autorisations de manière à permettre à une entité IAM (comme un utilisateur, un groupe ou un rôle) de créer, modifier ou supprimer un rôle lié à un service. Pour plus d'informations, consultez Service-Linked Role Permissions (autorisations du rôle lié à un service) dans le IAM User Guide (guide de l'utilisateur IAM).

Création d'un rôle lié à un service pour AWS CodeConnections

Vous n’avez pas besoin de créer manuellement un rôle lié à un service. Vous créez le rôle lorsque vous créez une ressource pour votre projet synchronisé avec Git avec l'API. CreateRepositoryLink

Si vous supprimez ce rôle lié à un service et que vous avez ensuite besoin de le recréer, vous pouvez utiliser la même procédure pour recréer le rôle dans votre compte.

Modification d'un rôle lié à un service pour AWS CodeConnections

Une fois que vous avez créé un rôle lié à un service, vous ne pouvez pas modifier le nom du rôle, car plusieurs entités peuvent faire référence à ce rôle. Néanmoins, vous pouvez utiliser IAM pour modifier la description du rôle. Pour plus d'informations, consultez Editing a Service-Linked Role (Modification d'un rôle lié à un service) dans le Guide de l'utilisateur IAM.

Suppression d'un rôle lié à un service pour AWS CodeConnections

Si vous n'avez plus besoin d'utiliser une fonction ou un service qui nécessite un rôle lié à un service, nous vous recommandons de supprimer ce rôle. De cette façon, vous n'avez aucune entité inutilisée qui n'est pas surveillée ou gérée activement. Vous devez nettoyer les ressources de votre rôle lié à un service avant de pouvoir les supprimer manuellement. Cela implique de supprimer toutes les connexions utilisant le rôle de service dans votre AWS compte.

Note

Si le AWS CodeConnections service utilise le rôle lorsque vous essayez de supprimer les ressources, la suppression risque d'échouer. Si cela se produit, patientez quelques minutes et réessayez.

Pour supprimer les AWS CodeConnections ressources utilisées par AWSServiceRoleForGitSync
  1. Ouvrez la console Developer Tools, puis choisissez Paramètres.

  2. Choisissez toutes connexions qui apparaissent dans la liste, puis Supprimer.

  3. Répétez ces étapes dans toutes les AWS régions où vous avez créé des connexions.

Pour utiliser IAM et supprimer le rôle lié à un service

Utilisez la console IAM ou l' AWS CLI AWS Identity and Access Management API pour supprimer le rôle lié au AWSServiceRoleForGitSync service. Pour plus d’informations, consultez Suppression d’un rôle lié à un service dans le Guide de l’utilisateur IAM.

Régions prises en charge pour les rôles AWS CodeConnections liés à un service

AWS CodeConnections prend en charge l'utilisation de rôles liés au service dans toutes les AWS régions où le service est disponible. Pour plus d’informations, consultez Régions et Points de terminaison AWS.