旧バージョンのドキュメントを参照しています。 最新のドキュメントはこちらをご参照ください。

環境変数 Vault

ビルド時に注入できるシークレットの環境変装への保存は一般的な方法です。

環境変数による構成

環境変数でシークレットを定義します。

export MY_SECRET_VALUE=EXAMPLE_VALUE

これで、次のシークレットを参照できます。

{vault://env/my-secret-value}

複数のシークレットを単一の環境変数で保存したい場合は、フラットな json 文字列を定義することもできます。ネストされた json はサポートされていません。

export PG_CREDS='{"username":"user", "password":"pass"}'

これにより、シークレットを個別に参照できます。

{vault://env/pg-creds/username}
{vault://env/pg-creds/password}

Helmで環境変数を追加する場合は、渡される変数の前に kong- が追加されていることを確認してください。

vaultsエンティティによる構成

Vault エンティティは、データベースが初期化された後にのみ使用できます。データベースが初期化される 前に 使用された値のシークレットは、Vaultsエンティティを使用できません。

curl -i -X PUT http://HOSTNAME:8001/vaults/my-env-vault \
  --data name=env \
  --data description="Store secrets in environment variables"

{
    "config": {
        "prefix": null
    },
    "created_at": 1644942689,
    "description": "Store secrets in environment variables",
    "id": "2911e119-ee1f-42af-a114-67061c3831e5",
    "name": "env",
    "prefix": "my-env-vault",
    "tags": null,
    "updated_at": 1644942689
}

_format_version: "3.0"
vaults:
- config:
    prefix: null
  description: Store secrets in environment variables
  name: env
  prefix: my-env-vault

エンティティを配置すると、次のようにシークレットを参照できます。

{vault://my-env-vault/my-secret-value}

Vault構成オプション

サポートされているツールのいずれかを使用してVaultsエンティティを設定するには、以下の設定オプションを使用します。

• Admin API
• 宣言型構成
• Kong Manager
• Konnect

Kong Gatewayの環境変数Vaultの構成オプション:

一般的なオプション：