> ## 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.

> My Organization API を使用すると、Auth0 の組織管理者がアプリケーション内から自身の IDプロバイダーと検証済みドメインを管理できるようになります。

# My Organization API と埋め込み可能な UI コンポーネント

<Warning>
  My Organization API と埋め込み可能な UI コンポーネントは現在、すべてのお客様に早期アクセスで提供されています。この機能を使用することで、お客様は [Okta’s Master Subscription Agreement](https://www.okta.com/legal/) に定められた該当する Free Trial 条項に同意したものとみなされます。Auth0 の製品リリース サイクルの詳細については、[Product Release Stages](/ja/docs/troubleshoot/product-lifecycle/product-release-stages) を参照してください。

  お客様は、My Organization API と埋め込み可能な UI コンポーネントの利用が、お客様のセキュリティ ポリシーおよび適用法令 (エンドユーザーに付与するあらゆる権限を含む) に準拠していることを確保する責任を負います。
</Warning>

Auth0 My Organization API は、Auth0 テナント内でお客様のビジネス顧客が自身の組織を管理できるようにする、組織スコープの安全なインターフェースを提供します。この API は、埋め込み型の委任管理と API ファーストの統合を支える技術基盤です。

<div id="core-capabilities">
  ## 主要機能
</div>

現在、この API では次の項目を管理できます。

* [Auth0 組織](/ja/docs/manage-users/organizations) の詳細 (名前、ブランディング、表示名)
* 組織固有の設定、所有権、関連付け
* [IDプロバイダー (IdP) ](/ja/docs/authenticate/identity-providers) と [SCIM](/ja/docs/authenticate/protocols/scim) のプロビジョニング
* ドメインとホーム レルム ディスカバリー (HRD) の設定

<Callout icon="file-lines" color="#0EA5E9" iconType="regular">
  My Organization API を使用すると、統合を技術的にきめ細かく制御できます。最短でデプロイするには、まず 埋め込み可能な UI コンポーネント、SDK、サンプルアプリケーションから始めることを強くお勧めします。埋め込み可能な UI コンポーネントとサンプルアプリケーションを使用すると、お客様やエンドユーザーにセルフサービスエクスペリエンスを提供するまでの時間と労力を大幅に削減できます。
</Callout>

<div id="set-up-my-organization-api">
  ## My Organization API の設定
</div>

<div id="activate-the-my-organization-api-in-auth0-dashboard">
  ### Auth0 Dashboard で My Organization API を有効化する
</div>

1. **[Auth0 Dashboard > Applications > APIs](https://manage.auth0.com/#/apis)** に移動します。
2. My Organization API のバナーを探します。
3. **Activate** を選択します。
   <Frame>
     <img src="https://mintcdn.com/translations/xwVvTWJUElMm5YAK/docs/images/cdy7uua7fh8z/my-org-api-activate.png?fit=max&auto=format&n=xwVvTWJUElMm5YAK&q=85&s=c75dfecde07cafca644ff8b04b24ba7a" alt="Auth0 Dashboard>Authentication>APIs" data-og-width="1200" width="1200" data-og-height="292" height="292" data-path="docs/images/cdy7uua7fh8z/my-org-api-activate.png" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/translations/xwVvTWJUElMm5YAK/docs/images/cdy7uua7fh8z/my-org-api-activate.png?w=280&fit=max&auto=format&n=xwVvTWJUElMm5YAK&q=85&s=714ade0f91d627b9c790ea2cc2a999f1 280w, https://mintcdn.com/translations/xwVvTWJUElMm5YAK/docs/images/cdy7uua7fh8z/my-org-api-activate.png?w=560&fit=max&auto=format&n=xwVvTWJUElMm5YAK&q=85&s=712a9a74a4644a4135b36a29ea689a3b 560w, https://mintcdn.com/translations/xwVvTWJUElMm5YAK/docs/images/cdy7uua7fh8z/my-org-api-activate.png?w=840&fit=max&auto=format&n=xwVvTWJUElMm5YAK&q=85&s=f6fc860d10e8f818836c85dede153ee7 840w, https://mintcdn.com/translations/xwVvTWJUElMm5YAK/docs/images/cdy7uua7fh8z/my-org-api-activate.png?w=1100&fit=max&auto=format&n=xwVvTWJUElMm5YAK&q=85&s=f12b0d19e492e041d11b0939553baef7 1100w, https://mintcdn.com/translations/xwVvTWJUElMm5YAK/docs/images/cdy7uua7fh8z/my-org-api-activate.png?w=1650&fit=max&auto=format&n=xwVvTWJUElMm5YAK&q=85&s=fd40df6d8adea92aed9845bfa9f446f5 1650w, https://mintcdn.com/translations/xwVvTWJUElMm5YAK/docs/images/cdy7uua7fh8z/my-org-api-activate.png?w=2500&fit=max&auto=format&n=xwVvTWJUElMm5YAK&q=85&s=698a5f0db2187bd37639ca18faf4e75c 2500w" />
   </Frame>
4. API が Applications > API の一覧に My Organization API として表示されます。

My Organization API を有効化すると、次のようになります。

* Auth0 では、デフォルトですべてのクライアントアプリケーションに対してこの API が無効になります。
* [クライアントグラント](/ja/docs/get-started/applications/application-access-to-apis-client-grants) または [RBAC](/ja/docs/manage-users/access-control/configure-core-rbac/enable-role-based-access-control-for-apis) ポリシーを使用して、アプリケーションとロールにアクセスを付与する必要があります。
* 顧客企業は、自社の組織の詳細を取得したり、自社の組織向けに IdP を設定したりできます。

<div id="default-settings">
  #### 既定の設定
</div>

**Auth0 ドメインとカスタムドメイン**

My Organization API では、正規の Auth0 ドメインまたはカスタムドメインを使用できますが、次の内容を含むプロセス全体を通して、同じドメインを使用する必要があります。

* アクセストークンをリクエストする
* オーディエンスまたは `aud` の値を設定する
* My Organization API のエンドポイントを呼び出す

Auth0 でカスタムドメインを使用する方法の詳細については、[Custom Domains](/ja/docs/customize/custom-domains) を参照してください。

**アクセスポリシー**

デフォルトでは、My Organization API には次のアプリケーション API アクセスポリシーが適用されます。

* ユーザーフローでは `require_client_grant`
* マシン間フローでは `deny-all`

アプリケーションがユーザーに代わって My Organization API にアクセスするには、そのアプリケーションのクライアントグラントを作成し、アプリケーションがリクエストできる最大のスコープを定義します。あるいは、ユーザーアクセスフローを `allow_all` に変更することで、テナント内の任意のアプリケーションが任意のスコープをリクエストできるようにすることもできます。

<Warning>
  My Organization API は機密性の高い情報や操作を扱うため、Auth0 はユーザーアクセスフローで `allow_all` を使用することを推奨していません。アプリケーションには本当に必要なアクセス権のみを付与し、潜在的なセキュリティリスクを最小限に抑えるために、最小権限の原則に従ってください。
</Warning>

最終的にアプリケーションに付与される権限は、アプリケーション API アクセスポリシーで許可されたスコープ、エンドユーザーに割り当てられたロールベースアクセス制御 (RBAC) の権限、およびユーザーの同意 (該当する場合) の共通部分によって決まります。

アプリケーション API アクセスポリシーと、それに関連付けられたクライアントグラントの管理方法の詳細については、[Application Access to APIs: Client Grants](/ja/docs/get-started/applications/application-access-to-apis-client-grants) を参照してください。

**トークンの有効期間**

My Organization API は、有効期間が 600 秒 (10 分) に固定されたアクセストークンを発行します。この短い有効期間は、テナントとそのリソースを保護するために意図的に設けられたセキュリティ対策です。

<Callout icon="file-lines" color="#0EA5E9" iconType="regular">
  My Organization API は、セキュリティ上の理由から常にオプトイン方式です。API を無効にすると、再度有効にするまで、接続されているすべてのアプリケーションからアクセスできなくなります。
</Callout>

### クライアントアプリケーションの属性を設定する

My Organization API で使用するために、Auth0 で[アプリケーションを作成](/ja/docs/get-started/auth0-overview/create-applications)します。作成後、**[Auth0 Dashboard > Applications > APIs](https://manage.auth0.com/#/apis)** に移動し、アプリケーションで必要なスコープを含めて My Organization API を認可します。

アプリケーションでは `my_organization_configuration` オブジェクトを指定する必要があります。指定しない場合、My Organization API はエラーを返してリクエストを拒否します。`my_organization_configuration` オブジェクトでは、次のプロパティを使用できます。

| **プロパティ**                      | **説明**                                                                                                                                                                                                                                                                                                                                                                 |
| ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `connection_profile_id`        | **接続プロファイル ID.** My Organization API の使用時にアプリケーションで利用される [接続プロファイル](/ja/docs/authenticate/enterprise-connections/connection-profile) の ID です。指定しない場合、接続プロファイル が必要な My Organization API の機能は動作しません。この ID は、同じテナント内の有効な 接続プロファイル を参照している必要があります。                                                                                                                         |
| `user_attribute_profile_id`    | **User Attribute Profile ID**。My Organization API の使用時にアプリケーションで利用される [ユーザー属性プロファイル](/ja/docs/authenticate/enterprise-connections/user-attribute-profile) の ID です。指定しない場合、ユーザー属性プロファイルが必要な My Organization API の機能は動作しません。この ID は、同じテナント内の有効なユーザー属性プロファイルを参照している必要があります。                                                                                               |
| `allowed_strategies`           | **文字列の配列。** 各文字列は一意で、サポートされているストラテジーを表します。サポートされているストラテジー (enum の値) は次のとおりです: `pingfederate`, `ad`, `adfs`, `waad`, `google-apps`, `okta`, `oidc`, `samlp`。                                                                                                                                                                                                            |
| `connection_deletion_behavior` | **Enum (allow、allow\_if\_empty) 。** このアプリケーションから My Organization API 経由でエンドユーザーが接続の削除を試みた際に、My Organization API がどのように動作するかを示します。enum の値と説明は次のとおりです: <p /> 1. `allow`: ユーザーが適切なスコープを持っている場合、接続を削除できます。その結果、その接続に関連するすべてのユーザーも削除されます。 <p /> 2.`allow_if_empty`: ユーザーが適切なスコープを持っている場合でも、接続内にユーザーが存在しない場合にのみ接続を削除できます。ユーザーが存在する場合、My Organization API はエラーを返し、削除は実行されません。 |

<div id="configure-client-application-attributes">
  #### クライアントアプリケーションの属性を設定する
</div>

<Tabs>
  <Tab title="Auth0 Dashboard">
    My Organization API に必要な属性を設定するには、次の手順を実行します。

    1. **[Dashboard > Applications > APIs](https://manage.auth0.com/#/apis)** に移動し、My Organization API を選択します。
    2. **Application Access** タブを選択します。
    3. 設定するアプリケーションを選択し、**Edit** を選択します。
    4. 次の設定を行います。<br />
       A. **任意**。接続プロファイル を設定します。 <br />

       1. 既存の 接続プロファイル を選択するか、新しく作成します。新しい 接続プロファイル を作成する場合: <br />
          a. 名前を追加します。<br />
          b. マッピングを確認し、新しい接続の属性に目的の設定が反映されていることを確認します。 <br />

       B. **任意**。ユーザー属性プロファイルを設定します。 <br />

       1. 名前を追加します。 <br />
       2. マッピングを確認し、プロファイル属性が希望する Auth0 の属性にマップされていることを確認します。 <br />

       C. サポート対象の IDプロバイダー を設定します。 <br />

       1. 1 つ以上の IDプロバイダー を有効にします。顧客管理者は、有効化されたプロバイダーの一覧から希望するオプションを選択できます。 <br />

       D. Connection Deletion Behavior を Allow または Allow if Empty に設定します。 <br />

       1. **Allow**: ユーザーが適切なスコープを持っている場合、接続を削除できます。この操作により、その接続に由来するすべてのユーザーが削除されます。 <br />
       2. Allow if Empty: ユーザーが適切なスコープを持っている場合、接続内にユーザーが存在しないときにのみ接続を削除できます。ユーザーが存在する場合、My Organization API はエラーを返し、削除は実行されません。 <br />

       E. User Access Authorization を Unauthorized、Authorized、または All に設定します。 <br />

       1. **Unauthorized**。権限は許可されません。 <br />
       2. **Authorized**。必要な権限を選択します。 <br />
       3. **All**。現在および今後追加されるすべての権限が含まれます。 <br />

       F. Client Credential Access Authorization を Unauthorized、Authorized、または All に設定します。 <br />

       1. **Unauthorized**。権限は許可されません。 <br />
       2. **Authorized**。必要な権限を選択します。 <br />
       3. **All**。現在および今後追加されるすべての権限が含まれます。 <br />
    5. **Save** を選択します。
  </Tab>

  <Tab title="Management API">
    Auth0 Dashboard を使用せずにクライアントアプリケーションの属性をプログラムで設定するには、使用可能な Management API エンドポイントを使用します。Management API を使用するには、[Management API アクセストークン](/ja/docs/secure/tokens/access-tokens/management-api-access-tokens)を取得する必要があります。

    * [`GET` `/api/v2/clients`](https://auth0.com/docs/api/management/v2/clients/get-clients)
    * [`POST` `/api/v2/clients`](https://auth0.com/docs/api/management/v2/clients/post-clients)
    * [`GET` `/api/v2/clients/{id}`](https://auth0.com/docs/api/management/v2/clients/get-clients-by-id)
    * [`PATCH` `/api/v2/clients/{id}`](https://auth0.com/docs/api/management/v2/clients/patch-clients-by-id)
  </Tab>
</Tabs>

<div id="generate-an-access-token">
  ## アクセストークンを生成する
</div>

My Organization API は、サポートされている [OAuth 2.0 フロー](https://auth0.com/docs/get-started/authentication-and-authorization-flow) のいずれかで取得した、ユーザーに紐づくアクセストークンでのみ呼び出せます。

<Callout icon="file-lines" color="#0EA5E9" iconType="regular">
  My Organization API に機密性の高い操作を許可する場合は、多要素認証 (MFA) によって追加のセキュリティポリシーを適用するため、[ステップアップ認証](/ja/docs/secure/multi-factor-authentication/step-up-authentication) の使用を強く推奨します。
</Callout>

<div id="example-with-authorization-code-flow">
  ### Authorization Code Flow の例
</div>

<Tooltip tip="クライアントシークレット: クライアント（アプリケーション）が認可サーバーに対して認証する際に使用する秘密情報です。これはクライアントと認可サーバーだけが知っている必要があり、推測されないよう十分なランダム性を備えていなければなりません。" cta="用語集を見る" href="/ja/docs/glossary?term=Client+Secret">クライアントシークレット</Tooltip>を使用する機密Webアプリケーションでは、[Authorization Code Flow](/ja/docs/get-started/authentication-and-authorization-flow/authorization-code-flow) を使用します。

```bash theme={null}
curl --request POST \
--url 'https://YOUR_DOMAIN/oauth/token' \
--header 'content-type: application/x-www-form-urlencoded' \
--data 'grant_type=authorization_code' \
--data 'client_id=YOUR_CLIENT_ID' \
--data 'client_secret=YOUR_CLIENT_SECRET' \
--data 'code=AUTH_CODE' \
--data 'redirect_uri=https://yourapp/callback' \
--data 'audience=https://YOUR_DOMAIN/my-org/'
```

**レスポンス例**

```json theme={null}
{
  "access_token": "eyJz93a...k4laUWw",
  "token_type": "Bearer",
  "expires_in": 600,
  "scope": "read:my_org:details update:my_org:identity_providers"
}
```

<div id="example-with-authorization-code-flow-with-pkce">
  ### PKCE を使用する認可コードフローの例
</div>

クライアントシークレットを持たないパブリックアプリケーション、シングルページアプリケーション、モバイルまたはネイティブアプリケーション、および CLI ツールでは、[PKCE を使用する認可コードフロー](/ja/docs/get-started/authentication-and-authorization-flow/authorization-code-flow-with-pkce) を使用します。

```bash theme={null}
curl --request POST \
--url 'https://YOUR_DOMAIN/oauth/token' \
--header 'content-type: application/x-www-form-urlencoded' \
--data 'grant_type=authorization_code' \
--data 'client_id=YOUR_CLIENT_ID' \
--data 'code=AUTH_CODE' \
--data 'code_verifier=CODE_VERIFIER' \
--data 'redirect_uri=https://yourapp/callback' \
--data 'audience=https://YOUR_DOMAIN/my-org/'
```

<div id="audience">
  ### 対象者
</div>

My Organization API のオーディエンスおよびベース URL は `https://{yourDomain}/my-org/` です。トークンには、オーディエンスとして `https://YOUR_DOMAIN/my-org/` を含める必要があります。他の API (`/me` や `/api/v2/` など) 用のトークンは使用できません。

<div id="scopes">
  ### Scopes
</div>

| **スコープ**                                        | **説明**                                  |
| ----------------------------------------------- | --------------------------------------- |
| `read:my_org:configuration`                     | クライアントの組織設定を参照する                        |
| `read:my_org:details`                           | クライアントの組織の詳細情報を参照する                     |
| `update:my_org:details`                         | クライアントの組織の詳細情報を更新する                     |
| `create:my_org:identity_providers`              | 組織のIDプロバイダーを作成する                        |
| `read:my_org:identity_providers`                | 組織のIDプロバイダーを参照する                        |
| `update:my_org:identity_providers`              | 組織のIDプロバイダーを更新する                        |
| `delete:my_org:identity_providers`              | 組織のIDプロバイダーを削除する                        |
| `update:my_org:identity_providers_detach`       | 組織からIDプロバイダーの関連付けを解除する                  |
| `create:my_org:identity_providers_domains`      | IDプロバイダーに組織ドメインを関連付ける                   |
| `delete:my_org:identity_providers_domains`      | IDプロバイダーから組織ドメインの関連付けを削除する              |
| `read:my_org:identity_providers_scim_tokens`    | このIDプロバイダーのProvisioning SCIMトークンを一覧表示する |
| `create:my_org:identity_providers_scim_tokens`  | このIDプロバイダーのProvisioning SCIMトークンを作成する   |
| `delete:my_org:identity_providers_scim_tokens`  | IDプロバイダーのProvisioning SCIMトークン設定を削除する   |
| `create:my_org:identity_providers_provisioning` | IDプロバイダーのProvisioning設定を作成する            |
| `read:my_org:identity_providers_provisioning`   | IDプロバイダーのProvisioning設定を参照する            |
| `update:my_org:identity_providers_provisioning` | IDプロバイダーのProvisioning設定を更新する            |
| `delete:my_org:identity_providers_provisioning` | IDプロバイダーのProvisioning設定を削除する            |
| `read:my_org:domains`                           | 組織のドメインを参照する                            |
| `delete:my_org:domains`                         | 組織のドメインを削除する                            |
| `create:my_org:domains`                         | 組織のドメインを作成する                            |
| `update:my_org:domains`                         | 組織のドメインを更新する                            |

<div id="endpoint-reference">
  ## エンドポイント リファレンス
</div>

My Organization API は、構成、組織の詳細、IDプロバイダー、ドメイン、プロビジョニング構成、SCIM トークンに関するエンドポイントをサポートしています。スキーマやエラーコードなどを含むエンドポイントの完全なリファレンスについては、[API Explorer](https://auth0.com/docs/api/myorganization) を参照してください。

<div id="sdk-reference">
  ## SDK リファレンス
</div>

この API は、TypeScript、Java、.NET、Go、Python 向けの SDK として提供されています。各 SDK 実装の詳細や、SDK の活用方法の例については、[SDK documentation](/ja/docs/libraries) を参照してください。

<div id="user-profiles">
  ## ユーザープロフィール
</div>

My Organization API は、サードパーティの顧客が作成する設定の構造、制約、ルールを定義するために、[接続プロファイル](/ja/docs/authenticate/enterprise-connections/connection-profile) と [ユーザー属性プロファイル](/ja/docs/authenticate/enterprise-connections/user-attribute-profile) を利用します。

<div id="connection-profile-cp">
  ### 接続プロファイル (CP)
</div>

接続プロファイルを使用すると、サードパーティによって作成される場合に、Auth0 開発者は Auth0 接続のプライベート設定をどのように構成するかを指定できます。接続プロファイルの仕組み、属性マッピングとオーバーライド、例、設定方法の詳細については、[Connection Profiles](/ja/docs/authenticate/enterprise-connections/connection-profile) を参照してください。

<div id="user-attribute-profile-uap">
  ### ユーザー属性プロファイル (UAP)
</div>

ユーザー属性プロファイル (UAP) は、SCIM、SAML、OIDC などのプロトコル全体で、ユーザー属性を一貫した方法で定義、管理、マッピングできるようにします。UAP の仕組み、属性マッピングとオーバーライド、例、設定方法の詳細については、[ユーザー属性プロファイル](/ja/docs/authenticate/enterprise-connections/user-attribute-profile) を参照してください。

<div id="rate-limits">
  ## レート制限
</div>

レート制限は、サービスティアに応じて適用されます。

| **ティア**                 | **読み取り (RPS)** | **書き込み (RPS)** |
| ----------------------- | -------------- | -------------- |
| **Free**                | 4              | 2              |
| **Public Self-Service** | 8              | 4              |
| **Public Enterprise**   | 40             | 20             |
| **Private Basic**       | 40             | 20             |
| **Private Performance** | 160            | 80             |

<div id="per-organization-rate-limits">
  ### 組織ごとのレート制限
</div>

サービスティアのレート制限に加えて、My Organization API では組織ごとのレート制限も適用されます。これらの制限は、リソースを公平に割り当て、特定の組織がテナント全体のパフォーマンスに影響を及ぼさないようにするために設けられています。こうした上限を設けることで、「ノイジーネイバー」問題を軽減し、ある組織でアクティビティが急増しても、共有リソースが過度に消費されたり、同じ環境内の他の組織に影響が及んだりしないようにしています。各組織には、読み取り操作と書き込み操作それぞれについて、1 秒あたりのリクエスト数 (RPS) が個別に割り当てられます。

| **Tier**                | **組織ごとの読み取り (RPS)** | **組織ごとの書き込み (RPS)** |
| ----------------------- | ------------------- | ------------------- |
| **Free**                | 4                   | 2                   |
| **Public Self-Service** | 4                   | 2                   |
| **Public Enterprise**   | 8                   | 4                   |
| **Private Basic**       | 8                   | 4                   |
| **Private Performance** | 16                  | 8                   |

<div id="cross-origin-requests">
  ## クロスオリジンリクエスト
</div>

Auth0テナントとは異なるドメインで実行されているブラウザーベースのアプリケーション (Single Page Application など) から My Organization API を直接呼び出そうとすると、[Cross-Origin Resource Sharing (CORS)](/ja/docs/get-started/applications/set-up-cors) と呼ばれるブラウザーのセキュリティポリシーの影響を受けます。既定では、ブラウザーはこのようなクロスオリジンリクエストをブロックします。

アプリケーションから API に正常にリクエストを送信できるようにするには、アプリケーションのドメイン (「オリジン」) をクライアントの設定に追加する必要があります。

1. [**Auth0 Dashboard > Applications**](https://manage.auth0.com/#/applications) に移動します。対象のアプリケーションを選択します。
2. Cross-Origin Authentication で、Allow Cross-Origin Authentication をオンにします。
3. Allowed Origins (CORS) を見つけて、アプリケーションのオリジン URL を入力します。
4. **Save** を選択します。

<Callout icon="file-lines" color="#0EA5E9" iconType="regular">
  アプリケーションで CORS を使用する必要がない場合は、Allow Cross-Origin Authentication がオフになっていることを確認してください。このリストにアプリケーションの URL を追加すると、Auth0 はそのオリジンからのリクエストを信頼し、クライアントサイドアプリケーションが API にアクセスできるようになります。
</Callout>

<div id="log-events">
  ## ログイベント
</div>

きめ細かな監査とモニタリングを実現するため、My Organization API はこの API 固有のログイベントセットを生成します。テナントでは引き続き[標準のシステムログが出力](/ja/docs/deploy-monitor/logs/log-event-type-codes)されますが、以下の表は、特に My Organization API のアクティビティによって発生するイベントタイプの完全な一覧を示しています。

これらのイベントコードを使用すると、API によって管理されるすべてのリソース、具体的には設定、組織の詳細、IdP、ドメインにわたるアクティビティを追跡できます。ログイベントスキーマの詳細については、[GitHub リポジトリ](https://github.com/auth0/auth0-log-schemas)を参照してください。

| **Event Code**                              | **Event**                                       | **Event Description**                                      |
| ------------------------------------------- | ----------------------------------------------- | ---------------------------------------------------------- |
| `my_organization_api_config_failed`         | My Organization API Config Failed               | My Organization API サービスの設定リソースに対する API 呼び出しに失敗しました        |
| `my_organization_api_org_details_succeeded` | My Organization API Org Details Succeeded       | My Organization API サービスの組織の詳細リソースに対する API 呼び出しに成功しました     |
| `my_organization_api_org_details_failed`    | My Organization API Org Details Failed          | My Organization API サービスの組織の詳細リソースに対する API 呼び出しに失敗しました     |
| `my_organization_api_idp_succeeded`         | My Organization API Identity Provider Succeeded | My Organization API サービスのIDプロバイダー リソースに対する API 呼び出しに成功しました |
| `my_organization_api_idp_failed`            | My Organization API Identity Provider Failed    | My Organization API サービスのIDプロバイダー リソースに対する API 呼び出しに失敗しました |
| `my_organization_api_domain_succeeded`      | My Organization API Domain Succeeded            | My Organization API サービスのドメイン リソースに対する API 呼び出しに成功しました     |
| `my_organization_api_domain_failed`         | My Organization API Domain Failed               | My Organization API サービスのドメイン リソースに対する API 呼び出しに失敗しました     |

<div id="organization-connection-ownership">
  ## 組織接続の所有権
</div>

この API では、テナント管理者が管理する接続と、組織が自ら管理する接続を区別するために、所有権モデルが導入されています。これは `organization_access_level` プロパティで制御されます。

**主要なプロパティ**: `organization_access_level`

| **Enum Value** | **Description**                                                                                                                                         |
| -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `none`         | テナント管理者によって割り当てられた関連付けです。この接続は My Organization API では表示も編集もできません。                                                                                       |
| `readonly`     | テナント管理者によって割り当てられた関連付けです。表示はできますが、My Organization API では編集できません。                                                                                        |
| `limited`      | テナント管理者によって割り当てられた関連付けです。My Organization API では、限定された情報の表示と変更が許可されます。具体的には、`show_as_button` 属性と `is_enabled` 属性です。                                      |
| `full`         | テナント管理者によって割り当てられた関連付けです。My Organization API の利用者は、追加の制限なしに、組織固有の接続属性、具体的には `show_as_button`、`is_enabled`、options、`display_name`、`domains` の各属性を変更できます。 |

**接続の Management API エンドポイント**:

* `GET` [`/api/v2/organizations/{id}/connections`](https://auth0.com/docs/api/management/v2/organizations/get-organization-connection)
* `POST` [`/api/v2/organizations/{id}/connections`](https://auth0.com/docs/api/management/v2/organizations/post-organization-connection)
* `PATCH` [`/api/v2/organizations/{id}/connections/{id}`](https://auth0.com/docs/api/management/v2/organizations/patch-organization-connection)
* `DELETE` [`/api/v2/organizations/{id}/connections/{id}`](https://auth0.com/docs/api/management/v2/organizations/delete-organization-connection)

`/connections` エンドポイントを呼び出すときは、`/enabled_connections` エンドポイントと同じスコープを使用します。

* `create:organization_connections`
* `read:organization_connections`
* `delete:organization_connections`
* `update:organization_connections`

追加のスキーマ属性を確認してください。

| **Property**                   | **Description**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| ------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `is_enabled`                   | **Boolean**。組織に対して接続を有効または無効にします。接続を無効にすると、接続自体は無効のまま、接続オブジェクトの値を保持できます。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| `organization_access_level`    | **Enum (null, none, readonly, limited, full)**。My Organization API の使用時に、ユーザーが持つアクセスの種類を決定します。1. `null` 2. `none` - テナント管理者によって割り当てられた関連付けです。この接続は My Organization API では表示も編集もできません。3. `readonly` - テナント管理者によって割り当てられた関連付けです。この接続は表示できますが、My Organization API では編集できません。4. `limited` - テナント管理者によって割り当てられた関連付けです。My Organization API では、限定された情報の表示と変更が許可されます。5. `full` - テナント管理者によって割り当てられた関連付けです。My Organization API の利用者は、My Organization API の使用時に、この接続を追加の制限なく変更できます。注: organization\_access\_level の値にかかわらず、My Organization API による変更には常に 接続プロファイル によって適用される制限が適用されます。 |
| `organization_connection_name` | **String**。接続の作成時に指定した名前を格納します。このフィールドは、接続プロファイル の connection\_name\_prefix\_template を評価して My Organization API が算出します。このフィールドは Management API でのみ表示および変更できます。                                                                                                                                                                                                                                                                                                                                                                                                              |

注意:

* これらのエンドポイントは、省略可能なクエリパラメーター `is_enabled=true/false` を受け付けます。指定した場合は、指定された `is_enabled` 値を持つ接続のみが表示されます。
* `organization_access_level` は Management API でのみ変更できます。
* `name` 属性が設定されていない場合は、`organization_access_level` を `none` から他の値に変更する前に、Management API で設定する必要があります。

<div id="auth0-universal-components">
  ## Auth0 Universal Components
</div>

API ファーストの統合ではなく、まずは埋め込み可能な UI コンポーネントである [Auth0 Universal Components](/ja/docs/get-started/universal-components/universal-components-overview) の利用を強くお勧めします。これらのリソースを利用することで、開発時間を大幅に短縮し、顧客にセルフサービス体験を迅速に提供できます。
