Zum Hauptinhalt springen
Version: 2024.3.0

Microsoft Graph Schnittstelle

Generelle Informationen

DocBee bietet ab der Version 2020.2 die Möglichkeit, den E-Mail-Versand, Mail-Parser und Kalender-Anbindung bei Office 365 über die Microsoft Graph Schnittstelle zu konfigurieren.

Einrichtung

Mit den folgenden Schritten richten Sie Ihr Office 365 ein, damit es mit DocBee über die Microsoft Graph Schnittstelle sprechen kann.

Basis

  1. Öffnen Sie das Microsoft Azure Portal und melden sich mit Ihrem Administrator Account an.
  2. Gehen Sie in die Azure Active Directory-Verwaltung
  3. App-Registrierungen
  4. Zum Registrieren einer neuen Anwendung gehen Sie auf die Schaltfläche + Neue Registrierung.
  5. Im folgendem Fenster geben Sie nun einen Namen ( z.B. "DocBee" ) ein und definieren die Unterstützten Kontotypen und lassen die optionale Umleitungs-URI (optional) leer.
  6. Nach dem Betätigen der Registrieren werden Sie auf die Anwendungs-Seite weitergeleitet. Hier können Sie sich schon mal die Anwendungs-ID (Client) und Verzeichnis-ID (Mandant) speichern.
  7. Nun öffnen Sie Zertifikate & Geheimnisse und betätigen unter Geheime Clientschlüssel die Schaltfläche + Neuer geheimer Clientschlüssel.
  8. Im folgendem Fenster geben Sie nun einen Namen ( z.B. "DocBee Schlüssel" ) ein und definieren eine Gültigkeitsdauer ( Wir empfehlen eine möglichst lange Dauer damit Sie nicht regelmäßig einen neuen Schlüssel anlegen müssen )
  9. Nach Betätigen der Schaltfläche Hinzufügen kopieren Sie sich bitte direkt den Wert ihreres neuen geheimen Schlüssels, dieser wird nämlich nach dem Neuladen nicht mehr vollständig angezeigt. WICHTIG: Kopieren Sie den Wert des Feldes Wert und nicht die Geheime ID
  10. Die Basis Einstellungen sind nun vorgenommen und Sie haben alle Werte, die Sie in DocBee eintragen müssen. Nun müssen Sie nur noch die Berechtigungen definieren je nach gewünschten Einsatzzwecks der Anbindung.

Berechtigungen definieren

Damit DocBee auch Daten erhalten kann, müssen noch Berechtigungen für die Anwendung erteilt werden. Die folgende Tabelle erklärt, wann Sie welche Berechtigung erteilen müssen.

TypBerechtigung
E-Mail VersendenMicrosoft Graph Mail.Send
Mail-ParserMicrosoft Graph Mail.ReadWrite
KalenderMicrosoft Graph Calendars.ReadWrite

Die folgende Anleitung erklärt, wie Sie die Berechtigungen hinzufügen.

  1. Gehen Sie in die Übersicht Ihrer angelegten Anwendung
  2. Klicken Sie auf API-Berechtigungen und dann auf + Berechtigung hinzufügen
  3. In diesem Dialog wählen Sie nun Microsoft Graph und den Typ Anwendungsberechtigungen aus.
  4. In der folgenden Liste wählen Sie nun die gewünschte Berechtigung aus und speichern die Berechtigung.
  5. Da es sich um Berechtigungen handelt, die vom Administrator bestätigt werden müssen, klicken Sie auf die Schaltfläche Administratorzustimmung erteilen und bestätigen Sie die Berechtigung.
  6. Fertig

Hinweis: Sie können die Standard Berechtigung MS Graph User.Read entfernen, diese wird von DocBee nicht benötigt.

FAQ

Warum liefert DocBee einen Authentifizierungs-Fehler?

Wir können mit den aktuellen Zugangsdaten keine Verbindung zu MS Graph aufbauen. Bitte überprüfen Sie Folgendes:

  • Ihre Zugangsdaten WICHTIG: Beim Geheimen Clientschlüssel muss der Wert des Feldes Wert und nicht die Geheime ID eingetragen werden
  • Ob die Anwendungsberechtigung erteilt wurde
  • Ob der Geheime Clientschlüssel nicht abgelaufen ist

Warum bekomme ich plötzlich einen Authentifizierungs-Fehler?

Bitte überprüfen Sie ob Ihr Geheimer Clientschlüssel eventuell abgelaufen ist und falls dies der Fall ist, legen Sie einen neuen an und hinterlegen Sie diesen in DocBee.