Microsoft Exchange Integration: Umstellung auf Microsoft Graph – Das sollten Haufe X360 Kunden jetzt wissen
Microsoft stellt Exchange Web Services (EWS) schrittweise ein
Microsoft modernisiert die Anbindung von Microsoft 365 kontinuierlich. Im Zuge dieser Weiterentwicklung wird die bisher genutzte Exchange Web Services (EWS)-Schnittstelle schrittweise durch Microsoft Graph ersetzt.
Auch Haufe X360 setzt deshalb künftig auf die moderne Microsoft Graph-Integration.
Für Unternehmen, die Microsoft Exchange Online gemeinsam mit Haufe X360 nutzen, wird diese Umstellung mit den kommenden Releases relevant.
Warum erfolgt die Umstellung?
Microsoft Graph ist die strategische API für Microsoft 365 und bietet zahlreiche Vorteile gegenüber EWS.
Ihre Vorteile:
Moderne OAuth 2.0-Authentifizierung
Optimale Unterstützung für Microsoft 365
Zukunftssichere Microsoft-Technologie
Höhere Sicherheitsstandards
Langfristige Unterstützung durch Microsoft
Häufige Fragen aus der Praxis
Muss ich sofort umstellen?
Nicht zwingend.
Einige Microsoft-365-Tenants verfügen derzeit noch über eine verlängerte Unterstützung der EWS-Schnittstelle. Microsoft empfiehlt jedoch ausdrücklich, sich nicht dauerhaft auf diese Übergangslösung zu verlassen und die Migration frühzeitig einzuplanen.
Kann die bestehende Microsoft Entra (Azure) App weiter genutzt werden?
Nach aktuellem Stand ist dies grundsätzlich möglich.
In den bisherigen Tests konnte die vorhandene App-Registrierung weiterverwendet werden. Meist müssen lediglich die erforderlichen Microsoft Graph-Berechtigungen ergänzt werden.
Ob dies in Ihrer Umgebung möglich ist, sollte jedoch individuell geprüft werden.
Empfohlener Migrationsablauf
Für eine möglichst reibungslose Umstellung empfiehlt Haufe beziehungsweise Acumatica folgenden Ablauf.
Vor dem ERP-Update
- Exchange-Synchronisation durchführen
- Benutzerzugriffe sperren
- Vollständiges Backup erstellen
Nach dem ERP-Update
- Erneut ein Backup erstellen
- Exchange-Synchronisation starten
- Microsoft Entra-App um die neuen Microsoft Graph-Berechtigungen erweitern
- Exchange Integration in Haufe X360 auf Microsoft Graph (Microsoft 365) umstellen
- Exchange-Verbindung neu konfigurieren
- Synchronisation mehrfach durchführen
- Synchronisierte Daten auf Dubletten oder Auffälligkeiten prüfen
- System wieder freigeben
Schritt-für-Schritt-Anleitung: OAuth-2.0-Anpassung
Hinweis: Diese Anleitung richtet sich an technisch versierte Administratoren. Je nach Microsoft-365-Umgebung können zusätzliche Anpassungen erforderlich sein. Führen Sie die Änderungen nach Möglichkeit zunächst in einer Testumgebung durch und erstellen Sie vorab eine Datensicherung.
Schritt 1: Authentifizierungsmethode auswählen
Öffnen Sie in Haufe X360 den Screen „E-Mail-Konten“ (SM204002) und wählen Sie im Feld „Authentifizierungsmethode“ die Option „OAuth 2.0 für Microsoft 365“ aus.
Schritt 2: Externe Anwendung öffnen
Klicken Sie im Feld „Externe Anwendung“ auf die Lupenschaltfläche. Das System öffnet daraufhin die Nachschlagetabelle „Externe Anwendungen“.
Schritt 3: Neue externe Anwendung anlegen
Klicken Sie in der Nachschlagetabelle auf die Plus-Schaltfläche in der Tabellen-Symbolleiste. Das System öffnet das Formular „Externe Anwendungen“ (SM301000) in einem neuen Browserfenster.
Schritt 4: Neuen Datensatz hinzufügen
Klicken Sie im Formular „Externe Anwendungen“ auf „Neuen Datensatz hinzufügen“.
Schritt 5: Anwendungstyp festlegen
Wählen Sie im Feld „Typ“ die Option „OAuth 2.0“ aus.
Schritt 6: Anwendungsnamen vergeben
Geben Sie im Feld „Anwendungsname“ einen eindeutigen Namen für die Anwendung ein, zum Beispiel:
Office365 Connector
Schritt 7: Client-ID übernehmen
Wechseln Sie zur Browser-Registerkarte mit dem Microsoft Entra Admin Center.
Öffnen Sie dort die Seite „Übersicht“ der registrierten Anwendung. Kopieren Sie den Wert der Anwendungs-ID (Client-ID) und fügen Sie ihn im Formular „Externe Anwendungen“ in Haufe X360 in das Feld „Client-ID“ ein.
Schritt 8: Client-Geheimnis erstellen und eintragen
Öffnen Sie im Microsoft Entra Admin Center den Bereich „Zertifikate und Geheimnisse“ und erstellen Sie einen neuen geheimen Clientschlüssel.
Kopieren Sie anschließend den angezeigten Wert und fügen Sie ihn im Formular „Externe Anwendungen“ in das Feld „Client-Geheimnis“ ein.
Wichtig: Verwenden Sie den Wert des geheimen Clientschlüssels und nicht die Geheime ID. Der Wert wird in der Regel nur direkt nach der Erstellung vollständig angezeigt und sollte daher unmittelbar sicher übernommen werden.
Schritt 9: Umleitungs-URI prüfen
Klicken Sie im Formular „Externe Anwendungen“ auf „Umleitungs-URI anzeigen“ und kopieren Sie den Wert aus dem Feld „Umleitungs-URI“.
Wechseln Sie anschließend zurück zum Microsoft Entra Admin Center und führen Sie dort die Schritte zum Hinzufügen einer Umleitungs-URI aus.
Wichtig: Dieser Schritt ist nur erforderlich, wenn sich die Umleitungs-URI gegenüber der bisherigen Konfiguration geändert hat. Ist die Adresse bereits korrekt hinterlegt, kann dieser Schritt übersprungen werden.
Schritt 10: Endpunkte öffnen
Klicken Sie auf der Übersichtsseite der registrierten Anwendung im Microsoft Entra Admin Center im oberen Menü auf „Endpunkte“.
Schritt 11: Autorisierungsendpunkt übernehmen
Kopieren Sie den Wert des OAuth-2.0-Autorisierungsendpunkts (v2) und fügen Sie ihn im Formular „Externe Anwendungen“ in Haufe X360 in das Feld „Autorisierungsendpunkt“ ein.
Schritt 12: Token-Endpunkt übernehmen
Kopieren Sie den Wert des OAuth-2.0-Token-Endpunkts (v2) und fügen Sie ihn im Formular „Externe Anwendungen“ in Haufe X360 in das Feld „Token-Endpunkt“ ein.
Nach der Konfiguration
Nach Abschluss der Einrichtung empfehlen wir folgende Prüfungen:
Verbindung testen
Exchange-Synchronisation mehrfach durchführen
Synchronisierte Termine, Kontakte und Aufgaben prüfen
Auf Dubletten oder Synchronisationsfehler achten
Erst wenn keine Auffälligkeiten mehr vorhanden sind, sollte das System wieder für alle Benutzer freigegeben werden.
Unsere Empfehlung
Auch wenn einzelne Microsoft-365-Umgebungen EWS aktuell noch unterstützen, empfehlen wir, die Migration auf Microsoft Graph frühzeitig einzuplanen.
So vermeiden Sie kurzfristigen Handlungsdruck und stellen sicher, dass Ihre Exchange-Integration langfristig auf einer modernen und von Microsoft unterstützten Technologie basiert.
Unser Team unterstützt Sie gerne bei:
der Prüfung Ihrer bestehenden Exchange-Konfiguration- der Planung der Migration
- der Einrichtung der Microsoft Graph-Integration
- Tests und Inbetriebnahme
Fazit
Die Umstellung auf Microsoft Graph ist ein wichtiger Schritt für eine sichere und zukunftsfähige Exchange-Integration in Haufe X360. Mit einer strukturierten Vorbereitung und der richtigen Konfiguration lässt sich die Migration in der Regel problemlos durchführen.
Sie haben Fragen oder benötigen Unterstützung? Nutzen Sie gerne die Kommentarfunktion oder sprechen Sie unser Team direkt an – wir unterstützen Sie bei der erfolgreichen Umstellung auf Microsoft Graph.