![[アップデート] Amazon Bedrock AgentCore Identityがプライベート認証局(CA)に対応しました!](https://devio2024-media.developers.io/image/upload/f_auto,q_auto/c_limit,w_1200/v1790875048/eyecatch/edq4dfptctqlcwjhffhs.png)
[アップデート] Amazon Bedrock AgentCore Identityがプライベート認証局(CA)に対応しました!
はじめに
こんにちは、チーズナンが好きなコンサル部の神野です。
Amazon Bedrock AgentCore Identityがプライベート認証局(CA)の発行した証明書に対応しました!
ちょっとニッチなアップデートですが、社内で独自にIdPを管理して社内のCAで証明書を発行しているケースには嬉しいのではないでしょうか!
先月のGatewayのターゲットに続くIdentity側のアップデートなので、主な変更点をまとめてVPC内のKeycloakにつないでみます。
あれ、前回と何が違うの・・・?前もプライベートCAに対応していなかった?と思った方もいるかもしれません・・・!!
前回はGatewayがMCPサーバーなどのターゲットに接続するときの話で、今回はAgentCore IdentityやGatewayのJWT認可がIdPに接続するときの話です。接続先がターゲットかIdPかの違いですね。

主な変更点
これまではAgentCore IdentityがVPC Lattice経由でVPC内のIdPに接続する場合でも、IdPに公開CAの証明書が必要でした。
そのため、以前Keycloakで試した際は公開ドメインを取得してACMの公開証明書を付けた内部ALBをKeycloakの前に置いていました。
今回からはCA証明書のPEM(テキスト形式の証明書ファイル)をS3かSecrets Managerに置いて参照するだけでプライベートCAの証明書のままIdPに直接つなげます!TLSを終端するためだけのALBや公開ドメインを用意しなくて済むのは嬉しいですね。

対象はエージェントが外部のサービスを呼び出すためにIdPからトークンを取得するカスタムのOAuth 2.0認証情報プロバイダー(アウトバウンド認証)です。
CAはAWS Private CA・社内のCA・自己署名のルートCAのどれでも使えます。
公式ブログではRuntimeやGatewayへの呼び出しをJWTで検証する認可(インバウンド認証)でも同じ設定ができると紹介されているので、今回はGatewayでこちらも試してみます。
ちなみに、新旧のCA証明書を1つのPEMにまとめればダウンタイムを抑えて入れ替えられます。
参照を外して更新すればプライベートCAの信頼も削除できます。
前提
今回は下記構成図のように検証を行います!

プライベートサブネットの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で実行します。検証に使ったコードは次のリポジトリに置いています。
リポジトリの主なファイルは次のとおりです。
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のホスト名を入れたサーバー証明書を作ります。
# プライベート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の起動時に取得します。

// 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
# 後続のコマンドで使う値をスタックの出力から読み込む
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を渡します。
各項目の意味合いは次の図のとおりです。

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証明書の参照も保存されていました。
{
"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を順に呼び出します。

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」というエラーで作成のリクエスト自体が通りません。

certificateConfigurations を省いてもプロバイダーは READY になるので、作成後は一度トークンを取得してKeycloakに接続できるところまで確かめておくと安心ですね。
GatewayのJWT認可(インバウンド認証)でも試す
Gatewayの認可設定(customJWTAuthorizer)にもプロバイダーと同じ形で certificateConfigurations を追加できます!
許可するaudienceにはレルムの定義でトークンに入れた agentcore-gateway を指定し、さきほどのプロバイダーで取得したトークンをそのままGatewayの呼び出しに使います。Gatewayは作成時にdiscovery URLを取得して検証し、呼び出し時にはJWTの署名とaudを確認します。

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の検証が通れば空のツール一覧が返ってきます。
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ステップの入れ替えを試してみます。

AgentCore IdentityはPEMの中身を作成・更新のときに読み取って保存するため、S3のファイルを書き換えたあとに更新APIも呼び出します。まずは新しいCAを作り、旧CAとまとめたPEMで更新します。
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だけでの更新
# 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"'
# 新しい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などでは活用できるかと思います!
本記事が少しでも参考になりましたら幸いです。最後までご覧いただきありがとうございました!









