[アップデート] Amazon Bedrock AgentCore Identityがプライベート認証局(CA)に対応しました!

[アップデート] Amazon Bedrock AgentCore Identityがプライベート認証局(CA)に対応しました!

Amazon Bedrock AgentCore IdentityがプライベートCAの証明書に対応しました!
2026.11.21

はじめに

こんにちは、チーズナンが好きなコンサル部の神野です。

Amazon Bedrock AgentCore Identityがプライベート認証局(CA)の発行した証明書に対応しました!

https://aws.amazon.com/jp/about-aws/whats-new/2026/11/bedrock-agentcore-identity-private-ca/

ちょっとニッチなアップデートですが、社内で独自にIdPを管理して社内のCAで証明書を発行しているケースには嬉しいのではないでしょうか!

先月のGatewayのターゲットに続くIdentity側のアップデートなので、主な変更点をまとめてVPC内のKeycloakにつないでみます。

https://dev.classmethod.jp/articles/agentcore-gateway-private-ca/

あれ、前回と何が違うの・・・?前もプライベートCAに対応していなかった?と思った方もいるかもしれません・・・!!

前回はGatewayがMCPサーバーなどのターゲットに接続するときの話で、今回はAgentCore IdentityやGatewayのJWT認可がIdPに接続するときの話です。接続先がターゲットかIdPかの違いですね。

GatewayとAgentCore Identityはリソースゲートウェイを経由してVPC内のサーバーに接続する。前回はGatewayからMCPサーバーなどのターゲットへの接続がプライベートCAの証明書に対応し、今回はトークンの取得とJWTの検証でKeycloakへの接続が対応した図

主な変更点

これまではAgentCore IdentityがVPC Lattice経由でVPC内のIdPに接続する場合でも、IdPに公開CAの証明書が必要でした。
そのため、以前Keycloakで試した際は公開ドメインを取得してACMの公開証明書を付けた内部ALBをKeycloakの前に置いていました。

https://dev.classmethod.jp/articles/agentcore-inbound-auth-private-keycloak/

今回からはCA証明書のPEM(テキスト形式の証明書ファイル)をS3かSecrets Managerに置いて参照するだけでプライベートCAの証明書のままIdPに直接つなげます!TLSを終端するためだけのALBや公開ドメインを用意しなくて済むのは嬉しいですね。

内部ALBでTLSを終端していたこれまでの構成と今回の直接つなぐ構成の比較図。今回はS3に置いたCA証明書のPEMを参照してKeycloakの証明書を検証する

対象はエージェントが外部のサービスを呼び出すためにIdPからトークンを取得するカスタムのOAuth 2.0認証情報プロバイダー(アウトバウンド認証)です。
CAはAWS Private CA・社内のCA・自己署名のルートCAのどれでも使えます。

公式ブログではRuntimeやGatewayへの呼び出しをJWTで検証する認可(インバウンド認証)でも同じ設定ができると紹介されているので、今回はGatewayでこちらも試してみます。

https://aws.amazon.com/blogs/machine-learning/private-certificate-authority-support-in-amazon-bedrock-agentcore-identity/

ちなみに、新旧のCA証明書を1つのPEMにまとめればダウンタイムを抑えて入れ替えられます。
参照を外して更新すればプライベートCAの信頼も削除できます。

前提

今回は下記構成図のように検証を行います!

AWS CLIからのトークンの要求を受けたIdentityがS3のCA証明書を参照してリソースゲートウェイ経由でKeycloakに接続する構成図

プライベートサブネットのEC2でKeycloakを動かし、OpenSSLで作った自己署名のルートCAから発行したサーバー証明書でHTTPSを受け付けます。

ホスト名の idp.internal.example.com はRoute 53のプライベートホストゾーンに登録してVPC内から名前解決できるようにし、AgentCore IdentityからはVPC Latticeのリソースゲートウェイ(AgentCoreからの通信をVPCに通す入り口)を経由してKeycloakに接続します。

この構成で認証情報プロバイダーを作り、AWS CLIからトークンを取得してみます。

項目 内容
リージョン ap-northeast-1
IdP Keycloak 26.8.2(EC2 t4g.medium・Amazon Linux 2023・Docker)
証明書の作成 OpenSSL 4.1.0(macOS)
環境の構築 AWS CDK(aws-cdk-lib 2.277.0・TypeScript・Node.js 26.13.0 + pnpm 10.28.1)
プロバイダーの作成とトークンの取得 AWS CLI 2.40.2
接続モード managed Lattice(managedVpcResource)

以降のコマンドはBashで実行します。検証に使ったコードは次のリポジトリに置いています。

https://github.com/yuu551/agentcore-identity-private-ca

リポジトリの主なファイルは次のとおりです。

ディレクトリ構成
agentcore-identity-private-ca/
├── certs.sh
├── env.sh
├── keycloak/realm-demo.json
└── cdk/
    ├── bin/app.ts
    └── lib/idp-stack.ts

それではさっそくやってみましょう!

やってみた

まずは証明書の準備から行います。

証明書を作る

CAであることを示す CA:TRUE を付けたプライベートCAと、SANにKeycloakのホスト名を入れたサーバー証明書を作ります。

certs.sh(抜粋)
# プライベートCA
openssl req -x509 -new -key ca.key -sha256 -days 3650 \
  -subj "/CN=$CA_NAME" \
  -addext "basicConstraints=critical,CA:TRUE" \
  -addext "keyUsage=critical,keyCertSign,cRLSign" \
  -out ca.pem

# サーバー証明書(SANにKeycloakのホスト名を入れる)
openssl x509 -req -in server.csr -CA ca.pem -CAkey ca.key -CAcreateserial \
  -days 365 -sha256 \
  -extfile <(printf "subjectAltName=DNS:%s\nbasicConstraints=CA:FALSE\nextendedKeyUsage=serverAuth\n" "$HOST") \
  -out server.pem

リポジトリをクローンして certs.sh を実行し、証明書の中身を確認します。

実行コマンド
git clone https://github.com/yuu551/agentcore-identity-private-ca.git
cd agentcore-identity-private-ca
./certs.sh
openssl x509 -in certs/ca.pem -noout -subject -ext basicConstraints
openssl verify -CAfile certs/ca.pem certs/server.pem
実行結果
subject=CN=Demo Private Root CA
X509v3 Basic Constraints: critical
    CA:TRUE
certs/server.pem: OK

CA証明書に CA:TRUE が付いていてサーバー証明書もこのCAで検証できていますね。

環境を用意する

VPC・Keycloak(EC2)・プライベートホストゾーン・CA証明書を置くS3バケットをCDKでまとめて作ります。

KeycloakはDockerで起動してサーバー証明書でHTTPSを受け付け、接続元はリソースゲートウェイのENIに付けるセキュリティグループに絞りました。

certs.shで作った証明書のうちサーバー証明書はKeycloakがHTTPSで使い、CA証明書はAgentCore IdentityがKeycloakの証明書を検証するのに使います。

サーバー証明書の秘密鍵はCDKのアセットに含めず、デプロイ前にSecrets Managerへ登録してEC2の起動時に取得します。

certs.shで作った秘密鍵はSecrets Managerに登録し、サーバー証明書とCA証明書はcdk deployでS3にアップロードする。Keycloakは起動時に秘密鍵とサーバー証明書を取得してHTTPSで使う。AgentCore Identityは作成・更新時にCA証明書を読み取ってKeycloakの証明書の検証に使う図

cdk/lib/idp-stack.ts(抜粋)
// Keycloakは、リソースゲートウェイのENIからの443だけを受け付ける
idpSg.addIngressRule(latticeSg, ec2.Port.tcp(443));

// UserData(-x を付けるとシークレットの値がcloud-initのログに残るので付けない)
'set -euo pipefail',
// 秘密鍵はSecrets Managerから600の権限で取得し、プライベートCAで署名したサーバー証明書でHTTPSを受け付ける
`(umask 077; aws secretsmanager get-secret-value --region ${this.region} --secret-id ${SERVER_KEY_SECRET} --query SecretString --output text > /opt/kc/tls/server.key)`,
'--https-certificate-file=/opt/keycloak/conf/tls/server.pem',
'--https-certificate-key-file=/opt/keycloak/conf/tls/server.key',

keycloak/realm-demo.json はKeycloakのレルム(realm)の定義で、レルムはクライアントやユーザーをまとめて管理する単位です。
ここでは demo レルムにAgentCore Identityが使うクライアント agentcore-client を作り、あとでGatewayが確認するaudience(トークンの宛先を表すaud)に agentcore-gateway を入れる設定も含めています。

後続のコマンドで使う値はスタックのデプロイ後に env.sh で読み込みます。

env.sh
env.sh
# 後続のコマンドで使う値をスタックの出力から読み込む
export AWS_REGION=ap-northeast-1
out() { aws cloudformation describe-stacks --stack-name PrivateCaIdp \
  --query "Stacks[0].Outputs[?OutputKey=='$1'].OutputValue" --output text; }
PE=$(out PrivateEndpoint)              # privateEndpoint に渡すJSON(VPC・サブネット・SG)
B=$(out BucketName)                    # CA証明書のPEMを置いたバケット
GW_ROLE=$(out GatewayRoleArn)          # インバウンド認証を試すGatewayのロール
KC_ID=$(out KeycloakInstanceId)
CLIENT_SECRET=$(aws secretsmanager get-secret-value --secret-id "$(out ClientSecretArn)" \
  --query SecretString --output text)
ACCOUNT=$(aws sts get-caller-identity --query Account --output text)
DISCOVERY_URL=https://idp.internal.example.com/realms/demo/.well-known/openid-configuration
スタックのデプロイ
export AWS_REGION=ap-northeast-1
# サーバー証明書の秘密鍵はSecrets Managerに登録しておく
aws secretsmanager create-secret --name private-ca-demo/keycloak-server-key \
  --secret-string file://certs/server.key
(cd cdk && pnpm install && pnpm cdk deploy PrivateCaIdp)
source env.sh

認証情報プロバイダーを作る

CA証明書を指定した認証情報プロバイダーをAgentCore Identityに作ります。JSONではVPC内のIdPにつなぐための privateEndpoint と同じ階層に certificateConfigurations を追加して、S3に置いたCA証明書のURIを渡します。

各項目の意味合いは次の図のとおりです。

customOauth2ProviderConfigの各項目が指す先の図。discoveryUrlとclientId・clientSecretはKeycloakを指す。privateEndpointはリソースゲートウェイを作るVPCとサブネットを指す。今回追加されたcertificateConfigurationsはS3に置いたCA証明書のPEMを指す

AgentCore IdentityはCA証明書をプロバイダーの作成・更新を実行したプリンシパルの認証情報で読み取るため、そのプリンシパルにはS3のオブジェクトに対する s3:GetObject が必要です。

プロバイダーの作成
CONFIG=$(jq -n \
  --arg url "$DISCOVERY_URL" --arg secret "$CLIENT_SECRET" --argjson pe "$PE" \
  --arg ca "s3://$B/ca/private-ca.pem" --arg owner "$ACCOUNT" '{
    customOauth2ProviderConfig: {
      oauthDiscovery: {discoveryUrl: $url},
      clientId: "agentcore-client",
      clientSecret: $secret,
      privateEndpoint: $pe,
      certificateConfigurations: [{s3: {uri: $ca, bucketOwnerAccountId: $owner}}]
    }}')

aws bedrock-agentcore-control create-oauth2-credential-provider \
  --name keycloak-private-ca \
  --credential-provider-vendor CustomOauth2 \
  --oauth2-provider-config-input "$CONFIG"

作成直後の CREATING から3分ほどで READY になり、設定を取得するとCA証明書の参照も保存されていました。

get-oauth2-credential-provider の結果(抜粋)
{
  "status": "READY",
  "oauth2ProviderConfigOutput": {
    "customOauth2ProviderConfig": {
      "certificateConfigurations": [
        {"s3": {"uri": "s3://privatecaidp-bucket83908e77-xxxx/ca/private-ca.pem", "bucketOwnerAccountId": "<アカウントID>"}}
      ]
    }
  }
}

トークンを取得する

エージェントを表すワークロードIDを作り、M2M(クライアントクレデンシャル)のフローでトークンを取得します。M2Mはユーザーのログインを挟まずにクライアントIDとシークレットでトークンを発行してもらう方式で、AWS CLIからは次の図のように2つのAPIを順に呼び出します。

AWS CLIがget-workload-access-tokenでワークロードアクセストークンを受け取り、get-resource-oauth2-tokenでトークンを要求する。AgentCore Identityはリソースゲートウェイ経由でKeycloakに接続し、登録したCA証明書でKeycloakの証明書を検証してアクセストークンを受け取る流れの図

2つの呼び出しとトークンのデコードはあとでも使うので token と claims という関数にまとめておきます。

トークンの取得
aws bedrock-agentcore-control create-workload-identity --name private-ca-demo-agent

token() {
  local wat=$(aws bedrock-agentcore get-workload-access-token \
    --workload-name private-ca-demo-agent --query workloadAccessToken --output text)
  aws bedrock-agentcore get-resource-oauth2-token \
    --workload-identity-token "$wat" \
    --resource-credential-provider-name "${1:-keycloak-private-ca}" \
    --scopes openid --oauth2-flow M2M \
    --query accessToken --output text
}

# 取得したJWTのペイロードをデコードして中身を確認する
claims() {
  token "$@" | cut -d. -f2 | uv run --no-project python -c \
    "import base64, json, sys; p = sys.stdin.read().strip(); print(json.dumps(json.loads(base64.urlsafe_b64decode(p + '=' * (-len(p) % 4))), indent=2))"
}
claims
デコード結果(抜粋)
{
  "iss": "https://idp.internal.example.com/realms/demo",
  "aud": ["agentcore-gateway", "account"],
  "azp": "agentcore-client",
  "clientAddress": "10.0.2.166"
}

インターネットから到達できないKeycloakのトークンが取れましたね!Keycloakから見た接続元の clientAddress をVPC内のENIと照らし合わせるとリソースゲートウェイのIPアドレスでした。

CA証明書を指定しないとどうなるか

比較のために certificateConfigurations を外したプロバイダー(keycloak-no-ca)も作ってみると、こちらも READY にはなるもののトークンの取得で失敗します。

実行コマンド
aws bedrock-agentcore-control create-oauth2-credential-provider \
  --name keycloak-no-ca \
  --credential-provider-vendor CustomOauth2 \
  --oauth2-provider-config-input "$(jq 'del(.customOauth2ProviderConfig.certificateConfigurations)' <<< "$CONFIG")"

# READY になってから実行する
token keycloak-no-ca
実行結果
aws: [ERROR]: An error occurred (ValidationException) when calling the GetResourceOauth2Token operation: HTTP request failed against private endpoint

デフォルトでは公開CAしか信頼しないためKeycloakの証明書を検証できずに失敗しているのですが、エラーに証明書の話は出てこないので少し迷いそうですね。

ほかにも2パターン試したところ、サーバー証明書のPEMを渡したプロバイダー(keycloak-leaf-cert)は「Leaf certificates are not allowed, must provide CA certificates only」という理由で CREATE_FAILED になりました。privateEndpoint なしでCA証明書を指定した場合は「The private certificate authority feature can only be used with private IdP」というエラーで作成のリクエスト自体が通りません。

作成・更新時にはprivateEndpointの有無とCAの証明書かどうかを確認する。トークンの取得時にはKeycloakの証明書を登録したCAで検証する。それぞれの段階で失敗したパターンを並べた図

certificateConfigurations を省いてもプロバイダーは READY になるので、作成後は一度トークンを取得してKeycloakに接続できるところまで確かめておくと安心ですね。

GatewayのJWT認可(インバウンド認証)でも試す

Gatewayの認可設定(customJWTAuthorizer)にもプロバイダーと同じ形で certificateConfigurations を追加できます!

許可するaudienceにはレルムの定義でトークンに入れた agentcore-gateway を指定し、さきほどのプロバイダーで取得したトークンをそのままGatewayの呼び出しに使います。Gatewayは作成時にdiscovery URLを取得して検証し、呼び出し時にはJWTの署名とaudを確認します。

Gatewayの作成時にリソースゲートウェイ経由でKeycloakのdiscovery URLを取得して検証し、CA証明書がないとここでFAILEDになる。呼び出し時はtoken関数で取得したトークンを付けてtools/listを呼び出し、GatewayがJWTの署名とaudを確認して空のツール一覧を返す流れの図

Gatewayの作成
AUTHZ=$(jq -n \
  --arg url "$DISCOVERY_URL" --argjson pe "$PE" \
  --arg ca "s3://$B/ca/private-ca.pem" --arg owner "$ACCOUNT" '{
    customJWTAuthorizer: {
      discoveryUrl: $url,
      allowedAudience: ["agentcore-gateway"],
      privateEndpoint: $pe,
      certificateConfigurations: [{s3: {uri: $ca, bucketOwnerAccountId: $owner}}]
    }}')

# 作成したGatewayのIDを控えて、呼び出しと後片付けで使う
GW_ID=$(aws bedrock-agentcore-control create-gateway \
  --name private-ca-inbound \
  --protocol-type MCP \
  --role-arn "$GW_ROLE" \
  --authorizer-type CUSTOM_JWT \
  --authorizer-configuration "$AUTHZ" \
  --query gatewayId --output text)

READY になるまで2分ほど待ってからトークンを付けて tools/list を呼び出します。ターゲットは登録していないのでJWTの検証が通れば空のツール一覧が返ってきます。

Gatewayの呼び出し
GW_URL=$(aws bedrock-agentcore-control get-gateway --gateway-identifier "$GW_ID" \
  --query gatewayUrl --output text)

curl -s -X POST "$GW_URL" \
  -H "Authorization: Bearer $(token)" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/list"}'
実行結果
{"jsonrpc":"2.0","id":1,"result":{"tools":[]}}

JWTの検証が通って応答が返ってきました!!

なら今度は証明書更新の時を考えてみましょう。

CA証明書を入れ替える

証明書更新時の入れ替えは気になりますよね!
新旧のCAをまとめたPEMを使って、公式ブログで紹介されている下記3ステップの入れ替えを試してみます。

https://aws.amazon.com/blogs/machine-learning/private-certificate-authority-support-in-amazon-bedrock-agentcore-identity/

PEMを旧CAと新CAにして更新する。Keycloakの証明書を新CAのものに差し替えてから最後にPEMを新CAだけにして更新する3ステップの図。更新時にcertificateConfigurationsを省くとCAの設定が外れる

AgentCore IdentityはPEMの中身を作成・更新のときに読み取って保存するため、S3のファイルを書き換えたあとに更新APIも呼び出します。まずは新しいCAを作り、旧CAとまとめたPEMで更新します。

新旧のCAをまとめて更新
OUT=certs-new CA_NAME="Demo Private Root CA 2" ./certs.sh
cat certs/ca.pem certs-new/ca.pem > certs/bundle.pem
aws s3 cp certs/bundle.pem s3://$B/ca/private-ca.pem

# 作成時と同じ設定(certificateConfigurations を含む)で更新する
aws bedrock-agentcore-control update-oauth2-credential-provider \
  --name keycloak-private-ca \
  --credential-provider-vendor CustomOauth2 \
  --oauth2-provider-config-input "$CONFIG"

M2Mのトークンは有効期限(今回は5分)の間は同じものが返ってくるので、デコードした iat(発行時刻)で新しく発行されたトークンか確かめながら進めました。

更新は十数秒で READY に戻り、Keycloakの証明書を新しいCAで署名したものに差し替えた後も新しく発行されたトークンを取得できました。

最後に信頼するCAを新しいCAだけにして更新した後も新しいトークンを取得できたので、新しいCAへ問題なく切り替えることができます!

Keycloakの証明書の差し替えと新しいCAだけでの更新
Keycloakの証明書の差し替え
# EC2を作り直しても新しい証明書で起動できるよう、初回起動と同じ server/server.pem を上書きする
aws s3 cp certs-new/server.pem s3://$B/server/server.pem
aws secretsmanager put-secret-value --secret-id private-ca-demo/keycloak-server-key \
  --secret-string file://certs-new/server.key
CID=$(aws ssm send-command --instance-ids "$KC_ID" --document-name AWS-RunShellScript \
  --parameters "commands=[\"aws s3 cp s3://$B/server/server.pem /opt/kc/tls/server.pem\",\"aws secretsmanager get-secret-value --region $AWS_REGION --secret-id private-ca-demo/keycloak-server-key --query SecretString --output text > /opt/kc/tls/server.key\",\"chown -R 1000:1000 /opt/kc\",\"docker restart keycloak\"]" \
  --query Command.CommandId --output text)
aws ssm wait command-executed --command-id "$CID" --instance-id "$KC_ID"

# 差し替え前と違うiatなら新しく発行されたトークン(同じiatはキャッシュなので5分ほど待って再実行する)
claims | grep '"iat"'
新しいCAだけでの更新
# 新しいiatのトークンを確認できてから旧CAを外す
aws s3 cp certs-new/ca.pem s3://$B/ca/private-ca.pem
aws bedrock-agentcore-control update-oauth2-credential-provider \
  --name keycloak-private-ca \
  --credential-provider-vendor CustomOauth2 \
  --oauth2-provider-config-input "$CONFIG"

# READY に戻ってから、同じように新しいiatのトークンを確認する
claims | grep '"iat"'

後片付け

Gatewayと認証情報プロバイダーを削除してからCDKのスタックを削除し、Secrets Managerに登録した秘密鍵とLambdaのロググループも消します。

後片付け
aws bedrock-agentcore-control delete-gateway --gateway-identifier "$GW_ID"
for p in keycloak-private-ca keycloak-no-ca; do
  aws bedrock-agentcore-control delete-oauth2-credential-provider --name "$p"
done
# サーバー証明書を渡すパターンも試した場合だけ実行する
# aws bedrock-agentcore-control delete-oauth2-credential-provider --name keycloak-leaf-cert
aws bedrock-agentcore-control delete-workload-identity --name private-ca-demo-agent
# スタックを削除する前にLambdaの関数名を控えて、残るロググループを特定する
FNS=$(aws cloudformation describe-stack-resources --stack-name PrivateCaIdp \
  --query "StackResources[?ResourceType=='AWS::Lambda::Function'].PhysicalResourceId" --output text)
(cd cdk && pnpm cdk destroy PrivateCaIdp)
aws secretsmanager delete-secret --secret-id private-ca-demo/keycloak-server-key \
  --force-delete-without-recovery
for fn in $FNS; do
  aws logs delete-log-group --log-group-name "/aws/lambda/$fn"
done

リソースゲートウェイのENIはプロバイダーとGatewayの削除から1分以内に自動で消えました。

おわりに

内部ALBと公開ドメインを用意していた以前と比べてPEMを置いて参照するだけで済むのは良いなと思いました!ちょっとニッチなアップデートではありますが、社内のネットワークで使用しているIdPなどでは活用できるかと思います!

本記事が少しでも参考になりましたら幸いです。最後までご覧いただきありがとうございました!

この記事をシェアする

AWSのお困り事はクラスメソッドへ

関連記事