> ## Documentation Index
> Fetch the complete documentation index at: https://docs.enclave.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Enclave in these docs is the code and cloud security platform at enclave.ai. It is not Open Enclave, Intel SGX or other hardware enclaves, or enclave.gg.
> People use Enclave in the web app at https://app.enclave.ai or the desktop app. These docs describe no public Enclave API or CLI, so don't invent endpoints, commands, or config files.
> Connecting an integration needs a person to sign in and approve access in a browser. Tell the user the exact step to take instead of saying you completed it.

# Azure DevOps

> Verbinden Sie Azure-DevOps-Organisationen, damit Enclave Ihre Azure-Repos-Repositorys lesen und kennenlernen kann.

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](https://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.

> [tab] Microsoft Entra ID
>
> 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.

> [tab] Personal Access Token
>
> Verwenden Sie diese Option, wenn Sie sich mit einem persönlichen Microsoft-Konto anmelden. Microsoft Entra ID kann für persönliche Konten keine Tokens ausstellen.
>
> 1. Erstellen Sie in Azure DevOps ein Personal Access Token, das Code lesen, Projekte auflisten und Service Hooks verwalten kann. Azure DevOps gruppiert diese Berechtigungen je nach Version des Token-Dialogs unterschiedlich. Siehe [Microsofts Referenz zu Token-Scopes](https://learn.microsoft.com/en-us/azure/devops/organizations/accounts/use-personal-access-tokens-to-authenticate).
>
> 2. Klicken Sie in Enclave auf **Personal access token**.
>
> 3. Geben Sie Ihre **Organization** ein. Das ist das Pfadsegment in `dev.azure.com/<organization>`.
>
> 4. Fügen Sie das Token ein und klicken Sie auf **Validate & connect**.
>
> > [!TIP]
> >
> > Verwenden Sie statt eines persönlichen Tokens eines von einem Service-Account. Aktivitäten erscheinen unter dem Konto, dem das Token gehört.

**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

> [accordion] Die Organisation zeigt "push events not active"
>
> 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**.

> [accordion] Die Organisation zeigt "Azure Boards unavailable"
>
> Über die Verbindung können keine Work Items erstellt werden. Erteilen Sie **Work Items (read & write)** und klicken Sie dann auf **Resync**.

> [accordion] Ein neues Projekt oder Repository erscheint nicht
>
> 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.

> [accordion] Die Token-Validierung schlägt fehl
>
> * **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.

> [accordion] Die Organisation zeigt "reconnect needed"
>
> Enclave kann die Anmeldedaten der Verbindung nicht mehr verwenden. Entfernen Sie die Organisation und verbinden Sie sie erneut.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.