> ## 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.

# AWS Key Management Service (KMS)

> Verbinden Sie AWS KMS über eine kontoübergreifende IAM-Rolle mit Iru Compliance, um Schlüsselinventar, Rotationsstatus und Grant-Metadaten ohne Entschlüsselungsberechtigungen zu erfassen.

### Über AWS Key Management Service (KMS)

Der Connector für **AWS Key Management Service** erfasst **Schlüsselmetadaten**, **Aliasse**, **Richtlinien**, **Grants**, **Tags** und den **Rotationsstatus**, damit Kontrollen nachweisen können, wie Schlüssel verwaltet werden. Iru verwendet **`sts:AssumeRole`** mit einer **externen ID**. Die unten empfohlene Inline-Richtlinie vermeidet **`kms:Decrypt`** und andere kryptografische Datenoperationen (nur Metadaten).

### So funktioniert es

Iru wird in einem eigenen AWS-Konto ausgeführt. Damit Iru **KMS**-Schlüsselmetadaten in Ihrem Konto lesen kann, erstellen Sie eine **IAM-Rolle** mit **`sts:AssumeRole`**-Vertrauensstellung (**External ID** aus dem Assistenten) und schreibgeschützten **`kms:`**-Berechtigungen, die für die Inventarisierung geeignet sind (vermeiden Sie Richtlinien, die schreibende Funktionen bündeln). Fügen Sie den **ARN** der Rolle anschließend in Iru ein.

Verzichten Sie für diesen Anwendungsfall auf **`AWSKeyManagementServicePowerUser`** – diese Richtlinie bündelt schreibende Funktionen. Verwenden Sie das explizite Inline-JSON aus dem Assistenten oder die unten stehende Vorlage.

| Detail | Wert |
| - | - |
| **Kategorie** | Sicherheit |
| **Authentifizierung** | Kontoübergreifende IAM-Rolle |

Referenzen: [KMS-Entwicklerhandbuch](https://docs.aws.amazon.com/kms/latest/developerguide/), [IAM-Richtlinien für KMS](https://docs.aws.amazon.com/kms/latest/developerguide/iam-policies.html).

### Voraussetzungen

* IAM-Administratorrechte zum Veröffentlichen von Rollen.
* Aktuelle Connector-Werte (**Principal**, **externe ID**).

### AWS KMS mit Iru verbinden

<Tabs>
  <Tab title="Iru Compliance">
    <Note>
      Beginnen Sie hier: Öffnen Sie den Quellen-Assistenten und kopieren Sie die **Vertrauensrichtlinie** (notieren Sie sich die **externe ID**). Wenn Sie bereit sind, die Rolle in AWS zu erstellen, wechseln Sie zur Registerkarte [**AWS**](#aws) und folgen Sie [**IAM-Rolle in AWS erstellen**](#create-the-iam-role-in-aws). Sobald Sie den **Role ARN** haben, kehren Sie zur Registerkarte [**Iru Compliance**](#iru-compliance) zurück und schließen Sie unten [**Rollen-ARN in Iru übermitteln**](#submit-the-role-arn-in-iru) ab.
    </Note>

    #### Vertrauensrichtlinie aus Iru abrufen

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

        <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="AWS KMS aktivieren">
        Suchen Sie **AWS KMS** (verwenden Sie **Kategorie** oder **Nach Name oder Beschreibung suchen**). Aktivieren Sie auf dieser Karte den **Schalter**. Lassen Sie die Assistenten-Registerkarte **Iru fordert Zugriff auf externe Dienste an** geöffnet.
      </Step>

      <Step title="JSON der Vertrauensrichtlinie kopieren">
        Der Assistent zeigt das JSON der **Vertrauensrichtlinie**, das Ihre IAM-Rolle verwenden muss (**Principal** und **sts:ExternalId**). Unten finden Sie ein **Beispiel** für die Struktur; **kopieren Sie das aktuelle JSON aus Ihrem Assistenten**, damit Konto, Principal-ARN und externe ID exakt übereinstimmen.

        ```json copy=false lines theme={null}
        {
          "Version": "2012-10-17",
          "Statement": [
            {
              "Effect": "Allow",
              "Principal": {
                "AWS": "arn:aws:iam::753695775620:role/IruConnect"
              },
              "Condition": {
                "StringEquals": {
                  "sts:ExternalId": "YOUR_EXTERNAL_ID"
                }
              },
              "Action": "sts:AssumeRole"
            }
          ]
        }
        ```
      </Step>

      <Step title="Zu AWS wechseln, um die Rolle zu erstellen">
        Lassen Sie die Registerkarte des Iru-Assistenten als Referenz geöffnet, wechseln Sie dann zur Registerkarte [**AWS**](#aws) und folgen Sie [**IAM-Rolle in AWS erstellen**](#create-the-iam-role-in-aws).
      </Step>
    </Steps>

    #### Rollen-ARN in Iru übermitteln

    <Note>
      Schließen Sie zuerst die Registerkarte [**AWS**](#aws) ab (bis einschließlich [**IAM-Rolle in AWS erstellen**](#create-the-iam-role-in-aws)), damit Sie den **Role ARN** der neuen Rolle haben.
    </Note>

    <Steps>
      <Step title="IAM Role ARN einfügen">
        Kehren Sie zur Registerkarte des Iru-Assistenten zurück. Fügen Sie den **Role ARN** an der Stelle ein, an der der Connector danach fragt.
      </Step>

      <Step title="Verbindung abschließen">
        Wählen Sie **Submit Role** aus. Wenn die Verbindung erfolgreich ist, zeigt der Assistent **Verbindung konfiguriert** an.
      </Step>

      <Step title="Prüfen, ob 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 vergewissern Sie sich, dass die Karte **AWS KMS** den Status **Aktiv** hat.
      </Step>
    </Steps>
  </Tab>

  <Tab title="AWS">
    <Note>
      Schließen Sie [**Vertrauensrichtlinie aus Iru abrufen**](#get-the-trust-policy-from-iru) auf der Registerkarte [**Iru Compliance**](#iru-compliance) ab, bevor Sie diese Rolle erstellen. Verwenden Sie die **externe ID** und die Vertrauensrichtlinie aus dem aktuellen Assistenten, wenn Sie **Trusted entity** konfigurieren.
    </Note>

    #### IAM-Rolle in AWS erstellen

    <Steps>
      <Step title="Workflow „Create role“ starten">
        Öffnen Sie **IAM** → **Roles** → **Create role**.
      </Step>

      <Step title="Vertrauenswürdige Entität konfigurieren">
        Wählen Sie **AWS account** → **Another AWS account**. Geben Sie **`753695775620`** ein (sofern Ihr Assistent keine andere ID anzeigt). Aktivieren Sie **Require external ID** und fügen Sie die externe ID aus Iru ein.
      </Step>

      <Step title="Umfassende verwaltete Richtlinien überspringen">
        Fahren Sie fort, ohne **`AWSKeyManagementServicePowerUser`** oder andere umfassende KMS-Richtlinien mit Schreibfunktionen anzuhängen.
      </Step>

      <Step title="Reine Metadaten-Inline-Richtlinie anhängen">
        Fügen Sie diese **Inline-Richtlinie** hinzu:

        ```json lines theme={null}
        {
          "Version": "2012-10-17",
          "Statement": [
            {
              "Effect": "Allow",
              "Action": [
                "kms:ListKeys",
                "kms:ListAliases",
                "kms:DescribeKey",
                "kms:GetKeyPolicy",
                "kms:GetKeyRotationStatus",
                "kms:ListGrants",
                "kms:ListKeyPolicies",
                "kms:ListResourceTags"
              ],
              "Resource": "*"
            }
          ]
        }
        ```

        <Note>
          Kein **`kms:Decrypt`**, **`kms:Encrypt`** oder **`GenerateDataKey`**. Iru kann Ihre Schlüssel nicht zur Verarbeitung von Chiffretext verwenden.
        </Note>
      </Step>

      <Step title="Rolle benennen und ARN kopieren">
        Benennen Sie die Rolle, erstellen Sie sie und kopieren Sie den **Role ARN**. Wechseln Sie zurück zur Registerkarte [**Iru Compliance**](#iru-compliance) und schließen Sie [**Rollen-ARN in Iru übermitteln**](#submit-the-role-arn-in-iru) ab.
      </Step>
    </Steps>

    <Note>
      Fahren Sie auf der Registerkarte [**Iru Compliance**](#iru-compliance) fort, um den **Role ARN** einzufügen und den Assistenten abzuschließen ([**Rollen-ARN in Iru übermitteln**](#submit-the-role-arn-in-iru)).
    </Note>
  </Tab>
</Tabs>

### Fehlerbehebung

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

  <Accordion title="AssumeRole verweigert">
    Beheben Sie Abweichungen bei der externen ID.
  </Accordion>

  <Accordion title="Lückenhafte CMK-Details">
    Ressourcenrichtlinien einzelner Schlüssel können **`DescribeKey`** verweigern – passen Sie die Schlüsselrichtlinien an, wenn Auditoren vollständige Transparenz verlangen.
  </Accordion>

  <Accordion title="Von AWS verwaltete Schlüssel">
    Werden immer aufgeführt, lassen sich aber manchmal weniger detailliert untersuchen als kundenverwaltete Schlüssel – dies entspricht dem erwarteten AWS-Verhalten.
  </Accordion>
</AccordionGroup>

### Hinweise

<CardGroup cols={2}>
  <Card title="Schlüssel sind regional: Das Inventar umfasst aktivierte Regionen." icon="circle-info">
    Schlüssel sind **regional**; das Inventar umfasst die aktivierten Regionen.
  </Card>

  <Card title="Funktioniert ausschließlich mit API-Metadaten: kein Schlüsselmaterial…" icon="shield">
    Funktioniert ausschließlich mit **API-Metadaten** – über Entschlüsselungsaufrufe dieses Connectors verlässt kein Schlüsselmaterial KMS.
  </Card>
</CardGroup>

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