Zum Hauptinhalt springen
Verbinden Sie Azure DevOps, damit Enclave die Repositorys in Ihren Azure-DevOps-Organisationen lesen und kennenlernen kann.

​
Bevor Sie beginnen

Sie benötigen in Enclave die Rolle Owner oder Admin. In Azure DevOps benötigt das verbindende Konto Project Administrator für die zu scannenden Projekte oder die Berechtigung Edit Subscription. Enclave erstellt damit die Service Hooks, die Push-Ereignisse senden. Ohne diese Berechtigung kann Enclave Ihren Code lesen, sieht aber keine neuen Commits.

​
Azure DevOps verbinden

1

Integrationen öffnen

Öffnen Sie Settings → Integrations in app.enclave.ai. Klicken Sie neben Azure DevOps auf Connect.
2

Anmeldemethode wählen

Wählen Sie die Option, die zu Ihrer Anmeldung bei Azure DevOps passt.
Verwenden Sie diese Option für ein Geschäfts-, Schul- oder Unikonto.
  1. Klicken Sie auf Microsoft Entra ID und melden Sie sich bei Microsoft an.
  2. Wählen Sie unter Choose organizations to connect die Azure-DevOps-Organisationen aus, die Enclave lesen soll.
  3. Klicken Sie auf Connect.
Sie können später weitere Organisationen verbinden.
3

Verbindung bestätigen

Zurück unter Settings → Integrations → Azure DevOps erscheint die Organisation unter Organizations mit der Anzahl ihrer Repositorys.

​
Berechtigungen

Enclave nutzt die Verbindung, um:
  • Repositorys, Branches und Pull Requests zu lesen. Enclave liest Ihren Code und seinen Verlauf.
  • Service-Hook-Subscriptions zu erstellen und zu entfernen. Enclave abonniert Push- und Pull-Request-Ereignisse, damit es weiß, wann sich Code ändert.
  • Azure-Boards-Work-Items für Findings zu erstellen und zu aktualisieren. Dafür ist die Berechtigung Work Items (read & write) erforderlich. Mit der Verbindung zu Azure DevOps ist auch Azure Boards verbunden. Eine separate Einrichtung gibt es nicht.

​
Verbindung verwalten

Öffnen Sie Settings → Integrations → Azure DevOps, um Ihre verbundenen Organisationen zu sehen.
  • Resync übernimmt Projekte und Repositorys, die nach dem Verbinden erstellt wurden. Azure DevOps benachrichtigt Enclave nicht, wenn sie erstellt werden. Klicken Sie daher nach dem Hinzufügen auf Resync. Außerdem prüft Resync die Berechtigungen erneut, nachdem Sie sie korrigiert haben.
  • Add organization verbindet eine weitere Azure-DevOps-Organisation.
  • Remove trennt eine Organisation. Enclave scannt ihre Repositorys dann nicht mehr. Sie können sie später erneut verbinden.

​
Fehlerbehebung

Enclave hat Ihre Repositorys gelesen, konnte aber keine Service Hooks erstellen. Erteilen Sie dem verbindenden Konto Edit Subscription (oder Project Administrator) für die Projekte und klicken Sie dann auf Resync.
Über die Verbindung können keine Work Items erstellt werden. Erteilen Sie Work Items (read & write) und klicken Sie dann auf Resync.
Klicken Sie bei der Organisation auf Resync. Bei einer großen Organisation läuft die Synchronisierung nach dem Klick weiter. Repositorys erscheinen, sobald sie synchronisiert sind.
  • Azure DevOps rejected this token: Das Token ist abgelaufen oder wurde widerrufen. Erstellen Sie ein neues.
  • This token can’t do everything Enclave needs: Erstellen Sie das Token neu, sodass es Code lesen, Projekte auflisten und Service Hooks verwalten kann.
  • This token authenticated but can’t see any projects: Fügen Sie den Besitzer des Tokens unter Project Settings → Permissions einem Projekt hinzu.
  • We couldn’t reach that Azure DevOps organization: Prüfen Sie den Namen der Organisation und Ihre Netzwerkregeln.
Enclave kann die Anmeldedaten der Verbindung nicht mehr verwenden. Entfernen Sie die Organisation und verbinden Sie sie erneut.