IAM Access Troubleshooter で AccessDenied の認可 ID から拒否したポリシーを特定してみた

IAM Access Troubleshooter で AccessDenied の認可 ID から拒否したポリシーを特定してみた

AWS IAM の Access Troubleshooter を試しました。AccessDenied エラーの認可 ID から、拒否したポリシーと statement、各チェックの結果、拒否時点のポリシー文書を取得できました。
2026.11.19

はじめに

2026年11月17日、IAM に Access Troubleshooter が追加されました。

https://aws.amazon.com/jp/about-aws/whats-new/2026/11/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(ポリシー文書の取得)

https://docs.aws.amazon.com/IAM/latest/UserGuide/troubleshoot_access-denied-authorization-id.html

拒否の再現

信頼ポリシーと 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 で原因調査を効率的に進められる可能性があります。ぜひお試しください。

この記事をシェアする

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

関連記事