Um den KI-Assistenten von Haiilo Inhalte von deinen Microsoft SharePoint-Seiten nutzen zu lassen, solltest du eine App-Registrierung bei Microsoft einrichten und die Zugangsdaten in Haiilo hinzufügen.

Wenn Microsoft mit dem KI-Assistenten verbunden ist, können deine Nutzer Antworten aus unterstützten textbasierten Dateien erhalten (z. B. PDFs, Word-Dokumente, PowerPoint-Präsentationen und Textdateien). Standardmäßig werden alle Dokumente in SharePoint berücksichtigt, aber du kannst die Indexierung optional auf bestimmte SharePoint-Seiten in der Konfiguration beschränken. Nutzer haben nur Zugriff auf die Informationen, für die sie bei Microsoft die Berechtigung haben.

Du kannst nicht dieselbe App-Registrierung verwenden, die du für Authentifizierung, Benutzerdirektories und M365-Add-on-Funktionen nutzt. Du musst eine neue erstellen.

App-Registrierung bei Microsoft einrichten

Du brauchst Admin-Rechte in deinem Microsoft Entra ID-Konto, um diese Schritte abzuschließen.

App erstellen

1. Melde dich bei der Microsoft Azure Plattform an.
2. Gehe zu Microsoft Entra ID > App-Registrierungen > Neue Registrierung.
3. Gib deiner App einen Namen, z. B. Haiilo KI-Assistent Sync.
4. Wähle bei Unterstützte Kontotypen Einzelmandant aus.
5. Klicke auf Registrieren.
6. Kopiere und speichere auf der App-Übersichtsseite die Anwendungs-(Client-)ID und die Verzeichnis-(Mandanten-)ID für die spätere Verwendung.

API-Berechtigungen festlegen

1. Gehe zu API-Berechtigungen.
2. Wähle Berechtigung hinzufügen > Microsoft Graph > Anwendungsberechtigungen.
3. Füge folgende API-Berechtigungen hinzu:
   • Directory.Read.All
   • Sites.Read.All
4. Dann wähle Berechtigung hinzufügen > Microsoft SharePoint > Anwendungsberechtigungen.
5. Füge die folgende API-Berechtigung hinzu:
   • Sites.Read.All
   • Alternativ, wenn dein Zugriff über SharePoint-Gruppen verwaltet wird, füge stattdessen die Berechtigung Sites.FullControl.All hinzu.
6. Wähle Admin-Zustimmung für app_name erteilen für die hinzugefügten Berechtigungen und stelle sicher, dass der Status für alle Berechtigungen als Erteilt für deinen_Mandanten markiert ist.

Zertifikat erstellen (OpenSSL)

Du musst ein Zertifikat erstellen, das Microsoft zur Überprüfung der App-Registrierung verwenden kann. Das öffentliche Zertifikat (.crt) wird bei Microsoft Entra ID hochgeladen, während die kombinierte Zertifikatdatei (.pem) in der Haiilo-Konfiguration hinzugefügt wird.

1. Bevor du beginnst: Installiere OpenSSL, falls es auf deinem System noch nicht verfügbar ist. Öffne dann ein Kommandozeilen-Tool, wie PowerShell unter Windows oder Terminal auf macOS.
2. Führe die folgenden Befehle aus, um die für die Microsoft-Integration benötigten Zertifikatdateien zu erstellen. Die Dateinamen, der Zertifikatsname und die Gültigkeitsdauer in den Beispielen unten kannst du an deine Anforderungen anpassen.
   1. Erstelle einen privaten Schlüssel: openssl genrsa -out azure-app.key 2048. Dadurch wird eine 2048-Bit private Schlüsseldatei mit dem Namen azure-app.key erstellt.
   2. Erstelle ein selbstsigniertes öffentliches Zertifikat: openssl req -new -x509 -key azure-app.key -out azure-app.crt -days 365 -subj "/CN=HaiiloAzureAppCert". Dadurch wird eine Zertifikatdatei mit dem Namen azure-app.crt erstellt, die 365 Tage gültig ist.
   3. Kombiniere den privaten Schlüssel und das Zertifikat in einer PEM-Datei: cat azure-app.key azure-app.crt > azure-app.pem. Dadurch wird eine Datei mit dem Namen azure-app.pem erstellt, die sowohl den privaten Schlüssel als auch das Zertifikat enthält und bei der Konfiguration der Microsoft-Integration in Haiilo verwendet wird.
3. Gehe dann in deiner Microsoft-App-Registrierung zu Zertifikate & Geheimnisse.
4. Wähle Zertifikat hochladen und wähle die erstellte .crt-Datei aus. Optional kannst du eine Beschreibung hinzufügen.
5. Wähle Hinzufügen.

Nachdem du diese Schritte abgeschlossen hast, bewahre die .pem-Datei auf. Du wirst sie im nächsten Schritt brauchen.

Den Inhaltstyp in Haiilo konfigurieren

Du benötigst die Berechtigung „Manage AVA“, um diese Einstellungen vorzunehmen.

1. Gehe in Haiilo zu Administration > AVA > Assistent.

2. Schalte Microsoft-Integration aktivieren ein.

3. Gib die Verzeichnis-(Mandanten-)ID ein, die du aus Microsoft Entra ID kopiert hast, in das Feld Mandanten-ID ein.
4. Gib die Anwendungs-(Client-)ID ein, die du aus Microsoft Entra ID kopiert hast, in das Feld Client-ID ein.
5. Gib den Zertifikatswert aus der erstellten .pem-Datei in das Feld Zertifikat (PEM) ein.
6. Optional: Beschränke die Indizierung auf bestimmte SharePoint-Seiten. Wenn du das Feld leer lässt, werden alle Seiten indiziert.
7. Wähle Änderungen speichern, um die Einstellungen zu übernehmen.