Configurare le email di Amazon SES

1. Verifica un mittente nella tua regione AWS

Apri Amazon SES in US East (N. Virginia), us-east-1. Scegli Configuration → Identities → Create identity, seleziona il dominio o indirizzo e completa la verifica DNS o via email. Usa la stessa regione e il mittente verificato nelle impostazioni seguenti.

I nuovi account SES iniziano in sandbox: verifica anche il destinatario o usa il simulatore di caselle SES. Richiedi l’accesso alla produzione in Account dashboard prima di inviare ai normali clienti. Apri Amazon SES

2. Per SMTP scegli IAM SMTP credentials

In SES apri SMTP settings → Create SMTP credentials. Scegli IAM SMTP credentials anziché Mail Manager con l’etichetta Recommended. La scheda IAM riporta Manual credential management. No traffic policies or rule sets. Premi Create IAM credentials, assegna un nome all’utente e scarica le credenziali SMTP prima di chiudere.

Crea credenziali IAM · Gestisci quelle esistenti

Questi link usano us-east-1, dove IAM SMTP classico è disponibile. Per un’altra regione supportata, crea credenziali regionali e usa il relativo endpoint SMTP. La password SMTP scaricata non è la chiave di accesso segreta AWS: usala solo nel passaggio 5. Istruzioni SMTP AWS

3. Evita costi inutili di Mail Manager

IAM SMTP e l’SDK SES inviano direttamente tramite SES, senza criteri di traffico o insiemi di regole Mail Manager. Evita un endpoint di ingresso aperto o mTLS opzionale: AWS indica 50 USD al mese per endpoint nella tariffazione a consumo. Gli endpoint autenticati sono attualmente gratuiti; Recommended non aggiunge sempre 50 USD. Restano i costi di invio e del piano scelto. Controlla i prezzi AWS

4. Invia con l’SDK AWS

Questa modalità usa l’API SES via HTTPS. In IAM concedi al ruolo del server o a un utente dedicato ses:SendEmail sull’identità SES verificata. Per un utente apri Security credentials → Create access key e salva ID e chiave segreta originali. Una password SMTP non firma richieste SDK.

Inserisci l’esempio in apps/web/.env.local in sviluppo o nei segreti dell’hosting in produzione. Sostituisci mittente e segnaposto. Con un ruolo IAM o un profilo AWS locale configurato, lascia vuoti entrambi i campi chiave e AWS_SESSION_TOKEN: l’SDK usa la catena predefinita. Le chiavi esplicite vanno fornite entrambe.

Per credenziali temporanee esplicite aggiungi il relativo AWS_SESSION_TOKEN e rinnova tutti e tre i valori alla scadenza. L’SDK rinnova le credenziali dei ruoli. Catena delle credenziali SDK AWS

EMAIL_PROVIDER=ses
EMAIL_FROM=Your App <[email protected]>
AWS_REGION=us-east-1
AWS_ACCESS_KEY_ID=<IAM-access-key-id>
AWS_SECRET_ACCESS_KEY=<original-IAM-secret-access-key>
# Temporary explicit credentials only:
AWS_SESSION_TOKEN=

5. Oppure usa IAM SMTP classico

Usa nome utente e password SMTP del passaggio 2 con questa configurazione alternativa. La porta 587 usa STARTTLS; SMTP_SECURE=false seleziona tale modalità. Endpoint, credenziali e mittente verificato devono essere della stessa regione.

Queste impostazioni del kit per acquirenti valgono per tutte e tre le piattaforme. Scegli una modalità: EMAIL_PROVIDER=smtp usa credenziali SMTP; EMAIL_PROVIDER=ses quelle API dell’SDK.

EMAIL_PROVIDER=smtp
EMAIL_FROM=Your App <[email protected]>
SMTP_HOST=email-smtp.us-east-1.amazonaws.com
SMTP_PORT=587
SMTP_SECURE=false
SMTP_USER=<downloaded-SMTP-username>
SMTP_PASSWORD=<downloaded-SMTP-password>

6. Configura una volta per web, mobile e desktop

Riavvia il server dopo le modifiche. Con il database migrato, richiedi un codice email su /auth per un destinatario consentito e controlla posta e spam. Mobile usa lo stesso server; desktop carica l’app web. Nessun client richiede chiavi AWS o password SMTP.

Mantieni le credenziali solo sul server, mai in NEXT_PUBLIC_, EXPO_PUBLIC_ o nel pacchetto desktop. In caso di errore controlla mittente, destinatari sandbox, regione, permessi IAM e tipo di credenziali. queued significa che SES ha accettato il messaggio, non che è arrivato. Panoramica della configurazione email