Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Tenant

Questo capitolo spiega come utilizzare la gestione dei tenant di Amazon SES per isolare, monitorare e gestire l'invio di e-mail tra più tenant all'interno del tuo account SES. Questa funzionalità aiuta i fornitori di software indipendenti (ISVs), le aziende e le organizzazioni che inviano e-mail per conto di più entità a valle a mantenere profili di reputazione separati e a evitare che i problemi con un tenant influiscano sugli altri.

Cos'è la gestione degli inquilini?

La gestione dei tenant è una funzionalità che consente di creare contenitori isolati chiamati «tenant» all'interno del proprio account SES. Ogni tenant può avere le proprie identità e-mail, set di configurazione, modelli e metriche di reputazione, garantendo che le attività di posta elettronica siano completamente separate tra diversi clienti o unità aziendali.

La gestione dei tenant risolve il problema rappresentato dalle cattive pratiche di posta elettronica di un cliente che in precedenza potevano mettere in pausa un intero account SES, con ripercussioni su tutti gli altri clienti. Con l'isolamento dei tenant, è possibile gestire più flussi di e-mail in modo indipendente, mantenendo la supervisione e il controllo centralizzati.

Un tenant funge da contenitore logico che raggruppa le risorse SES correlate. Quando si inviano e-mail per conto di un tenant specifico, SES tiene traccia delle metriche di reputazione e applica le politiche a livello di tenant. Questo isolamento garantisce che una frequenza di rimbalzo o un tasso di reclami elevati da parte di un tenant non influisca sulla recapitabilità delle e-mail inviate da altri inquilini.

La gestione degli inquilini è particolarmente utile per:

Come funziona la gestione degli inquilini

La gestione della reputazione degli inquilini funziona creando un contenitore logico per le risorse di invio delle e-mail. Assegni risorse specifiche a ciascun tenant, tra cui identità verificate (domini e indirizzi e-mail), set di configurazione e modelli. Quando si invia un'e-mail per conto di un tenant, si specifica il tenant nella chiamata API o nell'intestazione SMTP e SES verifica che le risorse utilizzate siano associate correttamente a quel tenant.

Associazione di risorse

Le risorse del tuo account SES possono essere associate agli inquilini in due modi:

Quando si associa una risorsa a un tenant, tale tenant ottiene l'autorizzazione a utilizzare quella risorsa per l'invio di e-mail. Con ogni richiesta di invio, SES verifica che il tenant specificato sia autorizzato a utilizzare l'identità, il set di configurazione e il modello contenuti nella richiesta. Se le risorse non sono associate correttamente, la richiesta di invio fallisce.

Monitoraggio e applicazione della reputazione

SES monitora continuamente le metriche chiave sulla reputazione di ciascun inquilino, tra cui la frequenza di rimbalzo, la frequenza dei reclami (comprese quelle del sistema Feedback Loop (FBL) del provider di cassette postali) e i segnali di feedback di terze parti. Quando queste metriche superano le soglie definite, SES crea «risultati sulla reputazione» classificati come:

Sulla base di questi risultati, SES può mettere automaticamente in pausa i tenant problematici attraverso politiche di reputazione configurate dall'utente. Sono disponibili tre livelli di applicazione:

Quando le metriche di un inquilino attivano una rilevazione della reputazione che soddisfa la soglia di applicazione prevista dalla politica selezionata, il sistema aggiorna automaticamente lo stato di invio del tenant su «In pausa» senza influire sulla capacità di invio degli altri inquilini. Mentre un tenant è in pausa, qualsiasi tentativo di inviare e-mail utilizzando quel tenant fallirà finché non esaminerai il problema e riabiliterai manualmente l'invio. Inoltre, puoi mettere in pausa manualmente le funzionalità di invio di un tenant quando necessario e riattivarle quando sei pronto per riprendere l'invio.

Configurazione degli inquilini

Creazione di inquilini

Utilizzo della console:

Utilizzando: AWS CLI

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

Assegnazione di risorse a un inquilino

Dopo aver creato un tenant, è necessario assegnare almeno un'identità verificata e un set di configurazione prima che il tenant possa inviare e-mail.

Utilizzo della console:

Utilizzando: 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

Configurazione delle politiche di reputazione

Le politiche di reputazione determinano quando l'invio di e-mail da parte di un inquilino viene sospeso automaticamente in base alle metriche relative alla reputazione. Quando si crea un tenant, SES assegna automaticamente la politica di reputazione Standard. Utilizza i seguenti passaggi se desideri passare a un'altra politica.

Utilizzo della console:

Utilizzando 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"

Invio di e-mail con gli inquilini

Quando si inviano e-mail tramite un tenant, è necessario specificare il tenant nelle chiamate API o nelle intestazioni SMTP e assicurarsi che tutte le risorse utilizzate siano associate a quel tenant.

Utilizzo dell'API con i tenant SendEmail

AWS CLI Esempio:

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 Esempio di SDK per 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'
)

Utilizzo di SMTP con tenant

Quando si utilizza SMTP per inviare e-mail tramite un tenant, è necessario includere le informazioni relative al tenant nell'intestazione di un'e-mail:

X-SES-TENANT: MyTenant

Questa intestazione indica a SES quale tenant deve essere utilizzato per l'operazione di invio delle e-mail, permettendo a SES di applicare la convalida delle risorse e il monitoraggio della reputazione appropriati.

Gestione dello stato del tenant

Visualizzazione dello stato e delle metriche del tenant

Utilizzo della console:

Utilizzando: AWS CLI

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

Sospensione e riattivazione degli inquilini

È possibile sospendere manualmente le funzionalità di invio di un tenant quando necessario e riattivarle quando è pronto per riprendere l'invio.

Utilizzo della console:

Usando: AWS CLI

Per mettere in pausa un inquilino:

# 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

Per mettere in pausa un inquilino:

# 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

Lavorare con i risultati relativi alla reputazione

Visualizzazione dei risultati relativi alla reputazione

Utilizzo della console:

Utilizzando AWS CLI:

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

La risposta include dettagli su tutti i risultati attivi:

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

Comprensione dei risultati sulla reputazione

I risultati sulla reputazione forniscono informazioni sui potenziali problemi relativi alle pratiche di invio di e-mail degli inquilini. Ogni risultato include:

I risultati più comuni includono:

Risoluzione dei problemi di reputazione

Quando si riceve un riscontro sulla reputazione, è importante indagare sulla causa principale e intraprendere tempestivamente azioni correttive:

Monitoraggio e analisi

Impostazione delle metriche CloudWatch

SES pubblica metriche specifiche per i tenant su Amazon. CloudWatch Le seguenti metriche sono disponibili per ogni tenant:

EventBridgeConfigurazione delle notifiche

Per impostazione predefinita, SES invia gli eventi al bus eventi EventBridge predefinito quando vengono rilevati i risultati della reputazione dei tenant o quando si verificano cambiamenti nello stato del tenant.

È possibile creare regole sul bus degli eventi predefinito per identificare eventi specifici EventBridge da inviare a uno o più obiettivi specifici.

Sono disponibili i seguenti tipi di dettagli:

Per l'invio di modifiche allo stato da parte del tenant:

Per i risultati sulla reputazione:

Esempio di modello di EventBridge regole per i risultati della reputazione:

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

Esempio di modello di EventBridge regole per l'invio di modifiche allo stato:

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

Descrizioni dei campi:

È possibile utilizzare questi eventi per monitorare le modifiche allo stato dei tenant e automatizzare le risposte nelle applicazioni. Ad esempio, potresti voler attivare avvisi quando gli inquilini sono disabilitati o tenere traccia delle metriche sanitarie degli inquilini nel tempo.

Integrazione con Trust & Safety AWS

Quando AWS Trust & Safety rileva problemi che normalmente comporterebbero l'applicazione a livello di account, il sistema degli inquilini consente risposte più mirate. Invece di mettere in pausa l'intero account, Trust & Safety può mettere in pausa solo gli inquilini problematici, consentendo al contempo agli inquilini conformi di continuare a inviare.

Questa applicazione a livello di tenant riduce l'impatto dei problemi di reputazione e aiuta a mantenere la continuità aziendale per gli altri flussi di posta elettronica.

Riceverai notifiche quando SES ha disabilitato l'invio a causa di problemi di elevata gravità che influiscono sulla reputazione degli inquilini e ha sottoposto il tuo account a una revisione. Nel AWS Support Center verrà aperta una richiesta per consentirti di collaborare con Trust & Safety per risolvere i problemi e ripristinare l'invio per l'inquilino interessato.

Best practice

Segui queste best practice per gestire efficacemente la reputazione dei tenant in Amazon SES:

Limitazioni

Quando utilizzi la gestione dei tenant, tieni presente queste limitazioni:

Prezzi

È previsto un costo aggiuntivo per inquilino al mese in base al numero di e-mail. Per informazioni dettagliate sui prezzi, consulta la pagina dei prezzi di SES.

Quando si utilizza CloudWatch con le metriche degli inquilini, le CloudWatch metriche standard per ogni tenant vengono fornite senza costi aggiuntivi come parte del monitoraggio di base. CloudWatch Funzionalità aggiuntive come dashboard personalizzati, allarmi o monitoraggio dettagliato possono comportare costi standard. CloudWatch