はじめに
2026年6月3日、Cognitoのマルチリージョンレプリケーション(以下MRR)がアップデートにより追加されました。
認証・認可で広く用いられているCognitoでも耐障害性向上のためにMRRが利用できるようになったことは喜ばしいことではないでしょうか。しかもMRRはユーザープロフィールだけでなく、資格情報もレプリケーションしてくれるようです。
ただ、この記事を書いている2026年9月段階では、限定的なリージョンでのみ利用可能な状態です。
2026年9月現在で適用されているリージョンは以下になります。
米国東部(オハイオ、バージニア北部)、米国西部(カリフォルニア北部、オレゴン)、アジア太平洋(ムンバイ、ソウル、シンガポール、シドニー、東京)、カナダ(中央)、ヨーロッパ(フランクフルト、アイルランド、ロンドン、パリ、ストックホルム)、南米(サンパウロ)。
大阪リージョンでは残念ながらまだMRRは利用できないということになります。(トホホ)
タイミングがいいのか悪いのか、Cognitoをアプリケーションの認証・認可に利用しているWebシステムにて、大阪リージョンを利用した災害対策(以下DR)の検討を行う必要がありました。
今回は東京リージョンにあるCognitoのユーザープールを大阪リージョンにレプリケーションするため、Lambdaの独自実装を行ったので紹介します。
Lambdaの中でCognito API経由のコピーを行っていますが、これではパスワードは複製できません。
本記事の手法は「フェイルオーバー後に利用ユーザーがパスワードリセットを行う」ことを前提とした暫定策です。
目的と背景
前述したとおり、東京リージョンで作成したCognitoユーザープールのユーザー情報を、大阪リージョンに構築するDRリソースから参照できるように大阪リージョンのユーザープールにレプリケーションしたい、というのが目的です。
自分は今までCognitoに関してあまり触ったことが無かったために知らなかったのですが、Cognitoには他サービスのようなバックアップ手段が用意されていません。AWS Backupの対応リソースにもCognitoは含まれておらず、MRRも対応していないということは意外でした。
公式からStep Functions とDynamoDBを利用したエクスポートの手段がガイダンスされてはいます。
Guidance for User Profiles Export with Amazon Cognito
※MFAが有効なユーザープールはサポートされていません。(sample codeより)
今回はDR対策として同期された状態を保ちたかったこと、subを認可処理で利用していることもあり、Lambdaで独自実装してみることにしました。
簡単な構成図
構成としてはこれだけです。大阪リージョンに置いたLambdaをEventBridge Scheduler で定期実行し、Lambdaが以下を行います。
- 東京のユーザープールから
ListUsersでユーザー一覧を取得 - 大阪のユーザープールからも
ListUsersでユーザー一覧を取得 - 差分を計算し、
AdminCreateUser/AdminUpdateUserAttributesで大阪側に反映
LambdaではCognito APIを呼び出しているだけに過ぎないので、裏を返せばAPIで参照できないものは複製できません。
Cognito APIで複製できるもの / できないもの
Cognito APIで参照できるもの、参照できないものについて整理してみました。
| 項目 | 可否 | 補足 |
|---|---|---|
| ユーザーの存在(作成・更新の追随) | ○ |
AdminCreateUser / AdminUpdateUserAttributes
|
email |
○ | 今回はユーザーの突き合わせキーとしても使用する |
email_verified |
○ | 複製元の値をそのまま複製。false だとパスワードリセットができない |
標準属性(name、phone_number など) |
○ | 複製する属性は明示指定(allowlist)。ListUsers で読めるものが対象となる |
カスタム属性(custom:*) |
○ | 複製先で同じ属性を定義しておく必要がある |
ユーザーの有効 / 無効(Enabled) |
○ | 複製元で無効のユーザーは複製先でも無効とする(AdminEnableUser / AdminDisableUser) |
| MFA | △ | MFAを使うかどうかの設定は再現できるが、TOTPのシークレットなど登録済みの情報は複製できない |
ユーザー名(Username) |
△ | 「E メールでサインイン」設定のプールでは Cognito が UUID を発行するため一致しない |
| パスワード(ハッシュ) | ✕ | 読み出す API が存在しない。フェイルオーバー後は全ユーザーがリセットする必要がある |
sub |
✕ | 複製先ユーザープールが再発行する。custom:origin_sub にコピーして回避する |
外部 IdP 連携ユーザー(EXTERNAL_PROVIDER) |
✕ | 複製先で IdP 連携を別途設定する必要がある |
| デバイス記憶 / リフレッシュトークン | ✕ | フェイルオーバー後は再ログインが必要になる |
○:複製可能 / △:一部のみ・代替手段で再現可能 / ✕:複製不可(APIで参照できない、または複製先に設定できない)
ちょっと工夫したところ
subの引継ぎ
Webシステム側では、DBのユーザーレコードにCognitoのsubを保存しておき、IDトークンのsubクレームでレコードを引いて認可処理を行っていました。
ですが、subはユーザープールごとに独立して発行される識別子で、同じ人物でも複製元と複製先では別の値になります。このままだと、複製先でのログイン自体は成功するのに、その後のAPIリクエストが全て弾かれることになります。
そこで、カスタム属性(custom:origin_sub)に複製元のsubを持たせることにしました。認可処理では、IDトークンのクレームにcustom:origin_subがあればそれを、無ければsubを参照します。
sub = claims.get("custom:origin_sub") or claims["sub"]
これでアプリケーション側の改修を最低限に抑えつつ、DR環境に対応する方針としました。
custom:origin_sub は、アプリクライアントの「属性権限」で「読み取り」だけを許可してください。
- 読み取りが無いと ID トークンにクレームが載らず、フォールバックが常に
sub側に落ちて全リクエストが弾かれます - 書き込みを許可していると、認可処理がこのクレームを信頼している以上、エンドユーザーが他人の
subを書き込んでそのユーザーになりすませてしまいます
パスワードリセットができる状態で作る
パスワードのハッシュを読みだすAPIは存在しないので、複製先のユーザーにパスワードを引き継ぐことはできません。フェイルオーバー後は全ユーザーにパスワードリセットをしてもらうしかありません。
ところが、AdminCreateUserで作成した「一時パスワード状態のユーザー」はFORCE_CHANGE_PASSWORDという状態になり、この状態だとユーザーがForgotPasswordを利用できなくなってしまいます。
NotAuthorizedException: User password cannot be reset in the current state.
このFORCE_CHANGE_PASSWORDの状態を抜け出してForgotPasswordで再設定ができるようにするためには、管理者側でパスワードを設定する必要があるのですが、そうなると全ユーザー分の手作業が発生してしまうので、現実的ではありません。
aws cognito-idp admin-set-user-password --user-pool-id <POOL_ID> --username <USERNAME> --password <PASSWORD> --permanent
そこで、Lambdaの中でユーザーを作成するタイミングで、ランダムなパスワードを仮で設定することにしました。こうすることで、「ユーザーが設定したパスワードはあるが、誰も知らない(忘れた)状態になり、ForgotPasswordでリセットできる」状態になりました。
# ユーザーを作成する
response = client.admin_create_user(
UserPoolId=target_user_pool_id,
Username=email, # サインイン用のエイリアスとして設定
UserAttributes=[
{"Name": "email", "Value": email},
{"Name": "email_verified", "Value": "true"}, # trueでないとForgotPasswordが使えない
# 以下、複製したい属性
...
],
MessageAction="SUPPRESS", # 招待メールを送らない
)
# CognitoがUUIDをUsernameとして払い出す(Eメールでサインインする場合)
username = response["User"]["Username"]
# ユーザー作成後、生成したランダムパスワードを設定する
client.admin_set_user_password(
UserPoolId=target_user_pool_id,
Username=username,
Password=generate_password(), # ランダムなパスワード
Permanent=True,
)
まとめ
今回はCognitoのユーザープールから別リージョンのユーザープールへユーザー情報を複製する方法について紹介しました。
今回の対応は暫定的な対応であり、CognitoのMRRが大阪リージョンにも対応したら、そちらに切り替えることになります。
自分が調査を行っていた際に、CognitoのDR対策についての情報はあまり見つけられなかったこともあり、記事を書くに至りました。(他の人はどうしているのだろうか・・・)
似たようなことでお悩みの方の参考になれば嬉しいです。
