> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# Amazon SES für E-Mails einrichten

Richte Amazon SES für Web, Mobile und Desktop mit AWS-SDK- oder IAM-SMTP-Zugangsdaten ein, verifiziere den Absender und vermeide unnötige Mail-Manager-Endpunktkosten.

## 1. Absender in deiner AWS-Region verifizieren

Öffne Amazon SES in US East (N. Virginia), us-east-1. Wähle Configuration → Identities → Create identity, dann deine Domain oder E-Mail-Adresse, und schließe die DNS- oder E-Mail-Verifizierung ab. Verwende unten dieselbe Region und den verifizierten Absender.

Neue SES-Konten starten in einer Sandbox: Verifiziere auch den Empfänger oder nutze den SES-Postfachsimulator. Beantrage unter Account dashboard Produktionszugang, bevor du an gewöhnliche Kundenadressen sendest. [Amazon SES öffnen](https://us-east-1.console.aws.amazon.com/ses/home?region=us-east-1)


## 2. Für SMTP die Option IAM SMTP credentials wählen

Öffne in SES SMTP settings → Create SMTP credentials. Wähle IAM SMTP credentials statt der mit Recommended markierten Mail-Manager-Option. Die IAM-Karte zeigt Manual credential management. No traffic policies or rule sets. Klicke auf Create IAM credentials, benenne den Versandnutzer und lade die SMTP-Zugangsdaten herunter, bevor du die Seite schließt.

[IAM-Zugangsdaten erstellen](https://us-east-1.console.aws.amazon.com/iam/home?SESRegion=us-east-1#/users/smtp/create) · [Vorhandene verwalten](https://us-east-1.console.aws.amazon.com/iam/home#/users)

Diese Links verwenden us-east-1, wo klassisches IAM SMTP verfügbar ist. Erstelle für eine andere unterstützte Region eigene Zugangsdaten und nutze deren SMTP-Endpunkt. Das heruntergeladene SMTP-Passwort ist kein AWS-Secret-Access-Key; nutze es nur für Schritt 5. [AWS-Anleitung für SMTP-Zugangsdaten](https://docs.aws.amazon.com/ses/latest/dg/smtp-credentials.html)


## 3. Unnötige Mail-Manager-Kosten vermeiden

IAM SMTP und das SES SDK senden direkt über SES ohne Mail-Manager-Verkehrsrichtlinien oder Regelsätze. Vermeide einen optionalen offenen oder mTLS-Ingress-Endpunkt: AWS nennt dafür beim À-la-carte-Tarif 50 US-Dollar monatlich pro Endpunkt. Authentifizierte Endpunkte sind derzeit kostenlos; Recommended kostet daher nicht automatisch 50 US-Dollar. Normale Versandgebühren und dein gewählter Tarif gelten weiterhin. [Aktuelle AWS-Preise prüfen](https://aws.amazon.com/ses/pricing/)


## 4. Mit dem AWS SDK senden

Dieser Modus nutzt die SES-API über HTTPS. Gib der Backend-Rolle oder einem eigenen Versandnutzer in IAM ses:SendEmail für die verifizierte SES-Identität. Öffne beim Nutzer Security credentials → Create access key und sichere Access Key ID und ursprünglichen Secret Access Key. Ein SMTP-Passwort kann keine SDK-Anfragen signieren.

Speichere das Beispiel lokal in apps/web/.env.local oder in den geheimen Einstellungen deines Produktionshosts. Ersetze Absender und Platzhalter. Bei einer IAM-Rolle oder einem eingerichteten lokalen AWS-Profil bleiben beide Schlüsselfelder und AWS_SESSION_TOKEN leer; das SDK nutzt seine Standard-Zugangsdatenkette. Explizite Schlüssel müssen vollständig als Paar angegeben werden.

Setze für temporäre explizite Zugangsdaten auch den zugehörigen AWS_SESSION_TOKEN und erneuere alle drei Werte nach Ablauf. Rollenzugangsdaten erneuert das SDK. [Zugangsdatenkette des AWS SDK](https://docs.aws.amazon.com/sdk-for-javascript/v3/developer-guide/setting-credentials-node.html)

```
EMAIL_PROVIDER=ses
EMAIL_FROM=Your App <hello@yourdomain.com>
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. Alternativ klassisches IAM SMTP nutzen

Verwende in dieser Alternative den SMTP-Nutzernamen und das SMTP-Passwort aus Schritt 2. Port 587 nutzt STARTTLS; SMTP_SECURE=false wählt diesen Verbindungsmodus. Endpunkt, Zugangsdaten und verifizierter Absender müssen zur selben Region gehören.

Diese Einstellungen des Käufer-Kits gelten für alle drei Plattformen. Wähle jeweils einen Modus: EMAIL_PROVIDER=smtp nutzt SMTP-Zugangsdaten, EMAIL_PROVIDER=ses die SDK-API-Zugangsdaten.

```
EMAIL_PROVIDER=smtp
EMAIL_FROM=Your App <hello@yourdomain.com>
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. Einmal für Web, Mobile und Desktop konfigurieren

Starte das Backend nach Änderungen neu. Fordere mit migrierter Datenbank unter /auth einen E-Mail-Anmeldecode für einen erlaubten Empfänger an und prüfe Posteingang und Spam. Mobile nutzt dasselbe Backend, Desktop lädt die Web-App. Beide Clients benötigen weder AWS-Schlüssel noch SMTP-Passwörter.

Zugangsdaten bleiben ausschließlich im Backend, niemals in NEXT_PUBLIC_, EXPO_PUBLIC_ oder im Desktop-Paket. Prüfe bei Fehlern Absenderverifizierung, Sandbox-Empfänger, Region, IAM-Rechte und Zugangsdatenart. queued bedeutet nur, dass SES die Nachricht angenommen hat, nicht dass sie im Postfach liegt. [E-Mail-Einrichtung im Überblick](https://supastack.dev/de/docs/web/setup-email.md)


Wenn du die Einrichtung fortsetzen möchtest, lies [Die übrigen Anbieter-Keys einsammeln](https://supastack.dev/de/docs/web/provider-keys.md).


## Weiter

[Die übrigen Anbieter-Keys einsammeln](https://supastack.dev/de/docs/web/provider-keys.md)
