# E-Mail

Konfigurieren Sie, wie die Plattform E-Mails versendet (über die integrierte Zustellung oder Ihren eigenen Anbieter) und senden Sie eine Testnachricht.

Requires: customMailProvider

> **Plan-Hinweis:** Ein eigener E-Mail-Anbieter ist ab dem Essential-Plan verfügbar. Siehe [Plans & add-ons](https://dts-identity.com/de/docs/getting-started/plans-and-addons.md). Auf niedrigeren Stufen versendet die Plattform alle E-Mails über ihre integrierte Zustellung.

Die Plattform versendet transaktionale E-Mails für Passwort-Zurücksetzungen, Adressverifizierung, Multi-Faktor-Registrierung, Willkommensnachrichten, Genehmigungsbenachrichtigungen, Einladungen und Kontowiederherstellung. Standardmäßig werden diese Nachrichten ohne Einrichtung über einen integrierten Anbieter zugestellt. Ab dem Essential-Plan können Sie **Ihren eigenen** E-Mail-Anbieter verbinden, sodass Nachrichten von Ihrer Domain stammen und Ihre Zustellbarkeits- und Compliance-Kontrollen nutzen.

[Image: Der Reiter „Mail" in den Branding-Einstellungen]

## Zustellmodus wählen

1. Öffnen Sie in der Admin Console **Branding → E-Mail**.
2. Wählen Sie, wie E-Mails zugestellt werden:
   - **Default delivery provider**: der integrierte Dienst. Nichts zu konfigurieren.
   - **Eigener E-Mail-Anbieter**: verbinden Sie einen der unten unterstützten Anbieter.
3. Wählen Sie **Send test email** und danach **Save changes**.

Wenn Sie beim Standardanbieter bleiben, ist nichts weiter einzurichten: Ihre E-Mails werden bereits zugestellt.

## Eigenen Anbieter verbinden

1. Wählen Sie **Eigener E-Mail-Anbieter**.
2. Wählen Sie einen Anbieter aus dem Raster. Jeder Anbieter blendet nur die Felder ein, die er benötigt.
3. Füllen Sie die **From**-Adresse (zum Beispiel `"Your App" <support@yourapp.com>`) und die anbieterspezifischen Felder aus.
4. Wählen Sie **Send test email**. Sobald der Test erfolgreich ist, wählen Sie **Save changes**.

### Unterstützte Anbieter

| Anbieter | Was Sie angeben |
|---|---|
| **Custom SMTP server** | Host, Port, TLS-Version, ob TLS verwendet wird, und einen Benutzernamen/ein Passwort, falls Ihr Server Authentifizierung erfordert |
| **Microsoft 365** | Tenant ID, Client ID und Client Secret einer registrierten App |
| **Amazon SES** | Region, Access Key ID und Secret Access Key |
| **SendGrid** | API Key |
| **Mailgun** | API Key, sendende Domain und Region (EU/US) |
| **Resend** | API Key |
| **Azure Communication Services** | Endpoint und Access Key |
| **SparkPost** | API Key und Region (EU/US) |
| **Mandrill** | API Key |

> **Custom SMTP:** Die Authentifizierung ist optional. Lassen Sie Benutzernamen und Passwort leer, wenn Ihr Relay unauthentifizierte Übermittlung von der Plattform akzeptiert. Wählen Sie die TLS-Version, die Ihr Server unterstützt.

### Geheime Felder

Anmeldedaten wie API Keys, Client Secrets und SMTP-Passwörter werden sicher gespeichert und als maskiertes Feld mit einem **reveal**-Steuerelement angezeigt, sodass Sie den Wert bestätigen können, ohne ihn auf dem Bildschirm offenzulegen. Um ein bestehendes Geheimnis unverändert zu lassen, belassen Sie sein Feld wie gespeichert.

## Test-E-Mail senden

Mit **Send test email** prüfen Sie eine Anbieterkonfiguration durchgängig, bevor Sie sie speichern. Die Plattform sendet eine Testnachricht an Ihre eigene Admin-Adresse mit den aktuell im Formular eingegebenen Werten; der Test speichert nichts. Das Ergebnis erscheint als Benachrichtigung und nennt bei einem Fehlschlag die wahrscheinliche Ursache (zum Beispiel abgelehnte Anmeldedaten, ein TLS-Konflikt zwischen Port und **Use TLS** oder ein nicht erreichbarer Server).

> **Wichtig:** **Save changes** ist erst nach einem erfolgreichen Test verfügbar. Jede spätere Änderung am Formular deaktiviert die Schaltfläche wieder bis zum nächsten erfolgreichen Test.

Kommt der Test nicht an, prüfen Sie Ihre Anbieter-Anmeldedaten, die From-Adresse und die sendende Domain oder Absenderverifizierung Ihres Anbieters.

## Welche E-Mails die Plattform versendet

Die Plattform versendet transaktionale E-Mails für die untenstehenden Abläufe. Nutzen Sie diese Liste, um zu bestätigen, dass ein Anbieter mit den für Sie relevanten Abläufen funktioniert: durchlaufen Sie jeden Pfad selbst und prüfen Sie die Zustellung. Mehrere davon sind Benachrichtigungen zu Sicherheitsereignissen, die auch als Audit-Einträge aufgezeichnet werden, sodass ein Admin eine vom Benutzer hinterfragte E-Mail mit dem Audit-Log korrelieren kann (siehe [Threat protection](https://dts-identity.com/de/docs/security/threat-protection.md)).

| E-Mail | Ausgelöst bei |
|---|---|
| E-Mail-Adresse verifizieren | Ein Benutzer fügt seine E-Mail hinzu oder ändert sie und muss sie bestätigen |
| Mobilnummer verifizieren | Ein Benutzer fügt seine Telefonnummer hinzu oder ändert sie |
| Einladung / Aktivierung | Ein Admin lädt einen Benutzer ein, oder eine Self-Service-Anmeldung erfordert Aktivierung |
| Passwort-Zurücksetzung | Ein Benutzer fordert eine Zurücksetzung an, oder ein Admin sendet eine |
| Konto entsperrt | Ein gesperrtes Konto wird wiederhergestellt oder entsperrt |
| Hinweis auf kompromittiertes Passwort | Eine Anmeldung wird blockiert, weil das Passwort in einem bekannten Datenleck auftauchte |
| Bestätigung der MFA-Registrierung | Ein Benutzer registriert einen neuen zweiten Faktor |
| MFA-E-Mail-Code | Ein Einmalcode wird für E-Mail-basierte MFA zugestellt |
| Benachrichtigung über neue Anmeldung | Eine Anmeldung erfolgt von einem unbekannten Gerät |
| Genehmigungsbenachrichtigung | Eine von einem Benutzer eingereichte Anfrage wird genehmigt oder abgelehnt |

## Was Sie anpassen können

- **Die From-Adresse (Absender)**: pro Anbieter auf dieser Seite festgelegt (zum Beispiel `"Your App" <support@yourapp.com>`), sodass Nachrichten von Ihrer Domain stammen.
- **Logo und Akzentfarbe**: Das Logo aus [Settings → General](https://dts-identity.com/de/docs/settings/general.md) und die Akzentfarbe aus [Erscheinungsbild](https://dts-identity.com/de/docs/branding/appearance.md) werden auf jede Nachricht angewendet, damit E-Mails zu Ihrem Anmeldeerlebnis passen.

Der Wortlaut jeder Nachricht stammt aus den übersetzten Sprachtexten der Instanz (ein Satz je aktivierter Sprache), nicht aus einem freien Editor pro Vorlage. Es gibt keine HTML-/Code-Vorlagen-Engine und kein Variablen-Scripting pro Nachricht. Um die Sprachen zu ändern, die Ihre E-Mails verwenden, verwalten Sie die aktivierten Sprachen unter [Settings → General](https://dts-identity.com/de/docs/settings/general.md).
