Skip to main content

Ü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

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. Offizielle Referenzen: Authentifizierungskonzepte, HTTP API, Richtlinien, 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.

HashiCorp Vault mit Iru verbinden

Richtlinie anwenden und Token ausstellen

1

Arbeitsstation mit Vault-CLI-Zugriff vorbereiten

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).
2

CLI bei Vault authentifizieren

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

Richtliniendatei schreiben

Speichern Sie die obige Beispielrichtlinie als .hcl-Datei auf diesem Rechner (zum Beispiel iru-compliance.hcl).
4

Richtlinie in Vault anwenden

Führen Sie vault policy write iru-compliance mit dem Pfad Ihrer Richtliniendatei aus.
5

Erneuerbares Token erstellen

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

AppRole für die Produktion bevorzugen

Bevorzugen Sie für die Produktion AppRole oder einen anderen automatisierten Ablauf anstelle langlebiger statischer Tokens.

Connector in Iru abschließen

1

Quellen öffnen

Erweitern Sie in Iru Compliance in der linken Navigationsleiste Compliance und wählen Sie Quellen.
Linke Navigation: Compliance erweitert, Sources ausgewählt
2

HashiCorp Vault aktivieren

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

Servervariablen konfigurieren

Geben Sie vault_addr ein (zum Beispiel https://vault.example.com:8200) und bestätigen Sie die Servervariablen, wenn Sie dazu aufgefordert werden.
4

Vault-Token einfügen

Fügen Sie das Token in das Feld X-Vault-Token ein, wenn Sie dazu aufgefordert werden.
5

Verbindung abschließen

Wählen Sie API-Schlüssel senden. Wenn die Verbindung erfolgreich ist, zeigt der Assistent Verbindung konfiguriert an.
6

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

Vault Enterprise-Namespaces erfordern möglicherweise Pfade oder Einstellungen über diese Grundkonfiguration hinaus – stimmen Sie sich mit Ihren Vault-Administratoren ab.

Verwandte Artikel

Quellenverwaltung

Alle Compliance-Quellen durchsuchen und verwalten.

Erste Schritte mit Compliance

Frameworks, Aktionen und Artefakte.

Iru-Übersicht

Wie Endpoint, Compliance und Identity zusammenwirken.

Artifacts-Verwaltung

Nachweise aus Quellen und Aktionen hochladen, prüfen und organisieren.