
AWS STS の GetScopedCredentials で一時認証情報の権限とセッション期間を絞ってみた
はじめに
2026年11月19日、AWS STS の GetScopedCredentials が発表されました。
この API は、既存の一時認証情報から、権限、セッション期間、またはその両方を絞った認証情報を発行します。この記事では AWS CLI で認証情報を発行し、絞った認証情報の動作と CloudTrail の記録を確認しました。
検証環境
| 項目 | 内容 |
|---|---|
| AWS CLI | aws-cli/2.41.2 |
| リージョン | ap-northeast-1 |
| 呼び出し元 | S3 のバケット一覧、EC2 のリージョン一覧、CloudTrail の lookup-events を実行できる IAM ロールのセッション(assumed-role) |
GetScopedCredentials は、引き受けたロールやフェデレーションのセッションなどの一時認証情報で呼びます。IAM ユーザーの長期認証情報から絞りたい場合は、GetSessionToken で一時認証情報を取得してから呼びます。グローバルエンドポイントでは使えないため、リージョナルエンドポイントを指定します。
認証情報の受け渡し
発行された JSON はシェル変数に格納し、次の関数 with_creds で、その認証情報をサブシェルの中だけで設定してコマンドを実行します。リージョンは環境変数で ap-northeast-1 に固定します。
環境変数の変更はサブシェルの中で完結するので、元のシェルの認証情報は変わりません。そのため、次の発行も呼び出し元の認証情報で続けられます。この関数は jq を使います。
export AWS_REGION=ap-northeast-1 AWS_DEFAULT_REGION=ap-northeast-1
with_creds() {
local json="$1"; shift
(
unset AWS_PROFILE
AWS_ACCESS_KEY_ID="$(jq -r .Credentials.AccessKeyId <<<"$json")"
AWS_SECRET_ACCESS_KEY="$(jq -r .Credentials.SecretAccessKey <<<"$json")"
AWS_SESSION_TOKEN="$(jq -r .Credentials.SessionToken <<<"$json")"
export AWS_ACCESS_KEY_ID AWS_SECRET_ACCESS_KEY AWS_SESSION_TOKEN
"$@"
)
}
権限を絞る
S3 のバケット一覧だけを許可するポリシーを、policy-s3-list.json として保存します。
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": "s3:ListAllMyBuckets",
"Resource": "*"
}
]
}
発行の前に、呼び出し元の ARN とセッションの期限を確認しておきます。
aws sts get-caller-identity
{
"UserId": "<ROLE_ID>:<SESSION_NAME>",
"Account": "<ACCOUNT_ID>",
"Arn": "arn:aws:sts::<ACCOUNT_ID>:assumed-role/<ROLE_NAME>/<SESSION_NAME>"
}
aws configure export-credentials --format process | jq -r .Expiration
2026-11-20T03:08:25+00:00
このポリシーを --policy に、用途を示す文字列を --scoped-session-description に渡して発行します。
CREDS=$(aws sts get-scoped-credentials \
--policy file://policy-s3-list.json \
--scoped-session-description devio-verify-1120-step1 \
--output json)
CREDS には次の JSON が入ります。
{
"Credentials": {
"AccessKeyId": "<masked>",
"SecretAccessKey": "<masked>",
"SessionToken": "<masked>",
"Expiration": "2026-11-20T03:08:25+00:00"
},
"SessionInfo": {
"ScopedSessionId": "<ROLE_ID>:<SESSION_NAME>",
"Arn": "arn:aws:sts::<ACCOUNT_ID>:assumed-role/<ROLE_NAME>/<SESSION_NAME>"
},
"SessionTokenUtilization": 18,
"SessionTokenSize": 760,
"ScopedPoliciesCount": 1
}
--duration-seconds を省略したため、Expiration は呼び出し元セッションの期限と同じ値になっています。
絞った認証情報で、ARN の確認、ポリシーで許可した操作、ポリシーで許可していない操作を順に実行します。
with_creds "$CREDS" aws sts get-caller-identity
{
"UserId": "<ROLE_ID>:<SESSION_NAME>",
"Account": "<ACCOUNT_ID>",
"Arn": "arn:aws:sts::<ACCOUNT_ID>:assumed-role/<ROLE_NAME>/<SESSION_NAME>"
}
with_creds "$CREDS" aws s3api list-buckets --query 'length(Buckets)'
95
with_creds "$CREDS" aws ec2 describe-regions --query 'length(Regions)'
aws: [ERROR]: An error occurred (UnauthorizedOperation) when calling the DescribeRegions operation: You are not authorized to perform this operation. User: arn:aws:sts::<ACCOUNT_ID>:assumed-role/<ROLE_NAME>/<SESSION_NAME> is not authorized to perform: ec2:DescribeRegions because no session policy allows the ec2:DescribeRegions action
絞った認証情報の ARN は呼び出し元と同じままで、権限はポリシーで許可した操作だけに限られました。
セッション期間を絞る
--duration-seconds だけを指定すると、権限は変えずに期間を短くできます。
SHORT=$(aws sts get-scoped-credentials \
--duration-seconds 900 \
--output json)
呼び出し時刻は 2026-11-20T02:32:22Z で、応答の Expiration は 2026-11-20T02:47:22+00:00、つまり 900秒後でした。ポリシーを省略したので、ScopedPoliciesCount は 0 です。
S3 のバケット一覧と、前節で拒否された EC2 のリージョン一覧を取得します。
with_creds "$SHORT" aws s3api list-buckets --query 'length(Buckets)'
with_creds "$SHORT" aws ec2 describe-regions --query 'length(Regions)'
95
17
権限は呼び出し元のままなので、どちらも成功しました。
呼び出し元を超えない
絞った認証情報から、さらに GetScopedCredentials を呼ぶこともできます。この節では、呼び出し元から発行した認証情報を「親」、親から発行した認証情報を「子」と呼びます。
親の認証情報から子を発行するには、親のポリシーで sts:GetScopedCredentials を許可する必要があります。そこで親には、S3 のバケット一覧と sts:GetScopedCredentials を許可するポリシーを指定し、期間を 900秒にします。ポリシーは policy-parent-s3-list-and-scope.json として保存します。
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"s3:ListAllMyBuckets",
"sts:GetScopedCredentials"
],
"Resource": "*"
}
]
}
子には、S3 のバケット一覧に加えて EC2 のリージョン一覧も許可する、親より広いポリシーを指定します。--duration-seconds は省略します。
子のポリシー(policy-s3-list-ec2-regions.json)
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"s3:ListAllMyBuckets",
"ec2:DescribeRegions"
],
"Resource": "*"
}
]
}
PARENT=$(aws sts get-scoped-credentials \
--policy file://policy-parent-s3-list-and-scope.json \
--duration-seconds 900 \
--scoped-session-description devio-verify-1120-step4b-parent \
--output json)
CHILD=$(with_creds "$PARENT" aws sts get-scoped-credentials \
--policy file://policy-s3-list-ec2-regions.json \
--scoped-session-description devio-verify-1120-step4b-child \
--output json)
親と子の Expiration はどちらも 2026-11-20T02:47:48+00:00 で、子は親の期限を継承しました。ScopedPoliciesCount は親が 1、子が 2 です。
子の認証情報で、子と親の両方が許可する S3 のバケット一覧と、子だけが許可する EC2 のリージョン一覧を取得します。
with_creds "$CHILD" aws s3api list-buckets --query 'length(Buckets)'
with_creds "$CHILD" aws ec2 describe-regions --query 'length(Regions)'
95
aws: [ERROR]: An error occurred (UnauthorizedOperation) when calling the DescribeRegions operation: You are not authorized to perform this operation. User: arn:aws:sts::<ACCOUNT_ID>:assumed-role/<ROLE_NAME>/<SESSION_NAME> is not authorized to perform: ec2:DescribeRegions because no session policy allows the ec2:DescribeRegions action
子に親より広いポリシーを指定しても、権限は親の範囲に収まりました。
期間の上限も親の残り時間です。親の認証情報から --duration-seconds 3600 で発行しようとすると、拒否されました。
with_creds "$PARENT" aws sts get-scoped-credentials --duration-seconds 3600
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 898 seconds.
CloudTrail の記録
最後の呼び出しから約10分後に、lookup-events で検索しました。
aws cloudtrail lookup-events \
--lookup-attributes AttributeKey=EventName,AttributeValue=GetScopedCredentials \
--max-results 20
検証で実行した GetScopedCredentials の呼び出しは、いずれも管理イベントとして記録されていました。managementEvent は true、eventCategory は Management でした。期間超過で拒否された呼び出しも、errorCode が InsufficientSessionLifetimeException のイベントとして含まれています。
requestParameters には、指定した policy の全文と scopedSessionDescription が記録されます。「権限を絞る」の節で発行したときの記録は次のとおりです。
{
"policy": "{\n \"Version\": \"2012-10-17\",\n \"Statement\": [\n {\n \"Effect\": \"Allow\",\n \"Action\": \"s3:ListAllMyBuckets\",\n \"Resource\": \"*\"\n }\n ]\n}\n",
"scopedSessionDescription": "devio-verify-1120-step1"
}
期間を指定した呼び出しでは、durationSeconds も記録されます。
成功した発行イベントの responseElements.credentials には、accessKeyId、sessionToken、expiration が入っています。secretAccessKey は含まれません。
絞った認証情報で実行した操作のイベントは、userIdentity のうち arn、principalId、sessionContext が呼び出し元と同じです。accessKeyId だけが異なります。次の表は、「権限を絞る」の節での発行と、発行した認証情報で実行した S3・EC2 の操作のイベントです。
| 時刻 | イベント名 | accessKeyId | errorCode |
|---|---|---|---|
| 02:32:00Z | GetScopedCredentials | 呼び出し元のキー | |
| 02:32:01Z | ListBuckets | 発行されたキー | |
| 02:32:02Z | DescribeRegions | 発行されたキー | Client.UnauthorizedOperation |
ListBuckets と DescribeRegions の accessKeyId は、発行イベントの responseElements に記録された accessKeyId と一致しました。この一致から、「権限を絞る」の節で発行した認証情報の操作イベントを、発行イベントに結び付けられました。発行イベントには scopedSessionDescription とポリシー全文が記録されているので、発行の用途と権限も確認できます。
まとめ
GetScopedCredentials で、既存の一時認証情報から、権限や期間を絞った認証情報を発行できるようになりました。
発行の呼び出しは CloudTrail に管理イベントとして記録され、発行した認証情報の操作イベントを発行イベントに結び付けられました。
特定の作業を実施するサブエージェントやサブタスクなどのワークロードに、権限を最小限に絞って与える手段としてご活用ください。







