Damit Benutzer ihre Microsoft-365-Postfächer, Kalender, Aufgaben (To Do), Kontakte und OneNote-Notizbücher verbinden können, braucht die Plattform eine App-Registrierung in Ihrem Microsoft-Verzeichnis (Entra ID). Die Benutzer melden sich danach selbst mit „Mit Microsoft anmelden“ an und bestätigen den Zugriff einmal. Kein Kennwort und kein Token verlässt dabei den Server.
1. App in Microsoft Entra registrieren
Im Microsoft Entra Admin Center unter Anwendungen → App-Registrierungen → Neue Registrierung:
- Name: z. B. RIVUS360.
- Unterstützte Kontotypen: Nur Konten in diesem Organisationsverzeichnis.
- Umleitungs-URI: Plattform Web, Adresse
https://<Ihre-Adresse>/sync/oauth/microsoft/callback/– eine einzige Eintragung gilt für Mail und Synchronisation. - Unter Zertifikate & Geheimnisse ein neues Clientgeheimnis anlegen. Notieren Sie den Wert sofort und das Ablaufdatum.
- Unter API-Berechtigungen → Microsoft Graph → Delegierte Berechtigungen hinzufügen:
| Berechtigung | Wofür |
|---|---|
User.Read, offline_access |
Anmeldung, dauerhafte Verbindung |
Mail.ReadWrite, Mail.Send |
Postfach lesen und senden |
Mail.ReadWrite.Shared, Mail.Send.Shared |
nur für freigegebene Postfächer (info@, Teampostfach) |
Calendars.ReadWrite |
Kalender |
Tasks.ReadWrite |
Erinnerungen und Aufgaben (Microsoft To Do) |
Contacts.ReadWrite |
Kontakte |
Notes.ReadWrite |
OneNote |
Optional Administratorzustimmung erteilen – dann müssen die Benutzer nicht einzeln zustimmen.
2. In der Plattform hinterlegen
Admin Einstellungen → System → Graph API (Ebene Mandant, gilt für alle Firmen; eine Firma kann auch eine eigene Konfiguration haben):
| Feld | Wert aus Entra |
|---|---|
| Microsoft Service | Microsoft Graph API |
| Authentifizierungsmethode | OAuth 2.0 |
| Microsoft Tenant ID | Verzeichnis-ID (Mandant) |
| Client ID / Application ID | Anwendungs-ID (Client) |
| Client Secret | der Wert des Geheimnisses |
| Secret läuft ab am / Erinnerung vor Ablauf | Ablaufdatum – die Plattform erinnert rechtzeitig |
Haken bei Standard-Konfiguration und Aktiv, dann Konfiguration speichern. Tenant ID, Client ID und Secret werden verschlüsselt gespeichert; das Secret ist danach nicht mehr abrufbar.
Achtung: Läuft das Clientgeheimnis ab, reißen alle Microsoft-Verbindungen ab. Legen Sie rechtzeitig ein neues an und tragen Sie es hier ein.
Weiter mit Postfächer einrichten.
