Microsoft 365 E-Mail-Account per OAuth verbinden

INHALTSVERZEICHNIS

TABLE OF CONTENTS

• Voraussetzungen
• Verbindung Microsoft 365 Account
• Absender-Adressen hinterlegen
• Tipp: Postfach-Adressen (z. B. spenden@) verwenden, ohne das Administrationskonto zu verbinden
  • Vorbereitung
  • Schritt-für-Schritt Anleitung

Über die OAuth-Schnittstelle kannst Du Deine FundraisingBox mit einem Microsoft-365-E-Mail-Konto verbinden. Dadurch versendet die FundraisingBox E-Mails, beispielsweise Automatische Dankes-E-Mail im Formular einrichten, direkt über den Microsoft-365-Mailserver Deiner Organisation.
Die Einrichtung erfolgt in wenigen Schritten.

Voraussetzungen

Für die Verbindung benötigst Du:

• einen Microsoft-365-Business-Account
• ein Microsoft-365-Konto, das später für den E-Mail-Versand verwendet werden soll

Je nach Konfiguration Deiner Microsoft-365-Umgebung muss eine Administrator*in außerdem erlauben, dass sich dieses Konto mit einer Drittanbieter-Anwendung verbindet und E-Mails versenden darf.

Für die OAuth-Verbindung werden folgende Berechtigungen benötigt:

• https://outlook.office.com/SMTP.Send 
• openid, profile und email
  • nötig, um automatisiert die richtige E-Mail-Adresse für autorisiertes SMTP auszulesen
• offline_access
  • nötig, damit die FundraisingBox dauerhaften Zugriff erhält

Verbindung Microsoft 365 Account

1. Klicke im Menü links unten auf Store und wählen Externe Services aus.
   
2. Klicke oben auf den Reiter Kommunikation, um die Auswahl einzuschränken.
   
3. Wähle Microsoft 365 für E-Mail Versand aus und klicke auf Details anzeigen.
   
4. Klicke auf Jetzt aktivieren .
5. Nun öffnet sich die Microsoft Login-Seite, wo Du Dich mit Eurem Microsoft-Account einloggen/autorisieren kannst:
   

6. Melde Dich an.

7. Stimme den notwendigen Bedingungen zu und vertraue der FundraisingBox.

8. Nach Abschluss wirst Du automatisch zurück zur FundraisingBox geleitet, wo Du den aktivierten Store-Eintrag siehst.

Absender-Adressen hinterlegen

Sobald Du den Microsoft E-Mail-Account erfolgreich mit der FundraisingBox verknüpft hast, musst Du mindestens eine Absender-Adressen in der FundraisingBox hinterlegen.

Hinweis: Wenn der Microsoft-Account nur eine E-Mail-Adresse hat, dann werden E-Mails immer mit dieser Adresse versendet, egal welche Absender-Adresse Du in der FundraisingBox anlegst/verwendest! Trotzdem muss unter https://secure.fundraisingbox.com/webmailer/senders eine FundraisingBox-Absender-Adresse angelegt werden!

Tipp: Postfach-Adressen (z. B. spenden@) verwenden, ohne das Administrationskonto zu verbinden

Wenn das Administrationskonto nicht gleichzeitig als Versandkonto genutzt werden soll, kannst Du stattdessen das gewünschte Postfach mit der FundraisingBox verbinden und die erforderliche Zustimmung anschließend über ein Administrationskonto erteilen.

Vorbereitung

Du benötigst:

• die Zugangsdaten des Microsoft-365-Postfachs, das später E-Mails versenden soll
• ein Microsoft-365-Administrationskonto
• zwei unterschiedliche Browser, beispielsweise Chrome und Firefox

Schritt-für-Schritt Anleitung

1. OAuth-Verbindung starten
   Öffne in Browser 1 (z. B. Chrome) den Store der FundraisingBox und starte die Aktivierung von Microsoft 365 für E-Mail-Versand., wie im vorherigen Abschnitt beschrieben über Store > Externe Services > Kommunikation > Microsoft365 OAuth > Jetzt aktivieren
2. Mit dem Versandkonto anmelden
   Melde Dich mit dem Microsoft-365-Konto an, das später den E-Mail-Versand übernehmen soll, beispielsweise spenden@organisation.de.
3. Administrationsanfrage öffnen
   Falls Microsoft meldet, dass eine Zustimmung Deiner Organisation erforderlich ist, kopiere den Link aus der Adresszeile des Browsers.
4. Zweiten Browser verwenden
   Öffne einen anderen Browser, beispielsweise Firefox.
   Verwende möglichst kein weiteres Fenster desselben Browsers, da dort häufig bereits das ursprüngliche Microsoft-Konto angemeldet ist.
5. Link öffnen
   Füge den zuvor kopierten Link im zweiten Browser ein.
6. Mit dem Administrationskonto anmelden
   Melde Dich jetzt mit einem Microsoft-365-Konto an, das Anwendungen für Eure Organisation freigeben darf.
7. Prüfe die angeforderten Berechtigungen
   Microsoft zeigt nun die Anwendung FundraisingBox O365 OAuth / SMTP an.
   Prüfe insbesondere, ob folgende Berechtigungen angefordert werden:
   • Versand von E-Mails
   • Zugriff auf grundlegende Profildaten
   • dauerhafter Zugriff auf das Konto
8. Erteile die Zustimmung
   
   Falls erforderlich, aktiviere Zustimmung im Namen Ihrer Organisation und bestätige anschließend mit Akzeptieren.
   Eine organisationsweite Zustimmung sollte nur von einer entsprechend berechtigten Administrator*in nach Prüfung der angeforderten Berechtigungen erteilt werden.
9. Anwendung im Microsoft Entra Admin Center kontrollieren
   Öffne dort:
   Entra ID → Unternehmensanwendungen → Alle Anwendungen
   Suche nach "FundraisingBox O365 OAuth / SMTP". Die Anwendung sollte vorhanden und für die Anmeldung aktiviert sein. Microsoft führt diese Einstellung in den Eigenschaften der Unternehmensanwendung unter "Für Benutzer zur Anmeldung aktiviert".
10. Zum ersten Browser zurückkehren
    Wechsle zurück zum ursprünglichen Browser 1.
    Die Verbindung mit dem gewünschten Versandkonto sollte nun abgeschlossen oder fortgesetzt werden.
11. Beantworte die Frage zur dauerhaften Anmeldung
    Microsoft fragt möglicherweise, ob Du angemeldet bleiben möchtest. Diese Auswahl hat keinen Einfluss auf die dauerhafte OAuth-Verbindung. Du kannst "Nein" auswählen, insbesondere wenn Du an einem gemeinsam genutzten Gerät arbeitest.
12. Kontrolliere die Verbindung in der FundraisingBox
    Nach erfolgreichem Abschluss wirst Du zurück zur FundraisingBox geleitet. Der Microsoft-365-Service sollte dort als aktiviert angezeigt werden. Anschließend muss mindestens eine Absender-Adresse in der FundraisingBox hinterlegt sein.
13. Teste, ob es geklappt hat
    Lege testweise die gewünschte Postfach-Adresse (z. B. spenden@ oder info@) erneut in der Absender-Konfiguration der FundraisingBox an.
    Lässt sich die Adresse ohne Fehler speichern, ist die OAuth-Verbindung korrekt eingerichtet und der spätere E-Mail-Versand sollte ebenfalls funktionieren.
    Die durch diesen Test doppelt angelegte Absender-Adressen kannst Du anschließend wieder löschen.