Überblick

In diesem Artikel führen wir Dich durch die für die Integration erforderlichen Schritte sowohl von der Microsoft-Seite als auch von der Beekeeper-Seite. Dieses Marketplace-Add-on ist kostenlos. Wenn Du Hilfe bei der Konfiguration benötigst, kannst Du Dich bei Deinem Customer Success Manager nach den Preisen für den technischen Implementierungssupport informieren.

Hinweis: Bitte überprüfe auf unserer Firmen-Website, ob diese Funktionalität in Deinem Preispaket verfügbar ist.

Bevor Du mit der Installation beginnen kannst, stelle sicher, dass Du die SharePoint-Integration im Beekeeper-Marketplace anforderst.

Navigiere dazu im Beekeeper-Admin-Bereich zu Erweiterungen > Marketplace, gib in der Suchleiste SharePoint ein und klicke dann auf Anfordern. Sobald Du das Add-on angefordert hast, wird die Marketplace-App vom Support-Team oder Deinem Customer Success Manager installiert. Dies ist erforderlich, damit Du auch den letzten Schritt dieser Anleitung abschließen kannst.

 

Der Vorgang ist in vier Schritte eingeteilt:

Wir beginnen mit der Autorisierung der Beekeeper-App in Azure Active Directory, damit eine Verbindung zwischen eurer Beekeeper-Dokumentbibliothek und SharePoint hergestellt werden kann.

Es gibt zwei Optionen, die Verbindung zwischen der SharePoint-Integration und einem SharePoint-Server einzurichten. Diese beiden Optionen sind:

• Flow zur Authentifizierung von Clientanmeldeinformationen
• Flow zur Authentifizierung von Benutzernamen/Kennwort

Dann zeigen wir Dir, wie Du die richtigen IDs für Deine spezifische SharePoint-Seite abrufen kannst. Dazu benötigen wir etwas Hilfe vom Microsoft Graph Explorer, auf den wir später noch eingehen werden.

Als nächstes konfigurieren wir Deine spezifische SharePoint-Seite so, dass sie für die Beekeeper-Plattform lesbar ist, und damit Deine Mitarbeitenden nahtlos darauf zugreifen können.

Die drei oben genannten Schritte sind alle darauf ausgerichtet, die erforderlichen Anmeldeinformationen für eine erfolgreiche Integration zu generieren. Diese Anmeldeinformationen sind in der folgenden Tabelle zusammengefasst und dienen als Vorlage für diese Integration.

Schließlich sehen wir uns an, wie man die Marketplace-App in Beekeeper konfiguriert, um die Verbindung zwischen Deiner Beekeeper-Dokumentbibliothek und SharePoint herzustellen.

 

Vorlage für die Anmeldeinformationen: Flow zur Authentifizierung von Clientanmeldeinformationen

Parameter	Wert
Basis-URL
Anwendungs-ID (Client-ID)
Verzeichnis-ID (Mandanten-ID)
Anwendungsgeheimnis
DriveID
SiteID
DriveItemID
Beekeeper-Ordner-ID

 

Vorlage für die Anmeldeinformationen: Flow zur Authentifizierung von Benutzernamen/Kennwort

Parameter	Wert
Basis-URL
Anwendungs-ID (Client-ID)
Verzeichnis-ID (Mandanten-ID)
Anwendungsgeheimnis
DriveID
SiteID
DriveItemID
Beekeeper-Ordner-ID

 

App-Registrierung in Azure Active Directory

Option 1: Flow zur Authentifizierung von Clientanmeldeinformationen

Bei diesem Szenario benötigst die SharePoint-Integration ein Token, um eine Web-API im eigenen Namen (nicht im Namen eines Benutzers) aufzurufen. Sie verwendet die Standardzuweisung für Clientanmeldeinformationen von OAuth 2.0.

Für Anwendungen, die ein Token für ihre eigenen Identitäten abrufen, gilt Folgendes:

• Sie sind vertrauliche Clientanwendungen. Diese Apps müssen angesichts der Tatsache, dass sie unabhängig von Benutzern auf Ressourcen zugreifen, ihre Identität nachweisen. Sie sind außerdem eher sensible Apps. Sie müssen von den Azure-AD-Mandantenadministratoren genehmigt werden.
• Sie haben bei Azure AD ein Geheimnis registriert (Anwendungskennwort oder Zertifikat). Dieses Geheimnis wird während des Aufrufs an Azure AD zum Abrufen eines Tokens übergeben.

 

Schritte zur Einrichtung der App

1. Melde Dich bei Deinem Microsoft 365 Admin Center an und wähle AzureActive Directory aus dem Hauptmenü aus.

2. Wähle danach im Azure Directory Admin Center Azure Active Directory aus dem Hauptmenü und App-Registrierung aus dem Untermenü.

3. Klicke dann auf Neue Registrierung.

4. Weise der SharePoint-Integration einen eindeutigen Namen zu. Wähle die Option Konten in einem beliebigen Organisationsverzeichnis (irgendein Azure-AD-Verzeichnis — mehrinstanzenfähig) für Unterstützte Kontotypen aus. Es ist kein Wert für den Umleitungs-URI erforderlich. Klicke anschließend auf Registrieren.

5. Merke Dir die Werte für die Anwendungs-ID (Client-ID) und die Verzeichnis-ID (Mandanten-ID). Diese Werte werden bei der Konfiguration der Integration innerhalb von Beekeeper benötigt! Klicke auf API-Berechtigungen anzeigen.

Benutze die Anwendungs-ID (Client-ID) und die Verzeichnis-ID (Mandanten-ID), um die Vorlage für die Anmeldeinformationen auszufüllen.

Anwendungs-ID (Client-ID)	8abb5250-fccf-4608-aa4a-c563d5aa0769
Verzeichnis-ID (Mandanten-ID)	9cadc3c2-7c83-4ca8-a506-73d2ee0e2cbc

 

6. Klicke auf Berechtigung hinzufügen und wähle Microsoft Graph.

7. Klicke auf Anwendungsberechtigungen und wähle die folgenden Berechtigungen aus der Liste aus:

- Files
    - Files.Read.All
- Sites
    - Sites.Read.All

8. Klicke anschließend auf Administratorzustimmung für ... Diese Einstellungen stellen sicher, dass im Vergleich zum normalen OAuth-Flow keine Genehmigung durch einen bestimmten Nutzer erforderlich ist.

9. Wähle Zertifikate & Geheimnisse aus dem Menü aus.

10. Klicke auf Neuer geheimer Clientschlüssel. Gib eine optionale Beschreibung des Geheimnisses und eine Dauer ein.

11. Kopiere diesen Wert jetzt, weil der Schlüssel später nicht mehr abgerufen werden kann. Wenn der Dialog geändert wird, ist das Geheimnis nicht mehr zugänglich! Der Schlüssel wird bei der Konfiguration der Integration innerhalb von Beekeeper benötigt.

Anwendungsgeheimnis

WKQ8h1MCW5z_c4JxsbfVAJ.m8~_3-P~x29

 

Diese 11 Schritte sollten die folgenden ersten 3 Felder erfolgreich generiert haben.

Anwendungs-ID (Client-ID)	8abb5250-fccf-4608-aa4a-c563d5aa0769
Verzeichnis-ID (Mandanten-ID)	9cadc3c2-7c83-4ca8-a506-73d2ee0e2cbc
Anwendungsgeheimnis	WKQ8h1MCW5z_c4JxsbfVAJ.m8~_3-P~x29

 

Option 2: Flow zur Authentifizierung von Benutzernamen/Kennwort

Bei diesem Szenario benötigst die SharePoint-Integration ein Token, um eine Web-API im Namen eines Benutzers aufzurufen. Sie verwendet den standardmäßigen Flow für OAuth 2.0-Kennwortanmeldeinformationen des Ressourcenbesitzers und erwirbt ein Token im Namen eines Benutzers.

Die Verwendung des Flows zur Authentifizierung von Benutzernamen/Kennwort wird nicht empfohlen, aber da die SharePoint-Integration eine Daemon-Anwendung ohne direkte Benutzerschnittstelle ist und wir wollen, dass sie im Namen eines Benutzers auf den SharePoint-Server zugreift, führt kein Weg daran vorbei, sie zu verwenden.

 

Für Anwendungen, die ein Token im Namen eines Benutzers erwerben, gilt Folgendes:

• Es sind vertrauliche Anwendungen. Diese Apps müssen angesichts der Tatsache, dass sie unabhängig von Benutzern auf Ressourcen zugreifen, ihre Identität nachweisen. Sie sind außerdem eher sensible Apps. Sie müssen von den Azure AD-Mandantenadministratoren genehmigt werden.
• Sie haben kein Geheimnis registriert, sondern verwenden eine Kombination aus Benutzernamen und Passwort. Dieser Benutzername und das Passwort werden während des Abrufens an Azure AD übergeben, um ein Token zu erhalten.
• Der Benutzer muss ein Azure-AD-Benutzer sein und MFA darf nicht aktiviert sein.

Schritte zur Einrichtung der App

Befolge zunächst die Schritte 1 bis 6 des Flows zur Authentifizierung von Clientanmeldeinformationen wie oben aufgeführt.

Fahre dann ab hier mit Schritt 7 fort.

7. Klicke auf delegierte Berechtigungen und wähle die folgenden Berechtigungen aus der Liste aus:

- Files
    - Files.Read.All
- Sites
    - Sites.Read.All

8. Klicke anschließend auf Administratorzustimmung für ... Diese Einstellungen stellen sicher, dass im Vergleich zum normalen OAuth-Fluss keine Genehmigung durch einen bestimmten Nutzer erforderlich ist.

9. Lasse öffentliche Clientflows zu. Diese Einstellung ist erforderlich, da wir den Flow für die Authentifizierung für Benutzernamen/Kennwort verwenden werden, bei dem wir einen Token (Passwort)-Genehmigungsflow verwenden, der keinen Umleitungs-URI nutzt.

10. Lege einen neuen Benutzer an oder wähle einen bestehenden aus, der für den Authentifizierungsflow verwendet werden soll. Verwende den Benutzernamen und das Passwort, um die Vorlage für die Anmeldeinformationen auszufüllen.

Benutzername	sharepoint-user@bkprpartners.onmicrosoft.com
Passwort	2A^,.XJuCg_#z[^K

 

Diese 10 Schritte sollten die folgenden 4 Felder erfolgreich generiert haben.

Anwendungs-ID (Client-ID)	8abb5250-fccf-4608-aa4a-c563d5aa0769
Verzeichnis-ID (Mandanten-ID)	9cadc3c2-7c83-4ca8-a506-73d2ee0e2cbc
Benutzername	sharepoint-user@bkprpartners.onmicrosoft.com
Passwort	2A^,.XJuCg_#z[^K

 

SharePoint-Site-IDs abrufen

So funktioniert's

Unter Verwendung eures Office-360-Logins, der URL Deines Unternehmens und des vorgesehenen SharePoint-Seitennamens werden wir den Microsoft Graph Explorer verwenden, um die SiteID, die FolderID und die DriveItemID für eure spezifische SharePoint-Seite abzurufen. Wir werden diese Werte in die Vorlage für die Anmeldeinformationen übertragen.

 

Einrichtungsschritte

1. Um eure Basis-URL abzurufen, melde Dich zuerst bei SharePoint an und navigiere zu eurer Homepage. Eure Basis-URL ist der Teil der URL, der hervorgehoben ist.

Basis-URL

bkprpartners.sharepoint.com

 

2.) Öffne einen Webbrowser mit der URL https://developer.microsoft.com/graph/graph-explorer um den Graph Explorer zu öffnen und Dich anzumelden.

3.) Über die URL https://graph.microsoft.com/v1.0/sites/<URL>:/sites/<Site Name>?expand=drive erhältst Du die SiteID und DriveID.

Hinweis: Ändere die URL und den Namen der angeforderten Seite in der URL!

Beispiel:

https://graph.microsoft.com/v1.0/sites/beekeeperpartners.sharepoint.com:/sites/Testsite-1?expand=drive

 

SiteID	bkprpartners.sharepoint.com,a380090f-4863-460a-949b-7206f1094203,3a3e5a7f-8c14-4b89-9d92-faa64231b9dc
DriveID	b!DwmAo2NICkaUm3IG8QlCA39aPjoUjIlLnZL6pkIxudw0J_Zc6UmsTJBHbfxUAw2j

 

4. Rufe die DriveItemID mit der soeben erworbenen DriveID und dem Pfad zu dem gewünschten Ordner ab, den Du für die Integration mit Beekeeper verbinden möchtest.

Option 1 — Individueller Ordner:

 

https://graph.microsoft.com/v1.0/drives/<DriveId>/root:/<Path to folder>

Hinweis: Ändere die URL und den Namen der angeforderten Seite in der URL!

Beispiel:

https://graph.microsoft.com/v1.0/drives/b!xrH_F8VeqkmhqXgtL7YFXJM_ynj7unNEjM43g93Vjg9htGz8yO8ITp2kCiTy0AJT/root:/sharepoint-test-data/Projekt-B

 

Option 2 — Liste von Ordnern:

https://graph.microsoft.com/v1.0/drives/<DriveId>/root/children

Beispiel:

https://graph.microsoft.com/v1.0/drives/b!xrH_F8VeqkmhqXgtL7YFXJM_ynj7unNEjM43g93Vjg9htGz8yO8ITp2kCiTy0AJT/root/children

 

DriveItemID

01Q7BYIEJNQYI2B7VQPJCZYBJCMJTA4TXX

 

Diese 4 Schritte sollen die 4 unten aufgeführten Werte für die Vorlagenfelder generiert haben.

Basis-URL	bkprpartners.shaerpoint.com
SiteID	bkprpartners.sharepoint.com,a380090f-4863-460a-949b-7206f1094203,3a3e5a7f-8c14-4b89-9d92-faa64231b9dc
DriveID	b!DwmAo2NICkaUm3IG8QlCA39aPjoUjIlLnZL6pkIxudw0J_Zc6UmsTJBHbfxUAw2j
DriveItemID	01Q7BYIEJNQYI2B7VQPJCZYBJCMJTA4TXX

 

Hinweis: Die Zugriffsberechtigungen für Ordner und ihre Dokumente müssen in Beekeeper angepasst werden. Wenn Du also benutzerdefinierte Zugriffsrechte für verschiedene Ordner haben möchtest, müssen die entsprechenden Berechtigungen in der Beekeeper-Dokumentbibliothek einrichtet werden. Da Berechtigungen nur auf der höchsten Ebene in der Dokumentbibliothek festgelegt werden können und alle Unterordner diese Berechtigungen erben, musst Du die DriveItemID für jeden Ordner abrufen, den Du in Beekeeper einrichten und für den Du die Zugriffsberechtigung anpassen möchtest.

 

Damit hast Du die Einrichtung der App abgeschlossen!

Wenn Du mehr über das Einrichten von Apps von der Microsoft-Seite her erfahren möchtest, empfehlen wir die folgenden Ressourcen:

• Übersicht über die Microsoft Identity Platform
• Details zur App-Registrierung

 

Einrichten in Beekeeper

Einen Integrationsordner erstellen

Jetzt generieren wir die Beekeeper-Ordner-ID und ergänzen die Anmeldeinformationen in der Vorlage.

1. Klicke im Admin-Bereich auf Dokumentbibliothek.

2. Klicke auf Neu hinzufügen und wähle Integrationsorder erstellen.

 

3. Benenne Deinen Ordner und wähle die Standorte und Gruppen aus, die darauf Zugriff haben sollen.

4. Sobald der Integrationsordner in der Dokumentbibliothek erscheint, klicke in den Ordner. Kopiere den Wert aus der URL, der nach "documents/" steht und füge ihn der Vorlage für die Anmeldeinformationen hinzu.

 

Beekeeper-Ordner-ID

ebecfec2-cd76-45ab-9325-cda697e45f58

 

Installiere und konfiguriere die Marketplace-App

1. Gehe zum Beekeeper-Admin-Bereich und wähle die Sharepoint-Integration-Marketplace-App aus, die Du unter der Registerkarte Angefordert/Installiert finden solltest.

 

2. Nachdem die App installiert wurde, klicke auf Konfiguration. Du solltest dann ein editierbares Konfigurationsfeld sehen.

Bitte wende Dich an Deinen Customer Success Manager oder reiche eine Anfrage unten ein, wenn Du das Konfigurationsfeld nicht sehen kannst.

3. Füge im Konfigurationsfeld die Informationen ein, die Du in der Vorlage für die Anmeldeinformationen zusammengetragen hast (siehe unten):

Option 1: Flow zur Authentifizierung von Clientanmeldeinformationen

{
  "integrations": [
    {
      "url": "Füge hier die Basis-URL ein",
      "secret": "Füge hier das Geheimnis der App-Registrierung ein",
      "integrationArtifactId": "Füge hier die Beekeeper-Ordner-ID ein",
      "details": {
        "driveId": "Füge hier die DriveID ein",
        "folderId": "Füge hier die DriveItemID ein (optional)",
        "siteId": "Füge hier die SiteID ein",
        "clientId": "Füge hier die Anwendungs-ID (Client-ID) ein",
        "tenantId": "Füge hier die Verzeichnis-ID (Mandanten-ID) ein"
      },
      "integrationType": "io.beekeeper.sharepoint",
      "id": "Füge hier eine eindeutige ID ein"
    }
  ]
}

 

Verwende bitte das folgende Beispiel, um das Format der erhaltenen IDs zu überprüfen:

Beispiel für die ausgefüllte Vorlage der Anmeldeinformationen: Flow zur Authentifizierung von Clientanmeldeinformationen

Parameter	Wert
Basis-URL	bkprpartners.sharepoint.com
Anwendungs-ID (Client-ID)	8abb5250-fccf-4608-aa4a-c563d5aa0769
Verzeichnis-ID (Mandanten-ID)	9cadc3c2-7c83-4ca8-a506-73d2ee0e2cbc
Anwendungsgeheimnis	WKQ8h1MCW5z_c4JxsbfVAJ.m8~_3-P~x29
DriveID	b!DwmAo2NICkaUm3IG8QlCA39aPjoUjIlLnZL6pkIxudw0J_Zc6UmsTJBHbfxUAw2j
SiteID	bkprpartners.sharepoint.com,a380090f-4863-460a-949b-7206f1094203,3a3e5a7f-8c14-4b89-9d92-faa64231b9dc
DriveItemID	01Q7BYIEJNQYI2B7VQPJCZYBJCMJTA4TXX
Beekeeper-Ordner-ID	ebecfec2-cd76-45ab-9325-cda697e45f58

Beispiel für eine Konfigurationsabbildung:

{
  "integrations": [
    {
      "url": "bkprpartners.sharepoint.com",
      "secret": "WKQ8h1MCW5z_c4JxsbfVAJ.m8~_3-P~x29",
      "integrationArtifactId": "ebecfec2-cd76-45ab-9325-cda697e45f58",
      "details": {
        "driveId": "b!DwmAo2NICkaUm3IG8QlCA39aPjoUjIlLnZL6pkIxudw0J_Zc6UmsTJBHbfxUAw2j",
        "folderId": "01Q7BYIEJNQYI2B7VQPJCZYBJCMJTA4TXX",
        "siteId": "bkprpartners.sharepoint.com,a380090f-4863-460a-949b-7206f1094203,3a3e5a7f-8c14-4b89-9d92-faa64231b9dc",
        "clientId": "8abb5250-fccf-4608-aa4a-c563d5aa0769",
        "tenantId": "9cadc3c2-7c83-4ca8-a506-73d2ee0e2cbc"
      },
      "integrationType": "io.beekeeper.sharepoint",
      "id": "sp1"
    }
  ]
}

 

Option 2: Flow zur Authentifizierung von Benutzernamen/Kennwort

{
  "integrations": [
    {
      "url": "Füge hier die Basis-URL ein",
      "secret": "Füge eine zufällige Zeichenfolge ein",
      "integrationArtifactId": "Füge hier die Beekeeper-Ordner-ID ein",
      "details": {
        "username": "Füge hier den Benutzernamen ein",
        "driveId": "Füge hier die DriveID ein",
        "folderId": "Füge hier die DriveItemID ein (optional)",
        "siteId": "Füge hier die SiteID ein",
        "clientId": "Füge hier die Anwendungs-ID (Client-ID) ein",
        "tenantId": "Füge hier die Verzeichnis-ID (Mandanten-ID) ein",
        "password": "Füge hier das Passwort ein"
      },
      "integrationType": "io.beekeeper.sharepoint",
      "id": "Füge hier eine eindeutige ID ein"
    }
  ]
}

Verwende bitte das folgende Beispiel, um das Format der erhaltenen IDs zu überprüfen:

Beispiel für die ausgefüllte Vorlage der Anmeldeinformationen: Flow zur Authentifizierung von Benutzernamen/Kennwort

Parameter	Wert
Basis-URL	bkprpartners.sharepoint.com
Anwendungs-ID (Client-ID)	8abb5250-fccf-4608-aa4a-c563d5aa0769
Verzeichnis-ID (Mandanten-ID)	9cadc3c2-7c83-4ca8-a506-73d2ee0e2cbc
Benutzername	sharepoint-user@bkprpartners.onmicrosoft.com
Passwort	2A^,.XJuCg_#z[^K
DriveID	b!DwmAo2NICkaUm3IG8QlCA39aPjoUjIlLnZL6pkIxudw0J_Zc6UmsTJBHbfxUAw2j
SiteID	bkprpartners.sharepoint.com,a380090f-4863-460a-949b-7206f1094203,3a3e5a7f-8c14-4b89-9d92-faa64231b9dc
DriveItemID	01Q7BYIEJNQYI2B7VQPJCZYBJCMJTA4TXX
Beekeeper-Ordner-ID	ebecfec2-cd76-45ab-9325-cda697e45f58

{
  "integrations": [
    {
      "url": "bkprpartners.sharepoint.com",
      "secret": "ignored",
      "integrationArtifactId": "ebecfec2-cd76-45ab-9325-cda697e45f58",
      "details": {
        "username": "sharepoint-user@bkprpartners.onmicrosoft.com",
        "driveId": "b!DwmAo2NICkaUm3IG8QlCA39aPjoUjIlLnZL6pkIxudw0J_Zc6UmsTJBHbfxUAw2j",
        "folderId": "01Q7BYIEJNQYI2B7VQPJCZYBJCMJTA4TXX",
        "siteId": "bkprpartners.sharepoint.com,a380090f-4863-460a-949b-7206f1094203,3a3e5a7f-8c14-4b89-9d92-faa64231b9dc",
        "clientId": "8abb5250-fccf-4608-aa4a-c563d5aa0769",
        "tenantId": "9cadc3c2-7c83-4ca8-a506-73d2ee0e2cbc",
        "password": "2A^,.XJuCg_#z[^K"
      },
      "integrationType": "io.beekeeper.sharepoint",
      "id": "sp1"
    }
  ]
}

{
  "integrations": [
    {
      "url": "bkprpartners.sharepoint.com",
      "integrationArtifactId": "dd63c1f8-6a8c-4044-87bf-ae1640d2e526",
      "secret": "0Hj.Pf4ZAQ.hUy5ymrAtAlnj-xe._VOAb1",
      "details": {
        "driveId": "b!DwmAo2NICkaUm3IG8QlCA39aPjoUjIlLnZL6pkIxudw0J_Zc6UmsTJBHbfxUAw2j",
        "folderId": "01Q7BYIEJNQYI2B7VQPJCZYBJCMJTA4TXX",
        "siteId": "bkprpartners.sharepoint.com,a380090f-4863-460a-949b-7206f1094203,3a3e5a7f-8c14-4b89-9d92-faa64231b9dc",
        "clientId": "fc775b55-b9c9-44a7-9911-f3d5f47110e3",
        "tenantId": "9cadc3c2-7c83-4ca8-a506-73d2ee0e2cbc"
      },
      "integrationType": "io.beekeeper.sharepoint",
      "id": "sp1"
    },
    {
      "url": "bkprpartners.sharepoint.com",
      "integrationArtifactId": "eine andere als oben",
      "secret": "0Hj.Pf4ZAQ.hUy5ymrAtAlnj-xe._VOAb1",
      "details": {
        "driveId": "b!DwmAo2NICkaUm3IG8QlCA39aPjoUjIlLnZL6pkIxudw0J_Zc6UmsTJBHbfxUAw2j",
        "folderId": "different than above",
        "siteId": "bkprpartners.sharepoint.com,a380090f-4863-460a-949b-7206f1094203,3a3e5a7f-8c14-4b89-9d92-faa64231b9dc",
        "clientId": "fc775b55-b9c9-44a7-9911-f3d5f47110e3",
        "tenantId": "9cadc3c2-7c83-4ca8-a506-73d2ee0e2cbc"
      },
      "integrationType": "io.beekeeper.sharepoint",
      "id": "eine andere als oben"
    }
  ]
}