Amazon Cognito の CloudTrail イベントで HIDDEN_DUE_TO_SECURITY_REASONS になったユーザーを sub から特定してみた
こんにちは!クラスメソッドオペレーションズ AWS テクニカルサポートチームの大高です。
Amazon Cognito ユーザープールの管理操作を CloudTrail で確認していたときに、操作の対象になったユーザーをどう調べればいいのか迷いました。
Cognito の認証ログにユーザー名が記録されないことは、次の記事で紹介されています。
今回は管理 API の操作について、AdminDisableUser などのイベントから、操作の対象になったユーザーを特定できるかを実際に試してみたいと思います。
やりたいこと
Cognito ユーザープールで AdminDisableUser などの管理 API を実行すると、その操作が CloudTrail にイベントとして記録されます。
このイベントから操作の対象になったユーザーを特定しようとしたのですが、requestParameters の username が HIDDEN_DUE_TO_SECURITY_REASONS になっていました。
対応方法
イベントの additionalEventData に記録されている sub(ユーザーごとに一意な ID)を使って、ListUsers API でユーザーを検索します。
公式ドキュメントには、イベントにユーザー名の代わりに UserSub(ユーザーの sub 属性の値)が記録されると書かれています。
あわせて、ListUsers API で sub をフィルターに指定すれば、ユーザーを見つけられるとも書かれています。
ユーザー固有のリクエストについて、Amazon Cognito は CloudTrail ログに UserSub を記録しますが、UserName は記録しません。
ListUsers API を呼び出し、sub のフィルターを使用することで、所定の UserSub のユーザーを見つけることができます。
ここで気になったのが、sub がイベントのどのフィールドに入っているのかです。
同じページを見てみると、CloudWatch Logs Insights のクエリ例で additionalEventData.sub が使われていました。
Amazon Cognito ユーザープール sub と共に、最近追加されたエラーコード NotAuthorizedException を伴う 25 件のログイベントを検索します。
fields @timestamp, additionalEventData.sub as user | sort @timestamp desc | limit 25 | filter eventSource = "cognito-idp.amazonaws.com" and errorCode= "NotAuthorizedException"
ただ、これは認証エラー(NotAuthorizedException)を調べるための例なので、管理 API のイベントでも同じなのかまでは分かりませんでした。
そこで、実際に試してみることにしました。
やってみた
sub はどこに記録されるか
検証用のユーザープールでテスト用のユーザーを作り、AdminDisableUser を実行してイベントを見てみました。
出力は見やすいように整形して、一部を省略しています。
aws cloudtrail lookup-events \
--lookup-attributes AttributeKey=EventName,AttributeValue=AdminDisableUser \
--max-results 1 \
--query 'Events[0].CloudTrailEvent' \
--output text
{
"eventVersion": "1.11",
(snip...)
"eventSource": "cognito-idp.amazonaws.com",
"eventName": "AdminDisableUser",
"awsRegion": "ap-northeast-1",
(snip...)
"requestParameters": {
"userPoolId": "ap-northeast-1_EXAMPLE",
"username": "HIDDEN_DUE_TO_SECURITY_REASONS"
},
"responseElements": null,
"additionalEventData": {
"sub": "12345678-90ab-cdef-1234-567890abcdef"
},
(snip...)
}
requestParameters の username は伏せられています。
一方で、additionalEventData には、操作の対象になったユーザーの sub が記録されていますね。
AdminCreateUser、AdminEnableUser、AdminDeleteUser のイベントでも、additionalEventData に sub が記録されていました。
sub からユーザーを特定する
あとは、この sub を ListUsers のフィルターに指定します。
完全一致で検索するときは「=」を使います。
Filter-Type: For an exact match, use =, for example, "given_name = "Jon"".
参考訳:
Filter-Type: 完全一致の場合は = を使用します(例: "given_name = "Jon"")。
AWS CLI では次のように実行します。
aws cognito-idp list-users \
--user-pool-id ap-northeast-1_EXAMPLE \
--filter 'sub = "12345678-90ab-cdef-1234-567890abcdef"' \
--query 'Users[].{Username:Username,Enabled:Enabled,Status:UserStatus}'
[
{
"Username": "test-user",
"Enabled": false,
"Status": "FORCE_CHANGE_PASSWORD"
}
]
無効化したテスト用のユーザー(test-user)を特定できました。
「Enabled」が false になっているので、AdminDisableUser の操作が反映されていることも分かりますね。
なお、「Status」が FORCE_CHANGE_PASSWORD なのは、AdminCreateUser で作ったあと一度もサインインしていないためです。
気になったこと
試していて気になったのは、AdminDeleteUser で削除したユーザーの場合です。
先ほどの test-user を削除したあとに、同じ sub で ListUsers を実行すると、結果は空になりました。
aws cognito-idp list-users \
--user-pool-id ap-northeast-1_EXAMPLE \
--filter 'sub = "12345678-90ab-cdef-1234-567890abcdef"' \
--query 'Users'
[]
イベントに sub は残っていますが、ユーザーはユーザープールから削除されているので、ListUsers では見つかりませんでした。
削除したユーザーのユーザー名をあとから調べたい場合は、削除前に sub とユーザー名の対応を別に記録しておく必要がありそうです。
まとめ
以上、Cognito の管理 API の CloudTrail イベントから、操作の対象になったユーザーを特定する方法でした。
今後、CloudTrail で HIDDEN_DUE_TO_SECURITY_REASONS を見かけたら、まずは additionalEventData の sub を ListUsers のフィルターに指定してみようと思います。
また、削除されたユーザーまで追う必要がある場合は、sub とユーザー名の対応を残す仕組みも考えてみたいと思います。
どなたかのお役に立てば幸いです。それでは!
参考情報
クラスメソッドオペレーションズ株式会社について
クラスメソッドグループのオペレーション企業です。
運用・保守開発・サポート・情シス・バックオフィスの専門チームが、IT・AI をフル活用した「しくみ」を通じて、お客様の業務代行から課題解決や高付加価値サービスまでを提供するエキスパート集団です。
当社は様々な職種でメンバーを募集しています。
「オペレーション・エクセレンス」と「らしく働く、らしく生きる」を共に実現するカルチャー・しくみ・働き方にご興味がある方は、クラスメソッドオペレーションズ株式会社 コーポレートサイト をぜひご覧ください。※2026 年 1 月 アノテーション㈱から社名変更しました








