Amazon ECR のプライベートレジストリがサポートしたグローバル認証トークンを試してみた

Amazon ECR のプライベートレジストリがサポートしたグローバル認証トークンを試してみた

us-east-1 で発行した1つのトークンで、ap-northeast-1 と eu-west-1 のプライベートレジストリに docker login、push、pull できました。トークンの発行手順と、複数リージョンでの使い方を紹介します。
2026.11.20

はじめに

2026-11-17 に、Amazon ECR のプライベートレジストリでグローバル認証トークンが使えるようになりました。

https://aws.amazon.com/jp/about-aws/whats-new/2026/11/global-authentication-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 の権限も必要です。

https://docs.aws.amazon.com/AmazonECR/latest/userguide/registry_auth.html

発行を許可する 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回の認証で複数リージョンのレジストリを操作できます。

この記事をシェアする

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

関連記事