認証
Atoms クラウドを使用してアプリに認証を追加し、ページやアクションを保護し、アクセスをテストし、Users モジュールで登録済みのアプリユーザーを表示します。
このページの認証には Atoms クラウド が使用されています。プロジェクトが接続されていない場合は、続行する前にエージェントに Atoms クラウドの接続を依頼するか、Atoms クラウド を参照してください。
Atoms クラウドでの認証の仕組み
Atoms クラウドは、アプリのユーザーアカウントとセッションを管理します。エージェントはサインアップとサインインの体験を構築し、それを Atoms クラウドに接続します。
特定のページやアクションを保護したり、異なる役割やアクセスレベルを作成したりするようエージェントに依頼できます。たとえば、サインイン済みのすべてのユーザーがダッシュボードを表示できる一方で、管理者だけが管理ページにアクセスできるようにできます。
アプリユーザーはプロジェクトの共同作業者とは異なります。 Atoms クラウド → Users には、あなたのアプリに登録した人が一覧表示されます。Atoms でプロジェクトを構築しているチームメイトは表示されません。ご自身の Atoms アカウントについてのヘルプは、Managing Your Account を参照してください。
エージェントで認証を設定する
プロジェクトチャットで、完全な認証フローをどのように機能させたいかを説明してください。以下を含めてください。
- ユーザーがどのようにアカウントを作成し、サインインするか。
- 提供したいすべてのサインイン方法。
- ユーザーにサインインを必須にするページまたはアクション。
- アプリに異なる役割またはアクセスレベルが必要かどうか。
Atoms クラウドは、アカウント作成、サインイン、権限、ユーザーセッションをサポートしています。メールアドレスとパスワードによる認証を使用できます。 Google sign-in が必要な場合は、明示的に依頼し、完成したフローをテストしてください。
エージェントはアプリに合わせて認証インターフェースを設計するため、見た目は異なる場合があります。要求したサインイン方法、保護されたページ、役割、アクセスルールが正しく機能することの確認に重点を置いてください。
エージェントが完了したら、次を行ってください。
- App ビューアー で完全なフローをテストします。
- テストアカウントを作成し、サインインが機能することを確認します。
- 保護されたページとアクションに正しいアクセスルールが設定されていることを確認します。
- Atoms クラウド → Users を開き、新しいアカウントが表示されることを確認します。
Atoms クラウド認証をテストする
通常のテストでは、 App ビューアー の Development 環境を使用してください。 Production は、本番フローを意図的にテストする場合にのみ使用してください。アカウントを作成する前に、選択されている環境と URL を確認してください。専用のテストアカウントを使用し、実際の顧客情報を使用したり、個人用パスワードを使い回したりしないでください。アプリに複数の役割がある場合は、各役割ごとに少なくとも 1 つのアカウントを作成してください。
以下のチェックを使用して、完全な認証フローをテストしてください。
| Test | What to do | Expected result |
|---|---|---|
| サインアウト中のアクセス | サインアウトしてから、認証が必要なはずのページにアクセスするか、機能を使おうとします。通常のユーザーフローと、そのページの直接 URL の両方をテストしてください。 | アプリはユーザーにサインインを求め、保護されたコンテンツを一切表示しません。 |
| アカウント作成 | アプリで利用可能な各サインアップ方法を使用して、新しいテストアカウントを作成します。 | アカウントが正常に作成され、 Atoms クラウド → Users に表示されます。 |
| サインイン | テストアカウントからサインアウトし、その後、利用可能な各方法で再度サインインします。 | ユーザーはサインインされ、正しいページに移動します。 |
| 読み込み状態 | サインアップまたはサインインフォームを送信し、リクエスト処理中のアプリの動作を確認します。 | アプリはリクエストが進行中であることを表示し、保護されたコンテンツを表示せずに重複送信を防ぎます。 |
| 誤った情報 | 誤ったメールアドレスまたはパスワードでサインインを試みます。 | アプリは明確なエラーを表示し、保護されたコンテンツを非表示のままにし、ユーザーが再試行できるようにします。 |
| 有効なセッション | サインインしてアプリを使用し、その後リロードまたは再度開きます。 | ユーザーは、セッションが有効である想定期間中はサインイン状態を維持します。 |
| 役割と権限 | 各役割のアカウントでサインインします。許可されたページやアクションと、制限されたページやアクションの両方へのアクセスを試します。 | 各アカウントは、その役割で許可されたコンテンツとアクションにのみアクセスできます。 |
| サインアウトとセッション期限切れ | サインアウトしてから、保護された領域に戻ろうとします。該当する場合は、セッションの有効期限が切れた後にも同じ確認を繰り返します。 | アプリは安全なサインアウト状態に戻り、保護されたコンテンツを表示しなくなります。 |
チェックに失敗した場合。 環境とサインイン方法を確認してから、専用のテストアカウントで再試行してください。それでもチェックに失敗する場合、またはアカウントが見つからない場合は、エージェントまたは承認済みのサポート窓口に調査を依頼してください。プロジェクトまたはチャットのリンク、URL、環境、サインイン方法、役割、正確なエラー内容、失敗したテストを含めてください。パスワード、認証コード、トークンは絶対に共有しないでください。
アプリに Google sign-in が含まれている場合は、ユーザーがアクセスする各 Development および Production URL でテストしてください。通常の確認ではまず Development をテストし、本番フローを意図的に検証する場合にのみ Production をテストしてください。1 つの URL で成功しても、別の URL でサインインが機能することの確認にはなりません。
Development と Production のユーザーは別々に保存されます。 プロジェクトに Production データベースがある場合、 Users パネルには Production ユーザーが表示されます。そうでない場合は、Development ユーザーが表示されます。現在、このパネルから手動で環境を切り替えることはできません。アカウントが見つからないように見える場合は、どの環境で作成されたかを確認してください。2 つのデータベース環境の詳細については、データベース を参照してください。
Atoms クラウドで登録済みユーザーを表示する
- デスクトップ端末でプロジェクトを開きます。
- App ビューアー があるのと同じワークスペースツールバーで、 Atoms クラウド を選択します。
- Atoms クラウドのサイドバーで Users を選択します。
- User Management の下で一覧を確認するか、 Search by name, email or UID を使用して特定のテストユーザーを見つけます。
Atoms クラウド認証を使用するプロジェクトでは、 Users テーブルに UID 、 Email 、 User Information 、 Role 、 Created 、 Last Updated が表示されます。検索フィールドを使用して、名前、メールアドレス、または UID でユーザーを見つけてください。
Users モジュールでは、アプリに登録されたアカウントの表示と検索ができます。認証設定やユーザーアクセスの管理はできません。以下の用途には使用できません。
- サインイン方法やアクセスルールを設定する。
- ユーザーを招待、削除、無効化、またはサインアウトする。
- パスワードをリセットしたり、ユーザーの役割を変更したりする。
認証を変更するには、何を変更したいかをエージェントに伝え、その後アプリで更新後の体験をテストしてください。