API-Schnittstellen
      Zurück zur Startseite
      1. FAQ / Wissensdatenbank
      2. Einrichtung
      3. API-Schnittstellen

      Office-365-Kalender synchronisieren mit openHandwerk

      Wie kann ich meinen Office-365-Outlook mit openHandwerk synchronisieren?

      Du hast mit openHandwerk die Möglichkeit deinen Office 365  E-Mail Versand zu verbinden.  Hierfür musst du (bzw. der Office-Mandanten-Admin deines Unternehemens) ein paar Einstellungen vornehmen, welche wir dir nachfolgend Schritt für Schritt erklären werden. 

      1. Aufruf der Admin-Konsole über https://admin.microsoft.com
      2. Login mit Microsoft-Zugangsdaten


      Mandanten-ID bestimmen

      1 (1)

      1. Anklicken zum Ausklappen und nach unten Scrollen bis Azure-Active-Directory erscheint

      2 (1)

      2. Azure-Active-Directory anklicken, um die Active-Directory-Admin-Center des Mandanten zu öffnen

      3 (1)

      3. Azure-Active-Directory anklicken, um zu den Active-Directory-Einstellungen zu gelangen

      4 (1)

      4. Notieren Sie die Mandanten-ID sicher (roter Kasten). Diese wird später von openHandwerk benötigt um dein Office-Abo identifizieren zu können

       

      openHandwerk Web-App registrieren und konfigurieren

      Anwendung registrieren

      1-2

      1. Scrolle nach unten bis App-Registrierung erscheint
      2. Klicke auf App-Registrierungen
        3
      3. Klicke auf Neue Registrierung
        4-7
      4. Gebe openHandwer-Cloud in das Textfeld für den Anwendungsnamen ein
      5. Belasse den Unterstützten Kontotyp bei Nur Konten in diesem Organisiationsverzeichnis (nur "ihr Firmenname" - einzelner Mandant)
      6. Gebe die angezeigte URL in das Textfeld ein
      7. Klicke auf Registrieren
        8
      8. Notiere die Anwendungs-ID sicher (roter Kasten), mit ihr identifiziert sich openHandwerk später als die soeben erstellte Anwendung

      Anwendung konfigurieren - Sicherheitsschlüssel erstellen

      konf_1-4

      1. Klicke auf Zertifikate & Geheimnisse
      2. Klicke auf Neuer geheimer Clientschlüssel
      3. Gebe im Textfeld Beschreibung "Zugang openHandwerk" ein und wähle im Auswahlfeld Gültig bis "24 Monate" als Dauer aus
      4. Klicke auf Hinzufügen
        konf_5
      5. Notiere umgehend den (geheimen) Schlüsselwert sicher (z.B. durch Klick au den Kopierbutton rechts vom Wert & anschließendem Einfügen in ein Textdokument)
        Wichtig: Dies muss sofort geschehen; bei einem erneuten Besuch der Seite ist dieser Wert nicht mehr sichtbar! Der Schlüssel wird von openHandwerk verwendet um sich gegenüber ihrer Office-Instanz zu authentifizieren.

      Anwendung konfigurieren - Berechtigung erteilen

      perm_1-3

      1. Klicke auf API-Berechtigungen
      2. Klicke auf Berechtigung hinzufügen
      3. Klicke auf Microsoft Graph
        perm_4-8
      4. Klicke auf Anwendung
      5. Gebe in das Textfeld "User.Read.All" ein
      6. Klappe durch Klick die Kategorie "User" aus
      7. Setze das Häckchen für "User.Read.All"
      8. Klicke auf Berechtigung hinzufügen
      9. Wiederhole die Schritte 2-8 für die Berechtigung "Calendars.ReadWrite". Tippe dafür in Schritt 5 diesmal "Calenders.ReadWrite" in das Suchfeld ein
        perm_10-12
      10. Bist du den Schritten bis hierhin gefolgt, sollten die in den roten Kästchen eingerahmten Berechtigung in der Berechtigungsübersicht auftauchen
      11. Klicke auf "Administratorzustimmung für "Ihre Firma" erteilen"
      12. Bestätigen sie dies mit Klick auf Ja 
        Hinweis zu den erteilten Berechtigungen:
        User.Read.All:
        Wird benötigt um die in der Office-Instanz hinterlegten Nutzeraccounts, E-Mail-Adressen und zugeordneten Lizenzen zum Zweck der Benutzerzuordnung zwischen OH und Office abrufen zu können.

      Jetzt ist dein Office Mandat erfolgreich für die Nutzung mit openHandwerk eingerichtet!


       

      Bei weiteren Problemen oder Fragen melden Sie sich bitte mit den Mindestanforderungen per E-Mail unter: .