HashiCorp Vault について
Iru は Vault HTTP API を使用して、シークレットエンジンのマウント、認証方式の構成、名前付きポリシー、監査デバイス、および関連する sys/ メタデータを読み取ります。各リクエストではX-Vault-Token に クライアントトークン を送信します。Iru が収集するのは 構成のエビデンス であり、シークレットの平文 の値ではありません。
Vault OSS、Enterprise（ネームスペースには追加のセットアップが必要な場合があります）、HCP Vault で動作します。
仕組み
vault_addr（例: https://vault.example.com:8200）を保存してから、トークンを受け付けます。
公式リファレンス: 認証の概念、HTTP API、ポリシー、AppRole。
前提条件
- Iru から到達可能な Vault クラスター（必要に応じてネットワーク / ファイアウォール / PrivateLink）。
- 以下の例のように、読み取り専用の
sys/アクセス権を持つ ポリシー と トークン（または AppRole）を作成する権限。
読み取り専用ポリシーの例（HCL）
.hcl ファイルとして保存し、vault policy write iru-compliance your-file.hcl で適用します。
HashiCorp Vault を Iru に接続する
ポリシーを適用してトークンを発行する
1
Vault CLI にアクセスできるワークステーションを準備する
TLS 経由で
VAULT_ADDR に到達でき、Vault CLI（vault バイナリ）がインストールされている踏み台ホストまたは管理用ワークステーションを使用します。2
CLI を Vault に認証する
以降のコマンドがポリシーの書き込みとトークンの作成に十分な権限で実行されるよう、組織でサポートされている方法（
vault login、OIDC など）でサインインします。3
ポリシーファイルを作成する
上記のポリシーの例を、そのマシン上に
.hcl ファイル（例: iru-compliance.hcl）として保存します。4
Vault でポリシーを適用する
ポリシーファイルのパスを指定して
vault policy write iru-compliance を実行します。5
更新可能なトークンを作成する
そのポリシーにバインドされた 更新可能な トークンを作成します（例:
vault token create -policy=iru-compliance -ttl=720h -renewable=true）。hvs. のトークン値をコピーします。6
本番環境では AppRole を推奨
本番環境では、有効期間の長い静的トークンではなく、AppRole などの自動化されたフローを推奨します。
Iru でコネクタを完了する
1
ソースを開く
Iru Compliance の左側のナビゲーションバーで コンプライアンス を展開し、ソース を選択します。
2
HashiCorp Vault をオンにする
HashiCorp Vault を探します（カテゴリ または 名前または説明で検索 を使用します）。そのカードで トグル をオンにします。コネクタウィザード用のブラウザタブまたはウィンドウが開く場合があります。
3
サーバー変数を構成する
vault_addr（例: https://vault.example.com:8200）を入力し、求められたらサーバー変数を確認します。4
Vault トークンを貼り付ける
求められたら、
X-Vault-Token フィールドにトークンを貼り付けます。5
接続を完了する
APIキーを送信 を選択します。接続に成功すると、ウィザードに 接続が構成されました と表示されます。
6
ソースが有効であることを確認する
Iru が外部サービスへのアクセスをリクエストしています のブラウザタブを閉じてから コンプライアンス → ソース に戻り、HashiCorp Vault カードが 有効 になっていることを確認します。
トラブルシューティング
ソースをオンにしても何も開かない
ソースをオンにしても何も開かない
Iru サイトの ポップアップブロッカー の設定を確認して、もう一度お試しください。
サーバー変数が失敗する
サーバー変数が失敗する
ソースを切り替えてウィザードを更新し、
vault_addr を再入力してください。403 permission denied
403 permission denied
トークンに
iru-compliance ポリシーをアタッチしてください。Enterprise のネームスペース も確認してください。トークンの有効期限切れ
トークンの有効期限切れ
新しいトークンを発行して Iru を更新してください。更新 を有効にするか、AppRole によるローテーションを使用してください。
Connection refused
Connection refused
ホスト名、ポート（8200）、TLS、および Iru からのアウトバウンド経路を確認してください。
503 sealed
503 sealed
テストする前に Vault を Unseal してください。
考慮事項
Vault Enterprise のネームスペースでは、パスや…
Vault Enterprise の ネームスペース では、このベースライン以外のパスや設定が必要になる場合があります。Vault の管理者と調整してください。
関連記事
Sources の管理
すべての Compliance ソースを参照、管理します。
Compliance を使い始める
フレームワーク、アクション、アーティファクト。
Iru の概要
Endpoint、Compliance、Identity がどのように連携するか。
Artifacts の管理
ソースやアクションから得たエビデンスをアップロード、確認、整理します。