Freigeben über

Bitbucket Pull Request Microsoft 365 Copilot Connector (Vorschau)

Der Bitbucket Pull Request Microsoft 365 Copilot Connector ermöglicht es Ihrem organization, Pull Requests und Dokumentation (.txt- und MD-Dateien) in Bitbucket zu indizieren. Nachdem Sie den Connector konfiguriert und Bitbucket-Inhalte indiziert haben, können Benutzer Informationen über Microsoft Search und Microsoft 365 Copilot suchen und abrufen.

Dieser Artikel richtet sich an Microsoft 365-Administratoren oder alle Personen, die den Bitbucket Copilot-Connector konfigurieren, ausführen oder überwachen.

Funktionen

  • Index Bitbucket-Repositorys, Pull Requests und Dokumentation.
  • Aktivieren Sie Microsoft Search und Microsoft 365 Copilot, um Bitbucket-Daten effizient abzurufen.
  • Verwalten von Bitbucket-ACLs und Benutzerberechtigungen.
  • Ermöglichen Sie Administratoren das Anpassen der Durchforstungshäufigkeit und der Indizierungseinstellungen.

Begrenzungen

  • Der Connector unterstützt die Indizierung von Bitbucket-CI/CD-Pipelines über status Indizierung hinaus nicht.
  • Es werden nur Repositorys, Pull Requests, MD- und .txt-Dateien indiziert.
  • Lokale/selbstgehostete Bitbucket-Instanzen werden derzeit nicht unterstützt.
  • Der Connector lässt das Feld LastModifiedBy möglicherweise leer, wenn Git-Änderungen keinem Bitbucket-Konto zugeordnet sind. Dies tritt auf, wenn eine manuelle Konfiguration, die Git-Änderungen mit Bitbucket-Benutzerkonten verknüpft, nicht vor einer inkrementellen Durchforstung abgeschlossen wird.

Voraussetzungen

  1. Auf Ihre Bitbucket-instance kann über die API zugegriffen werden.
  2. Das für die Authentifizierung verwendete Benutzerkonto hat Zugriff auf die Repositorys, Pull Requests und Wissensdateien, die indiziert werden sollen.
  3. Benutzer, die auf indizierte Bitbucket-Daten zugreifen, verfügen über entsprechende Microsoft Entra ID Identitäten für die Berechtigungszuordnung.
  4. Einrichten eines OAuth-Consumers in Bitbucket
    1. Wechseln Sie auf Bitbucket zur Seite Ihres Arbeitsbereichs.
    2. Klicken Sie in der oberen rechten Ecke auf das Zahnradsymbol, und wählen Sie Arbeitsbereichseinstellungen aus.
    3. Wählen Sie im linken Navigationsbereich OAuth-Consumer im Abschnitt Workflows aus.
    4. Klicken Sie auf Consumer hinzufügen , und füllen Sie die folgenden Umleitungs-URLs aus:
    • Verwenden Sie für Microsoft 365 Enterprisehttps://gcs.office.com/v1.0/admin/oauth/callback
    • Verwenden Sie für Microsoft 365 Government https://gcsgcc.office.com/v1.0/admin/oauth/callback
    1. Aktivieren Sie den Schlüssel so, dass die folgenden Berechtigungen zum Lesen von Problemen konfiguriert sind:
    • Account
    • Repositorien
    • Pull Requests
    1. Speichern Sie die Konfiguration, und kopieren Sie die Schlüssel- und Geheimniswerte.

Es wird empfohlen, separate Benutzerkonten für die OAuth-Authentifizierung für jede Verbindung zu verwenden, da das Bitbucket-Ratenlimit einzeln pro Benutzer berechnet wird.

Erste Schritte

Auswählen des Anzeigenamens

Wählen Sie einen Anzeigenamen aus, mit dem Benutzer Mergeanforderungen oder Dokumentationen in einer Copilot-Antwort erkennen können.

Bitbucket-instance-URL

Geben Sie die URL Ihres Bitbucket-instance ein (z. Bhttps://bitbucket.org/testinstance. ).

Authentifizierungstyp

  1. Geben Sie Ihre Client-ID mithilfe des Schlüssels Ihres Bitbucket OAuth-Consumers und Ihren geheimen Clientschlüssel mithilfe des entsprechenden OAuth-Consumergeheimnisses ein.
  2. Wählen Sie Autorisieren aus, um sich anzumelden und Zugriff zu gewähren.
  3. Klicken Sie auf Autorisieren , um sich anzumelden und die erforderlichen Zugriffsberechtigungen zu erteilen.

Rollout für eine begrenzte Zielgruppe

Testen Sie die Verbindung mit einer eingeschränkten Benutzerbasis in Copilot und Microsoft Search, bevor Sie den Connector bereitstellen.

Benutzerdefinierte Einrichtung

Im benutzerdefinierten Setup können Sie jeden der Standardwerte für Benutzer, Inhalte und Synchronisierung bearbeiten.

Benutzer

Identitätszuordnung

Aufgrund der Einschränkung der Bitbucket-API ordnet der Connector standardmäßig E-Mails in Microsoft Entra ID mit öffentlichen Namen von Bitbucket zu. Wenn diese Zuordnung nicht mit Ihrer Konfiguration übereinstimmt, passen Sie die Identitätszuordnung an.

Ordnen Sie Bitbucket-Benutzeridentitäten Microsoft Entra ID zu, um eine korrekte Berechtigungserzwingung sicherzustellen. Es folgen Beispiele:

  • Vollständiger Name: Ordnet die vollständigen Bitbucket-Namen Microsoft Entra ID Benutzereigenschaften zu.
  • Öffentlicher Name: Ordnet bitbucket öffentliche Namen mit Microsoft Entra ID Benutzereigenschaften zu.

Wenn bei der direkten Zuordnung ein Fehler auftritt, verwenden Sie reguläre Ausdrücke (regex) für die Transformation. Zum Beispiel:

  1. Wählen Sie Mail als Microsoft Entra Benutzereigenschaft aus.
  2. Wählen Sie Vollständiger Name als nicht Microsoft Entra Benutzereigenschaft aus.
  3. Verwenden Sie einen regulären Ausdruck, z. B. , ([^@]+) um eine Sequenz von einem oder mehreren Zeichen zu erfassen, die sich vor dem @ Symbol befinden.
  4. Erstellen Sie eine Formel, um die Zuordnung abzuschließen, z {0}@<your-domain>. B. .

Inhalt

Auf der Registerkarte Inhalt können Sie Eigenschaftenzuordnungen in den Beispieldaten für Metadaten wie Inhalt, Bezeichnungen, Beschreibungen und Zeitstempel überprüfen.

Synchronisieren

Sie können inkrementelle und vollständige Durchforstungen konfigurieren. Im Folgenden sind die Standardwerte aufgeführt:

  • Die inkrementelle Durchforstung wird standardmäßig alle 15 Minuten ausgeführt.
  • Die vollständige Durchforstung wird täglich ausgeführt, um die aktuelle Indizierung sicherzustellen.

Nächste Schritte

  • Überprüfen Sie die verbindungs status im Microsoft 365 Admin Center.

Wenn Sie Probleme haben oder Feedback geben möchten, wenden Sie sich an den Microsoft Graph-Support.

  • Last updated on