
Amazon ECR のプライベートレジストリがサポートしたグローバル認証トークンを試してみた
はじめに
2026-11-17 に、Amazon ECR のプライベートレジストリでグローバル認証トークンが使えるようになりました。
この記事では、us-east-1 で発行したトークンを ap-northeast-1 と eu-west-1 のレジストリで使いました。
トークンの発行
AWS CLI 2.41.0 と Docker 29.9.3 で試しました。発行には aws signin create-bearer-token を使います。
aws signin create-bearer-token \
--grant-type client_credentials \
--resource ecr.amazonaws.com \
--region us-east-1 \
--output json > /tmp/ecr-verify/token-default.json
保存した応答です。accessToken は長さだけ残して伏せています。
{
"accessToken": "<REDACTED len=3419>",
"tokenType": "Bearer",
"expiresIn": 43199
}
--region にはトークンを発行するリージョンを指定します。ここでは、2つのレジストリのリージョンとは別の us-east-1 にしました。expiresIn は12時間より1秒短い 43199 になりました。
発行に必要な IAM ポリシーは User Guide に記載されています。push や pull を行う場合は、これとは別に ECR の権限も必要です。
発行を許可する IAM ポリシー
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "CreateECRGlobalToken",
"Effect": "Allow",
"Action": "signin:CreateBearerToken",
"Resource": "arn:aws:signin:*:*:service-principal/ecr.amazonaws.com"
}
]
}
複数リージョンのレジストリでの利用
同じトークンを使って、ap-northeast-1 と eu-west-1 の2つのレジストリに docker login します。
jq -r .accessToken /tmp/ecr-verify/token-default.json | docker login --username AWS --password-stdin <ACCOUNT_ID>.dkr.ecr.ap-northeast-1.amazonaws.com
jq -r .accessToken /tmp/ecr-verify/token-default.json | docker login --username AWS --password-stdin <ACCOUNT_ID>.dkr.ecr.eu-west-1.amazonaws.com
どちらのレジストリでも Login Succeeded となり、v1 タグの push と pull も成功しました。
eu-west-1 のレジストリからの pull は、push 済みの v1 イメージをローカルから docker rmi で削除してから実行しました。
docker rmi <ACCOUNT_ID>.dkr.ecr.ap-northeast-1.amazonaws.com/ecr-global-token-test-a:v1 <ACCOUNT_ID>.dkr.ecr.eu-west-1.amazonaws.com/ecr-global-token-test-b:v1
docker pull <ACCOUNT_ID>.dkr.ecr.eu-west-1.amazonaws.com/ecr-global-token-test-b:v1
Untagged: <ACCOUNT_ID>.dkr.ecr.ap-northeast-1.amazonaws.com/ecr-global-token-test-a:v1
Untagged: <ACCOUNT_ID>.dkr.ecr.eu-west-1.amazonaws.com/ecr-global-token-test-b:v1
Deleted: sha256:5099b89d7666cc2186cad769ddc262ddc7c335b33f5fe79f9ffe50a01282b23e
v1: Pulling from ecr-global-token-test-b
58dee6a49ef1: Pulling fs layer
58dee6a49ef1: Download complete
58dee6a49ef1: Pull complete
Digest: sha256:5099b89d7666cc2186cad769ddc262ddc7c335b33f5fe79f9ffe50a01282b23e
Status: Downloaded newer image for <ACCOUNT_ID>.dkr.ecr.eu-west-1.amazonaws.com/ecr-global-token-test-b:v1
<ACCOUNT_ID>.dkr.ecr.eu-west-1.amazonaws.com/ecr-global-token-test-b:v1
まとめ
Amazon ECR のプライベートレジストリで、グローバル認証トークンを試しました。発表によると、AWS Sign-In の CreateBearerToken で発行した1つのトークンを、同一パーティションの複数の ECR プライベートレジストリに対して利用できます。
マルチリージョンに展開するサービスでは、これまでリージョンごとのレジストリに個別の認証が必要でした。グローバル認証トークンにより、1回の認証で複数リージョンのレジストリを操作できます。








