AdSpirit unterstützt den E-Mail-Versand über SMTP und moderne Authentifizierungsmethoden wie OAuth 2.0. Es gibt verschiedene Konfigurationen: Standard SMTP, Gmail mit App-Passwort, Gmail OAuth 2.0 für Unternehmen und Microsoft 365 OAuth 2.0. Für OAuth sind meist Adminrechte nötig, und Änderungen können verzögert wirksam werden. Wichtige Einstellungen umfassen Absenderadresse, SMTP-Host, Port und Authentifizierungstyp.
AdSpirit unterstützt den E-Mail-Versand über SMTP sowie moderne Authentifizierungsmethoden (OAuth 2.0).
Es stehen mehrere Konfigurationsmöglichkeiten zur Verfügung:
- Standardkonfiguration (SMTP)
- Gmail App Password
- Gmail OAuth 2.0
- Microsoft 365 OAuth 2.0
PFAD: Einstellungen -> Globale Einstellungen -> Firmendaten -> Konfiguration
1. Standard SMTP-Konfiguration
Diese Methode verwendet klassische SMTP-Zugangsdaten.
Konfiguration
- Absenderadresse: Eigene E-Mail-Adresse
- Benutzername: E-Mail-Benutzername
- Passwort: E-Mail-Passwort
- SMTP-Host: smtp.office365.com
- SMTP-Port: 0
- Verschlüsselung: tls
- Authentifizierungstyp: AdSpirit Default Configuration
Speichern Sie anschließend die Einstellungen.
Eine ausführliche Anleitung ist hier zu finden: Einrichtung eines eigenen SMTP-Servers für den E-Mail-Versand
2. Gmail mit App-Passwort
Diese Methode ist geeignet für Gmail-Konten (privat oder Google Workspace).
Voraussetzungen
- 2-Faktor-Authentifizierung (2FA) ist aktiviert
Einrichtung
- Aktivieren Sie die 2-Faktor-Authentifizierung im Google-Konto
- Erstellen Sie ein App-Passwort:
- App: Mail
- Gerät: frei wählbar (z. B. „Mailer“)
- Kopieren Sie das generierte Passwort
Konfiguration in AdSpirit
- Absenderadresse: identisch mit Benutzername
- Passwort: App-Passwort
- SMTP-Host: smtp.gmail.com
- SMTP-Port: 587
Speichern Sie die Einstellungen.
- Direktlink zu den App-Passwörtern: https://myaccount.google.com/apppasswords (Hinweis: Erfordert eingelogtes Google-Konto und aktive 2-Faktor-Authentifizierung)
- Offizielle Anleitung: Anmeldung mit App-Passwörtern (https://support.google.com/accounts/answer/185833)
3. Gmail OAuth 2.0 (empfohlen für Unternehmen)
Voraussetzungen
- Google Workspace Konto
- Super-Admin-Zugriff
Schritt 1: Service Account erstellen
- Google Cloud Console öffnen
- Neues Projekt erstellen (falls erforderlich)
- Gmail API aktivieren
- Service Account erstellen
- Domain-weite Delegierung aktivieren
- JSON-Schlüssel erstellen und herunterladen
Schritt 2: Admin-Freigabe
- Google Admin-Konsole öffnen
- Zu „Sicherheit → API-Steuerung → Domain-weite Delegierung“ navigieren
- Neue Delegierung hinzufügen
Eintragen:
- Client ID: aus dem Service Account
- OAuth Scopes:
https://mail.google.com/ https://www.googleapis.com/auth/gmail.send
Änderungen können verzögert wirksam werden.
Schritt 3: Konfiguration in AdSpirit
- Authentifizierungstyp: Gmail OAuth 2.0
- JSON-Datei hochladen
- Google Cloud Console: https://console.cloud.google.com/
- Leitfaden Dienstkonten: Dienstkonten erstellen und verwalten (https://docs.cloud.google.com/iam/docs/best-practices-service-accounts?hl=de)
- Domainweite Delegierung: Domainweite Delegierung von Berechtigungen (https://knowledge.workspace.google.com/admin/apps/control-api-access-with-domain-wide-delegation?hl=de)
4. Microsoft 365 OAuth 2.0
Schritt 1: App registrieren
- Microsoft Entra Admin Center öffnen
- Neue App registrieren
- Mandant: Single Tenant
Schritt 2: Tenant ID ermitteln
- Entra ID → Übersicht
- Tenant ID kopieren
Schritt 3: Berechtigungen setzen
- API Permissions hinzufügen
- Office 365 Exchange Online auswählen
- Berechtigung: SMTP.SendAsApp
- Admin-Zustimmung erteilen
Schritt 4: Client Secret erstellen
- Certificates & Secrets öffnen
- Neuen Secret erstellen
- Wert sofort speichern
Schritt 5: SMTP AUTH aktivieren
- Microsoft 365 Admin Center öffnen
- Benutzer auswählen
- Mail → E-Mail-Apps verwalten
- Authenticated SMTP aktivieren
Schritt 6: (Optional) Send-As Berechtigung
Add-RecipientPermission -Identity "noreply@firma.com" -Trustee "<App>" -AccessRights SendAs
Schritt 7: Konfiguration in AdSpirit
- Client ID
- Client Secret
- Tenant ID
- SMTP-Server: smtp.office365.com
- Port: 587
Speichern Sie die Einstellungen.
- Microsoft Entra Admin Center: https://entra.microsoft.com/
- SMTP AUTH aktivieren: Einstellen von SMTP AUTH in Exchange Online (https://learn.microsoft.com/de-de/exchange/clients-and-mobile-in-exchange-online/authenticated-client-smtp-submission)
- Microsoft Graph API Dokumentation: Senden von E-Mails über Microsoft Graph (https://learn.microsoft.com/de-de/graph/api/user-sendmail?view=graph-rest-1.0&tabs=http)
Wenn Sie auf Probleme stoßen könnte es hieran liegen:
- OAuth-Konfigurationen erfordern in der Regel Adminrechte
- Änderungen können verzögert aktiv werden
- Bei Problemen prüfen:
- SMTP AUTH aktiviert
- Berechtigungen korrekt gesetzt
- Zugangsdaten korrekt eingetragen