🗃️Connect Sharepoint

Einrichtung von SharePoint-Ordnern als Datenbank mithilfe von Azure Active Directory-Anwendungen. Die Einrichtung von Berechtigungen & die Verwendung der Microsoft Graph API werden beschrieben.

1. Registrieren Sie die "Sites Admin" App

1.1 Erstellen Sie eine neue Sites-Admin-App.

• Gehen Sie zur Übersichtsseite und notieren Sie sich die Client-ID (Anwendungs-ID) und die Tenant-ID (Verzeichnis-ID). Speichern Sie diese Informationen in einer Textdatei.

1.2 Graph API Zugriff gewähren

• In der Sites-Admin-App-Registrierung gewähren Sie Graph API-Berechtigungen für Application.Read.All und Sites.FullControl.All.

• Stellen Sie sicher, dass Sie die Administratorzustimmung für diese Berechtigungen erteilen.

1.3 Client Secret Key kreieren

• Navigieren Sie zur Seite "Zertifikate & Secrets", um Client Secrets zu erstellen.

• Kopieren Sie den geheimen Schlüsselwert in die Textdatei, die die Client-ID und die Tenant-ID enthält. Ihre Textdatei sollte Folgendes enthalten:

Client Id: 4dbceba4-*******-960918801231
Client Secret: JPz******************
Directory (tenant) ID: cef6ac5c-7bc6-*****-fdf05232c2f4

2. Registrieren Sie den Client für die Verbindung mit SharePoint

• Folgen Sie den oben genannten Schritten, erstellen Sie jedoch nur Zertifikate & Secrets mit der Berechtigung Sites.Selected.

• Kopieren Sie den geheimen Schlüsselwert in die Textdatei, die die Client-ID und die Tenant-ID enthält. Ihre Textdatei sollte Folgendes enthalten:

Client Id: 1ad09322-6c74-*****-8d736a2d9e92
Client Secret: Npn******************
Directory (tenant) ID: cef6ac5c-7bc6-*****-fdf05232c2f4

3. Verwenden Sie den Graph API-Endpunkt, um Berechtigungen für eine spezifische SharePoint Online-Site zuzuweisen.

Beziehen Sie sich auf Graph API Dokumentation.

• Verwenden Sie die Client-ID, das Client Secret und die Tenant-ID der Site-Admin-App, um der Zielanwendung Berechtigungen für eine spezifische SharePoint Online-Site zuzuweisen.

Schritte zur Nutzung von Graph API:

Schritt 1: Token von Microsoft Graph API bekommen

• Verwenden Sie Postman um die API aufzurufen.

Schritt 2: Holen Sie sich die Site-ID für die Zielanwendung.

• Beispiel: Um sich mit der Website "Site Data Local Test" zu verbinden, erhalten Sie die Site-ID:trustsoftjsc.sharepoint.com,de3c6e23-0395-4050-8157-46a1b5b1482e,3ec5a27e-56a1-4d99-b9d1-87a27b6335e3.

Schritt 3: Weisen Sie Berechtigungen der Zielanwendung zu.

• Machen Sie eine POST-Anfrage an den folgenden Endpunkt:

POST https://graph.microsoft.com/v1.0/sites/{siteId}/permissions
Content-Type: application/json

{
  "roles": ["read"],
  "grantedToIdentities": [
    {
      "application": {
        "id": "clientId",  // Target Application’s Client ID
        "displayName": "Site Data Local Test"  // Target Application’s Display Name
      }
    }
  ]
}

Schritt 4: Überprüfen Sie erneut die Berechtigungen für die Site.

• Überprüfen Sie die den Site zugewiesenen Berechtigungen.

Letzter Schritt:

Geben Sie die Client-ID, das Client Secret Key und die Tenant-ID der Zielanwendung sowie eine Liste der ausgewählten Sites an, die mit der Knowledge Bots-Plattform verbunden werden sollen.