Microsoft 365 / OAuth

Vollständige Anleitung: Userdoku Microsoft 365
Fehlercodes: AADSTS-Codes

Symptom: «OAuth nicht konfiguriert» / 503 / 409

Ursache: Keine Azure-App im Mandanten-Setup gespeichert (Client-ID + Secret fehlen).

Schritte:

1. Setup → Microsoft 365 öffnen
2. Client-ID und Client Secret eintragen
3. Redirect URI = angezeigte Callback-URL
4. Microsoft-Setup speichern
5. Hub erneut Verbinden

Symptom: AADSTS500113 — No reply address is registered

Ursache: In der Entra-App, die zur gespeicherten Client-ID gehört, fehlt die Web-Redirect-URI — oder die URI steht in einer anderen App als der Client-ID in LIRENO.

Schritte:

1. In LIRENO Setup die Application (client) ID notieren
2. Entra → App-Registrierungen → diese ID suchen (nicht nur nach Anzeigenamen)
3. Authentifizierung → Plattform Web
4. Exakt eintragen (Dev-Beispiel):
   https://api.dev.lireno.ch/api/v1/integrations/microsoft365/oauth/callback
5. Speichern → Hub erneut Verbinden

Häufiger Fehler: Neue App M365-4-LIRENO angelegt und dort die URI gesetzt, aber in LIRENO steht noch die Client-ID einer älteren App. Dann entweder URI in der alten App setzen oder neue Client-ID + neues Secret in LIRENO speichern.

Symptom: Authenticator ok, danach Microsoft-Fehlerseite

Ursache: MFA war erfolgreich; der Abbruch passiert beim Redirect (meist fehlende/falsche Reply Address oder falsche App).

Schritte: wie bei AADSTS500113; vollständige Fehlermeldung inkl. Request/Correlation Id notieren.

Symptom: «Bei Microsoft angemeldet», Hub zeigt nicht verbunden

Ursache: Entra-Portal-Login ≠ LIRENO-Hub-OAuth.

Schritte: Integrations-Hub → Microsoft 365 → Verbinden ausführen (Schritt C).

Symptom: Consent / Berechtigungen fehlen

Ursache: Graph-Scopes fehlen oder Admin-Zustimmung fehlt.

Schritte:

1. Entra → API-Berechtigungen → Contacts.ReadWrite, offline_access, openid, profile, email
2. Administratorzustimmung erteilen
3. Erneut Verbinden (prompt=consent kann erneut erscheinen)

Symptom: Nach Wechsel der Azure-App alle Firmen offline

Ursache: Tokens gehören zur alten App.

Schritte: Pro Firma im Hub neu Verbinden.

Symptom: Secret abgelaufen

Ursache: Client secret in Entra expired.

Schritte: Neues Secret in Entra → in LIRENO Setup eintragen → speichern → Hub neu verbinden.

Wann Support

• Request Id + Correlation Id + Timestamp (UTC) von Microsoft
• Client-ID (kein Secret!)
• Mandantennummer
• Dev oder Prod Callback