OAuth2 ermöglicht eine sichere Verbindung zwischen Odoo und Microsoft Office 365, ohne dass Passwörter ausgetauscht werden müssen. Das Protokoll nutzt zeitlich begrenzte Tokens zur Autorisierung und schützt damit die Benutzerdaten. Diese Anleitung erklärt das Konzept, die praktische Umsetzung und häufige Problembehebungen für eine erfolgreiche Integration.

🔐🔗 Odoo mit Microsoft Office 365 per OAuth2 verbinden – Vollständige Anleitung

🧠 Teil 1: Das Prinzip – Was ist OAuth2 und warum?

OAuth2 ist ein Autorisierungsprotokoll – kein einfaches Passwort-Login. Es ermöglicht, dass zwei Systeme (hier: Odoo und Microsoft 365) sicher miteinander kommunizieren, ohne dass Odoo jemals das echte Microsoft-Passwort eines Benutzers kennt oder speichert.

Stattdessen bekommt Odoo ein zeitlich begrenztes „Token" (wie ein Besucherausweis), das Microsoft ausstellt und das Odoo berechtigt, bestimmte Aktionen im Namen des Benutzers durchzuführen.

🏗️ Die drei Akteure

┌─────────────────┐         ┌──────────────────┐         ┌─────────────────┐
│                 │         │                  │         │                 │
│   ODOO          │ ◄─────► │  MICROSOFT       │ ◄─────► │   BENUTZER      │
│   (Client App)  │         │  AZURE / ENTRA   │         │   (Besitzer     │
│                 │         │  ID (Auth-Server)│         │   des Postfachs)│
└─────────────────┘         └──────────────────┘         └─────────────────┘
     möchte                      stellt                       erteilt
   E-Mails senden              Token aus                    Erlaubnis
   & empfangen

🔄 Der OAuth2-Flow – vereinfacht erklärt

Benutzer klickt "Connect" in Odoo
        ↓
Odoo leitet weiter zu Microsoft Login
        ↓
Benutzer meldet sich bei Microsoft an & erteilt Erlaubnis
        ↓
Microsoft schickt Benutzer zurück zu:
https://meine-odoo-url.de/microsoft_outlook/confirm
        ↓
Odoo empfängt Access Token + Refresh Token ✅
        ↓
Odoo nutzt Token für SMTP/IMAP – kein Passwort nötig!

🎯 Zwei Anwendungsfälle – wichtiger Unterschied!

Ich weise ausdrücklich darauf hin: Es gibt bei Odoo/Microsoft zwei unterschiedliche OAuth2-Integrationen – die oft verwechselt werden:

⚠️ Beide Fälle brauchen eine separate Azure App mit unterschiedlichen Redirect URLs und Berechtigungen!

🔑 Warum OAuth2 besser ist als klassisches Passwort

🛠️ Teil 2: Schritt-für-Schritt-Anleitung

🗺️ Überblick

Microsoft Azure Portal          →     Odoo Settings
─────────────────────────────         ──────────────────────────
App registrieren                →     Client-ID + Secret eintragen
API-Berechtigungen setzen       →     Ausgehenden Mailserver konfigurieren
Benutzer zuweisen               →     Eingehenden Mailserver konfigurieren
Client Secret erstellen         →     Verbindung testen

🅰️ Teil 2A: Microsoft Azure Portal konfigurieren

Schritt 1 – Azure Portal öffnen & App registrieren

👉 Azure Portal öffnen

1. Mit dem Microsoft Office 365 Administrator-Konto anmelden
2. Navigiere zu „Manage Microsoft Entra ID" (früher: Azure Active Directory)
3. Klicke oben auf „Add (+)" → „App registration"
4. Fülle das Formular aus:

⚠️ Wichtig: Die <deine-odoo-url> muss exakt der web.base.url in Odoo entsprechen!
Du findest sie unter: Einstellungen → Technisch → Systemparameter → web.base.url

5. Klicke auf „Register"

Schritt 2 – API-Berechtigungen setzen

👉 Im linken Menü: „API permissions"

1. Klicke auf „(+) Add a Permission"
2. Wähle „Microsoft Graph" → „Delegated Permissions"
3. Suche und füge folgende Berechtigungen hinzu:

💡 „Delegated" bedeutet: Odoo handelt im Namen des Benutzers – nicht als eigenständige App. Der Benutzer muss einmalig zustimmen.

4. Klicke auf „Add permissions"

Schritt 3 – Benutzer & Gruppen zuweisen

1. Gehe zurück zur „Overview" der App
2. Klicke auf „Managed Application in Local Directory"
3. Im linken Menü: „Users and Groups"
4. Klicke auf „(+) Add User/Group"
5. Füge alle Benutzer/Gruppen hinzu, die Outlook in Odoo nutzen sollen
6. Klicke „Select" → „Assign"

Schritt 4 – Client-ID & Client-Secret erstellen

Client-ID ermitteln:

• In der „Overview" der App: Application (Client) ID kopieren 📋

Client Secret erstellen:

1. Im linken Menü: „Certificates & Secrets"
2. Klicke auf „(+) New Client Secret"
3. Fülle aus:
   • Description: Odoo Fetchmail
   • Expires: Maximal mögliches Datum wählen (24 Monate oder Custom)
4. Klicke „Add"
5. Den „Value" sofort kopieren! ⚠️ Er wird danach nicht mehr vollständig angezeigt!

⚠️ Ich empfehle dringend, das Ablaufdatum zu notieren und im Kalender einzutragen – bei Ablauf gibt es sofortige Mailunterbrechungen!

🅱️ Teil 2B: Odoo konfigurieren – Ausgehender Mailserver

Schritt 5 – Outlook-Integration in Odoo aktivieren

👉 Einstellungen → Allgemeine Einstellungen → Integrationen

1. „Microsoft Outlook" aktivieren ✅
2. Client-ID aus Schritt 4 eintragen
3. Client-Secret aus Schritt 4 eintragen
4. Speichern

Schritt 6 – Ausgehenden Mailserver einrichten

👉 Einstellungen → Allgemeine Einstellungen → Ausgehende Mailserver

1. „Neu erstellen"
2. Haken bei „Outlook OAuth" setzen
3. Fülle aus:

4. Klicke auf „Connect your Outlook account"
5. Microsoft-Fenster öffnet sich → Anmelden → „Yes" klicken
6. Grüner Badge „Outlook Token Valid" erscheint ✅
7. „Verbindung testen" klicken

🅲️ Teil 2C: Odoo konfigurieren – Eingehender Mailserver

Schritt 7 – Eingehenden Mailserver einrichten

👉 Einstellungen → Technisch → E-Mail → Eingehende Mailserver

💡 Das Technische Menü ist nur im Entwicklermodus sichtbar!
Aktivieren unter: Einstellungen → Allgemein → Entwicklermodus aktivieren

1. „Neu erstellen"
2. Servertyp: Outlook OAuth Authentication
3. Fülle aus:

4. Klicke auf „Connect your Outlook account"
5. Erneut Microsoft-Login durchführen → Erlaubnis erteilen
6. „Verbindung testen" klicken ✅

✅ Teil 3: Checkliste & häufige Fehler

✅ Abschlusskontrolle

□ Azure App registriert mit korrekter Redirect URL
□ API Permissions: SMTP.Send + IMAP.AccessAsUser.All gesetzt
□ Benutzer/Gruppen in der App zugewiesen
□ Client-ID und Client-Secret in Odoo eingetragen
□ web.base.url in Odoo stimmt mit Redirect URL überein
□ Ausgehender Mailserver: Token gültig (grüner Badge)
□ Eingehender Mailserver: Verbindung erfolgreich getestet
□ Ablaufdatum des Client-Secrets notiert!

⚠️ Häufige Fehler & Lösungen

📚 Weiterführende Links

Ich hoffe, dieses vollständige Dokument hilft dir und deinem Team bei der Einrichtung! Du kannst es direkt als interne Dokumentation oder Kundenanleitung verwenden. 🎉

Viel Erfolg bei der Umsetzung – ich drücke dir die Daumen! 🤞

Oddy
Odoo-Expertin bei Detalex GmbH