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 éditeurs de logiciels indépendants (ISV), les entreprises et les organisations qui envoient des e-mails pour le compte de plusieurs entités en aval à conserver des profils de réputation distincts et à éviter que les problèmes liés à un locataire n'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 » dans votre compte SES. Chaque locataire peut disposer de ses propres identités de messagerie, de ses propres ensembles de configuration, de ses modèles et de ses propres indicateurs de réputation, ce qui garantit que les activités de messagerie sont complètement séparées entre les différents clients ou unités commerciales.

La gestion des locataires permet de résoudre le problème suivant : les mauvaises pratiques d'un client en matière de courrier électronique pouvaient entraîner la suspension de l'intégralité d'un compte SES, affectant ainsi tous les autres clients. Grâce à l'isolation des locataires, vous pouvez gérer plusieurs flux d'e-mails de manière indépendante tout en maintenant une supervision et un contrôle centralisés.

Un tenant sert de conteneur logique qui regroupe les ressources SES associées. Lorsque vous envoyez des e-mails pour le compte d'un locataire spécifique, SES suit les indicateurs de réputation et applique les politiques au niveau du locataire. Cet isolement garantit qu'un taux de rebond ou de plainte élevé de la part d'un locataire n'a pas d'impact sur la délivrabilité des e-mails envoyés par d'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 pour le compte d'un locataire, vous spécifiez le locataire 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 l'envoi d'e-mails. À chaque demande d'envoi, SES confirme 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 principaux indicateurs 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 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 recherche 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 d'e-mail à l'aide de ce locataire échouera tant que vous n'aurez pas examiné le problème et réactivé manuellement l'envoi. En outre, vous pouvez suspendre manuellement les capacités d'envoi d'un locataire si nécessaire, 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 de AWS CLI :

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

Attribuer des 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 des e-mails.

À l'aide de la console :

À l'aide de 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 quand 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 de 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'e-mails aux locataires

Lorsque vous envoyez un e-mail via un locataire, vous devez spécifier le locataire 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 relatives au 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 de AWS CLI :

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

Interrompre et suspendre les locataires

Vous pouvez suspendre manuellement les capacités d'envoi d'un locataire si nécessaire, et les annuler lorsque vous êtes prêt à reprendre l'envoi.

À l'aide de la console :

À l'aide de 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

Utilisation des résultats relatifs à la réputation

Affichage des résultats relatifs à la réputation

À l'aide de la console :

À l'aide de 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 en matière de réputation

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

Les résultats les plus courants sont les suivants :

Résoudre les problèmes de réputation

Lorsque vous recevez un résultat 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 statistiques 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 résultats de réputation du locataire sont détectés 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 des locataires qui envoient des modifications :

Pour en savoir plus sur 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 suivre l'évolution du statut des locataires et automatiser les réponses dans vos applications. Par exemple, vous souhaiterez peut-être déclencher des alertes lorsque des locataires sont désactivés ou suivre les indicateurs de santé des locataires au fil du temps.

Intégration à AWS Confiance & et sécurité

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 contribue à 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 des locataires et aura placé votre compte en cours de révision. Un dossier vous sera ouvert dans le centre d' AWS assistance 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 :

Tenant-level listes de suppression

Par défaut, tous les locataires de votre compte partagent la liste de suppression au niveau du compte. Cela signifie que lorsqu'un destinataire rebondit ou se plaint de l'adresse e-mail d'un locataire, cette adresse est supprimée pour chaque locataire du compte. Tenant-level les listes de suppression résolvent ce problème en donnant à chaque locataire sa propre liste de suppression isolée.

Lorsque vous activez la suppression au niveau du locataire pour un locataire, SES gère une liste de suppression distincte pour ce locataire. Les rebonds et les plaintes concernent uniquement le locataire qui a envoyé l'e-mail. Les autres locataires peuvent continuer à envoyer aux mêmes destinataires. Vous configurez la suppression au niveau du locataire en définissant le SuppressionScope to TENANT et en choisissant lequel SuppressedReasons (rebonds, plaintes, ou les deux) à suivre.

Pour des informations complètes sur la configuration et la gestion des listes de suppression au niveau des locataires, consultez. Utilisation de listes de suppression au niveau des locataires dans Amazon SES

Limitations

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

Tarification

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

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