Utilisation de rôles liés à un service pour Amazon Cognito

Amazon Cognito utilise AWS Identity and Access Management (IAM) des rôles liés à un service. Un rôle lié à un service est un type unique de IAM rôle doté d'une politique de confiance qui permet Service AWS à un homme d'assumer ce rôle. Les rôles liés à un service sont prédéfinis par Amazon Cognito et incluent toutes les autorisations dont le service a besoin pour appeler AWS d'autres services en votre nom.

Un rôle lié à un service simplifie la configuration d’Amazon Cognito, car vous n’avez pas besoin d’ajouter manuellement les autorisations requises. Amazon Cognito définissant les autorisations de ses rôles liés à un service, sauf définition contraire, seul Amazon Cognito peut endosser ses rôles. Les autorisations définies incluent la politique de confiance et la politique d'autorisations, et cette politique d'autorisations ne peut être attachée à aucune autre IAM entité.

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

Pour plus d'informations sur les autres services qui prennent en charge les rôles liés à un service, consultez la section AWS Services compatibles avec IAM et recherchez les services dont la valeur est Oui dans la colonne Rôle lié au service. Choisissez un Oui ayant un lien permettant de consulter la documentation du rôle lié à un service, pour ce service.

Autorisations de rôle lié à un service pour Amazon Cognito

Amazon Cognito utilise les rôles liés à un service suivants :

• AWSServiceRoleForAmazonCognitoIdpEmailService— Permet au service de groupes d'utilisateurs Amazon Cognito d'utiliser vos SES identités Amazon pour envoyer des e-mails.

• AWSServiceRoleForAmazonCognitoIdp— Permet aux groupes d'utilisateurs Amazon Cognito de publier des événements et de configurer des points de terminaison pour vos projets Amazon Pinpoint.

AWSServiceRoleForAmazonCognitoIdpEmailService

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

• email.cognito-idp.amazonaws.com

La politique d’autorisations de rôle permet à Amazon Cognito d’effectuer les actions suivantes sur les ressources spécifiées :

Actions autorisées pour AWSServiceRoleForAmazonCognitoIdpEmailService :

• Action : ses:SendEmail et ses:SendRawEmail

• Ressource: *

La politique refuse à Amazon Cognito la possibilité d’effectuer les actions suivantes sur les ressources spécifiées :

Actions refusées

• Action : ses:List*

• Ressource: *

Grâce à ces autorisations, Amazon Cognito peut utiliser vos adresses e-mail vérifiées sur Amazon SES uniquement pour envoyer des e-mails à vos utilisateurs. Amazon Cognito envoie des courriels à vos utilisateurs quand ceux-ci effectuent certaines actions dans l’appli cliente pour un groupe d’utilisateurs, comme une inscription ou une réinitialisation de mot de passe.

Vous devez configurer les autorisations pour autoriser une IAM entité (telle qu'un utilisateur, un groupe ou un rôle) à créer, modifier ou supprimer un rôle lié à un service. Pour plus d'informations, consultez la section Autorisations relatives aux rôles liés à un service dans le Guide de l'IAMutilisateur.

AWSServiceRoleForAmazonCognitoIdp

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

• email.cognito-idp.amazonaws.com

La politique d’autorisations de rôle permet à Amazon Cognito d’effectuer les actions suivantes sur les ressources indiquées :

Actions autorisées pour AWSServiceRoleForAmazonCognitoIdp

• Action : cognito-idp:Describe

• Ressource: *

Avec cette autorisation, Amazon Cognito peut appeler les opérations Amazon Describe API Cognito à votre place.

Note

Lorsque vous intégrez Amazon Cognito à Amazon Pinpoint à createUserPoolClient l'aide de updateUserPoolClient et, les autorisations relatives aux ressources y sont ajoutées sous forme SLR de politique intégrée. La politique incluse fournit des autorisations mobiletargeting:UpdateEndpoint et mobiletargeting:PutEvents. Celles-ci permettent à Amazon Cognito de publier des événements et de configurer des points de terminaison pour les projets Pinpoint que vous intégrez avec Cognito.

Création d’un rôle lié à un service pour Amazon Cognito

Vous n’avez pas besoin de créer manuellement un rôle lié à un service. Lorsque vous configurez un groupe d'utilisateurs afin qu'il utilise votre SES configuration Amazon pour gérer la livraison des e-mails dans le AWS Management Console AWS CLI, le ou Amazon CognitoAPI, Amazon Cognito crée le rôle lié au service pour vous.

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 configurez un groupe d'utilisateurs pour utiliser votre SES configuration Amazon pour gérer la livraison des e-mails, Amazon Cognito crée à nouveau le rôle lié au service pour vous.

Avant qu'Amazon Cognito puisse créer ce rôle, les IAM autorisations que vous utilisez pour configurer votre groupe d'utilisateurs doivent inclure l'iam:CreateServiceLinkedRoleaction. Pour plus d'informations sur la mise à jour des autorisations dansIAM, consultez la section Modification des autorisations d'un IAM utilisateur dans le Guide de IAM l'utilisateur.

Modification d’un rôle lié à un service pour Amazon Cognito

Vous ne pouvez pas modifier les rôles AmazonCognitoIdp ou les rôles AmazonCognitoIdpEmailService liés à un service dans. AWS Identity and Access Management 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 au rôle. Vous pouvez toutefois modifier la description du rôle à l'aide deIAM. Pour plus d'informations, consultez la section Modification d'un rôle lié à un service dans le Guide de l'IAMutilisateur.

Suppression d’un rôle lié à un service pour Amazon Cognito

Si vous n’avez plus besoin d’utiliser une fonctionnalité ou un service qui nécessite un rôle lié à un service, nous vous recommandons de supprimer ce rôle. Si vous supprimez ce rôle, vous ne retenez que les entités qu’Amazon Cognito surveille ou gère activement. Avant de supprimer des rôles AmazonCognitoIdp ou des rôles AmazonCognitoIdpEmailService liés à un service, vous devez effectuer l'une des opérations suivantes pour chaque groupe d'utilisateurs qui utilise le rôle :

• Supprimer le groupe d’utilisateurs.

• Mettre à jour les paramètres de messagerie dans le groupe d’utilisateurs afin d’utiliser la fonctionnalité de messagerie par défaut. Le paramètre par défaut n’utilise pas le rôle lié à un service.

N'oubliez pas d'exécuter l'action dans chacune d'elles Région AWS avec un groupe d'utilisateurs utilisant le rôle.

Note

Si le service Amazon Cognito 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 un groupe d’utilisateurs Amazon Cognito

1. Connectez-vous à la console Amazon Cognito AWS Management Console et ouvrez-la à l'adresse. https://console.aws.amazon.com/cognito

2. Sélectionnez Gérer les groupes d’utilisateurs.

3. Sur la page Vos groupes d’utilisateurs, choisissez le groupe d’utilisateurs que vous souhaitez supprimer.

4. Sélectionnez Supprimer le groupe.

5. Dans la fenêtre Supprimer un groupe d’utilisateurs, saisissez delete, puis choisissez Supprimer le groupe.

Pour mettre à jour un groupe d’utilisateurs Amazon Cognito afin qu’il utilise la fonctionnalité de courriel par défaut

1. Connectez-vous à la console Amazon Cognito AWS Management Console et ouvrez-la à l'adresse. https://console.aws.amazon.com/cognito

2. Sélectionnez Gérer les groupes d’utilisateurs.

3. Sur la page Vos groupes d’utilisateurs, choisissez le groupe d’utilisateurs que vous souhaitez mettre à jour.

4. Dans le menu de navigation de gauche, choisissez Personnalisation des messages.

5. Sous Voulez-vous envoyer des e-mails via votre SES configuration Amazon ? , choisissez Non - Utiliser Cognito (par défaut).

6. Une fois que vous avez défini les options de votre compte de messagerie, choisissez Enregistrer les modifications.

Pour supprimer manuellement le rôle lié à un service à l'aide de IAM

Utilisez la IAM console AWS CLI, le ou le AWS API pour supprimer des rôles AmazonCognitoIdp ou AmazonCognitoIdpEmailService liés à un service. Pour plus d'informations, consultez la section Suppression d'un rôle lié à un service dans le Guide de l'IAMutilisateur.

Régions prises en charge pour les rôles liés à un service Amazon Cognito

Amazon Cognito prend en charge les rôles liés au service partout Régions AWS où le service est disponible. Pour plus d’informations, consultez Régions AWS and Endpoints.