Externe Connectors für Anreicherungsaufgaben konfigurieren

Mit Drittanbieter-Authentifizierungsanbietern können Sie Knowledge Studio-Anreicherungsaufgaben sicher mit externen Plattformen wie GitHub, Microsoft SharePoint und Atlassian Confluence verbinden. Führen Sie die Schritte zur Generierung von Anmeldedaten und zur Konfiguration des Authentifizierungsanbieters in diesem Dokument als Teil der erforderlichen Einrichtung aus.

Hinweis

Bevor Sie externe Connectors konfigurieren, müssen die folgenden Voraussetzungen erfüllt sein:

  • Sehen Sie sich den gesamten Workflow zur Konfiguration der Anreicherung unter Voraussetzungen für Anreicherungsaufgaben konfigurieren an.
  • Achten Sie darauf, dass Sie auf den Zielplattformen von Drittanbietern (GitHub, Microsoft SharePoint oder Atlassian Confluence) die erforderlichen Administrator- oder Entwicklerberechtigungen haben, um Zugriffstokens zu generieren oder Anwendungen zu registrieren.
  • Wenn Sie Anmeldedaten sicher speichern und an Aufgaben anhängen möchten, müssen Sie den Agent Identity-Dienst richtig konfigurieren. Weitere Informationen finden Sie unter IAM-Berechtigungen für Authentifizierungsanbieter einrichten.

Wenn Sie den Anreicherungs-Agent mit Wissensquellen von Drittanbietern verbinden, müssen Sie den Google Cloud Agent Identity-Dienst verwenden. Agent Identity fungiert als Authentifizierungsmanager, der Ihre Drittanbieter-Anmeldedaten sicher speichert und dem Anreicherungs-Agenten kurzlebige Zugriffstokens bereitstellt. So müssen menschliche Operatoren während der Aufgabenausführung nie direkt mit Roh-Clientschlüsseln arbeiten.

GitHub konfigurieren

Wenn Sie Knowledge Studio mit GitHub-Repositories verbinden möchten, müssen Sie in GitHub ein detailliertes persönliches Zugriffstoken (Personal Access Token, PAT) erstellen und in einem API-Schlüssel-Authentifizierungsanbieter speichern.

  1. Melden Sie sich bei GitHub an, klicken Sie auf Ihr Profilbild und dann auf Settings (Einstellungen).
  2. Gehen Sie zu Entwicklereinstellungen > Persönliche Zugriffstokens > Feingranulare Tokens.
  3. Klicken Sie auf Neues Token erstellen.
  4. Konfigurieren Sie die Tokenattribute:
    • Tokenname: Geben Sie einen aussagekräftigen Namen ein, z. B. enrichment-agent.
    • Ablaufdatum: Legen Sie ein geeignetes Ablaufdatum fest.
    • Ressourceninhaber: Wählen Sie die Organisation oder das Nutzerkonto aus, die bzw. das Inhaber der Ziel-Repositories ist.
    • Repository-Zugriff: Wählen Sie Nur ausgewählte Repositories und dann die Repositories aus, die Sie anreichern möchten.
    • Berechtigungen: Gewähren Sie bestimmten Lesezugriff oder Lese- und Schreibzugriff für die erforderlichen Bereiche (z. B. Probleme, Pull-Anfragen und Inhalte).
  5. Klicken Sie auf Generate token (Token generieren) und kopieren Sie das Token an einen sicheren Ort.
  6. Registrieren Sie einen API-Schlüssel-Authentifizierungsanbieter in Google Cloud und geben Sie das PAT als API-Schlüssel an. Siehe Mit einem API-Schlüssel mit Auth Manager authentifizieren.

Weitere Informationen zum Erstellen eines PAT finden Sie in der GitHub-Dokumentation unter Persönliche Zugriffstokens verwalten.

Microsoft SharePoint konfigurieren

Wenn Sie eine Verbindung zu Microsoft SharePoint herstellen, rufen Sie OAuth-Anmeldedaten von Microsoft Entra ID (früher Azure Active Directory) über einen zweibeinigen OAuth-Flow ab.

  1. Registrieren Sie eine neue Anwendung im Microsoft Entra Admin Center.
  2. Gewähren Sie Microsoft Graph API-Berechtigungen:
    1. Gehen Sie zu API-Berechtigungen > Berechtigung hinzufügen > Microsoft Graph > Anwendungsberechtigungen (wählen Sie nicht „Delegierte Berechtigungen“ aus).
    2. Fügen Sie die Bereiche Sites.Read.All und Files.Read.All hinzu.
    3. Klicken Sie für Ihren Mandanten auf Administratoreinwilligung erteilen, damit beide Anwendungsberechtigungen als „Gewährt“ angezeigt werden.

  3. Erstellen Sie einen neuen Clientschlüssel. Notieren Sie sich den Wert sofort, da er nur einmal angezeigt wird. Weitere Informationen finden Sie unter Neuen Clientschlüssel erstellen.

  4. Kopieren Sie die Konfigurationswerte Ihrer Anwendung. Erfassen Sie nach der Registrierung die folgenden Werte für die Konfiguration Ihres Authentifizierungsanbieters:

    • Client-ID: Die Anwendungs-ID (Client-ID) aus der App-Übersicht.
    • Token-URL: Klicken Sie auf der Seite Übersicht auf den Tab Endpunkte. Kopieren Sie die URL mit der Bezeichnung OAuth 2.0-Token-Endpunkt (Version 2).

  5. Registrieren Sie einen 2-beinigen OAuth-Authentifizierungsanbieter in Google Cloud mit diesen Secrets. Geben Sie beim Erstellen des Anbieters den Standardbereich für den Parameter --allowed-scopes an:

    --allowed-scopes="https://graph.microsoft.com/.default"

    Weitere Informationen finden Sie in der Microsoft Entra-Dokumentation unter Anwendung bei der Microsoft Identity Platform registrieren.

Atlassian Confluence konfigurieren

Da Confluence kein 2-Legged OAuth für Server-zu-Server-Agents unterstützt, müssen Sie in Atlassian ein dediziertes Dienstkonto (oder Dummy-Nutzerkonto) erstellen, ihm die erforderlichen Berechtigungen erteilen und ein PAT generieren.

  1. Melden Sie sich in Confluence mit dem spezifischen Dienstkonto an.
  2. Klicken Sie oben rechts auf Ihr Profilbild.
  3. Wählen Sie im Menü Einstellungen (oder Kontoeinstellungen) aus.
  4. Gehen Sie auf dem Tab „Sicherheit“ zum Bereich „API-Tokens“.
  5. Klicken Sie auf den Button API-Token mit Bereichen erstellen. Verwenden Sie kein Token ohne Bereich, da sonst nicht alle erforderlichen Tools abgerufen werden.
  6. Geben Sie einen aussagekräftigen Namen ein (z. B. enrichment-agent), konfigurieren Sie das Ablaufdatum und klicken Sie auf Weiter.
  7. Wählen Sie in der Liste App auswählen die Option Atlassian MCP aus und klicken Sie auf Weiter.
  8. Wählen Sie alle folgenden Confluence-Lese- und Suchbereiche aus:
    • read:page:confluence
    • read:space:confluence
    • search:confluence
    • read:confluence-content.all
    • read:confluence-content.summary
    • read:confluence-space.summary
    • search:rovo:mcp
    • read:jira-work
  9. Klicken Sie auf Weiter und dann auf Erstellen.
  10. Kopieren Sie das generierte Token.
  11. Formatieren Sie den String mit den Anmeldedaten für den Authentifizierungsanbieter Google Cloud als<ATLASSIAN_EMAIL>:<API_TOKEN>. Atlassian erfordert die HTTP-Basisauthentifizierungscodierung (email:api_token), um die persönlichen API-Tokens programmatisch zu verwenden.
  12. Registrieren Sie einen API-Schlüssel-Authentifizierungsanbieter in Google Cloud und geben Sie den String<ATLASSIAN_EMAIL>:<API_TOKEN> als API-Schlüssel an. Weitere Informationen finden Sie unter Mit einem API-Schlüssel mit Auth Manager authentifizieren.

Weitere Informationen zum Erstellen eines PAT finden Sie in der Atlassian-Dokumentation unter API-Tokens für Ihr Atlassian-Konto verwalten.

Nächste Schritte