Paperless-ngx: OAuth2 für Microsoft 365 einrichten

Paperless-ngx kann Anhänge aus E-Mail-Postfächern automatisch verarbeiten. Damit dies auch mit einem Microsoft 365 Konto funktioniert, müssen einige Einstellungen vorgenommen werden. In diesem Artikel zeigen wir, was zu tun ist, damit die Anbindung funktioniert.

OAuth2

OAuth2 ist ein Autorisierungsprotokoll, das es einer Anwendung ermöglicht, im Namen eines Nutzers auf bestimmte Ressourcen zuzugreifen, ohne dass der Nutzer seine Zugangsdaten preisgeben muss. Der Benutzer erteilt der Anwendung eine Autorisierung auf einer Bestätigungsseite des Anbieters (z. B. Microsoft). Nach der Zustimmung erhält die Anwendung einen Access Token.

Dieser Access Token dient als Schlüssel für die freigegebenen Ressourcen. Die Anwendung bekommt nur die Berechtigungen, die genehmigt wurden. Der Token ist zeitlich begrenzt und kann jederzeit widerrufen werden.

Einrichtung in Azure

1. Melde dich mit deinem Microsoft-Konto im Azure-Portal an und wähle Microsoft Entra ID.
2. Klicke auf Hinzufügen → App-Registrierung. Vergib einen Namen und wähle den Kontotyp (z. B. Konten in einem beliebigen Organisationsverzeichnis).
3. Bei den Umleitungs-URIs wähle Web und trage ein:
   https://deine.paperless-url.de/api/oauth/callback
4. Klicke auf Registrieren.
5. Navigiere zu Verwaltung → Authentifizierung und aktiviere die Häkchen bei Zugriffstoken und ID-Token. Speichern.
6. Gehe zu Zertifikate & Geheimnisse → Neuer geheimer Clientschlüssel. Beschreibung vergeben, Gültigkeit wählen. Wert sicher notieren.
7. Unter Übersicht die Anwendungs-ID (Client) kopieren.

Einrichtung auf dem Server

Auf deinem Server im Paperless-ngx Installationsordner die Datei docker-compose.env öffnen und diese Zeilen hinzufügen/ändern:

PAPERLESS_OAUTH_CALLBACK_BASE_URL=https://deine.paperless-domain.de
PAPERLESS_OUTLOOK_OAUTH_CLIENT_ID=<DEINE_AZURE_CLIENT_ID>
PAPERLESS_OUTLOOK_OAUTH_CLIENT_SECRET=<DEIN_AZURE_CLIENT_SECRET>

Danach die Paperless-ngx Container neu starten:

docker compose down
docker compose up -d

Einrichtung in Paperless-ngx

1. Im Webinterface von Paperless-ngx anmelden und links auf E-Mail klicken.
2. Auf Outlook Konto verbinden klicken. Du wirst zu Microsoft weitergeleitet und meldest dich an.
3. Nach erfolgreicher Anmeldung zurück bei Paperless: E-Mail-Adresse eintragen – fertig.

Das war alles zu “Paperless-ngx: OAuth2 für Microsoft 365 einrichten“.

Als Nächstes: E-Mail-Regeln anlegen, damit Anhänge automatisch verarbeitet werden.
https://pathconnect.de/blog/e-mail-account-in-paperless-ngx-einbinden/

Open Source Software bei PathConnect

Einfach auswählen und loslegen. Wir passen die Software genau an deine Bedürfnisse an, kümmern uns um die Wartung und stehen dir mit persönlichem Support zur Seite. Unser Angebot umfasst eine Vielzahl von Open-Source-Lösungen, die perfekt auf deine Anforderungen zugeschnitten werden können. Genieße den Komfort eines Rundum-Services, der Installation, Anpassungen und Updates beinhaltet, damit du dich voll und ganz auf deine Projekte konzentrieren kannst.