FAQs
#1015 - Client Secret für den Zugriff auf Microsoft-Mailarchive (OAuth) funktioniert nicht mehr
Betroffene Versionen: 7.x – 8.1.7
Das aktuell verwendete Client Secret für den Zugriff auf Microsoft-Mailarchive läuft am 19.12.2025 ab.
Um einen reibungslosen Betrieb sicherzustellen und Ausfälle zu vermeiden, muss bei allen Systemen, die Microsoft (OAuth) im Einsatz haben, spätestens bis zu diesem Datum eine Aktualisierung durchgeführt werden.
Sind eine oder beide der genannten Voraussetzungen erfüllt, betrifft Sie die Änderung.
1. Über die Modulverwaltung
Administration → Module → Mailarchiv
Unter Exchange-Postfach sehen Sie, ob eines der Microsoft OAuth-Verfahren aktiviert ist.
2. Über die Servereinstellungen
Administration → Servereinstellungen → SMTP-Konfiguration
Unter SMTP – Authentifizierungsverfahren erkennen Sie, ob OAuth2 aktiviert ist.
Lösungswege (zwei Optionen)
Option A: Update auf DOCBOX® Version 8.1.8.1 – Unsere Empfehlung
Vorteil: Komplettes Systemupdate inkl. der neuesten Features, nicht nur ein Patch.
Schritte:
- Gehen Sie zu docbox.eu/download → Wählen Version 8.x → Laden „DOCBOX Version 8.1.8.1“ auf dem DOCBOX® Server herunter.
- Öffnen Sie den DOCBOX® Starter auf dem DOCBOX® Server.
- Stoppen Sie alle Dienste und schließen den Starter.
- Führen Sie die herunter geladene Anwendung DOCBOX8.1.8.1.exe aus.
- Klicken Sie sich durch die Installation und warten auf Abschluss.
- Öffnen Sie den Starter erneut und starten alle Dienste.
- Bei einem Update einer Vorversion muss ggf. die Datenbank aktualisiert und die DOCBOX® lizenziert werden.
Option B: Nur Patch einspielen (Microsoft-Mailarchiv über OAuth)
Vorteil: Schneller, falls Sie keine vollständige Version 8.1.8.1 installieren möchten.
Schritte:
- Gehen Sie zu docbox.eu/download → Wählen Version 8.x → Laden den Patch „microsoft-key-update.exe“ auf dem DOCBOX® Server herunter.
- Führen Sie die herunter geladene Anwendung microsoft-key-update.exe aus.
- Folgen Sie der Anleitung bis zum Ende.
Wir empfehlen, das Update über Ihren Fachhandelspartner durchführen zu lassen.
Sollten Sie ein umfangreicheres Update von Version 7.x oder 8.0 auf Version 8.1.8.1 benötigen, ist dafür eine TAN (Transaktionsnummer) erforderlich.
Dieses Update sollte ausschließlich durch Ihren Fachhandelspartner vorgenommen werden, um einen reibungslosen Ablauf sicherzustellen.
Für Option A und B:
Wenn Sie das Update oder den Patch nach dem 19.12.2025 installieren, kann es erforderlich sein, die OAuth-Authentifizierung in der DOCBOX® erneut durchzuführen.
Wichtig: Deadline 19.12.2025
Nach diesem Datum funktionieren keine Microsoft Mailarchive oder SMTP-Verbindungen mehr, sofern die Umstellung nicht erfolgt.