View a markdown version of this page

Envoi d'e-mails au nom du propriétaire d'identité pour l'autorisation d'envoi Amazon SES - Amazon Simple Email Service

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

    SourceArn

    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 Source de SendRawEmail.

    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 dans SourceArn.

    FromArn

    ARN 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.

    ReturnPathArn

    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 ReturnPath de SendRawEmail.

  • 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-ARN

    Correspond à SourceArn.

    X-SES-FROM-ARN

    Correspond à FromArn.

    X-SES-RETURN-PATH-ARN

    Correspond à 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

SourceArn

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 Source de SendEmail ou SendTemplatedEmail.

ReturnPathArn

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 ReturnPath de SendEmail ou SendTemplatedEmail.

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.