組織メンバーを招待する

組織にメンバーを割り当てたいものの、そのユーザーがまだデータストアに存在しない場合 (またはデータストアには存在していても、まだその組織のメンバーではない場合) は、そのユーザーを組織に招待できます。この場合、ユーザーにはリンク付きのメールが送信されます。ユーザーはそのリンクからアカウントを作成するかログインして組織に参加でき、必要に応じて事前定義されたロールも付与されます。また、アプリケーションにリダイレクトされるため、すぐに利用を開始できます。 招待フローを設定するには、次の手順を行います。

1. メンバーシップ招待フローをアプリケーションに統合する
2. ユーザー招待フローをカスタマイズする
3. メンバーシップ招待を送信する

​

メンバーシップ招待フローをアプリケーションに統合する

ユーザー招待を機能させるには、招待の受諾フローの一部としてアプリケーションにルートを設定し、テナントまたはアプリケーションに対して関連するデフォルトのログインルートを設定する必要があります。設定した URI へのリンクは、ユーザーに送信される招待メールに含まれます。

​

URIを設定する

URI をすべてのアプリケーションで共有する場合は、Auth0 Dashboard > Settings > Advanced で Tenant Login URL を設定できます。共有しない場合は、Auth0 Dashboard > Applications > Applications から開けるアプリケーションの設定で Application Login URI を使用して、アプリケーションごとに URI を設定できます。

​

ルートの動作を指定する

アプリケーション内のルートは、クエリ文字列内の invitation および organization パラメーターを受け取り、その後、両方のパラメーターを付けて Auth0 Authentication API の Authorization エンドポイントを呼び出す必要があります。 たとえば、Application Login URI が https://myapp.com/login に設定されている organization 対応のアプリケーションがある場合、エンドユーザーに送信されるメール招待内のリンクは次のようになります。https://myapp.com/login?invitation={invitation_ticket_id}&organization={organization_id}&organization_name={organization_name}

​

ユーザー招待フローをカスタマイズする

ユーザー招待の prompt と、ユーザーが受け取るメールをカスタマイズするには、Universal Login の prompt とメールテンプレートを変更します。詳しくは、以下のページを参照してください。

• Universal Login Page Templates
• Universal Login Internationalization
• メールテンプレートをカスタマイズする

​

ローカライズ

招待するユーザーのロケールは事前にはわからないため、Management API を使用して、任意の user_metadata パラメータを招待エンドポイントに送信できます。ユーザー招待フローをローカライズする際は、User Invitation メールテンプレートからこのパラメータにアクセスし、他の多言語メールテンプレートと同じロジックを使用できます。 招待されたユーザーが適切な言語で招待内容を表示するには、アプリケーションが ui_locales パラメータを送信するか、招待されたユーザーのブラウザーが適切な Accept-Language ヘッダーを送信する必要があります。詳しくは、メールテンプレートのカスタマイズ: 多言語メールテンプレートを参照してください。

​

メンバーシップ招待を送信する

Auth0 Dashboard または Management API を使用して、ユーザーに organization のメンバーシップ招待を送信 できます。独自のメールサービスで招待を送信したい場合は、招待 URL のみを生成することもできます。それ以外の場合は、ユーザーにリンクを含むメールが送信され、そのリンクから構成済みの接続を使用して organization にログインできます。