> ## Documentation Index
> Fetch the complete documentation index at: https://auth0.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 組織メンバーを招待する

> メールでメンバーを組織に招待する方法を学びます。

<Card title="利用可能性はAuth0プランによって異なる">
  この機能が利用できるかどうかは、使用しているログイン実装とAuth0プラン（または契約）によります。詳細については、「[価格設定](https://auth0.com/pricing)」をお読みください。
</Card>

メンバーを[Organization](/docs/ja-jp/manage-users/organizations/organizations-overview)に割り当てたいのに、そのユーザーがデータストアにまだ存在していない場合（またはユーザーがデータストアに存在しているが、まだ組織のメンバーではない場合）は、そのメンバーを組織に招待できます。この場合、ユーザーは、アカウントを作成するかログインして組織に参加するためのリンクを含むメールを受信することになります。このリンクにより、必要に応じて事前に定義されたロールを使用してアプリケーションにリダイレクトされ、すぐに使い始められるようになります。

<Warning>
  Organizationメンバーのロールは、Auth0の[ロールベースのアクセス制御](/docs/ja-jp/manage-users/access-control/rbac)を通じてユーザーに割り当てられるロールとは別のものです。Organizationへの招待を受け入れたユーザーに、事前定義されたロールが適用される場合は、ユーザーがそのOrganizationを介してログインした場合のみ該当するロールが適用されます。Dashboardで「[Organization Member roles (Organizationメンバーのロール）](/docs/ja-jp/manage-users/organizations/configure-organizations/retrieve-member-roles)」を参照してください。
</Warning>

招待フローを構成するには：

1. [メンバーシップ招待フローをアプリケーションに統合する](#integrate-the-membership-invitation-flow-into-your-application)
2. [ユーザー招待フローをカスタマイズする](#customize-the-user-invitation-flow)
3. [メンバーシップ招待を送信する](#send-membership-invitations)

<Callout icon="file-lines" color="#0EA5E9" iconType="regular">
  **制限事項**

  * Auth0では、ユーザー招待をメールでしか送信できません。別の方法で招待を送信したい場合は、招待URLの生成を選択することができます。
  * 招待されたユーザーは、ログインするか、招待を受け取ったメールアドレスでアカウントを作成しなければなりません。
</Callout>

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

ユーザー招待を機能させるには、招待受諾フローの一部としてアプリケーションで経路を設定し、テナントまたはアプリケーションに[関連付けられたデフォルトのログイン経路を構成](/docs/ja-jp/authenticate/login/auth0-universal-login/configure-default-login-routes)します。構成されたURIへのリンクは、ユーザーに送信される招待メールに含まれます。

### URIを構成する

すべてのアプリケーションでURIを共有しなければならない場合には、**テナントのログインURL** を[［Auth0 Dashboard］>［Settings（設定）］>［Advanced（詳細設定）］](https://manage.auth0.com/#/tenant/advanced)で設定することができます。または、アプリケーション設定の **［Application Login URI（アプリケーションのログインURI）］** を使用して、それぞれのアプリケーションにURIを設定することができます。 これは[［Auth0 Dashboard］>［Applications（アプリケーション）］>［Applications（アプリケーション）］](https://manage.auth0.com/#/applications)で行います。

### 経路の動作を指定する

アプリケーションの経路はクエリ文字列で`invitation`と`organization`のパラメーターを受け付け、その両方のパラメーター使ってAuth0 Authentication APIの[認可](https://auth0.com/docs/api/authentication#authorize-application)エンドポイントを呼び出す必要があります。

<Callout icon="file-lines" color="#0EA5E9" iconType="regular">
  複数テナントのシナリオで、Organization名がサブドメインまたはパス変数として使用されている場合（たとえば、`acme.myapp.com`）は、ユーザーに送信される招待リンクに`organization_name`パラメーターも含まれます。Authentication APIの[認可](https://auth0.com/docs/api/authentication#authorize-application)エンドポイントにこのパラメーターを送る必要はありません。
</Callout>

たとえば、組織対応のアプリケーションで **［Application Login URI（アプリケーションのログインURI）］** が`https://myapp.com/login`に設定されている場合、エンドユーザーに送信される招待メールには次のリンクが含まれます：`https://myapp.com/login?invitation={invitation_ticket_id}&organization={organization_id}&organization_name={organization_name}`.

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

<Callout icon="file-lines" color="#0EA5E9" iconType="regular">
  ユーザー招待フローをカスタマイズするには、カスタムドメインを使用しなければなりません。無料プランではカスタムドメインを無料で1つ使用できます。追加のカスタムドメインは、すべての有料プランでご利用いただけます。
</Callout>

ユーザー招待プロンプトとユーザーが受信するメールをカスタマイズするには、ユニバーサルログインプロンプトとメールテンプレートを変更します。詳細については、以下のページを参照してください。

* [ユニバーサルログインページのテンプレート](/docs/ja-jp/customize/login-pages/universal-login/customize-templates)
* [ユニバーサルログインの国際化](/docs/ja-jp/customize/internationalization-and-localization/universal-login-internationalization)
* [メールテンプレートをカスタマイズする](/docs/ja-jp/customize/email/email-templates)

### ローカリゼーション

招待したユーザーの言語設定は事前に分からないため、<Tooltip data-tooltip-id="react-containers-DefinitionTooltip-0" href="/docs/ja-jp/glossary?term=management-api" tip="Management API: 顧客が管理タスクを実行できるようにするための製品。" cta="用語集の表示">Management API</Tooltip>を使用して任意の`user_metadata`パラメーターを招待エンドポイントに送信することができます。ユーザー招待フローをローカライズする場合は、**ユーザー招待** メールテンプレートを通してこのパラメーターにアクセスし、[他の多言語メールテンプレートで使うのと同じロジックを使用する](/docs/ja-jp/customize/email/email-templates)ことができます。

招待されたユーザーが適切な言語で招待を見るには、アプリケーションが`ui_locales`パラメーターを送信するか、招待されたユーザーのブラウザーが適切な`Accept-Language`ヘッダーを送信しなければなりません。詳細については、「[メールテンプレートをカスタマイズする：多言語のメールテンプレート](/docs/ja-jp/customize/email/email-templates)」を参照してください。

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

<Tooltip data-tooltip-id="react-containers-DefinitionTooltip-0" href="/docs/ja-jp/glossary?term=auth0-dashboard" tip="Auth0 Dashboard: サービスを構成するためのAuth0の主製品。" cta="用語集の表示">Auth0 Dashboard</Tooltip>またはManagement APIを使用して[組織メンバーシップの招待状を送る](/docs/ja-jp/manage-users/organizations/configure-organizations/send-membership-invitations)ことができます。独自のメールサービスを使用して招待を送信する場合は、招待URLの生成のみを選択できます。それ以外の場合、ユーザーは、構成された接続を使用して組織にログインできるリンクを含むメールを受け取ります。

<Callout icon="file-lines" color="#0EA5E9" iconType="regular">
  ユーザーが招待を受け入れると、そのメールアドレスに検証済みのマークが付きます。

  ユーザーがフェデレーションログインを通して招待を受け入れた場合、IDプロバイダーが返すメールアドレスは、招待の送信先メールアドレスと一致しなければなりません。メール検証は、後続のログイン時にIDプロバイダーが返した値でオーバライドされません。

  期限までにユーザーが招待を受け入れなかった場合は、招待に期限切れのマークが付き、いずれ[Auth0 Dashboard](/docs/ja-jp/get-started/auth0-overview/dashboard)から削除されます。
</Callout>