Anweisungen zum Einrichten einer Anwendung in Azure AD für die Graph API

Microsoft ändert häufig die Bezeichnungen seiner Produkte sowie die Anordnung und Namen seiner Menüs. Daher sind die in der folgenden Anleitung bereitgestellten Informationen nur am Tag der Erstellung gültig. Wir können keine Garantie für die Genauigkeit der Bezeichnungen zu einem späteren Zeitpunkt übernehmen.

Diese Anleitung richtet sich ausschließlich an Microsoft-Unternehmenskunden (Microsoft Azure AD). Das übliche Microsoft 365 Home User-Konto bietet diese Funktion nicht.

Die Anleitung ist in zwei Teile unterteilt:

1. Die Konfiguration der Microsoft Azure Cloud
2. Die Konfiguration der bookingtime-Organisation

Bitte lesen Sie die gesamte Anleitung sorgfältig durch, bevor Sie beginnen. Im ersten Teil werden drei Werte generiert, die wir im zweiten Teil dieser Anleitung benötigen.

Teil 1: Konfiguration der Microsoft Azure Cloud

1. Melden Sie sich im Portal „Microsoft Entra Admin“ unter https://entra.microsoft.com an.
   
   
2. Wählen Sie im Navigationsmenü links „Applikationen“ und anschließend den Unterpunkt „App Registrierungen“ aus.
   
   
   
   
3. Klicken Sie oben im Menü auf „Neu registrieren“.
   
   
   
   
   1. Geben Sie oben einen beschreibenden Namen für die Anwendung ein, z. B. „Graph API Sync with bookingtime“.
      
      
   2. Wählen Sie unter „Supported account types“ die Option „Accounts in this organizational directory only (NAME_OF_YOUR_ORGANIZATION - single tenant)“.
      
      
   3. Klicken Sie unten auf „Register“.
      
      
      
      
4. Nach der Registrierung öffnet sich ein Fenster mit der neu erstellten Anwendung. Speichern Sie folgende Werte. Fügen Sie diese in die Tabelle auf der ersten Seite der Anleitung ein und speichern Sie die Datei.
   
   
   1. 1. Kopieren Sie die "Application (client) ID."
         
         
      2. Kopieren Sie die "Directory (tenant) ID."
         
         
         
         
5. Gehen Sie im Navigationsmenü der Anwendung zu „Certificates & secrets“ und klicken Sie auf „New client secret“.
   
   
   
   
   
6. Ein Menü wird von rechts eingeblendet.
   
   
   1. Geben Sie einen beschreibenden Namen ein, z. B. „bookingtime Client secret“.
      
      
   2. Wählen Sie eine Gültigkeitsdauer aus, z. B. „180 Tage (6 Monate)“.
      
      
      
      
7. Klicken Sie unten auf „Add".
   Nachdem das Passwort abgelaufen ist kann der Kalender sich nicht mehr synchronisieren. Ein neues Passwort muss generiert werden, damit der Kalender sich erneut synchronisieren kann.
   
   
8. Kopieren Sie das ClientSecret sofort aus dem Feld „Value“.
   
   Es wird nach Erstellung eines neuen Schlüssels nicht mehr zugänglich sein. Falls das ClientSecret nicht gespeichert wurde, muss es neu erstellt werden.
   
   
   
   
9. Wählen Sie im linken Navigationsmenü „API permissions“ und klicken Sie rechts auf die Schaltfläche „Add a permission“.
   
   
   
   
10. Ein Menü wird von der rechten Seite eingeblendet.
    
    
    1. Klicken Sie "Microsoft Graph".
       
       
    2. Wählen Sie "Application permissions".
       
       
    3. Die permissions werden in einer Liste angezeigt. Scrollen Sie runter bis zu “Calendars”.
       
       
    4. Aktivieren Sie das Kästchen “Calendars.ReadWrite” und bestätigen Sie mit “Add permissions”.
       
       
       
       
11. Unter „Configured permissions“ klicken Sie auf die Schaltfläche „Grant admin consent for 'NAME_OF_ORGANIZATION'“.
    
    
    
    
12. Bestätigen Sie mit "Ja" den “Grant the admin consent confirmation” Dialog.
    
    

Die Registrierung der Anwendung in Azure AD ist damit abgeschlossen.

Nutzen Sie die generierten Werte (TenantId, ClientId, ClientSecret), um Microsoft 365 mit bookingtime zu verbinden.

Die Berechtigungen der Anwendung gelten für alle Mitglieder der Organisation, in der sie erstellt wurde. Delegierte Berechtigungen können mit der Graph API derzeit nicht umgesetzt werden.

Part 2: bookingtime organization configuration

1. Melden Sie sich in Ihrem bookingtime Portal an (https://app.bookingtime.com/).
   
   
2. Klicken Sie auf  "Einstellungen" im Menü auf der linken Seite.
   
   
   
   
3. Wählen Sie im linken Menü „Settings“ und anschließend „General Settings“ sowie das Untermenü „Office 365 sync“.
   
   
   
   
4. Geben Sie nun die drei Werte ein, die Sie im ersten Teil generiert haben.
    
   1. Um die TenantID einzugeben, fügen Sie bitte die folgende URL vor der ID hinzu: 
      
      “https://login.microsoftonline.com/” 
      Die Server-URL sollte dann beispielsweise so aussehen:
      “https://login.microsoftonline.com/10d38d51-bb2d-4df3-a713-db339d5493rh”
      
      
   2. Geben Sie die ClientID unverändert ein.
      
      
   3. Geben Sie das ClientSecret unverändert ein.
      
      
      
      
5. Klicken Sie im linken Navigationsmenü auf „Synchronisierung“ und wählen Sie die Schaltfläche „Externer Kalender“.
   
   
   
   
6. Wählen Sie einen Mitarbeiter aus und klicken Sie auf „Bestätigen“.
   
   
7. Wählen Sie den Mitarbeiter erneut aus und geben Sie eine E-Mail-Adresse ein. Nach wenigen Minuten sollte die Synchronisierung starten. Bei erfolgreicher Synchronisierung wird im Feld „Letzter Erfolg“ auf der rechten Seite ein Zeitstempel angezeigt. 
   
   

Anhang: Fehlerbehebung

Falls die Synchronisierung fehlschlägt, wird eine kurze Benachrichtigung für den Benutzer angezeigt. Im folgenden Bild sehen Sie ein Beispiel für eine erfolgreiche und eine fehlgeschlagene Synchronisierung.

Um detaillierte Informationen zum Fehler zu erhalten, wählen Sie den Tab „Synchronisierungsverlauf“.

Im gezeigten Fall ist der Benutzer „d.wellt@organization.com“ ungültig – entweder existiert er nicht in der Organisation oder die E-Mail-Adresse wurde falsch eingegeben.

Falls die Synchronisierung fehlschlägt, überprüfen Sie bitte die von Ihnen eingegebenen Werte auf der bookingtime-Website oder kontrollieren Sie Ihre Konfiguration in Microsoft Azure.

Sollten weiterhin Fehler auftreten, zögern Sie nicht, uns zu kontaktieren.