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

GCP Secret Manager

Kong Gatewayの実装の現在のバージョンでは、2つの方法でGCP Secret Managerの構成をサポートしています。

• 環境変数
• ワークロードID

GCP Secret Managerを構成する

GCP Secret Managerを構成するには、GCP_SERVICE_ACCOUNT環境変数をサービスアカウントの認証情報を参照するJSONドキュメントに設定する必要があります。

export GCP_SERVICE_ACCOUNT=$(cat gcp-project-c61f2411f321.json)

Kong Gatewayはキーを使用して自動的にGCP APIを認証し、アクセス権を付与します。

GKE クラスタで、GCP Secret Manager を Workload Identity と一緒に使用するには、ポッドの仕様を更新して、サービスアカウントをポッドに関連付けます。構成情報については、Workload Identity の構成に関するドキュメントを参照してください。

注：

• Workload Identity では、 GCP_SERVICE_ACCOUNTを設定する必要はありません。
• GCP Vault をバックエンドとして使用する場合は、公式の GCP API が使用する SSL 証明書を Kong が信頼できるように、lua_ssl_trusted_certificate 構成ディレクティブの一部として system が構成されていることを確認してください。

例:

secret-nameという名前でGCP Secret Managerのシークレットを使用するには、以下のように1つ以上のプロパティを含むJSONオブジェクトをGCPで作成します。

{
  "foo": "bar",
  "snip": "snap"
}

以下のように、シークレットの個々のリソースを参照できるようになりました。

{vault://gcp/secret-name/foo?project_id=project_id}
{vault://gcp/secret-name/snip?project_id=project_id}

プロバイダー（gcp）とGCPプロジェクトID（project_id）の両方を指定する必要があります。Kong Gatewayを起動する前に、環境変数を使用してプロジェクトIDを構成できます。

export KONG_VAULT_GCP_PROJECT_ID=project_id

その後、参照でそれを繰り返す必要はありません。

{vault://gcp/secret-name/foo}
{vault://gcp/secret-name/snip}

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

データベースが初期化されると、プロバイダーとGCPプロジェクトIDをカプセル化するVaultエンティティを作成できます。

curl -i -X PUT http://HOSTNAME:8001/vaults/gcp-sm-vault \
  --data name=gcp \
  --data description="Storing secrets in GCP Secret Manager" \
  --data config.project_id="project_id"

{
    "config": {
        "project_id": "project_id"
    },
    "created_at": 1657874961,
    "description": "Storing secrets in GCP Secret Manager",
    "id": "90e200be-cf84-4ce9-a1d6-a41c75c79f31",
    "name": "gcp",
    "prefix": "gcp-sm-vault",
    "tags": null,
    "updated_at": 1657874961
}

_format_version: "3.0"
vaults:
- config:
    project_id: project_id
  description: Storing secrets in GCP Secret Manager
  name: gcp
  prefix: gcp-sm-vault

Vaultエンティティを配置すると、それを通じてGCPシークレットを参照できます。

{vault://gcp-sm-vault/secret-name/foo}
{vault://gcp-sm-vault/secret-name/snip}

Vaultエンティティの設定オプション

サポートツールのいずれかから、次の構成オプションを使用して Vault エンティティを構成します。

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

Kong Gateway の GCP Secret Manager vault の構成オプション:

一般的なオプション: