- 管理者はユーザーアカウントを作成します。
- 管理者は登録メール招待状をユーザーに送信します。
- ユーザーは招待状メールのリンクに従って、アカウントのパスワードをセットアップします。
- ユーザーはパスワードを作成し、検証します。
- ユーザーがサインインします。
招待状の作成
- メールテンプレートのカスタマイズと、それを使用したパスワード変更メールの送信です。
- パスワード変更チケットを作成します。
/password-changeManagement APIエンドポイントを呼び出すパスワード変更チケットを作成することにより、一意のリンクを生成します。以下を行う必要があります。
user.email_verifiedパラメーターをfalseに設定してAuth0データベースユーザーを作成します。ユーザー作成エンドポイントを使用できます。- 外部メールサービスにアクセスして構成する
- Management APIアクセストークンを取得する
パスワード変更チケットを作成する
- Management APIエンドポイントに
user_idまたはメールとconnection_idを使用してユーザーを指定します。 - リダイレクトによってユーザーを送信する場所を指定します。
result_urlパラメーターは、ユーザーがパスワードを設定した後にアプリケーションがユーザーに送信するリダイレクトの場所です。この場合、result_urlはアプリのログインページでなければなりません。詳細については、「ログイン後にユーザーをリダイレクトする」をお読みください。以下に示すclient_idパラメーターを使用することもできます。顧客がメールを確認すると、クライアントのデフォルトのログインURIにリダイレクトされます。 - 招待リンクの有効期間を指定します。
ttl_secパラメーターを使用して、招待リンクがアクティブな期間を設定します。ttl_secパラメーターは、関連するセキュリティ上の懸念事項に合わせて調整する必要があります。リンクは1回限りの使用であるため、ユーザーがパスワードを設定すると、再利用される危険性はありません。 - メールアドレスを確認します。登録済みのメールアカウントに送信する場合は、
mark_email_as_verifiedパラメーターをtrueに設定します。メールアカウントが登録されていない場合には、メール検証をtrueに設定 しないでください 。このエンドポイントの要求が成功すると、チケットURLを返します。このURLを使用してユーザーの招待を作成します。
クエリーパラメーターチケットURLを追加する
#を設定できる一意のコード値が含まれます。#より前の部分は編集しないでください。
パラメーターを追加して、設定パスワードワークフローUIを指定します。例：
メールテンプレート作成する
- ユーザーアカウントを要求する次の手順。
- リンクの有効期限。
- 有効期限が切れた場合の新しい招待を生成するための手順。
user.app_metadataに追加することができます。さらに、メールテンプレートでこのプロパティをチェックできます。
パスワードリセットUIをカスタマイズする
ユーザーエクスペリエンスを完了する
- ユーザーはパスワードを送信します。
- パスワード変更画面がリダイレクトされ、URLが返されます。
- ターゲットアプリは
/authorizeにリダイレクトします。 - ユーザー資格情報提出します。
- ユーザーはアプリに認証されます。
result_urlは、ユーザーがパスワードを作成した後にリダイレクトされる場所になります。この場合、ログインワークフローを開始できるように、URLをユーザーが招待されたサイトに配置する必要があります。ターゲットアプリは、successパラメーターを解析してエラーが発生していないことを確認してから、すぐにAuth0へのリダイレクトを開始してユーザーをログインさせる必要があります。
ユーザーエクスペリエンスを最適化するには、ターゲットアプリでemailパラメータを解析し、それをlogin_hintパラメータとして認証要求に含めることができます。これにより、ログインフォームにユーザーのメールアドレスが事前に入力されます。