[アップデート] AWS STS の GetScopedCredentials で権限と有効期間を絞った認証情報を作ってみた
はじめに
2026 年 11 月 19 日、AWS STS に新規 API GetScopedCredentials が追加されました。
現状で使っている一時認証情報から、権限や有効期間を絞った認証情報を作れる API です。ロールを引き受け直すわけではないので、ID はそのままに権限だけを減らせます。
「AI エージェント向けに必要な権限だけを持つ認証情報を渡す」というのがユースケースとして想定されているようです。
この記事では、実際に AWS CLI から GetScopedCredentials を呼び出し、権限と有効期間がどう絞られるのかを確かめてみます。
GetScopedCredentials の特徴
これまでも、AssumeRole にセッションポリシーを渡せば権限を絞った一時認証情報を作れました。ドキュメントを読むと、GetScopedCredentials とは次の点が異なるようです。
| 項目 | AssumeRole とセッションポリシー | GetScopedCredentials |
|---|---|---|
| 呼び出しに使える認証情報 | IAM ユーザーや一時認証情報 | 一時認証情報だけ |
| 結果の ID | 引き受けたロールのセッション | 呼び出し元と同じセッション |
| ポリシーを重ねたとき | 前のセッションポリシーを置き換える | 前の絞り込みに重ねる。最大 3 層 |
| 有効期間の上限 | ロールチェーンでは 1 時間 | 呼び出し元のセッションの残り時間 |
IAM ユーザーの認証情報を絞りたい場合は、先に GetSessionToken で一時認証情報を取得してから呼び出します。
呼び出し元には sts:GetScopedCredentials の許可が必要です。また、グローバルエンドポイントの sts.amazonaws.com では使えず、リージョンのエンドポイントを使う必要があります。
試しにグローバルエンドポイントを指定してみると、次のエラーが返りました。
aws sts get-scoped-credentials --duration-seconds 300 \
--endpoint-url https://sts.amazonaws.com --region us-east-1
aws: [ERROR]: An error occurred (InvalidAction) when calling the GetScopedCredentials operation: Operation not supported on STS global endpoint
特定のバケットの読み取りだけに絞る
まずは、管理者権限を持つロールのセッションから S3 バケット devio-gsc-e6fe0a41-a の読み取りだけができる認証情報を作ってみます。
検証用に、devio-gsc-e6fe0a41-a と devio-gsc-e6fe0a41-b の 2 つのバケットを用意し、それぞれに hello.txt を置きました。
絞り込みに使うポリシーは次の通りです。
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": ["s3:ListBucket", "s3:GetObject"],
"Resource": [
"arn:aws:s3:::devio-gsc-e6fe0a41-a",
"arn:aws:s3:::devio-gsc-e6fe0a41-a/*"
]
}
]
}
--policy にこのファイルを渡して呼び出します。--scoped-session-description には用途の説明を書いておけます。
aws sts get-scoped-credentials \
--policy file://read-bucket-a.json \
--scoped-session-description "read-only-bucket-a"
{
"Credentials": {
"AccessKeyId": "ASIA...",
"SecretAccessKey": "...",
"SessionToken": "IQoJb3JpZ2lu...",
"Expiration": "2026-11-20T10:54:41+00:00"
},
"SessionInfo": {
"ScopedSessionId": "AROAEXAMPLEID:my-session",
"Arn": "arn:aws:sts::123456789012:assumed-role/MyRole/my-session"
},
"SessionTokenUtilization": 18,
"SessionTokenSize": 752,
"ScopedPoliciesCount": 1
}
SessionInfo.Arn は、呼び出し元のセッションの ARN と同じでした。返ってきた認証情報を環境変数に入れて aws sts get-caller-identity を実行しても、呼び出し元と同じ ARN が返ります。
この認証情報で操作をいくつか試してみました。
| 操作 | 結果 |
|---|---|
devio-gsc-e6fe0a41-a の一覧の取得 |
成功 |
devio-gsc-e6fe0a41-a の hello.txt の取得 |
成功 |
devio-gsc-e6fe0a41-b の一覧の取得 |
AccessDenied |
devio-gsc-e6fe0a41-a へのアップロード |
AccessDenied |
ec2:DescribeRegions |
UnauthorizedOperation |
想定通り、ポリシーで許可した操作だけができるようになっています!
拒否されたときのエラーメッセージは次の通りでした。because no session policy allows とあるので、絞り込みのポリシーはセッションポリシーと同じ扱いで評価されているようです。
aws: [ERROR]: An error occurred (AccessDenied) when calling the ListObjectsV2 operation: User: arn:aws:sts::123456789012:assumed-role/MyRole/my-session is not authorized to perform: s3:ListBucket on resource: "arn:aws:s3:::devio-gsc-e6fe0a41-b" because no session policy allows the s3:ListBucket action
削除系の操作だけ外す
次は逆に、ほとんどの権限を残したまま一部の操作だけを外してみます。ドキュメントでも紹介されていた Allow と NotAction の組み合わせで書いてみました。
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"NotAction": [
"s3:DeleteObject",
"s3:DeleteBucket",
"ec2:TerminateInstances",
"sts:AssumeRole*"
],
"Resource": "*"
}
]
}
このポリシーで絞った認証情報では、次の通りになりました。
| 操作 | 結果 |
|---|---|
devio-gsc-e6fe0a41-a へのアップロード |
成功 |
devio-gsc-e6fe0a41-a のオブジェクトの削除 |
AccessDenied |
ec2:DescribeRegions |
成功 |
アップロードはできても、アップロードしたオブジェクトを削除することはできません。エージェントに作業させるときに「削除系だけはさせたくない」という場面で使えそうですね。
有効期間を短くする
--duration-seconds を指定すると、有効期間を短くできます。60 秒を指定して作った認証情報は、作成直後には使えましたが、60 秒以降には ExpiredToken で拒否されました。
aws: [ERROR]: An error occurred (ExpiredToken) when calling the ListObjectsV2 operation: The provided token has expired.
呼び出し元のセッションの残り時間より長い値は指定できません。上限の 129600 秒を指定してみると、InsufficientSessionLifetime が返りました。
エラーメッセージには、呼び出し元のセッションの残り時間も書かれています。
aws: [ERROR]: An error occurred (InsufficientSessionLifetime) when calling the GetScopedCredentials operation: The requested DurationSeconds exceeds the remaining lifetime of the calling session. Remaining session lifetime is 3593 seconds.
--duration-seconds を省略した場合は、Expiration が呼び出し元のセッションと同じ時刻になりました。
絞り込みを重ねてみる
GetScopedCredentials で作った認証情報から、重ねて GetScopedCredentials を呼び出すこともできます。ポリシーは前の絞り込みに重なっていくので、後からポリシーを広げても権限は戻らないはずです。
次の 3 層を順に重ねてみました。
| 層 | 許可した操作 |
|---|---|
| 1 | s3:* と sts:GetScopedCredentials |
| 2 | devio-gsc-e6fe0a41-a の読み取りと sts:GetScopedCredentials |
| 3 | 全ての操作 |
3 層目では全ての操作を許可していますが、devio-gsc-e6fe0a41-b の一覧の取得も ec2:DescribeRegions も拒否されました。2 層目までの絞り込みがそのまま残っていますね。
さらに 4 層目のポリシーを渡そうとすると上限に達してしまいました。
aws: [ERROR]: An error occurred (ValidationError) when calling the GetScopedCredentials operation: Credentials have reached the maximum scope down limit and cannot be scoped down further.
なお、上の検証で 1 層目と 2 層目に sts:GetScopedCredentials を入れていたのは、これがないと次の層を作れないためです。s3:* だけを許可した認証情報から呼び出すと、次のように拒否されました。
aws: [ERROR]: An error occurred (AccessDenied) when calling the GetScopedCredentials operation: User: arn:aws:sts::123456789012:assumed-role/MyRole/my-session is not authorized to perform: sts:GetScopedCredentials on resource: arn:aws:sts::123456789012:self because no session policy allows the sts:GetScopedCredentials action
エージェントに渡した認証情報から、サブエージェント用にさらに絞った認証情報を作らせたい場合は、sts:GetScopedCredentials を許可に含めておく必要があります。逆に、それ以上の絞り込みをさせたくない場合は含めなければ良さそうです。
おわりに
GetScopedCredentials を使うと、今のセッションの ID を保ったまま、権限と有効期間だけを絞った認証情報を簡単に作れました。ロールを新しく用意しなくても、エージェントに渡す前に権限を減らせるのは便利ですね。
一方で、絞り込みは 3 層までで、重ねるには sts:GetScopedCredentials の許可を残しておく必要があります。エージェントとサブエージェントの階層を設計するときは、どの層で何を絞るかを先に決めておくのが良さそうです。







