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

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

> Auth0 Dashboard または Management API を使用して、組織へのメンバーシップ招待を送信する方法を学びます。

export const ReleaseStageNotice = ({feature, stage, plans, contact, terms}) => {
  const stageTextMap = {
    "beta": "Beta",
    "ea": "早期アクセス"
  };
  const stageText = stageTextMap[stage] || "製品リリース段階";
  const prsLink = "/docs/troubleshoot/product-lifecycle/product-release-stages";
  const linkify = (text, url) => {
    return <a href={url} target="_blank" rel="noreferrer" class="link">{text}</a>;
  };
  const includeDetails = (plans, contact, terms) => {
    const hasDetails = terms || plans || contact;
    if (!hasDetails) return null;
    return <span data-as="p">
            {plans && <>この機能は{linkify(`${plans}プラン`, "https://auth0.com/pricing")}でご利用いただけます。 </>}
            {contact && "参加をご希望の場合は、" + contact + "までお問い合わせください。 "}
            {terms && <>この機能を使用することにより、Oktaの該当する無料トライアル規約および{linkify("Master Subscription Agreement", "https://www.okta.com/legal")}に同意したものとみなされます。</>}
        </span>;
  };
  return <Warning>
            <span data-as="p">
                <strong>{feature}機能は現在、{linkify(stageText, prsLink)}です。</strong>
            </span>

            {includeDetails(plans, contact, terms)}
        </Warning>;
};

[組織](/docs/ja-jp/manage-users/organizations/organizations-overview)へのメンバーシップ招待は、<Tooltip tip="Auth0 Dashboard: サービスを設定するための Auth0 のメイン製品です。" cta="用語集を見る" href="/docs/ja-jp/glossary?term=Auth0+Dashboard">Auth0 Dashboard</Tooltip>または<Tooltip tip="Auth0 Dashboard: サービスを設定するための Auth0 のメイン製品です。" cta="用語集を見る" href="/docs/ja-jp/glossary?term=Management+API">Management API</Tooltip>を使用してユーザーに送信できます。

<div id="auth0-dashboard">
  ## Auth0 Dashboard
</div>

Auth0 Dashboard でメンバーを招待するには、次の手順に従います。

1. [Auth0 Dashboard > 組織](https://manage.auth0.com/#/organizations) に移動し、メンバーシップを設定する組織を選択します。
2. **Invitations** ビューで、**Invite Members** を選択します。
3. メンバーを招待する アプリケーション を選択し、組織に招待するユーザーのメールアドレスを入力して、**Send Invite(s)** を選択します。

   <Callout icon="file-lines" color="#0EA5E9" iconType="regular">
     必要に応じて、ユーザーが招待を承諾する際に使用する接続や、承諾時に組織メンバーに割り当てるロールを指定できます。組織ロールを事前に割り当てるには、ロールセレクターでこの組織にスコープが設定されたロールを選択します。
   </Callout>

<ReleaseStageNotice feature="Organization Roles" stage="ea" terms="true" contact="Auth0 Support" />

[複数のカスタムドメイン](/docs/ja-jp/customize/custom-domains/multiple-custom-domains) を有効にすると、**Send Invite(s)** セクションの **Domain** で、テナントの通知ドメインを選択できます。

<div id="management-api">
  ## Management API
</div>

<Warning>
  アプリケーション向けにカスタマイズした管理ダッシュボードから招待機能を公開する場合は、新しいメンバーを招待する前に、認証済みユーザーが組織に属していることを確認するため、[confidential アプリケーション](/docs/ja-jp/get-started/applications/confidential-and-public-applications)を使用してください。あるいは、特定のロールが割り当てられているユーザー以外は新しいメンバーを招待できないように制限することもできます。
</Warning>

Management API を使用してメンバーを招待するには:

Create Organization Invitations エンドポイントに `POST` リクエストを送信します。`ORG_ID`、`MGMT_API_ACCESS_TOKEN`、`NAME_OF_USER`、`EMAIL_ADDRESS`、`CLIENT_ID`、`CONNECTION_ID`、`EXP_TIME`、`ROLE_ID`、`SEND_INVITATION_EMAIL_OPTION` の各プレースホルダー値は、それぞれ組織ID、Management API の<Tooltip tip="アクセストークン: API へのアクセスに使用される、不透明な文字列または JWT の形式の認証情報。" cta="用語集を見る" href="/docs/ja-jp/glossary?term=Access+Token">アクセストークン</Tooltip>、招待するユーザーの名前、招待するユーザーのメールアドレス、<Tooltip tip="Client ID: Auth0 から登録済みリソースに付与される識別値。" cta="用語集を見る" href="/docs/ja-jp/glossary?term=client+ID">client ID</Tooltip>、接続 ID、有効期限、ロール ID に必ず置き換えてください。

```json lines theme={null}
{
  "method": "POST",
  "url": "https://{yourDomain}/api/v2/organizations/ORG_ID/invitations",
"headers": [
  { "name": "Content-Type", "value": "application/json" },
  { "name": "Authorization", "value": "Bearer MGMT_API_ACCESS_TOKEN" },
  { "name": "Cache-Control", "value": "no-cache" }
  ],
  "postData": {
  "mimeType": "application/json",
  "text" : "{ \"inviter\": { \"name\": \"NAME_OF_USER\"}, \"invitee\": { \"email\": \"EMAIL_ADDRESS\" }, \"client_id\": \"CLIENT_ID\", \"connection_id\": \"CONNECTION_ID\", \"ttl_sec\": \"EXP_TIME\", \"roles\": [ \"ROLE_ID\", \"ROLE_ID\", \"ROLE_ID\" ], \"send_invitation_email\": \"SEND_EMAIL_INVITATION_OPTION\" }"
  }
}
```

[複数のカスタムドメイン](/docs/ja-jp/customize/custom-domains/multiple-custom-domains) を有効にしている場合は、`auth0-custom-domain` HTTP ヘッダーを含める必要があります。詳しくは、[複数のカスタムドメイン](/docs/ja-jp/customize/custom-domains/multiple-custom-domains#customize-email-handling-using-the-management-api) をご覧ください。

<Callout icon="file-lines" color="#0EA5E9" iconType="regular">
  **Auth0 ドメインを確認する**

  Auth0 ドメインは、テナント名、リージョンのサブドメイン (テナントが米国リージョンにあり、2020 年 6 月以前に作成されている場合を除く) 、および `.auth0.com` を組み合わせたものです。たとえば、テナント名が `travel0` の場合、Auth0 ドメイン名は `travel0.us.auth0.com` になります。 (テナントが米国にあり、2020 年 6 月以前に作成されている場合、ドメイン名は `https://travel0.auth0.com` になります。)

  カスタムドメインを使用している場合は、こちらにそのカスタムドメイン名を指定してください。
</Callout>

| Value                          | Description                                                                                                                                             |
| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `ORG_ID`                       | メンバーシップを割り当てる対象の 組織 の ID。                                                                                                                               |
| `MGMT_API_ACCESS_TOKEN`        | スコープ `create:organization_invitations` を持つ [Management API のアクセストークン](/docs/ja-jp/secure/tokens/access-tokens/management-api-access-tokens)。            |
| `NAME_OF_USER`                 | 招待を送信するユーザーの名前。最大 300 文字。                                                                                                                               |
| `EMAIL_ADDRESS`                | 招待の送信先メールアドレス。                                                                                                                                          |
| `CLIENT_ID`                    | 招待されたユーザーが認証を行うアプリケーションの ID。                                                                                                                            |
| `CONNECTION_ID`                | 招待されたメンバーが認証を行う接続の ID。                                                                                                                                  |
| `EXP_TIME`                     | 招待の有効期限が切れるまでの秒数。指定しない場合、または 0 に設定した場合は、デフォルトで 604800 秒 (7 日間) になります。最大 2592000 秒 (30 日間) 。                                                             |
| `ROLE_ID`                      | 指定した 組織 について、招待されたユーザーに割り当てるロールの ID。組織スコープのロールを事前に割り当てるには、組織ロールの ID を渡します。`roles` 配列は任意です。省略した場合、招待されたユーザーはロールが割り当てられていない状態で参加します。メンバー 1 人あたり最大 50 ロール。 |
| `SEND_INVITATION_EMAIL_OPTION` | Auth0 がメールを送信するかどうかを示します。値は `true` または `false` です。`false` に設定すると、Auth0 は招待 URL を生成し、それを独自のメールサービスを通じてユーザーに送信できます。                                       |

<div id="response-status-codes">
  ### レスポンスステータスコード
</div>

レスポンスとして返される可能性のあるステータスコードは次のとおりです。

| Status code | Error code             | Message                                                                                                                                                                 | Cause                                                      |
| ----------- | ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------- |
| `200`       |                        | 招待が正常に作成されました。                                                                                                                                                          |                                                            |
| `400`       | `invalid_body`         | 指定された client\_id は存在しません。                                                                                                                                               | リクエストのペイロードが有効ではありません。                                     |
| `400`       | `invalid_body`         | 指定された接続は存在しません。                                                                                                                                                         | リクエストのペイロードが有効ではありません。                                     |
| `400`       | `invalid_body`         | パスワードレス接続はサポートされていません。                                                                                                                                                  | リクエストのペイロードが有効ではありません。                                     |
| `400`       | `invalid_body`         | 招待 URL を生成するには、デフォルトのログインルートが必要です。詳しくは、[Configure default login routes](/docs/ja-jp/authenticate/login/auth0-universal-login/configure-default-login-routes) を参照してください。 | リクエストのペイロードが有効ではありません。                                     |
| `400`       | `invalid_body`         | 指定されたロールのうち 1 つ以上が存在しません: role1, role2'。                                                                                                                                | リクエストのペイロードが有効ではありません。                                     |
| `400`       | `invalid_body`         | リクエスト本文が無効です。メッセージは原因によって異なります。                                                                                                                                         | リクエストのペイロードが有効ではありません。                                     |
| `400`       | `invalid_query_string` | リクエストのクエリ文字列が無効です。メッセージは原因によって異なります。                                                                                                                                    | クエリ文字列が有効ではありません。                                          |
| `401`       |                        | 無効なトークンです。                                                                                                                                                              |                                                            |
| `401`       |                        | JSON Web Token の検証で無効な署名を受信しました。                                                                                                                                        |                                                            |
| `401`       |                        | クライアントはグローバルではありません。                                                                                                                                                    |                                                            |
| `403`       | `insufficient_scope`   | スコープが不足しています。必要なスコープのいずれか: `create:organization_invitations`。                                                                                                           | 提供された bearer token のスコープでは許可されていないフィールドの読み取りまたは書き込みを試みました。 |
| `404`       |                        | その ID に一致する組織が見つかりません。                                                                                                                                                  |                                                            |
| `429`       |                        | リクエストが多すぎます。X-RateLimit-Limit、X-RateLimit-Remaining、X-RateLimit-Reset ヘッダーを確認してください。                                                                                    |                                                            |