SharePoint-Websites-Wissenskonnektor

Einführung

Verbinden Sie SharePoint-Websites, Webseiten und Newsbeiträge, damit deren Inhalte in Docebo als abrufbares Wissen verfügbar werden.

Dieser Konnektor synchronisiert Inhalte von Websites und Webseiten sowie auf ausgewählten SharePoint-Websites gespeicherte Newsbeiträge mit Docebo Knowledge, sodass diese Inhalte durchsuchbar sind und von KI-Assistenten und Agenten verwendet werden können. Er umfasst ausschließlich Webseiten, Listen oder andere Website-Inhalte. Für SharePoint-Dateien gibt es einen eigenen Konnektor.

1. Grundlegende Informationen

Welche Inhalte synchronisiert werden

Welche Inhalte extrahiert werden

2. Voraussetzungen im Quellsystem

Erforderliche Rolle

Sie benötigen eine der folgenden Microsoft-Entra-ID-(Azure-AD-)Rollen, um die Einrichtung abzuschließen:

• Globaler Administrator oder
• Anwendungsadministrator oder Cloudanwendungsadministrator in Kombination mit einer Rolle, die die Erteilung der Administratoreinwilligung ermöglicht (z. B. Administrator für privilegierte Rollen)

Außerdem benötigen Sie auf jeder Website, die Sie synchronisieren möchten, Zugriff als Websitebesitzer oder SharePoint-Administrator.

Erforderliche Einstellungen

Bedingte Zugriffsrichtlinien dürfen den Dienstprinzipal der App nicht daran hindern, Microsoft Graph zu erreichen.

3. Vorbereitung im Quellsystem

App-Registrierung erstellen

Melden Sie sich beim Azure-Portal an und gehen Sie zu Microsoft Entra ID → App-Registrierungen → Neue Registrierung. Benennen Sie die App (z. B. „Docebo Knowledge connector“), belassen Sie Unterstützte Kontotypen auf einem einzigen Mandanten, und legen Sie jetzt den Umleitungs-URI fest — wählen Sie Web aus und geben Sie die Callback-URL ein. Wenn Sie dies bereits bei der Registrierung erledigen, sparen Sie später einen Schritt. Die URL folgt immer diesem Muster: https://[YOUR-DOCEBO-PLATFORM-URL]/knowledge/v1/integrations/connections/callback — zum Beispiel https://demo.docebosaas.com/knowledge/v1/integrations/connections/callback. Wählen Sie Registrieren aus.

Registrieren einer Anwendung mit bereits eingetragener Umleitungs-URI.

API-Berechtigungen zuweisen

Öffnen Sie die App → API-Berechtigungen → Berechtigung hinzufügen und fügen Sie die unten aufgeführten Berechtigungen sowohl aus Microsoft Graph als auch aus SharePoint hinzu. Sobald alle hinzugefügt wurden, wählen Sie Administratoreinwilligung erteilen aus, um sie gesammelt zu genehmigen.

Microsoft Graph

SharePoint

Clientgeheimnis hinzufügen

Gehen Sie zu Zertifikate & Geheimnisse → Neues Clientgeheimnis. Geben Sie eine Beschreibung und ein Ablaufdatum ein und wählen Sie anschließend Hinzufügen aus. Kopieren Sie nach der Erstellung den in der Spalte Wert angezeigten Wert — nicht den Wert aus der Spalte Geheimnis-ID, die ähnlich aussieht, aber für die Authentifizierung nicht funktioniert. Sobald Sie diese Seite verlassen, können Sie den Wert nicht erneut anzeigen.

Clientgeheimnisse laufen nach dem hier festgelegten Zeitplan ab. Wenn ein Geheimnis abläuft und nicht vorher ersetzt wird, funktioniert die SharePoint-Verbindung nicht mehr — richten Sie vor dem Ablaufdatum eine Erinnerung ein.

Hinzufügen eines Clientgeheimnisses mit festgelegter Beschreibung und Ablaufdatum.

Zertifikat hinzufügen

Für den direkten Zugriff auf die SharePoint-API benötigen Sie zusätzlich zum Geheimnis ein Zertifikat.

Wir empfehlen, die integrierte Funktion zu verwenden, damit das Zertifikat und der private Schlüssel für Sie erstellt werden. Klicken Sie dazu auf die Schaltfläche Zertifikat generieren.

Dadurch wird sharepoint-cert.pem (das Zertifikat) erstellt und die Felder Zertifikatfingerabdruck und Privater Schlüssel werden automatisch ausgefüllt. Sie müssen das Zertifikat lediglich unter Zertifikate & Geheimnisse → Zertifikate → Zertifikat hochladen zu Ihrer App-Registrierung hinzufügen und sharepoint-cert.pem hochladen.

Registerkarte Zertifikate mit dem hochgeladenen Zertifikat und seinem Fingerabdruck.

Alternativ können Sie mit OpenSSL ein selbstsigniertes Zertifikat und einen privaten Schlüssel generieren:

openssl req -x509 -newkey rsa:2048 -keyout sharepoint-key.pem -out sharepoint-cert.pem -days 180 -nodes -subj "/CN=my-custom-cn"

cat sharepoint-key.pem | pbcopy

Dadurch werden ebenfalls der private Schlüssel und das Zertifikat generiert. Sie müssen jedoch anschließend den privaten Schlüssel manuell in das Feld kopieren und den Fingerabdruck kopieren, nachdem Sie das Zertifikat zu Ihrer App-Registrierung hochgeladen haben, um ihn ebenfalls in das entsprechende Feld einzutragen.

4. Erforderliche Aktionen in Docebo

Konnektor autorisieren

1. Gehen Sie zu Add-ons und Integrationen → Wissenskonnektoren → Erstellen → SharePoint – Websites. Dieses Menü ist nur für Superadmins sichtbar.
2. Geben Sie die Verzeichnis-ID (Mandanten-ID) und Ihre SharePoint-Website-URL ein — ohne das Präfix https:// oder einen abschließenden Schrägstrich.
3. Geben Sie die Client-ID, das Clientgeheimnis, den Fingerabdruck des Zertifikats und den privaten Schlüssel aus Ihrer Azure-App ein und wählen Sie anschließend Verbinden aus.
4. Erteilen Sie im Microsoft-Popup die Einwilligung.
5. Wählen Sie auf dem Bereichsbildschirm aus, welche Websites Sie später zum Hinzufügen zu Wissenssammlungen verfügbar machen möchten, und speichern Sie Ihre Auswahl.