GitHub-Datenspeicher einrichten

Auf dieser Seite wird beschrieben, wie Sie einen Datenspeicher erstellen und GitHub mit Gemini Enterprise verbinden.

Hinweis

Bevor Sie die GitHub-Verbindung einrichten, benötigen Sie Folgendes:

  • Weisen Sie dem Nutzer die Rolle „Discovery Engine Editor“ (roles/discoveryengine.editor) zu. Diese Rolle ist erforderlich, damit der Nutzer den Datenspeicher erstellen kann. So weisen Sie diese Rolle zu:

    1. Rufen Sie in der Google Cloud Console die Seite IAM auf.

      IAM aufrufen

    2. Suchen Sie das Nutzerkonto und klicken Sie auf Bearbeiten Bearbeiten.
    3. Weisen Sie dem Nutzer die Rolle Discovery Engine Editor zu: Weitere Informationen finden Sie unter IAM-Rollen und -Berechtigungen.

  • Melden Sie sich in Ihrem GitHub-Konto an und rufen Sie die Authentifizierungsdaten ab.

  • Erstellen Sie eine GitHub-Anwendung, um diesen Connector zu verwenden. Weitere Informationen finden Sie unter GitHub-Anwendungen erstellen.

GitHub-Datenspeicher erstellen

So erstellen Sie einen GitHub-Datenspeicher:

  1. Rufen Sie in der Google Cloud Console die Seite Gemini Enterprise auf.

    Gemini Enterprise

  2. Projekt auswählen oder erstellen Google Cloud .

  3. Klicken Sie im Navigationsmenü auf Datenspeicher.

  4. Klicken Sie auf Datenspeicher erstellen.

  5. Suchen Sie im Abschnitt Quelle nach GitHub und wählen Sie es aus.

  6. Im Bereich Daten > Authentifizierungseinstellungen:

    1. Geben Sie die Details zu den Clientanmeldedaten ein:

      • Client-ID: Die OAuth-Client-ID für Ihre Anwendung.
      • Clientschlüssel: Der OAuth-Clientschlüssel für Ihre Anwendung.

      Weitere Informationen zu Anmeldedaten finden Sie unter GitHub-Konfiguration.

    2. Wenn sich Ihre Nutzer über einen Identitätsanbieter (IdP) anmelden, z. B. mit GitHub Enterprise Managed Users (EMU), geben Sie die GitHub-SSO-Anmeldedaten ein. Andernfalls lassen Sie diese Felder leer.

      • GitHub-SSO-Bereich: Der GitHub-Namespace, der die Anmeldung steuert. Wenn Ihr IdP auf Unternehmensebene konfiguriert ist, wählen Sie Unternehmen aus. Wenn Ihr IdP auf Organisationsebene konfiguriert ist, wählen Sie orgs aus.

      • GitHub-SSO-Slug: Der Slug Ihres GitHub-Unternehmens oder Ihrer GitHub-Organisation, z. B. octocorp für die Unternehmens-URL https://github.com/enterprises/octocorp. Geben Sie nur den Slug ein, nicht die vollständige URL.

    3. Klicken Sie auf Authentifizieren und schließen Sie die Überprüfung der GitHub-Autorisierung ab.

  7. Im Abschnitt Daten> Erweiterte Optionen:

    1. Geben Sie den Namen Ihrer GitHub-Organisation in das Feld Organization Name ein. Dies ist erforderlich, um den Umfang von Suchanfragen und Aktionen festzulegen.

    2. Klicken Sie auf Weiter.

  8. Im Bereich Daten > Zu suchende Entitäten:

    1. Wählen Sie die erforderlichen Entitäten aus.

    2. Klicken Sie auf Weiter.

  9. Im Abschnitt Aktionen:

    1. Wählen Sie unter GitHub-Aktionen auswählen, die aktiviert werden sollen die entsprechenden Aktionen aus der Kategorie aus, um sie für den Datenspeicher zu aktivieren.

      Informationen zum Verwalten der Liste der Aktionen finden Sie unter Aktionen verwalten.

    2. Klicken Sie auf Weiter.

  10. Wenn im Ablauf zum Erstellen eines Datenspeichers der Abschnitt Erweiterte Optionen angezeigt wird, können Sie darin das Kästchen Statische IP-Adressen aktivieren auswählen. So wird sichergestellt, dass der Datenspeicher für ausgehenden Traffic einen festen Satz von IP-Adressen verwendet, die auf dem Quellsystem auf die Zulassungsliste gesetzt werden können. Weitere Informationen finden Sie unter Ausgehenden Traffic mit statischer IP-Adresse konfigurieren.

  11. Im Abschnitt Konfiguration:

    1. Wählen Sie in der Liste Multiregional den Speicherort für den Daten-Connector aus.
    2. Geben Sie im Feld Name des Daten-Connectors einen Namen für den Connector ein.
    3. Wenn Sie us oder eu als Speicherort gewählt haben, konfigurieren Sie die Verschlüsselungseinstellungen:
      • Optional: Wenn Sie keine Schlüssel für einzelne Regionen konfiguriert haben, klicken Sie auf Zur Einstellungsseite, um dies zu tun. Weitere Informationen finden Sie unter Einen Schlüssel für eine einzelne Region für Drittanbieter-Connectors registrieren.
      • Wählen Sie Googleverwalteter Verschlüsselungsschlüssel oder Cloud KMS-Schlüssel aus.
      • Falls Sie Cloud KMS-Schlüssel ausgewählt haben:
        • Wählen Sie in der Liste Schlüsselverwaltungstyp den entsprechenden Typ aus.
        • Wählen Sie in der Liste Cloud KMS-Schlüssel den Schlüssel aus.
      Weitere Informationen finden Sie unter Kundenverwaltete Verschlüsselungsschlüssel.

  12. Klicken Sie auf Weiter.

  13. Wählen Sie im Bereich Abrechnung die Option Allgemeine Preise oder die Option Konfigurierbare Preise aus. Weitere Informationen finden Sie unter Abrechnungsstatus Ihrer Projekte prüfen und Lizenzen.

  14. Klicken Sie auf Erstellen. Gemini Enterprise erstellt den Datenspeicher und zeigt ihn auf der Seite Datenspeicher an.

Klicken Sie auf der Seite Datenspeicher auf den Namen des Datenspeichers, um den Status anzuzeigen. Sobald sich der Status des Datenspeichers von Wird erstellt zu Aktiv ändert, ist der GitHub-Connector einsatzbereit.

Datenverarbeitung und Abfrageausführung

In diesem Abschnitt wird beschrieben, wie Gemini Enterprise Ihre Abfrage verarbeitet und welche Auswirkungen die Verwendung des föderierten Datenspeichers auf den Datenschutz hat.

Ausführung von Abfragen

Nachdem Sie GitHub autorisiert und eine Suchanfrage an Gemini Enterprise gesendet haben, passiert Folgendes:

  • Gemini Enterprise sendet Ihre Suchanfrage direkt an die GitHub API.
  • Gemini Enterprise kombiniert die Ergebnisse mit denen aus anderen verbundenen Datenquellen und zeigt ein umfassendes Suchergebnis an.

Datenverarbeitung

Wenn Sie eine föderierte Suche von Drittanbietern verwenden, gelten folgende Regeln für die Datenverarbeitung:

  • Ihr Abfragestring wird an das Such-Backend des Drittanbieters (GitHub API) gesendet.
  • Diese Drittanbieter können Abfragen mit Ihrer Identität verknüpfen.
  • Wenn mehrere Datenquellen für die föderierte Suche aktiviert sind, wird die Abfrage möglicherweise an alle gesendet.
  • Sobald die Daten im Drittanbietersystem angekommen sind, unterliegen sie den Nutzungsbedingungen und Datenschutzbestimmungen dieses Systems.

Nächste Schritte