Mit OAuth kannst du den E-Mail-Versand deiner Soulclick-Plattform über dein eigenes Microsoft-365- oder Exchange-Konto laufen lassen. So werden Spendenverdankungen, Kontaktbestätigungen und alle weiteren automatischen E-Mails von deiner eigenen Absenderadresse verschickt.

📍

Navigation: Admin → Grundeinstellungen → E-Mail-Versand → E-Mail Einstellungen

ℹ️

Allgemeine Informationen zu den E-Mail-Optionen (Standard, OAuth, SMTP) findest du unter E-Mail Einstellungen.

Voraussetzungen

• Ein Microsoft-365- oder Exchange-Online-Konto mit Administratorzugriff auf das Azure-Portal
• Die E-Mail-Adresse, die als Absender verwendet werden soll (z. B. [email protected])
• Zugriff auf das Soulclick Admin

Schritt 1: App-Registrierung in Azure AD

1. Melde dich im Azure-Portal an.
2. Navigiere zu Azure Active Directory → App-Registrierungen → Neue Registrierung.
3. Vergib einen Namen (z. B. „Soulclick E-Mail“).
4. Unter Unterstützte Kontotypen wähle „Nur Konten in diesem Organisationsverzeichnis“.
5. Umleitungs-URI: Lasse das Feld leer (wird nicht benötigt).
6. Klicke auf Registrieren.

Nach der Registrierung siehst du die Übersicht mit:

Schritt 2: Client-Secret erstellen

1. In der App-Registrierung → Zertifikate & Geheimnisse → Neuer geheimer Clientschlüssel.
2. Vergib eine Beschreibung (z. B. „Soulclick“) und wähle eine Gültigkeitsdauer.
3. Klicke auf Hinzufügen.
4. Kopiere den Wert sofort – er wird nur einmal angezeigt. Diesen Wert trägst du später in Soulclick als „Client Secret“ ein.

⚠️

Speichere den Client-Secret-Wert sofort. Nach dem Verlassen der Seite kann er nicht mehr angezeigt werden.

Schritt 3: API-Berechtigung setzen

1. In der App-Registrierung → API-Berechtigungen → Berechtigung hinzufügen.
2. Wähle Microsoft Graph.
3. Wähle Anwendungsberechtigungen (nicht „Delegierte Berechtigungen“).
4. Suche nach Mail.Send und aktiviere das Häkchen.
5. Klicke auf Berechtigung hinzufügen.
6. Klicke auf Administratorzustimmung für [Organisation] erteilen und bestätige.

⚠️

Mail.Send ist die einzige benötigte Berechtigung. Setze keine weiteren Berechtigungen, um das Sicherheitsrisiko minimal zu halten.

Nach erfolgreicher Zustimmung wird in der Spalte „Status“ ein grünes Häkchen mit „Für [Organisation] erteilt“ angezeigt.

Schritt 4: Konfiguration in Soulclick

1. Öffne das Soulclick Admin unter Grundeinstellungen → E-Mail-Versand → E-Mail Einstellungen.
2. Setze das Häkchen bei Eigenen E-Mail-Server verwenden.
3. Wähle OAuth-Authentifizierung.
4. Trage die folgenden Werte ein:

5. Klicke auf Speichern.

Ab sofort werden alle automatischen E-Mails deiner Soulclick-Plattform über diese Absenderadresse verschickt.

Fehlerbehebung

💡

Client Secrets haben eine begrenzte Gültigkeitsdauer (max. 24 Monate). Plane rechtzeitig eine Erneuerung ein, damit der E-Mail-Versand nicht unterbrochen wird.

Zusammenfassung