> ## 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.
# HashiCorp Vault
> Verbinden Sie Vault mit einem Client-Token und einer Least-Privilege-Richtlinie mit Iru Compliance, um Nachweise zu Mounts, Richtlinien und Audit-Konfiguration zu erfassen.
### Über HashiCorp Vault
Iru liest **Mounts von Secrets Engines**, die **Konfiguration von Authentifizierungsmethoden**, **benannte Richtlinien**, **Audit-Geräte** und zugehörige **sys/**-Metadaten über die Vault HTTP API. Jede Anfrage sendet Ihr **Client-Token** im Header **`X-Vault-Token`**. Iru erfasst **Konfigurationsnachweise** – keine **Secret-Werte im Klartext**.
Funktioniert mit **Vault OSS**, **Enterprise** (Namespaces erfordern möglicherweise zusätzliche Einrichtung) und **HCP Vault**.
### So funktioniert es
```http theme={null}
X-Vault-Token: hvs.xxxxxxxx
```
Tokens können aus jeder Vault-**Authentifizierungsmethode** stammen (Token, AppRole, LDAP usw.). Der Assistent speichert zuerst **`vault_addr`** (zum Beispiel `https://vault.example.com:8200`) und nimmt dann das Token entgegen.
| Detail | Wert |
| - | - |
| **Kategorie** | Sicherheit |
| **Authentifizierung** | Client-Token (`X-Vault-Token`) |
Offizielle Referenzen: [Authentifizierungskonzepte](https://developer.hashicorp.com/vault/docs/concepts/auth), [HTTP API](https://developer.hashicorp.com/vault/api-docs), [Richtlinien](https://developer.hashicorp.com/vault/docs/concepts/policies), [AppRole](https://developer.hashicorp.com/vault/docs/auth/approle).
### Voraussetzungen
* Ein Vault-Cluster, der **von Iru aus erreichbar** ist (Netzwerk / Firewall / PrivateLink, je nach Bedarf).
* Berechtigung zum Erstellen einer **Richtlinie** und eines **Tokens** (oder einer AppRole) mit schreibgeschütztem **`sys/`**-Zugriff wie im folgenden Beispiel.
### Beispiel für eine schreibgeschützte Richtlinie (HCL)
Speichern Sie sie als `.hcl`-Datei und wenden Sie sie mit **`vault policy write iru-compliance your-file.hcl`** an.
```hcl lines theme={null}
path "sys/mounts" {
capabilities = ["read", "list"]
}
path "sys/auth" {
capabilities = ["read", "list"]
}
path "sys/policy" {
capabilities = ["read", "list"]
}
path "sys/policies/acl/*" {
capabilities = ["read", "list"]
}
path "sys/audit" {
capabilities = ["read", "list"]
}
path "auth/token/lookup-self" {
capabilities = ["read"]
}
```
### HashiCorp Vault mit Iru verbinden
#### Richtlinie anwenden und Token ausstellen
Verwenden Sie einen Jump-Host oder eine Administrator-Arbeitsstation, die **`VAULT_ADDR`** über TLS erreichen kann und auf der die **Vault-CLI** installiert ist (`vault`-Binärdatei).
Melden Sie sich mit der von Ihrer Organisation unterstützten Methode an (**`vault login`**, OIDC usw.), damit nachfolgende Befehle mit ausreichenden Berechtigungen zum Schreiben von Richtlinien und Erstellen von Tokens ausgeführt werden.
Speichern Sie die obige Beispielrichtlinie als `.hcl`-Datei auf diesem Rechner (zum Beispiel `iru-compliance.hcl`).
Führen Sie **`vault policy write iru-compliance`** mit dem Pfad Ihrer Richtliniendatei aus.
Erstellen Sie ein **erneuerbares** Token, das an diese Richtlinie gebunden ist (zum Beispiel **`vault token create -policy=iru-compliance -ttl=720h -renewable=true`**). Kopieren Sie den **`hvs.`**-Tokenwert.
Bevorzugen Sie für die Produktion **AppRole** oder einen anderen automatisierten Ablauf anstelle langlebiger statischer Tokens.
#### Connector in Iru abschließen
Erweitern Sie in Iru Compliance in der linken Navigationsleiste **Compliance** und wählen Sie **Quellen**.
Suchen Sie **HashiCorp Vault** (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.
Geben Sie **`vault_addr`** ein (zum Beispiel `https://vault.example.com:8200`) und bestätigen Sie die Servervariablen, wenn Sie dazu aufgefordert werden.
Fügen Sie das Token in das Feld **`X-Vault-Token`** ein, wenn Sie dazu aufgefordert werden.
Wählen Sie **API-Schlüssel senden**. Wenn die Verbindung erfolgreich ist, zeigt der Assistent **Verbindung konfiguriert** an.
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 **HashiCorp Vault** den Status **Aktiv** hat.
### Fehlerbehebung
Prüfen Sie die Einstellungen des **Pop-up-Blockers** für die Iru-Website und versuchen Sie es erneut.
Aktualisieren Sie den Assistenten, indem Sie die Quelle aus- und wieder einschalten; geben Sie **`vault_addr`** erneut ein.
Hängen Sie die Richtlinie **`iru-compliance`** an das Token an; prüfen Sie **Enterprise-Namespaces**.
Stellen Sie ein neues Token aus und aktualisieren Sie Iru; aktivieren Sie die **Erneuerung** oder verwenden Sie die AppRole-Rotation.
Prüfen Sie Hostname, Port (**8200**), TLS und ausgehende Routen von Iru.
**Entsiegeln** (Unseal) Sie Vault vor dem Testen.
### Hinweise
Vault **Enterprise**-**Namespaces** erfordern möglicherweise Pfade oder Einstellungen über diese Grundkonfiguration hinaus – stimmen Sie sich mit Ihren Vault-Administratoren ab.
### Verwandte Artikel
Alle Compliance-Quellen durchsuchen und verwalten.
Frameworks, Aktionen und **Artefakte**.
Wie Endpoint, Compliance und Identity zusammenwirken.
Nachweise aus Quellen und Aktionen hochladen, prüfen und organisieren.