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.
Gestion des identités et des accès dans Amazon SES
Vous pouvez utiliser AWS Identity and Access Management (IAM) avec Amazon Simple Email Service (Amazon SES) pour spécifier les actions d'API SES qu'un utilisateur, un groupe ou un rôle peut effectuer. (Dans cette rubrique, nous nous référons à ces entités collectivement comme utilisateur.) Vous pouvez également contrôler les adresses électroniques que l'utilisateur peut utiliser pour le destinataire « From » et les adresses « Return-Path (Chemin de retour) » des e-mails.
Par exemple, vous pouvez créer une stratégie IAM permettant aux utilisateurs de votre organisation d'envoyer des e-mails, mais pas d'exécuter des actions administratives comme la vérification des statistiques d'envoi. Autre exemple, vous pouvez écrire une stratégie qui permet à un utilisateur d'envoyer des emails via SES à partir de votre compte, mais uniquement s'ils utilisent une adresse d'expédition spécifique.
Pour utiliser IAM, vous définissez une stratégie IAM, qui est un document définissant explicitement les autorisations et attachez la stratégie à un utilisateur. Pour savoir comment créer des stratégies IAM, consultez le guide de l'utilisateur IAM. En dehors de l'application des restrictions que vous définissez dans votre stratégie, il n'y a pas de modifications sur la façon dont les utilisateurs interagissent avec SES ou dans la façon dont SES exécute les demandes.
Note
-
Si votre compte se trouve dans l'application de données (sandbox) SES, ses restrictions empêchent la mise en œuvre de certaines de ces politiques. Voir Demander un accès de production.
-
Vous pouvez également contrôler l'accès à SES en utilisant les stratégies d'autorisation d'envoi. Si les stratégies IAM limitent les actions que les utilisateurs peuvent effectuer, les stratégies d'autorisation d'envoi limitent la façon dont les identités vérifiées peuvent être utilisées. De plus, seules les stratégies d'autorisation d'envoi peuvent accorder l'accès entre comptes. Pour en savoir plus sur l'autorisation d'envoi, consultez Utilisation de l'autorisation d'envoi avec Amazon SES.
Si vous recherchez des informations sur la manière de générer des informations d'identification SMTP SES pour un utilisateur, consultez Obtention des SES SMTP informations d'identification Amazon.
Création de stratégies IAM pour l'accès à SES
Cette section explique comment vous pouvez utiliser les stratégies IAM plus particulièrement avec SES. Pour apprendre à créer des stratégies IAM en général, consultez le guide de l'utilisateur IAM.
Il existe trois raisons pour utiliser IAM avec SES :
-
Limiter l'action d'envoi d'e-mails.
-
Limiter les adresses « From », destinataire et « Return-Path (Chemin de retour) » des e-mails que l'utilisateur envoie.
-
Contrôler les aspects généraux de l'utilisation de l'API tels que la durée pendant laquelle un utilisateur est autorisé à appeler l'API qu'il est habilité à utiliser.
Restriction de l'action
Pour contrôler quelles actions SES un utilisateur peut effectuer, vous utilisez l'élément Action
d'une stratégie IAM. Vous pouvez définir l'élément Action
sur n'importe quelle action d'API SES en préfixant le nom d'API avec la chaîne en minuscules ses:
. Par exemple, vous pouvez définir Action
sur ses:SendEmail
, ses:GetSendStatistics
ou ses:*
(pour toutes les actions).
Ensuite, selon Action
, spécifiez l'élément Resource
comme suit :
Si l'élément Action
n'autorise l'accès qu'aux API d'envoi d'e-mails (c'est-à-dire, ses:SendEmail
et/ou ses:SendRawEmail
) :
-
Pour autoriser l'utilisateur à envoyer à partir de n'importe quelle identité figurant dans le vôtre Compte AWS, réglez
Resource
sur * -
Pour restreindre les identités à partir desquelles un utilisateur est autorisé à effectuer des envois, définissez
Resource
sur les ARN des identités que vous autorisez l'utilisateur à employer.
Si l'élément Action
autorise l'accès à toutes les API :
-
Si vous ne souhaitez pas restreindre les identités à partir desquelles l'utilisateur peut effectuer des envois, définissez
Resource
sur * -
Si vous souhaitez restreindre les identités à partir desquelles un utilisateur est autorisé à effectuer des envois, vous devez créer deux stratégies (ou deux instructions dans une stratégie) :
-
Un avec
Action
défini sur une liste explicite des non-email-sending API autorisées etResource
défini sur * -
L'une avec
Action
définie sur l'une des API d'envoi d'e-mails (ses:SendEmail
et/ouses:SendRawEmail
) etResource
défini sur l'ARN ou les ARN des identités que vous autorisez l'utilisateur à utiliser.
-
Pour obtenir la liste des actions SES disponibles, consultez le document Référence d'API Amazon Simple Email Service. Si l'utilisateur se sert de l'interface SMTP, vous devez autoriser l'accès à ses:SendRawEmail
au minimum.
Restriction des adresses e-mail
Si vous voulez restreindre l'utilisateur à certaines adresses e-mail, vous pouvez utiliser un bloc Condition
. Dans le bloc Condition
, vous spécifiez les conditions à l'aide de clés de condition comme décrit dans le guide de l'utilisateur IAM. En utilisant les clés de condition, vous pouvez contrôler les adresses électroniques suivantes :
Note
Ces clés de condition d'adresse e-mail s'appliquent uniquement aux API indiquées dans le tableau suivant.
Clé de condition |
Description |
API |
---|---|---|
|
Restreint les adresses des destinataires, qui incluent les adresses « To: », « CC » et « BCC ». |
|
|
Limite l'adresse d'expédition. |
|
|
Limite l'adresse d'expédition utilisée comme nom d'affichage. |
|
|
Limite l'adresse « Return-Path (Chemin de retour) », qui est l'adresse à laquelle les retours à l'expéditeur et les réclamations peuvent vous être envoyés via le transfert de commentaires par e-mail. Pour en savoir plus sur le transfert de commentaires par e-mail, consultez Réception des notifications Amazon SES par e-mail. |
|
Restriction par la version de l'API SES
En utilisant la clé ses:ApiVersion
dans les conditions, vous pouvez restreindre l'accès à SES en fonction de la version de l'API SES.
Note
L'interface SMTP SES utilise l'API SES version 2 de ses:SendRawEmail
.
Restriction de l'utilisation de l'API générale
En utilisant des AWS touches « wide » dans certaines conditions, vous pouvez restreindre l'accès à SES en fonction d'aspects tels que la date et l'heure auxquelles l'utilisateur est autorisé à accéder aux API. SES implémente uniquement les clés AWS de politique générales suivantes :
-
aws:CurrentTime
-
aws:EpochTime
-
aws:SecureTransport
-
aws:SourceIp
-
aws:SourceVpc
-
aws:SourceVpce
-
aws:UserAgent
-
aws:VpcSourceIp
Pour en savoir plus sur ces clés, consultez le guide de l'utilisateur IAM.
Exemples de stratégies IAM pour SES
Cette rubrique fournit des exemples de stratégies qui permettent un accès utilisateur à SES, mais uniquement sous certaines conditions.
Exemples de stratégie dans cette section :
- Autorisation de l'accès complet à toutes les actions SES
- Autorisation de l'accès à l'API SES version 2 uniquement
- Autorisation de l'accès aux actions d'envoi d'e-mail uniquement
- Restriction de la période d'envoi
- Restriction des adresses des destinataires
- Restriction de l'adresse d'expédition
- Restriction du nom d'affichage de l'expéditeur de l'e-mail
- Restriction de la destination des commentaires de retour à l'expéditeur et de réclamation
Autorisation de l'accès complet à toutes les actions SES
La stratégie suivante permet à un utilisateur d'appeler n'importe quelle action SES.
{ "Version":"2012-10-17", "Statement":[ { "Effect":"Allow", "Action":[ "ses:*" ], "Resource":"*" } ] }
Autorisation de l'accès à l'API SES version 2 uniquement
La stratégie suivante permet à un utilisateur d'appeler uniquement les actions SES de l'API version 2.
{ "Version":"2012-10-17", "Statement":[ { "Effect":"Allow", "Action":[ "ses:*" ], "Resource":"*", "Condition": { "StringEquals" : { "ses:ApiVersion" : "2" } } } ] }
Autorisation de l'accès aux actions d'envoi d'e-mail uniquement
La stratégie suivante permet à un utilisateur d'envoyer des e-mails avec SES, mais ne permet pas à l'utilisateur d'exécuter des actions administratives, telles que l'accès aux statistiques d'envoi SES.
{ "Version":"2012-10-17", "Statement":[ { "Effect":"Allow", "Action":[ "ses:SendEmail", "ses:SendRawEmail" ], "Resource":"*" } ] }
Restriction de la période d'envoi
La stratégie suivante permet à un utilisateur d'appeler les API d'envoi d'e-mails SES uniquement pendant le mois de septembre 2018.
{ "Version":"2012-10-17", "Statement":[ { "Effect":"Allow", "Action":[ "ses:SendEmail", "ses:SendRawEmail" ], "Resource":"*", "Condition":{ "DateGreaterThan":{ "aws:CurrentTime":"2018-08-31T12:00Z" }, "DateLessThan":{ "aws:CurrentTime":"2018-10-01T12:00Z" } } } ] }
Restriction des adresses des destinataires
La stratégie suivante permet à un utilisateur d'appeler les API SES d'envoi d'e-mails, mais uniquement pour les adresses de destinataires du domaine example.com (StringLike
est sensible à la casse).
{ "Version":"2012-10-17", "Statement":[ { "Effect":"Allow", "Action":[ "ses:SendEmail", "ses:SendRawEmail" ], "Resource":"*", "Condition":{ "ForAllValues:StringLike":{ "ses:Recipients":[ "*@example.com" ] } } } ] }
Restriction de l'adresse d'expédition
La stratégie suivante permet à un utilisateur d'appeler les API SES d'envoi d'e-mails, mais uniquement si l'adresse d'expédition est marketing@example.com.
{ "Version":"2012-10-17", "Statement":[ { "Effect":"Allow", "Action":[ "ses:SendEmail", "ses:SendRawEmail" ], "Resource":"*", "Condition":{ "StringEquals":{ "ses:FromAddress":"marketing@example.com" } } } ] }
La politique suivante permet à un utilisateur d'appeler l'SendBounceAPI, mais uniquement si l'adresse « De » est bounce@example.com.
{ "Version":"2012-10-17", "Statement":[ { "Effect":"Allow", "Action":[ "ses:SendBounce" ], "Resource":"*", "Condition":{ "StringEquals":{ "ses:FromAddress":"bounce@example.com" } } } ] }
Restriction du nom d'affichage de l'expéditeur de l'e-mail
La stratégie suivante permet à un utilisateur d'appeler les API Amazon SES d'envoi d'e-mails, mais uniquement si le nom d'affichage de l'adresse d'expédition inclut Marketing (StringLike
est sensible à la casse).
{ "Version":"2012-10-17", "Statement":[ { "Effect":"Allow", "Action":[ "ses:SendEmail", "ses:SendRawEmail" ], "Resource":"*", "Condition":{ "StringLike":{ "ses:FromDisplayName":"Marketing" } } } ] }
Restriction de la destination des commentaires de retour à l'expéditeur et de réclamation
La stratégie suivante permet à un utilisateur d'appeler les API SES d'envoi d'e-mails, mais uniquement si l'adresse « Return-Path (Chemin de retour) » de l'e-mail est feedback@example.com.
{ "Version":"2012-10-17", "Statement":[ { "Effect":"Allow", "Action":[ "ses:SendEmail", "ses:SendRawEmail" ], "Resource":"*", "Condition":{ "StringEquals":{ "ses:FeedbackAddress":"feedback@example.com" } } } ] }