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