Wichtiger Hinweis
Microsoft stellt den Support für Exchange Web Services (EWS) in Exchange Online ein. Nach der aktuellen Planung (Mai 2025) wird EWS ab dem 1. Oktober 2026 standardmäßig blockiert. Die vollständige und endgültige globale Abschaltung aller EWS-Requests erfolgt dann am 1. April 2027.
Bitte beachten Sie, dass Microsoft diesen Zeitplan noch einmal ändern kann. Kunden von DocuWare Connect to Mail sollten jedoch so bald wie möglich auf die Graph-API umsteigen. Bitte nutzen Sie den folgenden KBA-Artikel, um auf die Graph-API umzusteigen: KBA-38086
Frage:
Wie kann ich meine „Connect to Mail“-Konfigurationen auf die OAuth2-Authentifizierung umstellen?
Antwort:
Bitte lesen Sie die folgende Anleitung zur Aktivierung der OAuth2-Authentifizierung für „Connect to Mail“:
Hintergrundinformationen
Microsoft hat offiziell angekündigt, dass die Basis-Authentifizierung zum 1. Oktober 2022 eingestellt wird. Nach diesem Datum ist es nicht mehr möglich, die Basis-Authentifizierung für Exchange Online-Systeme zu konfigurieren.
Angesichts der bevorstehenden Einstellung wird es notwendig sein, die OAuth2-Authentifizierung zu implementieren, um sicherzustellen, dass Ihre „Connect to Mail“-Jobs weiterhin funktionieren. Die erforderlichen Schritte können je nach verwendetem DocuWare-System variieren. Bitte beachten Sie die folgenden Szenarien hinsichtlich der Einführung von OAuth2.
Weitere Informationen zur Einstellung der Basis-Authentifizierung finden Sie unter: Einstellung der Basis-Authentifizierung/exchange-online
Hinweis: Auch wenn die Basis-Authentifizierung deaktiviert ist, steht die SMTP-Authentifizierung weiterhin zur Verfügung.
Für Cloud-Kunden ohne benutzerdefinierte App in Azure
Es ist nicht erforderlich, eine Konfiguration für die Mail-Dienste zu erstellen, da DocuWare bereits alles bereitstellt, was für die Verbindung zu Ihrem Office 365-E-Mail-Konto über OAuth2 benötigt wird. Rufen Sie Ihr „E-Mails allgemein“-Plugin auf und stellen Sie eine direkte Verbindung zu Ihrem Office 365-Konto her, indem Sie die Option„Exchange Online“auswählen.
Für Cloud-Kunden, die eine selbst erstellte App in Azure verwenden
Wenn Sie sich mit Ihrer selbst erstellten App bei Office 365 verbinden möchten, führen Sie die folgenden Schritte aus:
Registrieren Sie die OAuth-App im Azure Active Directory Ihrer Organisation
Wechseln Sie zur App-Registrierung Ihrer Organisation und klicken Sie auf das Plus-Symbol füreine neue Registrierung
Geben Sie einen Anzeigenamen ein und geben Sie eine Umleitungs-URI an, z. B. „https://my-company.com/DocuWare/Settings?link=MailCapture“
Hinweis: Bei der Umleitungs-URI wird zwischen Groß- und Kleinschreibung unterschieden, und sie muss über das Internet erreichbar sein. Diese Umleitungs-URL wird von Microsoft aufgerufen, nachdem sich ein Benutzer erfolgreich authentifiziert hat.Öffnen Sie das Menü „Authentifizierung“ auf der linken Seite und scrollen Sie nach unten zur Überschrift „Implicit Grant“. Stellen Sie sicher, dass sowohl „Zugriffstoken“ als auch „ID-Token“ aktiviert sind, und speichern Sie anschließend Ihre Änderungen.
Wechseln Sie zum Menü „Zertifikate & Geheimnisse“ und erstellen Sie ein neues Client-Geheimnis. Bewahren Sie dieses Client-Geheimnis sicher ab. Wir benötigen es später bei der Registrierung der App in den Mail-Diensten von DocuWare.
Wählen Sie anschließend im Menü zur App-Registrierung „API-Berechtigungen“aus und fügen Sie eine neue Berechtigung hinzu.
Wählen Sie unter den Microsoft-APIs „Microsoft Graph“ aus und klicken Sie auf „Delegierte Berechtigungen“.
Fügen Sie die folgenden Berechtigungen hinzu und speichern Sie Ihre Änderungen:
offline_access
openid
EWS.AccessAsUser.All
User.Read
Klicken Sie abschließend in der Übersicht der konfigurierten Berechtigungen auf „Administratorzugriff für IHR FIRMENNAME gewähren “. Dieser Schritt ist optional. Wenn Sie den Zugriff jetzt nicht gewähren, muss dies anschließend von einem Administrator der Organisation vorgenommen werden. Andernfalls kann der Benutzer keine Berechtigung für „Connect to Mail“ erteilen.
Herzlichen Glückwunsch! Sie haben Ihre persönliche OAuth2-App nun erfolgreich konfiguriert. Wechseln Sie zur Übersicht und kopieren Sie die Werte für „Anwendungs- (Client-)ID“, „OAuth 2.0-Autorisierungsendpunkt (v2)“ und „OAuth 2.0-Token-Endpunkt (v2)“ (aus dem Menü „Endpunkte“). Wir benötigen diese Werte für die Registrierung bei den Mail-Diensten.
Zugriff für „Connect to Mail“ auf die Exchange-Web-Services-APIs gewähren
Bevor wir zu DocuWare wechseln, müssen wir die Exchange Web Services-APIs als „Low Impact“ einstufen.
Hinweis: Dieser Schritt ist unabhängig davon erforderlich, ob Sie die offizielle DocuWare Cloud-OAuth-App oder Ihre selbst registrierte Azure-App verwenden.
Öffnen Sie in Azure Active Directory die Kachel „Unternehmensanwendungen“
Wechseln Sie anschließend zu „Zustimmung und Berechtigungen“
Wählen Sie im Untermenü „Einstellungen zur Benutzerzustimmung (Vorschau)“ die Option„Benutzerzustimmung für Apps von verifizierten Herausgebern für ausgewählte Berechtigungen zulassen (empfohlen)“ aus
Stufen Sie die folgenden Berechtigungen als geringfügig ein, einschließlich der Exchange Web Services-APIs:
Berechtigungen
EWS.AccessAsUser.All
Offline_access
Profil
openid
E-Mail
User.Read
Denken Sie daran, Ihre Änderungen zu speichern – nun können Benutzer Zugriff auf diese App gewähren. Fahren Sie bitte mit dem folgenden Abschnitt fort.
Erstellen Sie in DocuWare Cloud eine neue Verbindung zum Exchange-Mail-Dienst
Nachdem nun alles eingerichtet ist, konfigurieren Sie „Connect to Mail“ so, dass die Authentifizierung über OAuth2 auf Exchange erfolgt.
Hinweis: Das Erstellen einer Verbindung zum Exchange-E-Mail-Dienst in „Connect to Mail“ ist nur erforderlich, wenn Sie Office 365 / Exchange Online von DocuWare On-Premises aus verbinden möchten oder Ihr Office 365 über die Microsoft National Cloud betrieben wird.
Öffnen Sie die DocuWare-Konfigurationen [https://your-DocuWare/DocuWare/Settings]
Öffnen Sie das Plugin für die Mail-Dienste und wählen Sie „Neuen Exchange-Mail-Service erstellen“.
Stellen Sie sicher, dass als Authentifizierungstyp „OAuth2-Authentifizierung verwenden“eingestellt ist .
Geben Sie alle Angaben ein, die Sie bei der Registrierung der Azure Active Directory-App notiert haben.
Achten Sie darauf, genau die bei der Registrierung verwendete Redirect-URI einzugeben. (z. B. „https://my-company.com/DocuWare/Einstellungen?link=MailCapture“)
Möglicherweise ist es erforderlich, die URL der Exchange-Web Services zu ändern.
Speichern Sie Ihre Konfiguration.
Nun können Sie diese neue Verbindung zum Exchange-Mail-Dienst im Plugin „E-Mails allgemein“ nutzen.
Für On-Premises-Kunden, die eine selbst erstellte App in Azure verwenden
Registrieren Sie Ihre Anwendung als öffentlichen Client bei Azure Active Directory. Sie können eine Anwendung über das Azure Active Directory-Verwaltungscenter oder über Microsoft Graph registrieren. Im Folgenden finden Sie Anweisungen von Microsoft, die Sie über den unten stehenden Link aufrufen können:
So authentifizieren Sie eine EWS-Anwendung mithilfe von oauth/register-your-application
Öffnen Sie einen Browser, rufen Sie die Seite „https://entra.microsoft.com“ auf und melden Sie sich mit einem persönlichen Konto (auch als Microsoft-Konto bezeichnet) oder einem Arbeits- oder Schulkonto an .
Wählen Sie in der linken Navigationsleiste „Azure Active Directory“aus und wählen Sie anschließend unter „Verwalten“ die Option„App-Registrierungen“ aus .
Wählen Sie „Neue Registrierung“aus . Legen Sie auf der Seite„Anwendung registrieren “ die folgenden Werte fest.
Legen Sie unter„Name“ einen aussagekräftigen Namen für Ihre Appfest .
Legen Sie unter„Unterstützte Kontotypen“ die für Ihr Szenario passende Optionfest .
Ändern Sie bei „Umleitungs-URI“ die Dropdown-Auswahl auf „Web“ und setzen Sie den Wert auf „https://my-company.com/DocuWare/Settings?link=MailCapture“.
Wählen Sie „Registrieren“. Kopieren Sie auf der nächsten Seite den Wert der Anwendungs- (Client-)ID; Sie benötigen ihn später.
Sobald die Anwendung erstellt wurde, benötigen Sie die folgenden Informationen, um die Mail-Dienste in DocuWare einzurichten.
Anwendungs- (Client-)ID
Client-Geheimnis
OAuth 2.0-Autorisierungsendpunkt
OAuth 2.0-Token-Endpunkt
Umleitungs-URI
Erstellen Sie eine neue Verbindung zum Exchange-Mail-Dienst in DocuWare (On-Premises)
Nachdem nun alles eingerichtet ist, ist es an der Zeit, dies in „Connect to Mail“ einzurichten, damit sich „Connect to Mail“ über OAuth 2.0 bei Exchange authentifiziert.
Hinweis: Das Erstellen einer Verbindung zum Exchange-E-Mail-Dienst in „Connect to Mail“ ist nur erforderlich, wenn Sie Office 365 / Exchange Online von DocuWare On-Premises aus verbinden möchten oder wenn Ihr Office 365 über die Microsoft National Cloud betrieben wird.
Öffnen Sie die DocuWare-Konfigurationen [https://your-DocuWare/DocuWare/Settings]
Öffnen Sie das Mail-Service-Plugin und wählen Sie „Neuen Exchange-Mail-Dienst erstellen“
Stellen Sie sicher, dass der Authentifizierungstyp auf „OAuth2-Authentifizierung verwenden“eingestellt ist
Geben Sie alle Details ein, die Sie sich bei der Erstellung der neuen Azure Active Directory-App-Registrierung notiert haben.
Vergessen Sie nicht, genau dieselbe Umleitungs-URI aus der Registrierung einzugeben (z. B. „https://my-company.com/DocuWare/Einstellungen?link=MailCapture“)
Möglicherweise ist es erforderlich, die URL der Exchange-Web Services zu ändern.
Ablegen und Speichern Ihrer Konfiguration
Nun können Sie diese neue Verbindung zum Exchange-Mail-Dienst im Plugin „E-Mails allgemein“ verwenden.
Aktualisierung bestehender E-Mail-Verbindungen auf die neue OAuth2-Authentifizierung
Bevor die Basis-Authentifizierung deaktiviert wird, empfehlen wir, den bestehenden Mail-Dienst mit Identitätsübernahme unverändert zu lassen, damit bereits verbundene E-Mail-Konten ordnungsgemäß funktionieren, bis Microsoft die Basis-Authentifizierung am 1. Oktober 2022 vollständig deaktiviert.
Jeder, der über eine bestehende E-Mail-Verbindung im Plugin „E-Mails allgemein“ verfügt, muss sich erneut über die neue Option „Mit Microsoft anmelden“ anmelden. Benutzer mit einer bestehenden E-Mail-Verbindung müssen entweder den offiziellen DocuWare-Mail-Dienst„Exchange Online“ (nur für DocuWare Cloud verfügbar) oder den neu erstellten Exchange-Mail-Dienst auf Basis der OAuth-Authentifizierung auswählen.
Hinweis: Sobald Microsoft die Basis-Authentifizierung für Office 365 und Exchange Online einstellt, können E-Mail-Verbindungen, die den alten Mechanismus verwenden, „Connect to Mail“ nicht mehr nutzen. Sie werden von DocuWare automatisch deaktiviert.
Dieser KBA gilt sowohl für Cloud- als auch für On-Premises-Organisationen.
Bitte beachten Sie: Dieser Artikel ist eine Übersetzung aus dem Englischen. Die in diesem Artikel enthaltenen Informationen basieren auf der/den englischsprachigen Originalversion(en) des Produkts. In der übersetzten Version unserer Artikel können kleinere Fehler enthalten sein, z.B. in der Grammatik. Wir können zwar nicht für die vollständige Richtigkeit der Übersetzung garantieren, aber in den meisten Fällen werden Sie sie als ausreichend informativ empfinden. Im Zweifelsfall wechseln Sie bitte zurück zur englischen Version dieses Artikels.