Amazon Cognito のポイントインタイムリカバリ(PITR)で削除したユーザーを復旧してみた

Amazon Cognito のポイントインタイムリカバリ(PITR)で削除したユーザーを復旧してみた

Amazon Cognito のポイントインタイムリカバリ(PITR)で、削除したユーザーを復旧しました。削除したユーザーは sub、パスワード、グループ所属、TOTP MFA が元のまま戻り、復旧ポイント後に作ったユーザーは削除されました。確認中は書き込みが拒否されました。
2026.11.19

はじめに

2026年11月18日に、Amazon Cognito がポイントインタイムリカバリ(PITR)に対応しました。

https://aws.amazon.com/jp/about-aws/whats-new/2026/11/cognito-point-in-time-recovery/

PITR は、ユーザープールのユーザーデータを過去の時点の状態へ戻す機能です。この記事では、Essentials プランのユーザープールでユーザーとグループを削除・変更し、AWS CLI で復旧しました。

前提

PITR は Essentials と Plus のユーザープールで自動的に有効になります。復旧ポイントに指定できる範囲は、Essentials が過去1日、Plus が過去14日です。

AWS CLI は 2.41.1 を使いました。

IAM ポリシーでは、ユーザープールのリソースに対する次の5つのアクションを許可する必要があります。AmazonCognitoPowerUser マネージドポリシーにはすべて含まれています。

cognito-idp:InitiatePointInTimeRecovery
cognito-idp:DescribePointInTimeRecovery
cognito-idp:StartPointInTimeRecovery
cognito-idp:CancelPointInTimeRecovery
cognito-idp:ListPointInTimeRecoveries

https://docs.aws.amazon.com/cognito/latest/developerguide/user-pool-point-in-time-recovery.html

検証用データ

ユーザー alice、bob、carol、dave をグループ admins、editors とともに作成し、その後に次の操作をしました。

ユーザー 作成時の状態 作成後の操作
alice グループ admins、TOTP MFA 削除
bob グループ editors 削除
carol グループなし name を carol-updated に更新、パスワードを変更
dave グループなし 変更なし
eve 存在しない 作成(グループ temp)
frank 存在しない 作成

グループは、その後 editors を削除し、temp を作成しました。

プールとアプリクライアントの作成コマンド

Essentials を指定してユーザープールを作成し、TOTP MFA を OPTIONAL で有効にしました。

aws cognito-idp create-user-pool --pool-name pitr-verify-1119 --user-pool-tier ESSENTIALS --deletion-protection INACTIVE
aws cognito-idp set-user-pool-mfa-config --user-pool-id <USER_POOL_ID> --mfa-configuration OPTIONAL --software-token-mfa-configuration Enabled=true
aws cognito-idp create-user-pool-client --user-pool-id <USER_POOL_ID> --client-name pitr-client --no-generate-secret --explicit-auth-flows ALLOW_USER_PASSWORD_AUTH ALLOW_REFRESH_TOKEN_AUTH

復旧の手順

復旧ポイントの指定とプレビュー

initiate には、復旧ポイントを UTC(末尾 Z)のタイムスタンプで渡します。現在から15分以上前の時刻を指定する必要があります。今回は、ユーザー4名とグループの作成直後の時刻を指定しました。

aws cognito-idp initiate-point-in-time-recovery --user-pool-id <USER_POOL_ID> --restore-timestamp <RESTORE_TIMESTAMP_UTC>
{
    "Restoration": {
        "RestoreId": "<RESTORE_ID>",
        "RestoreStatus": "PREVIEW_GENERATING",
        "RestoreTimestamp": "2026-11-19T11:25:10+09:00",
        "TriggerTimestamp": "2026-11-19T11:51:12.629000+09:00"
    }
}

以降の describe、start には、この応答の RestoreId を渡します。

RestoreStatus が PREVIEW_GENERATED になるまで、initiate から約16分かかりました。

describe で、プレビューの件数を確認します。

aws cognito-idp describe-point-in-time-recovery --user-pool-id <USER_POOL_ID> --restore-id <RESTORE_ID>
{
    "Restoration": {
        "RestoreId": "<RESTORE_ID>",
        "RestoreStatus": "PREVIEW_GENERATED",
        "RestoreTimestamp": "2026-11-19T11:25:10+09:00",
        "TriggerTimestamp": "2026-11-19T11:51:12.629000+09:00",
        "RestorePreview": [
            {
                "Entity": "Passkeys",
                "CreateCount": 0,
                "UpdateCount": 0,
                "DeleteCount": 0
            },
            {
                "Entity": "User MFAs",
                "CreateCount": 1,
                "UpdateCount": 0,
                "DeleteCount": 0
            },
            {
                "Entity": "Users",
                "CreateCount": 2,
                "UpdateCount": 1,
                "DeleteCount": 2
            },
            {
                "Entity": "Groups",
                "CreateCount": 1,
                "UpdateCount": 0,
                "DeleteCount": 1
            }
        ]
    }
}

Users の CreateCount は削除済みユーザーの再作成、DeleteCount は復旧ポイント後に作ったユーザーの削除の件数です。実際の差分は次のとおりです。

項目 件数 実際の差分
Users 作成 2 alice、bob の再作成
Users 更新 1 carol
Users 削除 2 eve、frank
Groups 作成 1 editors
Groups 削除 1 temp
User MFAs 作成 1 alice の TOTP
Passkeys すべて 0 なし

admins は alice の削除でメンバーが減りましたが、Groups の UpdateCount は 0 です。

プレビュー確認中の動作

PREVIEW_GENERATED の間に、ユーザープールへの書き込み、読み取り、サインインを実行した結果です。

操作 リクエストの種類 結果
AdminCreateUser、AdminUpdateUserAttributes、CreateGroup 署名付きリクエスト ValidationException: Cannot modify user pool resources while point-in-time recovery is in progress.
ListUsers、AdminGetUser 署名付きリクエスト 成功
InitiateAuth(MFA を設定していない dave) ユーザーからのリクエスト 成功
UpdateUserAttributes、ChangePassword、SignUp ユーザーからのリクエスト ForbiddenException: A required service is currently unavailable. If this issue persists, contact your administrator.

ユーザーからのリクエストのエラーメッセージからは、復旧中であることが分かりません。

復旧の開始

プレビューを確認したら、start を実行します。

aws cognito-idp start-point-in-time-recovery --user-pool-id <USER_POOL_ID> --restore-id <RESTORE_ID>

start の応答で RestoreStatus は RESTORING でした。RESTORE_COMPLETED を初めて確認したのは、start から約70秒後です。

復旧結果

戻ったもの

項目 復旧ポイント時点 復旧直前(変更後) 復旧後
alice の sub 5774ead8… ユーザーなし 5774ead8…
bob の sub 47342a18… ユーザーなし 47342a18…
alice のサインイン 成功(TOTP のチャレンジあり) UserNotFoundException 元のパスワードで成功。復旧ポイント前に登録した TOTP のコードでチャレンジを完了
bob のサインイン 成功 UserNotFoundException 元のパスワードで成功
グループ所属 alice は admins、bob は editors alice、bob とも存在しない alice は admins、bob は editors
グループ一覧 admins、editors admins、temp admins、editors
carol の name carol carol-updated carol
eve 存在しない 存在する UserNotFoundException
frank 存在しない 存在する UserNotFoundException
dave 存在する 変更なし 変更なし

変更したパスワードは維持される

Developer Guide の記載どおり、PITR はパスワードの変更を元に戻しません。パスワードを変更したユーザー(carol)は、変更後のパスワードでサインインできました。

まとめ

Amazon Cognito のユーザープールが PITR に対応しました。

従来、操作ミスなどでユーザーデータを復旧するには、独自に用意したバックアップと復旧の仕組みを使うほかありませんでした。復旧したユーザーはパスワードを再設定する必要があり、sub も新しいものになっていました。PITR では、パスワードや sub を維持したまま、指定した時点に戻せるようになりました。

本番環境のユーザーデータの復旧手段として有効ですが、プール設定、アプリクライアント、IdP などは対象外です。また、プレビューの確認中はユーザープールへの書き込みが拒否され、プレビューの生成には今回約16分かかりました。

事前に評価環境などで復旧を試し、影響や所要時間を把握したうえで使うことをおすすめします。

この記事をシェアする

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

関連記事