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.

Locataires

Ce chapitre explique comment utiliser la gestion des locataires Amazon SES pour isoler, surveiller et gérer l'envoi d'e-mails entre plusieurs locataires au sein de votre compte SES. Cette fonctionnalité aide les fournisseurs de logiciels indépendants (ISVs), les entreprises et les organisations qui envoient des e-mails au nom de plusieurs entités en aval à maintenir des profils de réputation distincts et à éviter que les problèmes liés à un client n'en affectent les autres.

Qu'est-ce que la gestion des locataires ?

La gestion des locataires est une fonctionnalité qui vous permet de créer des conteneurs isolés appelés « locataires » au sein de votre compte SES. Chaque locataire peut avoir ses propres identités de messagerie, ensembles de configuration, modèles et indicateurs de réputation, ce qui garantit que les activités de courrier électronique sont complètement séparées entre les différents clients ou unités commerciales.

La gestion des locataires permet de relever le défi posé par le fait que les mauvaises pratiques d'un client en matière de courrier électronique pouvaient auparavant suspendre l'intégralité d'un compte SES, ce qui aurait des répercussions sur tous les autres clients. Grâce à l'isolation des locataires, vous pouvez gérer plusieurs flux de courrier électronique de manière indépendante tout en maintenant une supervision et un contrôle centralisés.

Un locataire sert de conteneur logique qui regroupe les ressources SES associées. Lorsque vous envoyez des e-mails au nom d'un locataire spécifique, SES suit les indicateurs de réputation et applique les politiques au niveau du locataire. Cette isolation garantit qu'un taux de rebond élevé ou un taux de plaintes de la part d'un locataire n'a pas d'impact sur la délivrabilité des e-mails envoyés par les autres locataires.

La gestion des locataires est particulièrement utile pour :

Comment fonctionne la gestion des locataires

La gestion de la réputation des locataires fonctionne en créant un conteneur logique pour vos ressources d'envoi d'e-mails. Vous attribuez des ressources spécifiques à chaque locataire, notamment des identités vérifiées (domaines et adresses e-mail), des ensembles de configuration et des modèles. Lorsque vous envoyez un e-mail au nom d'un locataire, vous le spécifiez dans votre appel d'API ou dans votre en-tête SMTP, et SES vérifie que les ressources utilisées sont correctement associées à ce locataire.

Association de ressources

Les ressources de votre compte SES peuvent être associées aux locataires de deux manières :

Lorsque vous associez une ressource à un locataire, celui-ci obtient l'autorisation d'utiliser cette ressource pour envoyer des e-mails. À chaque demande d'envoi, SES vérifie que le locataire spécifié est autorisé à utiliser l'identité, le jeu de configuration et le modèle contenus dans la demande. Si les ressources ne sont pas correctement associées, la demande d'envoi échoue.

Surveillance et application de la réputation

SES surveille en permanence les indicateurs clés de réputation de chaque locataire, notamment les taux de rebond, les taux de plaintes (y compris ceux provenant du système Feedback Loop (FBL) du fournisseur de boîtes aux lettres) et les signaux de feedback provenant de tiers. Lorsque ces indicateurs dépassent les seuils définis, SES crée des « résultats de réputation » classés comme suit :

Sur la base de ces résultats, SES peut automatiquement suspendre les locataires problématiques grâce à des politiques de réputation que vous configurez. Trois niveaux d'application sont disponibles :

Lorsque les statistiques d'un locataire déclenchent une constatation de réputation qui atteint le seuil d'application en vertu de la politique que vous avez sélectionnée, le système met automatiquement à jour le statut d'envoi du locataire sur « Suspendu » sans affecter la capacité d'envoi des autres locataires. Lorsqu'un locataire est suspendu, toute tentative d'envoi de courrier électronique par ce locataire échouera tant que vous n'aurez pas examiné le problème et que vous n'aurez pas réactivé manuellement l'envoi. En outre, vous pouvez suspendre manuellement les fonctionnalités d'envoi d'un locataire en cas de besoin et les annuler lorsque vous êtes prêt à reprendre l'envoi.

Configuration des locataires

Création de locataires

À l'aide de la console :

À l'aide du AWS CLI :

aws sesv2 create-tenant \
    --tenant-name "MyTenant" \
    --region us-east-1

Affectation de ressources à un locataire

Après avoir créé un locataire, vous devez attribuer au moins une identité vérifiée et un ensemble de configuration avant que le locataire puisse envoyer un e-mail.

À l'aide de la console :

À l'aide du AWS CLI :

# Assign an identity to a tenant
aws sesv2 create-tenant-resource-association \
    --tenant-name "MyTenant" \
    --resource-arn "arn:aws:ses:us-east-1:123456789012:identity/example.com" \
    --region us-east-1

# Assign a configuration set to a tenant
aws sesv2 create-tenant-resource-association \
    --tenant-name "MyTenant" \
    --resource-arn "arn:aws:ses:us-east-1:123456789012:configuration-set/MyConfigSet" \
    --region us-east-1

Configuration des politiques de réputation

Les politiques de réputation déterminent à quel moment l'envoi d'e-mails d'un locataire est automatiquement suspendu en fonction des indicateurs de réputation. Lorsque vous créez un locataire, SES attribue automatiquement la politique de réputation standard. Suivez les étapes ci-dessous si vous souhaitez passer à une autre politique.

À l'aide de la console :

À l'aide du AWS CLI :

update-reputation-entity-policy \
    --reputation-entity-type "RESOURCE" \
    --reputation-entity-reference "arn:aws:ses:us-east-1:123456789012:tenant/tenantId" \
    --reputation-entity-policy "arn:aws:ses:us-east-1:aws:reputation-policy/standard"

Envoi d'un e-mail aux locataires

Lorsque vous envoyez un e-mail via un tenant, vous devez le spécifier dans vos appels d'API ou vos en-têtes SMTP et vous assurer que toutes les ressources utilisées sont associées à ce locataire.

Utilisation de l' SendEmail API avec les locataires

AWS CLI Exemple :

aws sesv2 send-email \
  --tenant-name "MyTenant" \
  --from-email-address "sender@example.com" \
  --destination "ToAddresses=recipient@example.com" \
  --content "Simple={Subject={Data='Test Subject',Charset=utf-8},Body={Text={Data='Test email body',Charset=utf-8}}}" \
  --configuration-set-name "MyConfigSet"

AWS Exemple de SDK pour Python :

import boto3

client = boto3.client('sesv2')
response = client.send_email(
    FromEmailAddress='sender@example.com',
    Destination={
        'ToAddresses': ['recipient@example.com']
    },
    Content={
        'Simple': {
            'Subject': {
                'Data': 'Test email'
            },
            'Body': {
                'Text': {
                    'Data': 'This is a test email sent using a tenant.'
                }
            }
        }
    },
    ConfigurationSetName='MyConfigurationSet',
     TenantName='MyTenant'
)

Utilisation du protocole SMTP avec les locataires

Lorsque vous utilisez le protocole SMTP pour envoyer un e-mail via un locataire, incluez les informations du locataire dans un en-tête d'e-mail :

X-SES-TENANT: MyTenant

Cet en-tête indique à SES quel locataire doit être utilisé pour l'opération d'envoi d'e-mails, ce qui permet à SES d'appliquer la validation des ressources et le suivi de réputation appropriés.

Gestion du statut des locataires

Afficher le statut et les statistiques des locataires

À l'aide de la console :

À l'aide du AWS CLI :

# Get tenant details
aws sesv2 get-tenant --tenant-name "MyTenant"

Suspendre et annuler la suspension des locataires

Vous pouvez suspendre manuellement les fonctionnalités d'envoi d'un locataire en cas de besoin et les annuler lorsque vous êtes prêt à reprendre l'envoi.

À l'aide de la console :

À l'aide du AWS CLI :

Pour suspendre un locataire :

# Pause a tenant
aws sesv2 update-reputation-entity-customer-managed-status \
  --reputation-entity-type RESOURCE 
  --reputation-entity-reference "arn:aws:ses:us-east-1:593442965613:tenant/tenantId"
  --sending-status DISABLED

Pour annuler la pause d'un locataire :

# Unpause a tenant
aws sesv2 update-reputation-entity-customer-managed-status \
  --reputation-entity-type RESOURCE 
  --reputation-entity-reference "arn:aws:ses:us-east-1:593442965613:tenant/tenantId"
  --sending-status ENABLED

Travailler avec les résultats de réputation

Afficher les résultats de réputation

À l'aide de la console :

À l'aide du AWS CLI :

aws sesv2 list-recommendations \
   --filter='{ "RESOURCE_ARN":"arn:aws:ses:us-east-1:012345678901:tenant/tenantId"}'

La réponse inclut des détails sur tous les résultats actifs :

{
    "Recommendations": [
        {
            "ResourceArn": "arn:aws:ses:us-east-1:012345678901:tenant/{tenant-name}/{tenant-id}",
            "Type": "BOUNCE",
            "Description": "The bounce rate exceeded 15.0% based on a representative volume of 664 emails from July 11, 2025 at 14:41 (UTC) to July 11, 2025 at 16:26 (UTC).",
            "Status": "OPEN",
            "CreatedTimestamp": "2025-07-11T16:16:14.029000+00:00",
            "LastUpdatedTimestamp": "2025-07-11T16:37:14.145000+00:00",
            "Impact": "HIGH"
        }
    ]
}

Comprendre les résultats relatifs à la réputation

Les résultats de réputation fournissent des informations sur les problèmes potentiels liés aux pratiques d'envoi d'e-mails de vos locataires. Chaque résultat inclut :

Les résultats courants incluent :

Résoudre les problèmes de réputation

Lorsque vous recevez une constatation de réputation, il est important d'en rechercher la cause première et de prendre rapidement des mesures correctives :

Surveillance et analytique

Configuration des CloudWatch métriques

SES publie des statistiques spécifiques aux locataires sur Amazon. CloudWatch Les mesures suivantes sont disponibles pour chaque locataire :

Configuration des EventBridge notifications

Par défaut, SES envoie des événements au bus d'événements EventBridge par défaut lorsque des informations relatives à la réputation du locataire sont détectées ou lorsque le statut du locataire change.

Vous pouvez créer des règles sur le bus d'événements par défaut afin d'identifier des événements spécifiques EventBridge à envoyer à une ou plusieurs cibles spécifiées.

Les types de détails suivants sont disponibles :

Pour les modifications de statut envoyées par le locataire :

Pour les résultats relatifs à la réputation :

Exemple de modèle de EventBridge règles pour les résultats de réputation :

{
  "detail-type": "Advisor Recommendation Status Open",
  "source": "aws.ses",
  "account": "012345678901",
  "time": "2023-11-15T17:00:59Z",
  "region": "us-east-1",
  "resources": [
    "arn:aws:ses:us-east-1:012345678901:tenant/{tenant-name}/{tenant-id}"
  ],
  "detail": { 
       "version": "1.0.0",
       "data": "The bounce rate exceeded 15.0% based on a representative volume of 197 emails from July 11, 2025 at 14:43 (UTC) to July 11, 2025 at 16:13 (UTC).",
       "metadata":{"impact":"HIGH","type":"BOUNCE"}
  
    }
}

Exemple de modèle de EventBridge règle pour l'envoi de modifications de statut :

{
        "detail-type": "Sending Status Disabled",
        "source": "aws.ses",
        "account": "012345678901",
        "time": "2025-07-24T12:44:28Z",
        "region": "us-east-1",
        "resources": [
            "arn:aws:ses:us-east-1:012345678901:tenant/{tenant-name}/{tenant-id}"
        ],
        "detail": {
            "version": "1.0.0",
            "data": {
                "origin": "CUSTOMER_MANAGED",
                "record": {
                    "status": "DISABLED",
                    "cause": "Status manually updated.",
                    "lastUpdatedTimestamp": [2025, 7, 24, 12, 44, 28, 995000000]
                }
            }
        }
    }

Descriptions des champs :

Vous pouvez utiliser ces événements pour surveiller les changements de statut des locataires et automatiser les réponses dans vos applications. Par exemple, vous souhaiterez peut-être déclencher des alertes lorsque les locataires sont désactivés ou suivre les indicateurs de santé des locataires au fil du temps.

Intégration avec AWS Trust & Safety

Lorsque AWS Trust & Safety détecte des problèmes qui devraient normalement entraîner une application au niveau du compte, le système des locataires permet des réponses plus ciblées. Au lieu de suspendre l'intégralité de votre compte, Trust & Safety peut suspendre uniquement les locataires problématiques tout en permettant aux locataires conformes de continuer à envoyer.

Cette application au niveau du locataire réduit l'impact des problèmes de réputation et permet de maintenir la continuité des activités pour vos autres flux de courrier électronique.

Vous recevrez des notifications lorsque SES aura désactivé l'envoi en raison de problèmes graves affectant la réputation du locataire et aura soumis votre compte à un examen. Un dossier vous sera ouvert dans le AWS Support Center afin que vous puissiez travailler avec Trust & Safety pour résoudre les problèmes et rétablir l'envoi pour le locataire concerné.

Bonnes pratiques

Suivez ces bonnes pratiques pour gérer efficacement la réputation des locataires dans Amazon SES :

Limites

Lorsque vous utilisez la gestion des locataires, tenez compte des limites suivantes :

Tarification

Des frais supplémentaires sont facturés par locataire et par mois en fonction du nombre de courriels. Pour obtenir des informations détaillées sur les tarifs, consultez la page de tarification de SES.

Lors de l'utilisation CloudWatch avec les métriques des locataires, CloudWatch les métriques standard pour chaque locataire sont fournies sans frais supplémentaires dans le cadre de la surveillance de base. Des CloudWatch fonctionnalités supplémentaires telles que des tableaux de bord personnalisés, des alarmes ou une surveillance détaillée peuvent entraîner des frais standard CloudWatch.