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

# Microsoft Azure DevOps

> Verbinden Sie Microsoft Azure DevOps über Microsoft Entra ID OAuth mit Iru Compliance, um Projekteinstellungen, Repositorys, Branch-Richtlinien, Pull Requests, Pipelines, Berechtigungen und Audit-Aktivitäten der Organisation zu erfassen.

### Über Microsoft Azure DevOps

Iru liest **Projekte**, **Repositorys**, **Branch-Richtlinien**, **Pull Requests**, **Build- und Release-Pipelines**, **Benutzer und Gruppen**, **Dienstverbindungen** und **Audit-Log-Ereignisse** aus der Azure DevOps REST API. Die Authentifizierung erfolgt über delegiertes **OAuth 2.0** mit **Microsoft Entra ID** und verwendet denselben Assistenten **Launch OAuth Authentication** wie die anderen Microsoft Azure-Quellen. Sie melden sich mit einem Geschäftskonto an. Iru fragt nicht nach einem Personal Access Token. Die Erfassung ist auf die Organisationen und Projekte beschränkt, die dieses Konto bereits sehen kann. **Variablennamen** von Pipelines werden erfasst; **Secret-Werte nicht**.

### So funktioniert es

```http theme={null}
OAuth 2.0 authorization code flow (Microsoft Entra ID)
```

Iru verwendet den OAuth 2.0 Authorization Code Flow von Microsoft gegenüber Azure DevOps. Nachdem Sie sich im Pop-up angemeldet und zugestimmt haben, erhält Iru ein kurzlebiges Zugriffstoken und erneuert es automatisch. Die angeforderten Scopes folgen dem Berechtigungsmodell von Azure DevOps (Lesezugriff wie `vso.code`, `vso.build`, `vso.release`, `vso.graph` und `vso.audit_log`). Erstellen Sie kein Personal Access Token und fügen Sie keines ein. Der Assistent akzeptiert keines.

| Detail | Wert |
| - | - |
| **Kategorie** | Entwicklertools |
| **Authentifizierung** | OAuth 2.0 (Microsoft Entra ID) |

Offizielle Referenzen: [REST-API-Übersicht](https://learn.microsoft.com/en-us/rest/api/azure/devops/), [Zugriff auf REST-APIs mit OAuth 2.0 autorisieren](https://learn.microsoft.com/en-us/azure/devops/integrate/get-started/authentication/oauth).

### Voraussetzungen

* Ein **Microsoft Entra ID**-Konto, das sich bei der Azure DevOps-Organisation anmelden kann, die Iru lesen soll (`contoso` aus `https://dev.azure.com/contoso`).
* Sichtbarkeit aller Projekte, die Iru lesen soll. OAuth ist delegiert, daher übernimmt Iru den Projektzugriff dieses Kontos. Ein Konto, das ein Projekt nicht sehen kann, liefert dafür keine Daten.
* Browser-**Pop-ups** sind für die Iru-Website zugelassen, damit der Microsoft-Zustimmungsbildschirm geöffnet werden kann. Legen Sie den Projektumfang fest: Wenn Branch-Richtlinien außerhalb des Umfangs liegen, kann Iru Kontrollen zu Code-Reviews oder Genehmigungen nicht überprüfen.

### Microsoft Azure DevOps mit Iru verbinden

<Tabs>
  <Tab title="Azure DevOps">
    <Note>
      Schließen Sie diese Registerkarte ab, bevor Sie die Quelle in Compliance verbinden.
    </Note>

    <Steps>
      <Step title="Bei Azure DevOps anmelden">
        Melden Sie sich bei `https://dev.azure.com/{your-organization}` mit dem **Microsoft Entra ID**-Konto an, das Sie im Iru-Assistenten verwenden (derselbe Tenant und dieselbe Organisation, die Iru lesen soll).
      </Step>

      <Step title="Projektzugriff bestätigen">
        Bestätigen Sie, dass Sie jedes Projekt im Umfang öffnen können. Iru kann nur erfassen, worauf dieses Konto bereits Zugriff hat.
      </Step>

      <Step title="Pop-ups im Browser zulassen">
        Lassen Sie **Pop-ups** für Ihren Iru-Hostnamen zu, damit der Microsoft-Zustimmungsbildschirm aus dem Connector-Assistenten geöffnet werden kann.
      </Step>

      <Step title="Fallstricke bei mehreren Tenants beachten">
        Wenn Ihr Unternehmen mehrere Microsoft Entra ID-Tenants verwendet, melden Sie sich im selben Browserprofil von persönlichen Microsoft-Konten ab oder verwenden Sie ein privates Fenster, damit das OAuth-Pop-up das richtige Geschäftskonto auswählt.
      </Step>

      <Step title="Kein Personal Access Token erstellen">
        Iru authentifiziert sich mit OAuth 2.0. Fügen Sie kein PAT in den Assistenten ein.
      </Step>
    </Steps>

    <Note>
      Fahren Sie auf der Registerkarte [**Iru Compliance**](#iru-compliance) fort.
    </Note>
  </Tab>

  <Tab title="Iru Compliance">
    <Note>
      Schließen Sie zuerst die Registerkarte [**Azure DevOps**](#azure-devops) ab.
    </Note>

    <Steps>
      <Step title="Quellen öffnen">
        Erweitern Sie in Iru Compliance in der linken Navigationsleiste **Compliance** und wählen Sie **Quellen**.

        <Frame>
          <img src="https://mintcdn.com/iru/tI0HDLDwHj8r9Ile/assets/media/images/iru-navigation-compliance-sources.png?fit=max&auto=format&n=tI0HDLDwHj8r9Ile&q=85&s=87dcef15fc17d2fb9a6e53f454e41710" alt="Linke Navigation: Compliance erweitert, Sources ausgewählt" width="410" height="1024" data-path="assets/media/images/iru-navigation-compliance-sources.png" />
        </Frame>
      </Step>

      <Step title="Microsoft Azure DevOps aktivieren">
        Suchen Sie **Microsoft Azure DevOps** (verwenden Sie **Kategorie** oder **Nach Name oder Beschreibung suchen**). Aktivieren Sie auf dieser Karte den **Schalter**. Möglicherweise öffnet sich ein Browser-Tab oder -Fenster für den Connector-Assistenten.
      </Step>

      <Step title="OAuth-Authentifizierung starten">
        Wählen Sie **Launch OAuth Authentication**. Der Assistent zeigt **Perform OAuth Authentication** an.
      </Step>

      <Step title="Anmelden und zustimmen">
        Wenn sich das Microsoft-Fenster öffnet, melden Sie sich mit demselben Geschäftskonto an, das Sie in Azure DevOps überprüft haben, und wählen Sie auf dem Zustimmungsbildschirm **Accept**.
      </Step>

      <Step title="Verbindung abschließen">
        Wenn sich das OAuth-Fenster schließt und Iru den Austausch abgeschlossen hat, zeigt der Assistent **Verbindung konfiguriert** an. Wenn der Assistent zusätzlich nach einem **Organisations**namen fragt, geben Sie nur den Namen ein (zum Beispiel `contoso`, nicht die vollständige URL).
      </Step>

      <Step title="Bestätigen, dass die Quelle aktiv ist">
        Schließen Sie die Browser-Registerkarte **Iru fordert Zugriff auf externe Dienste an**, kehren Sie dann zu **Compliance** → **Quellen** zurück und bestätigen Sie, dass die Karte **Microsoft Azure DevOps** den Status **Aktiv** hat.
      </Step>
    </Steps>
  </Tab>
</Tabs>

### Fehlerbehebung

<AccordionGroup>
  <Accordion title="Beim Aktivieren der Quelle öffnet sich nichts">
    Prüfen Sie die Einstellungen des **Pop-up-Blockers** für die Iru-Website und versuchen Sie es erneut.
  </Accordion>

  <Accordion title="Die Authentifizierung schlägt fehl oder das Microsoft-Fenster erscheint nie">
    Prüfen Sie die Einstellungen des **Pop-up-Blockers** und melden Sie sich dann mit dem Geschäftskonto für den richtigen Microsoft Entra ID-Tenant an.
  </Accordion>

  <Accordion title="Repositorys werden angezeigt, Branch-Richtlinien, Pull Requests oder Pipelines jedoch nicht">
    Dem angemeldeten Konto fehlt der Lesezugriff auf diese Objekte. Melden Sie sich mit einem Konto an, das jedes Projekt im Umfang sehen kann, oder lassen Sie diesen Zugriff von einem Administrator erteilen und stellen Sie die Verbindung erneut her.
  </Accordion>

  <Accordion title="Ein Projekt fehlt vollständig">
    Das Konto, das OAuth abgeschlossen hat, kann dieses Projekt nicht sehen. Stellen Sie die Verbindung mit einem Konto erneut her, das Zugriff auf jedes Projekt im Umfang hat.
  </Accordion>

  <Accordion title="Die Karte zeigt nach einer Phase der Inaktivität „Broken“ an">
    Zugriffstokens werden erneuert, solange die Verbindung aktiv ist. Wenn die Aktualisierung unterbrochen wird, deaktivieren und aktivieren Sie die Quelle und schließen Sie OAuth erneut ab. Es handelt sich nicht um den Ablauf eines PAT. Iru verwendet für diese Quelle kein Personal Access Token.
  </Accordion>
</AccordionGroup>

### Verwandte Artikel

<CardGroup cols={2}>
  <Card title="Quellenverwaltung" icon="plug" href="/de/compliance/sources-management">
    Alle Compliance-Quellen durchsuchen und verwalten.
  </Card>

  <Card title="Erste Schritte mit Compliance" icon="rocket" href="/de/compliance/getting-started-with-compliance">
    Frameworks, Aktionen und **Artefakte**.
  </Card>

  <Card title="Iru-Übersicht" icon="layer-group" href="/de/iru/platform-overview/iru-overview">
    Wie Endpoint, Compliance und Identity zusammenwirken.
  </Card>

  <Card title="Artifacts-Verwaltung" icon="folder-open" href="/de/compliance/artifacts-management">
    Nachweise aus Quellen und Aktionen hochladen, prüfen und organisieren.
  </Card>
</CardGroup>