> ## 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 Key Vault

> Verbinden Sie Azure Key Vault über OAuth mit Iru Compliance, um Metadaten zu Vaults, Schlüsseln, Secrets und Zertifikaten für Audits zu erfassen, ohne tatsächliche Secret-Werte offenzulegen.

### Über Microsoft Azure Key Vault

Die Quelle **Microsoft Azure Key Vault** liest die **Vault-Konfiguration** und **Metadaten** zu Schlüsseln, Secrets und Zertifikaten über **Azure Resource Manager**. **Iru liest keine Secret-Werte, kein Schlüsselmaterial und keine privaten Schlüssel**; es werden nur Namen, Attribute, Ablaufdaten, Zugriffskonfigurationen und ähnliche Felder erfasst, die die Verwaltungs-API bereitstellt.

Iru authentifiziert sich mit **delegiertem OAuth 2.0** (Microsoft Entra ID) als der Benutzer, der den Assistenten abschließt. Alles, was dieser Benutzer in Azure nicht lesen kann, erscheint nicht in Iru.

### So funktioniert es

Iru verwendet den **OAuth 2.0 Authorization Code Flow** von Microsoft gegenüber **Azure Resource Manager**. Der angeforderte Scope lautet:

`https://management.azure.com/user_impersonation`

| Detail | Wert |
| - | - |
| **Kategorie** | Entwicklertools |
| **Authentifizierung** | OAuth 2.0 (Microsoft Entra ID, Azure Resource Manager) |
| **Anbietertarif** | Jedes Azure-Abonnement mit Key Vault-Ressourcen |

#### Was Iru erfasst

| Datentyp | Hinweise |
| - | - |
| Key Vault-Konfiguration | Name, Standort, SKU (Standard oder Premium), vorläufiges Löschen, Löschschutz |
| Schlüssel (Metadaten) | Bezeichner, zulässige Vorgänge, Aktivierungsstatus, Ablaufdatum (**kein** Schlüsselmaterial) |
| Secrets (Metadaten) | Namen, Inhaltstyp, Aktivierungsstatus, Ablaufdatum (**keine** Secret-Werte) |
| Zertifikate (Metadaten) | Bezeichner, Aussteller, Gültigkeit (**keine** privaten Schlüssel) |
| Zugriffsrichtlinien / RBAC | Welche Principals welche Berechtigungen für jeden Vault haben |

Iru ändert **keine** Vaults, Objekte oder Zugriffsrichtlinien.

Offizielle Referenzen: [Azure Key Vault-Dokumentation](https://learn.microsoft.com/azure/key-vault/), [Key Vault REST API](https://learn.microsoft.com/rest/api/keyvault/), [Key Vault RBAC-Leitfaden](https://learn.microsoft.com/azure/key-vault/general/rbac-guide), [Integrierte Rollen für Sicherheit](https://learn.microsoft.com/azure/role-based-access-control/built-in-roles/security).

### Voraussetzungen

* **Microsoft Entra ID**-Anmeldung beim [Azure-Portal](https://portal.azure.com).
* Die integrierte Rolle **Key Vault Reader** (empfohlen) oder **Reader**, zugewiesen auf **Abonnement**ebene für die breiteste Abdeckung aller Vaults oder auf Ebene einzelner Vaults, wenn Sie die Sichtbarkeit bewusst einschränken. **Key Vault Reader** umfasst das Lesen von Vaults und Metadaten zu Schlüsseln, Secrets und Zertifikaten **ohne** Zugriff auf Secret- oder Schlüsselmaterial.
* Browser-**Pop-ups** sind zugelassen, damit der Connector-Assistent beim Aktivieren der Quelle geöffnet werden kann.

Zugriff bestätigen: **Subscriptions** → Ihr Abonnement → **Access control (IAM)** → **View my access**.

Beispiel für eine Rollenzuweisung (ersetzen Sie die Platzhalter):

```bash theme={null}
az role assignment create \
  --assignee <your-user-principal-name> \
  --role "Key Vault Reader" \
  --scope /subscriptions/<subscription-id>
```

### Microsoft Azure Key Vault mit Iru verbinden

Bestätigen Sie zuerst unter **Microsoft Azure** den Portalzugriff und die Abdeckung durch **Key Vault Reader** (oder **Reader**) und schließen Sie dann OAuth in **Iru Compliance** ab. Der Assistent zeigt **Step 1 of 1: Perform OAuth Authentication** an.

<Tabs>
  <Tab title="Microsoft Azure">
    <Note>
      Schließen Sie diese Registerkarte ab, bevor Sie OAuth in **Iru Compliance** starten.
    </Note>

    <Steps>
      <Step title="Beim Azure-Portal anmelden">
        Öffnen Sie [portal.azure.com](https://portal.azure.com) und melden Sie sich mit dem Konto an, das Sie im Iru-Assistenten verwenden.
      </Step>

      <Step title="Zielabonnement öffnen">
        Suchen Sie nach **Subscriptions** und öffnen Sie dann das Abonnement, das die **Key Vaults** enthält (oder ihnen übergeordnet ist), die Iru lesen soll.
      </Step>

      <Step title="Key Vault- oder Reader-Zugriff überprüfen">
        Öffnen Sie **Access control (IAM)** → **View my access**. Bestätigen Sie gemäß den **Voraussetzungen** **Key Vault Reader** für bestimmte Vaults oder **Reader** auf Abonnementebene.
      </Step>

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

      <Step title="Den richtigen Microsoft Entra ID-Tenant einplanen">
        Wenn Sie mehrere Tenants verwenden, nutzen Sie eine saubere Browsersitzung, damit sich OAuth beim **Geschäfts**-Tenant anmeldet, dem die Vaults gehören.
      </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 [**Microsoft Azure**](#microsoft-azure) 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="Integration aktivieren">
        Suchen Sie **Microsoft Azure Key Vault** (setzen Sie **Kategorie** auf **Developer tools** oder verwenden Sie **Nach Name oder Beschreibung suchen**). Aktivieren Sie auf dieser Karte den **Schalter**, um den Connector-Assistenten zu starten.
      </Step>

      <Step title="OAuth starten und anmelden">
        Wählen Sie **Launch OAuth Authentication**. Wenn sich das Microsoft-Fenster öffnet, melden Sie sich mit demselben Konto an, das Sie im Azure-Portal ü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.
      </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 Key Vault** 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="Leere Vault-Liste oder 403-Fehler">
    Dem angemeldeten Konto fehlt möglicherweise **Key Vault Reader** oder **Reader** für das Abonnement oder die Vaults. Überprüfen Sie die **IAM**-Zuweisungen (siehe **Voraussetzungen**).
  </Accordion>

  <Accordion title="Falscher Microsoft Entra-Tenant">
    Melden Sie sich im Microsoft-Pop-up **ab** und mit dem Konto für den **richtigen** Tenant an.
  </Accordion>

  <Accordion title="Status „Broken“">
    **Deaktivieren** und **aktivieren** Sie **Microsoft Azure Key Vault** unter **Quellen** und schließen Sie OAuth erneut ab.
  </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>