
IAM Access Troubleshooter で AccessDenied の認可 ID から拒否したポリシーを特定してみた
はじめに
2026年11月17日、IAM に Access Troubleshooter が追加されました。
Access Troubleshooter は、対応するサービスと API の AccessDenied エラーに一意の識別子(認可 ID)を付ける機能です。この ID を使うと、評価されたポリシー、認可コンテキスト、評価結果を取得できます。
この記事では、検証用ロールに明示的な Deny を付けて拒否を起こし、認可 ID から拒否したポリシーと拒否時点のポリシー文書を取得しました。
検証の前提
AWS CLI は 2.41.0 を使いました。認可評価の詳細の取得には、aws iam-toolbox サブコマンドを使います。
取得 API を呼ぶ資格情報には、IAM User Guide の記載では次の IAM 権限が必要です。
- iam:GetRequestAuthorizationDetails(評価の詳細の取得)
- iam:GetRequestAuthorizationPolicy(ポリシー文書の取得)
拒否の再現
信頼ポリシーと Deny ポリシーを用意して、検証用ロールを作ります。Deny ポリシーは、iam:ListRoles を含む読み取り API 4つを1つの statement でまとめて拒否します。
trust-policy.json と deny-policy.json
trust-policy.json(<ACCOUNT_ID> は自分のアカウント ID に置き換えます)
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": { "AWS": "arn:aws:iam::<ACCOUNT_ID>:root" },
"Action": "sts:AssumeRole"
}
]
}
deny-policy.json
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "DenyReadApis",
"Effect": "Deny",
"Action": [
"sqs:ListQueues",
"ec2:DescribeInstances",
"iam:ListRoles",
"kms:ListKeys"
],
"Resource": "*"
}
]
}
aws iam create-role --role-name access-troubleshooter-test --assume-role-policy-document file://trust-policy.json
aws iam put-role-policy --role-name access-troubleshooter-test --policy-name DenyReadApis --policy-document file://deny-policy.json
Deny はロールに付いているので、拒否を起こすコマンドはロールの一時資格情報で実行します。
aws sts assume-role --role-arn arn:aws:iam::<ACCOUNT_ID>:role/access-troubleshooter-test --role-session-name denied-test --duration-seconds 900
返ってきた一時資格情報を環境変数 AWS_ACCESS_KEY_ID、AWS_SECRET_ACCESS_KEY、AWS_SESSION_TOKEN に設定しました。その状態で aws iam list-roles を実行すると、次の AccessDenied エラーが返りました。認可 ID は AWS ドキュメントの例示値に置き換えています。
aws: [ERROR]: An error occurred (AccessDenied) when calling the ListRoles operation: User: arn:aws:sts::111122223333:assumed-role/access-troubleshooter-test/denied-test is not authorized to perform: iam:ListRoles on resource: arn:aws:iam::111122223333:role/ with an explicit deny in an identity-based policy. Go to https://us-east-1.console.aws.amazon.com/iam/home?region=us-east-1#/authorization-details/EXAMPLE1a2b3c4d5e6f7g8h9i0j for complete details, or call the GetRequestAuthorizationDetails API with the following authorization id: EXAMPLE1a2b3c4d5e6f7g8h9i0j
拒否したのはロールのインラインポリシーです。エラー文にポリシーの ARN は出ませんでした。
認可評価の詳細の取得
一時資格情報の環境変数を unset して元の資格情報に戻し、get-request-authorization-details を呼びます。
取得 API は、拒否が起きたリージョンで呼びます。今回はエラー文のコンソール URL が us-east-1 だったので、--region us-east-1 を指定しました。<authorization-id> には、エラー文の認可 ID を入れます。
aws iam-toolbox get-request-authorization-details --region us-east-1 --authorization-id <authorization-id>
拒否の5秒後にこのコマンドを実行すると、ResourceNotFoundException が返りました。拒否の約1分後に同じ認可 ID で再実行すると、取得できました。最初の例外の原因は ID の誤りではないので、拒否の直後に返ったときは、時間を置いて再実行します。
応答の evaluations には、iam:ListRoles の評価1件が入っていて、evaluatedEffect は EXPLICIT_DENY です。この評価の checks は5件です。
| checkType | 対象 | evaluatedEffect | 一致したポリシー |
|---|---|---|---|
| SERVICE_CONTROL_POLICY | root | ALLOW | p-FullAWSAccess |
| SERVICE_CONTROL_POLICY | OU | ALLOW | p-FullAWSAccess |
| SERVICE_CONTROL_POLICY | アカウント | ALLOW | p-FullAWSAccess |
| PRINCIPAL | - | EXPLICIT_DENY | inline:6111414566fd200b |
| SESSION | - | ALLOW | inline:5904601e6713d7c1 |
検証アカウントは AWS Organizations に所属しているため、SCP のチェックが並んでいます。
拒否したポリシーを特定するには、evaluatedEffect が EXPLICIT_DENY のチェックを探し、その matchedPolicies を見ます。今回は PRINCIPAL のチェックです。
{
"checkType": "PRINCIPAL",
"evaluatedEffect": "EXPLICIT_DENY",
"relevantPolicyTypes": [
"IDENTITY_BASED_POLICY"
],
"matchedPolicies": [
{
"uri": "inline:6111414566fd200b",
"matchedStatements": [
{
"sid": "DenyReadApis",
"evaluatedEffect": "DENY"
}
]
}
]
}
uri は拒否したポリシーの識別子、sid は拒否した statement の Sid です。
拒否したポリシーの uri は ARN ではなく、インラインポリシーに AWS が付けた識別子です。応答の policies には同じ uri の項目があり、attachedTo からアタッチ先のロールが分かります。
{
"type": "IDENTITY_BASED_POLICY",
"inline": true,
"uri": "inline:6111414566fd200b",
"attachedTo": [
{
"arn": "arn:aws:iam::111122223333:role/access-troubleshooter-test"
}
]
}
拒否時点のポリシー文書の取得
get-request-authorization-policy に、認可 ID と policies の uri を渡します。<policy-uri> には、拒否したポリシーの uri(今回は inline:6111414566fd200b)を入れます。
aws iam-toolbox get-request-authorization-policy --region us-east-1 --authorization-id <authorization-id> --policy-uri <policy-uri>
{
"policyDocument": {
"Version": "2012-10-17",
"Statement": [
{
"Sid": "DenyReadApis",
"Effect": "Deny",
"Action": [
"sqs:ListQueues",
"ec2:DescribeInstances",
"iam:ListRoles",
"kms:ListKeys"
],
"Resource": "*"
}
]
}
}
policyDocument は、ロールに付けた deny-policy.json と同じ内容でした。
まとめ
Access Troubleshooter は、AccessDenied エラーに付く認可 ID から、評価されたポリシーと各チェックの結果、拒否時点のポリシー文書を取得できる機能です。
iam:ListRoles への明示的な Deny では、PRINCIPAL チェックから拒否したインラインポリシーと statement の Sid を特定できました。
IAM のアクセス拒否が発生したときに、クライアント側に返る認可 ID をエラーメッセージなどから特定できれば、IAM Access Troubleshooter で原因調査を効率的に進められる可能性があります。ぜひお試しください。











