Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Mandanten

In diesem Kapitel wird erklärt, wie Sie das Amazon SES-Mandantenmanagement verwenden, um den E-Mail-Versand zwischen mehreren Mandanten innerhalb Ihres SES-Kontos zu isolieren, zu überwachen und zu verwalten. Diese Funktion hilft unabhängigen Softwareanbietern (ISVs), Unternehmen und Organisationen, die E-Mails im Namen mehrerer nachgelagerter Einheiten versenden, dabei, separate Reputationsprofile zu verwalten und zu verhindern, dass Probleme mit einem Mandanten sich auf andere auswirken.

Was ist Mandantenmanagement?

Die Mandantenverwaltung ist eine Funktion, mit der Sie isolierte Container, sogenannte „Mandanten“, in Ihrem SES-Konto erstellen können. Jeder Mandant kann seine eigenen E-Mail-Identitäten, Konfigurationssätze, Vorlagen und Reputationsmetriken haben, wodurch sichergestellt wird, dass die E-Mail-Aktivitäten vollständig zwischen verschiedenen Kunden oder Geschäftsbereichen getrennt sind.

Das Mandantenmanagement befasst sich mit der Herausforderung, dass die schlechten E-Mail-Praktiken eines Kunden zuvor dazu geführt haben, dass ein ganzes SES-Konto gesperrt wurde, was sich auf alle anderen Kunden auswirkte. Mit der Mandantenisolierung können Sie mehrere E-Mail-Streams unabhängig voneinander verwalten und gleichzeitig die zentrale Überwachung und Kontrolle behalten.

Ein Mandant dient als logischer Container, der verwandte SES-Ressourcen zusammenfasst. Wenn Sie E-Mails im Namen eines bestimmten Mandanten versenden, verfolgt SES Reputationskennzahlen und setzt Richtlinien auf Mandantenebene durch. Diese Isolierung stellt sicher, dass eine hohe Absprungrate oder Beschwerderate von einem Mandanten die Zustellbarkeit der von anderen Mandanten gesendeten E-Mails nicht beeinträchtigt.

Das Mietermanagement ist besonders wertvoll für:

So funktioniert das Mietermanagement

Beim Tenant Reputation Management wird ein logischer Container für Ihre Ressourcen zum Senden von E-Mails erstellt. Sie weisen jedem Mandanten bestimmte Ressourcen zu, einschließlich verifizierter Identitäten (Domänen und E-Mail-Adressen), Konfigurationssätze und Vorlagen. Wenn Sie E-Mails im Namen eines Mandanten senden, geben Sie den Mandanten in Ihrem API-Aufruf oder SMTP-Header an, und SES überprüft, ob die verwendeten Ressourcen ordnungsgemäß mit diesem Mandanten verknüpft sind.

Ressourcenzuordnung

Ressourcen in Ihrem SES-Konto können auf zwei Arten mit Mandanten verknüpft werden:

Wenn Sie eine Ressource einem Mandanten zuordnen, erhält dieser Mandant die Erlaubnis, diese Ressource für den E-Mail-Versand zu verwenden. Bei jeder Sendeanforderung überprüft SES, ob der angegebene Mandant berechtigt ist, die Identität, den Konfigurationssatz und die Vorlage in der Anfrage zu verwenden. Wenn die Ressourcen nicht richtig zugeordnet sind, schlägt die Sendeanforderung fehl.

Überwachung und Durchsetzung der Reputation

SES überwacht kontinuierlich wichtige Reputationskennzahlen für jeden Mandanten, darunter Absprungraten, Beschwerdequoten (einschließlich der Daten aus dem Feedback Loop (FBL) -System des Postfachanbieters) und Feedback-Signale von Drittanbietern. Wenn diese Kennzahlen definierte Schwellenwerte überschreiten, erstellt SES „Reputationsergebnisse“, die wie folgt kategorisiert sind:

Basierend auf diesen Ergebnissen kann SES problematische Mandanten mithilfe von Reputationsrichtlinien, die Sie konfigurieren, automatisch sperren. Drei Durchsetzungsstufen sind verfügbar:

Wenn anhand der Kennzahlen eines Mandanten eine Reputation festgestellt wird, die den Schwellenwert für die Durchsetzung gemäß Ihrer ausgewählten Richtlinie erreicht, aktualisiert das System den Sendestatus des Mandanten automatisch auf „Unterbrochen“, ohne dass die Sendefähigkeit anderer Mandanten beeinträchtigt wird. Solange ein Mandant pausiert ist, schlägt jeder Versuch, E-Mails mit diesem Mandanten zu senden, fehl, bis Sie das Problem überprüfen und das Senden manuell wieder aktivieren. Darüber hinaus können Sie die Sendefunktionen eines Mandanten bei Bedarf manuell unterbrechen und die Pause wieder aufheben, wenn Sie bereit sind, den Versand fortzusetzen.

Mieter einrichten

Mieter erstellen

Verwendung der Konsole:

Verwenden Sie AWS CLI:

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

Zuweisen von Ressourcen zu einem Mandanten

Nachdem Sie einen Mandanten erstellt haben, müssen Sie mindestens eine verifizierte Identität und einen Konfigurationssatz zuweisen, bevor der Mandant E-Mails senden kann.

Verwenden der Konsole:

Mit dem 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

Konfiguration von Reputationsrichtlinien

Reputationsrichtlinien legen anhand von Reputationskennzahlen fest, wann der E-Mail-Versand eines Mandanten automatisch unterbrochen wird. Wenn Sie einen Mandanten erstellen, weist SES automatisch die Standard-Reputationsrichtlinie zu. Gehen Sie wie folgt vor, wenn Sie zu einer anderen Richtlinie wechseln möchten.

Verwenden der Konsole:

Mit dem 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"

Senden von E-Mails mit Mietern

Wenn Sie E-Mails über einen Mandanten senden, müssen Sie den Mandanten in Ihren API-Aufrufen oder SMTP-Headern angeben und sicherstellen, dass alle verwendeten Ressourcen diesem Mandanten zugeordnet sind.

Verwenden der SendEmail API mit Mandanten

AWS CLI Beispiel:

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 SDK für Python — Beispiel:

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'
)

SMTP mit Mandanten verwenden

Wenn Sie SMTP verwenden, um E-Mails über einen Mandanten zu senden, fügen Sie die Mandanteninformationen in einen E-Mail-Header ein:

X-SES-TENANT: MyTenant

Dieser Header teilt SES mit, welcher Mandant für den E-Mail-Versand verwendet werden soll, sodass SES die entsprechende Ressourcenvalidierung und Reputationsverfolgung durchführen kann.

Verwaltung des Mandantenstatus

Mandantenstatus und Kennzahlen anzeigen

Verwendung der Konsole:

Mit dem AWS CLI:

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

Unterbrechen und Aufheben der Pausierung von Mietern

Sie können die Sendefunktionen eines Mandanten bei Bedarf manuell unterbrechen und die Pause wieder aufheben, wenn Sie bereit sind, den Versand fortzusetzen.

Verwenden der Konsole:

Verwenden Sie AWS CLI:

Um einen Mandanten zu pausieren:

# 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

So heben Sie die Pause eines Mandanten auf:

# 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

Arbeiten mit Reputationsergebnissen

Ergebnisse zur Reputation anzeigen

Verwendung der Konsole:

Verwenden Sie AWS CLI:

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

Die Antwort enthält Einzelheiten zu allen aktiven Ergebnissen:

{
    "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"
        }
    ]
}

Die Ergebnisse zur Reputation verstehen

Die Ergebnisse zur Reputation geben Aufschluss über potenzielle Probleme mit den E-Mail-Versandpraktiken Ihrer Mieter. Jedes Ergebnis beinhaltet:

Zu den häufigsten Ergebnissen gehören:

Behebung von Reputationsproblemen

Wenn Sie ein Reputationsergebnis erhalten, ist es wichtig, die eigentliche Ursache zu untersuchen und umgehend Abhilfemaßnahmen zu ergreifen:

Überwachung und Analytik

CloudWatch Metriken einrichten

SES veröffentlicht mieterspezifische Metriken bei Amazon. CloudWatch Die folgenden Metriken sind für jeden Mandanten verfügbar:

Benachrichtigungen einrichten EventBridge

Standardmäßig sendet SES Ereignisse an den EventBridge Standardereignisbus, wenn Feststellungen zur Mandantenreputation erkannt werden oder wenn sich der Mandantenstatus ändert.

Sie können Regeln auf dem Standardereignisbus erstellen, um bestimmte Ereignisse EventBridge zu identifizieren und an ein oder mehrere angegebene Ziele zu senden.

Die folgenden Detailtypen sind verfügbar:

Für Mandanten, die Statusänderungen senden:

Für Reputationsermittlungen:

Beispiel für ein EventBridge Regelmuster für Reputationsergebnisse:

{
  "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"}
  
    }
}

Beispiel für ein EventBridge Regelmuster für das Senden von Statusänderungen:

{
        "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]
                }
            }
        }
    }

Beschreibungen der Felder:

Sie können diese Ereignisse verwenden, um Änderungen am Mandantenstatus zu überwachen und Reaktionen in Ihren Anwendungen zu automatisieren. So können Sie beispielsweise Warnmeldungen auslösen, wenn Mieter deaktiviert sind, oder die Kennzahlen zum Zustand der Mandanten im Laufe der Zeit verfolgen.

Integration in AWS Vertrauen Sie der & Sicherheit

Wenn AWS Trust & Safety Probleme feststellt, die normalerweise zu einer Durchsetzung auf Kontoebene führen würden, ermöglicht das Mietersystem gezieltere Maßnahmen. Anstatt Ihr gesamtes Konto zu pausieren, kann Trust & Safety nur die problematischen Mieter pausieren, während Mieter, die sich an die Vorschriften halten, weiterhin E-Mails senden können.

Diese Durchsetzung auf Mandantenebene reduziert die Auswirkungen von Reputationsproblemen und trägt dazu bei, die Geschäftskontinuität Ihrer anderen E-Mail-Streams aufrechtzuerhalten.

Sie erhalten Benachrichtigungen, wenn SES den Versand aufgrund schwerwiegender Probleme, die den Ruf des Mandanten beeinträchtigen, deaktiviert und Ihr Konto einer Überprüfung unterzogen hat. Im AWS Support Center wird ein Fall für Sie eröffnet, sodass Sie mit Trust & Safety zusammenarbeiten können, um Probleme zu lösen und den Versand für den betroffenen Mieter wiederherzustellen.

Bewährte Methoden

Folgen Sie diesen bewährten Methoden, um den Ruf von Mandanten in Amazon SES effektiv zu verwalten:

Tenant-level Listen zur Unterdrückung

Standardmäßig teilen sich alle Mandanten in Ihrem Konto die Sperrliste auf Kontoebene. Das bedeutet, dass, wenn ein Empfänger die E-Mail eines Mandanten zurückweist oder sich über sie beschwert, diese Adresse für jeden Mandanten im Konto ausgeblendet wird. Tenant-level Unterdrückungslisten lösen dieses Problem, indem jeder Mandant seine eigene isolierte Unterdrückungsliste erhält.

Wenn Sie die Unterdrückung auf Mandantenebene für einen Mandanten aktivieren, führt SES eine separate Unterdrückungsliste für diesen Mandanten. Bounces und Beschwerden betreffen nur den Mandanten, der die E-Mail gesendet hat. Andere Mieter können weiterhin an dieselben Empfänger senden. Sie konfigurieren die Unterdrückung auf Mandantenebene, indem Sie die Option „SuppressionScopeBis“ festlegen TENANT und auswählen, welche SuppressedReasons (Bounces, Beschwerden oder beides) verfolgt werden sollen.

Vollständige Informationen zur Konfiguration und Verwaltung von Sperrlisten auf Mandantenebene finden Sie unter. Verwenden von Unterdrückungslisten auf Mandantenebene in Amazon SES

Einschränkungen

Beachten Sie bei der Verwendung von Tenant Management die folgenden Einschränkungen:

Preisgestaltung

Es gibt eine zusätzliche Gebühr pro Mieter und Monat, die sich nach der Anzahl der E-Mails richtet. Detaillierte Preisinformationen finden Sie auf der SES-Preisseite.

Bei Verwendung CloudWatch mit CloudWatch Mandantenmetriken werden die Standardmetriken für jeden Mandanten im Rahmen der grundlegenden Überwachung ohne zusätzliche Kosten bereitgestellt. Für zusätzliche CloudWatch Funktionen wie benutzerdefinierte Dashboards, Alarme oder eine detaillierte Überwachung können CloudWatch Standardgebühren anfallen.