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.
Envoi d'e-mails au nom du propriétaire d'identité pour l'autorisation d'envoi Amazon SES
En tant qu'expéditeur délégué, vous envoyez les e-mails de la même façon que les autres expéditeurs Amazon SES, sauf que vous fournissez l'Amazon Resource Name (ARN) de l'identité que son propriétaire vous a autorisé à utiliser. Lorsque vous appelez Amazon SES pour envoyer l'e-mail, Amazon SES vérifie si l'identité que vous avez spécifiée est associée à une stratégie qui vous autorise à effectuer un envoi pour ladite identité.
Il existe différentes façon de spécifier l'ARN de l'identité au moment d'envoyer un e-mail. La méthode que vous utilisez varie selon que vous envoyez l'e-mail à l'aide des opérations de l'API Amazon SES ou de l'interface SMTP Amazon SES.
Important
-
Pour envoyer un e-mail avec succès, vous devez vous connecter au point de terminaison Amazon SES dans le AWS Région dans laquelle le titulaire de l'identité a vérifié l'identité.
-
En outre, le AWS comptes de tous les deux le propriétaire de l'identité et l'expéditeur délégué doivent être retirés du sandbox avant que l'un ou l'autre des comptes puisse envoyer des e-mails à des adresses non vérifiées. Pour plus d’informations, consultez Demander un accès à la production (sortie du sandbox Amazon SES).
-
Si l'identité que vous avez été autorisé à utiliser est dupliquée dans une région secondaire dans le cadre du Points de terminaison mondiaux caractéristique :
-
Le propriétaire de l'identité aurait dû vous fournir un ARN d'identité contenant le paramètre region, tel que
us-east-1, remplacé par un astérisque*comme dans l'exemple suivant,arn:aws:ses:*:123456789012:identity/user@example.com. -
Le propriétaire de l'identité doit avoir créé des politiques d'autorisation d'envoi pour vous dans les régions principale et secondaire.
-
Utilisation de l'API Amazon SES
Comme pour tout expéditeur d'e-mails Amazon SES, si vous accédez à Amazon SES via l'API Amazon SES (soit directement via HTTPS, soit indirectement via un AWS SDK), vous pouvez choisir entre l'une des trois actions d'envoi d'e-mails suivantes : SendEmail, SendTemplatedEmail, et SendRawEmail. Le document Référence d'API Amazon Simple Email Service décrit en détail ces API, mais nous offrons ici une présentation des paramètres d'autorisation d'envoi.
SendRawEmail
Si vous souhaitez utiliser SendRawEmail afin de contrôler le format de vos e-mails, vous pouvez spécifier l'identité entre comptes de deux manières différentes :
-
Transmettez les paramètres facultatifs à l'
SendRawEmailAPI. Les paramètres requis sont décrits dans le tableau suivant :Paramètre
Description
SourceArnARN de l'identité associée à la stratégie d'autorisation d'envoi qui vous permet d'effectuer un envoi pour l'adresse e-mail spécifiée dans le paramètre
SourcedeSendRawEmail.Note
Si vous spécifiez uniquement
SourceArn, Amazon SES définit les adresses d'expédition (From) et de chemin de retour (Return-Path (Chemin de retour)) avec l'identité spécifiée dansSourceArn.FromArnARN de l'identité associée à la stratégie d'autorisation d'envoi qui vous permet de spécifier une adresse d'expédition déterminée dans l'en-tête de l'e-mail brut.
ReturnPathArnARN de l'identité associée à la stratégie d'autorisation d'envoi qui vous permet d'utiliser l'adresse e-mail spécifiée dans le paramètre
ReturnPathdeSendRawEmail. -
Inclure X-headers dans l'e-mail. X-headers sont des en-têtes personnalisés que vous pouvez utiliser en plus des en-têtes d'e-mail standard (tels que le From, Reply-To, ou en-têtes d'objet). Amazon SES en reconnaît trois X-headers que vous pouvez utiliser pour spécifier les paramètres d'autorisation d'envoi :
Important
Ne les incluez pas X-headers dans la signature DKIM, car ils sont supprimés par Amazon SES avant l'envoi de l'e-mail.
X-Header
Description
X-SES-SOURCE-ARNCorrespond à
SourceArn.X-SES-FROM-ARNCorrespond à
FromArn.X-SES-RETURN-PATH-ARNCorrespond à
ReturnPathArn.Amazon SES supprime tout X-headers depuis l'e-mail avant de l'envoyer. Si vous incluez plusieurs instances d'un X-header, Amazon SES utilise uniquement la première instance.
L'exemple suivant montre un e-mail qui inclut une autorisation d'envoi. X-headers:
X-SES-SOURCE-ARN: arn:aws:ses:us-east-1:123456789012:identity/example.com X-SES-FROM-ARN: arn:aws:ses:us-east-1:123456789012:identity/example.com X-SES-RETURN-PATH-ARN: arn:aws:ses:us-east-1:123456789012:identity/example.com From: sender@example.com To: recipient@example.com Return-Path: feedback@example.com Subject: subject Content-Type: multipart/alternative; boundary="----=_boundary" ------=_boundary Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 7bit body ------=_boundary Content-Type: text/html; charset=UTF-8 Content-Transfer-Encoding: 7bit body ------=_boundary--
SendEmail et SendTemplatedEmail
Si vous utilisez l'opération SendEmail ou SendTemplatedEmail, vous pouvez spécifier l'identité entre comptes en transmettant les paramètres facultatifs ci-dessous. Vous ne pouvez pas utiliser X-header méthode lorsque vous utilisez SendEmail ou SendTemplatedEmail opération.
Paramètre |
Description |
|---|---|
|
ARN de l'identité associée à la stratégie d'autorisation d'envoi qui vous permet d'effectuer un envoi pour l'adresse e-mail spécifiée dans le paramètre |
|
ARN de l'identité associée à la stratégie d'autorisation d'envoi qui vous permet d'utiliser l'adresse e-mail spécifiée dans le paramètre |
L'exemple suivant montre comment envoyer un e-mail contenant le SourceArn et ReturnPathArn attributs à l'aide de SendEmail ou SendTemplatedEmail fonctionnement et AWS SDK pour Python (Boto3)
import boto3 from botocore.exceptions import ClientError # Create a new SES resource and specify a region. client = boto3.client('ses',region_name="us-east-1") # Try to send the email. try: #Provide the contents of the email. response = client.send_email( Destination={ 'ToAddresses': [ 'recipient@example.com', ], }, Message={ 'Body': { 'Html': { 'Charset': 'UTF-8', 'Data': 'This email was sent with Amazon SES.', }, }, 'Subject': { 'Charset': 'UTF-8', 'Data': 'Amazon SES Test', }, }, SourceArn='arn:aws:ses:us-east-1:123456789012:identity/example.com', ReturnPathArn='arn:aws:ses:us-east-1:123456789012:identity/example.com', Source='sender@example.com', ReturnPath='feedback@example.com' ) # Display an error if something goes wrong. except ClientError as e: print(e.response['Error']['Message']) else: print("Email sent! Message ID:", response['MessageId'])
Utilisation de l'interface SMTP Amazon SES
Lorsque vous utilisez l'interface SMTP Amazon SES pour l'envoi entre comptes, vous devez inclure les en-têtes X-SES-SOURCE-ARN, X-SES-FROM-ARN et X-SES-RETURN-PATH-ARN dans votre message. Transmettez ces en-têtes une fois que vous avez émis la commande DATA dans la conversation SMTP.