Appwrite の2FA：Console アカウントに認証アプリを設定する方法

Appwrite には2種類の多要素認証（MFA）があり、違うページを開いてしまいがちです。1つは、自分のアプリにユーザー向けとして組み込む機能です。もう1つは自分の開発者アカウント、つまり Appwrite Console にサインインして組織やプロジェクトを管理するためのアカウントを保護するものです。このガイドで扱うのは後者です（Appwrite）。アプリを使う人のための MFA については、Appwrite のAuth のドキュメントで説明されています。

Console のアカウントでは、MFA は任意です。Appwrite のドキュメントでは、対応している方法として認証アプリの時間ベースのコード（TOTP）が挙げられ、今後ほかの要素も追加される予定だとされています（Appwrite）。以下の手順では iPhone の Authenticator App - Novaz を使いますが、どの認証アプリでも手順は同じです。

このガイドの確認方法: Appwrite の手順は、下にリンクした Appwrite 公式ドキュメントとそのスクリーンショットに基づいています（2026年10月21日に確認）。Appwrite のアカウントで実際に試してはいないため、ラベルが多少異なる場合があります。Novaz の手順は、アプリのバージョン 1.0.5 で確認しています。

認証アプリで MFA を有効にする

Appwrite のページは短く、本文とスクリーンショットでラベルが少し異なります。以下の手順は両方に基づいています（Appwrite）。

1. Appwrite Console にサインインします。右上のアカウントメニューを開き、Your account（あなたのアカウント）を選択します。
2. セキュリティ設定に移動します。Appwrite のスクリーンショットでは、左側の一覧の Security（セキュリティ）で、ページに Multi-factor authentication（多要素認証）カードがあります。
3. Multi-factor authentication のスイッチをオンにします。
4. 認証アプリを追加します。本文ではボタンが Add authentication factor（認証要素を追加）と呼ばれ、スクリーンショットでは Authenticator app（認証アプリ）の行に Add（追加）ボタンがあります。
5. Scan QR code（QR コードをスキャン）ウインドウが開きます。Novaz で + をタップし、QR コードをスキャン をタップして、コードにカメラを向けます。Console を同じ iPhone で開いている場合は、スクリーンショットを撮り、代わりに 写真を選ぶ を使います。詳しくは同じ iPhone で QR コードをスキャンする方法をご覧ください。
6. スキャンできない場合は、同じウインドウにコピーボタン付きの Manual entry code（手動入力用コード）が表示されています。Novaz で + をタップし、キーを手動で入力 をタップして、サービス に Appwrite などの名前を入力し、設定キー にコードを貼り付けます。詳しくは2FA の設定キーとは？をご覧ください。
7. Continue（続ける）を選択し、Novaz に表示されている現在のコードを入力して設定を完了します。
8. リカバリーコードを保存します（次のセクション）。

ドキュメントには、コードの桁数も更新間隔も書かれていません。QR コードならこれらの設定がアプリに伝わるので、スキャンするほうが確実です。手入力したキーでは、6桁のコードが30秒ごとに生成されます。

リカバリーコードがアカウントに戻る唯一の手段

これについて Appwrite はめずらしいほど率直です。ドキュメントでは、リカバリーコードを「the only way to access your account if you lose access to your authenticator app」（認証アプリにアクセスできなくなった場合に、アカウントにアクセスする唯一の方法）としています（Appwrite）。ロックされた Console アカウントについてのサポートの窓口は書かれていません。

スクリーンショットでは、同じ設定ページに Recovery codes（リカバリーコード）の行と View（表示）ボタンがあるので、サインインしている間はもう一度確認できます。パスワードマネージャーや印刷した紙など、iPhone 以外の場所にコピーを保管してください。Novaz のバックアップがない場合や、Appwrite のアカウントより古い場合は、このコードがアカウントに戻る手段になります。詳しくは2FA のバックアップコードをご覧ください。

同じスクリーンショットには要素として Email（メール）も表示されており、アカウントの確認済みアドレスにワンタイムコードが送られます。ページの本文には認証アプリしか書かれていないため、サインイン時にメールのコードを予備として使えるかどうかは、ドキュメントからは判断できません。

Appwrite がコードを受け付けない場合

Appwrite のドキュメントには、コードが受け付けられない場合についての説明がありません。最もよくある原因は iPhone の時計です。設定 › 一般 › 日付と時刻 を開き、自動設定 をオンにします。時計が15秒以上ずれていると、Novaz も警告を表示します。キーを手入力した場合は、すべてコピーできているか確認してください。ほかの原因については認証アプリのコードが使えない場合をご覧ください。

機種変更するとき

MFA を新しい iPhone に移す方法も、認証アプリを置き換える方法も、MFA をオフにする方法も、Appwrite のドキュメントには書かれていません。これらの操作は、古い iPhone でまだサインインできるうちに、同じ Multi-factor authentication カードから行ってください。Novaz の iCloud バックアップをオンにしていたか、バックアップファイルを書き出していれば、新しい iPhone に Appwrite を復元できます。ない場合は、新しい iPhone に新規アカウントとして追加することになります。詳しくは認証アプリを新しい iPhone に移行する方法をご覧ください。

認証アプリをなくした場合

リカバリーコードの1つを使ってサインインし、新しい iPhone で認証アプリを設定し直します。リカバリーコードがない場合、アカウントに戻るほかの方法は Appwrite のドキュメントには示されていません。詳しくは認証アプリの入った iPhone をなくした場合をご覧ください。

Appwrite 公式ヘルプ

• Multi-factor authentication（Console アカウント）
• Multi-factor authentication（Appwrite Auth、アプリのユーザー向け）
• Security