Utilisation de rôles pour créer des secrets pour les destinations d'API

Amazon EventBridge utilise des rôles AWS Identity and Access Management (IAM) liés à un service. Un rôle lié à un service est un type unique de rôle IAM lié directement à EventBridge. Les rôles liés à un service sont prédéfinis par EventBridge et comprennent toutes les autorisations nécessaires au service pour appeler d'autres services AWS en votre nom.

Un rôle lié à un service permet d'utiliser EventBridge plus facilement, car vous n'avez pas besoin d'ajouter manuellement les autorisations requises. EventBridge définit les autorisations de ses rôles liés à un service et, sauf définition contraire, seul EventBridge peut endosser 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.

Vous pouvez supprimer un rôle lié à un service uniquement après la suppression préalable de ses ressources connexes. Vos ressources EventBridge sont ainsi protégées, car vous ne pouvez pas involontairement supprimer l'autorisation d'accéder aux ressources.

Pour plus d'informations sur les autres services prenant en charge les rôles liés à un service, consultez les AWS services opérationnels avec IAM et recherchez les services présentant la mention Yes (Oui) dans la colonne Service-linked roles (Rôles liés à un service). Sélectionnez un Oui ayant un lien pour consulter la documentation du rôle lié à un service, pour ce service.

Autorisations des rôles liés à un service pour EventBridge

EventBridgeutilise le rôle lié au service nommé AWSServiceRoleForAmazonEventBridgeApiDestinations— Permet d'accéder aux secrets du Gestionnaire de secrets créés par. EventBridge

Le rôle lié à un service AWSServiceRoleForAmazonEventBridgeApiDestinations approuve les services suivants pour endosser le rôle :

• apidestinations.events.amazonaws.com

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

• Action : create, describe, update and delete secrets; get and put secret values sur secrets created for all connections by EventBridge

Vous devez configurer les autorisations de manière à permettre à vos utilisateurs, groupes ou rôles de créer, modifier ou supprimer un rôle lié à un service. Pour plus d’informations, consultez Autorisations de rôles liés à un service dans le Guide de l’utilisateur IAM.

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

Vous n’avez pas besoin de créer manuellement un rôle lié à un service. Lorsque vous créez une connexion dans leAWS Management Console, le ou l'AWSAPIAWS CLI, vous EventBridge créez le rôle lié au service pour vous.

Important

Ce rôle lié à un service peut apparaître dans votre compte si vous avez effectué une action dans un autre service qui utilise les fonctions prises en charge par ce rôle. Si vous utilisiez le EventBridge service avant le 11 février 2021, date à laquelle il a commencé à prendre en charge les rôles liés au service, vous avez EventBridge créé le AWSServiceRoleForAmazonEventBridgeApiDestinationsrôle dans votre compte. Pour en savoir plus, consultez la section Un nouveau rôle est apparu dans mon compte Compte AWS.

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. Lorsque vous créez une connexion, EventBridge crée à nouveau le rôle lié au service pour vous.

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

EventBridge ne vous permet pas de modifier le rôle lié à un service AWSServiceRoleForAmazonEventBridgeApiDestinations. Une fois que vous avez créé un rôle lié à un service, vous ne pouvez pas changer le nom du rôle, car plusieurs entités peuvent faire référence à ce rôle. Néanmoins, vous pouvez modifier la description du rôle à l’aide d’IAM. Pour en savoir plus, consultez Modification d’un rôle lié à un service dans le guide de l’utilisateur IAM.

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

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. Cependant, vous devez nettoyer votre rôle lié à un service avant de pouvoir le supprimer manuellement.

Nettoyer un rôle lié à un service

Avant de pouvoir utiliser IAM pour supprimer un rôle lié à un service, vous devez supprimer toutes les ressources utilisées par le rôle.

Note

Si le service EventBridge utilise le rôle lorsque vous essayez de supprimer les ressources, la suppression peut échouer. Si cela se produit, patientez quelques minutes et réessayez.

Pour supprimer les ressources EventBridge utilisées par AWSServiceRoleForAmazonEventBridgeApiDestinations (console)

1. Ouvrez la EventBridge console Amazon à l'adresse https://console.aws.amazon.com/events/.

2. Sous Intégrations, choisissez les destinations de l'API, puis cliquez sur l'onglet Connexions.

3. Choisissez la connexion, puis choisissez Supprimer.

Pour supprimer les ressources EventBridge utilisées par la AWSServiceRoleForAmazonEventBridgeApiDestinations (interface de ligne de commande AWS)

• Utilisez la commande suivante : delete-connection

Pour supprimer les ressources EventBridge utilisées par AWSServiceRoleForAmazonEventBridgeApiDestinations (API)

• Utilisez la commande suivante : DeleteConnection

Suppression manuelle du rôle lié au service

Utilisez la console IAM, l'AWS CLI ou l'API AWS pour supprimer le rôle lié à un service AWSServiceRoleForAmazonEventBridgeApiDestinations. 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 liés à un service EventBridge

EventBridge prend en charge l'utilisation des rôles liés à un service dans toutes les régions où le service est disponible. Pour plus d'informations, consultez AWSRégions et points de terminaison.