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

# Connection Profile

> Connection Profile を使用して、サードパーティが Auth0 接続を作成する際に、その非公開設定をどのように構成するかを指定します。

Auth0 では、Okta、Microsoft Entra ID、Google Workspace などの外部フェデレーテッド ID プロバイダー (IdP) でユーザーを認証するためのエンタープライズ接続を提供しています。構成済みの接続には、外部 IdP とのシングルサインオン (SSO) 、ユーザープロビジョニング、logout 連携のためのプロトコル固有の設定に加え、その接続が Auth0 の Universal Login や Organizations 機能とどのように連携するかを制御する非公開設定が含まれます。

Connection Profile (CP) を使用すると、サードパーティが Auth0 接続を作成する際に、その非公開設定をどのように構成すべきかを Auth0 開発者が指定できます。

<h2 id="how-it-works">
  仕組み
</h2>

* **プロファイル定義**: 管理者は Connection Profile を作成し、Auth0 の delegated administration 機能のいずれかを使って接続が作成されるたびに、その接続に書き込むプロパティ値を定義します。

* **柔軟な適用範囲**: 現在、プロファイルは Self-Service Enterprise Configuration と Okta Express Configuration のフローにリンクされていますが、より幅広く再利用できるように設計されており、プロビジョニング、オンボーディング、権限管理、さらに今後の Auth0 の機能にも対応します。

<h2 id="connection-profile-properties">
  Connection Profile のプロパティ
</h2>

Connection Profile は JSON オブジェクトで、設定可能な以下のプロパティをサポートしており、新しく作成されるすべての接続に適用されます。

| **プロパティ**                                 | **説明**                                                                                                                                                                                                                                                                                                                                                                                                 |
| ----------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `connection_name_prefix_template`         | 接続名に使用する必要がある接頭辞を表します。接続の `name` パラメーターに対応します。この値では、Organization ID と organization名 の変数置換をサポートします。最終的な接頭辞を生成するには、OIN ワークフローでこれらの値を置換する必要があります。変数は中かっこ ({}) で囲みます。 <p /> サポート対象の変数: <p /> <ul><li>`org_id`: Organization ID</li><li>`org_name`: [organization名](/docs/ja-jp/manage-users/organizations/configure-organizations/create-organizations#auth0-dashboard)</li></ul> <p /> 例: `con-{org_id}-` |
| `enabled_features`                        | このリストでは、設定された接続でサポートされる機能を指定します。リストに含まれていない機能は使用できません。<p /> サポート対象の値: <ul><li>`scim`: これが含まれている場合、接続で SCIM を設定できます。</li><li>`universal_logout`: これが含まれている場合、この接続で Universal Logout 機能を使用できます。</li></ul>                                                                                                                                                                                                |
| `organization.assign_membership_on_login` | ログイン時に、ユーザーに organization のメンバーシップを自動的に割り当てるかどうかを指定します。これは、organization の `enabled_connections` サブリソースの `assign_membership_on_login` プロパティに対応します。  <Callout icon="file-lines" color="#0EA5E9" iconType="regular">Okta 向けの Express Configuration 連携では、`optional` は `required` として扱われます</Callout> <p />                                                                                                  |
| `cross_app_access_resource_app`           | 任意。Organization 管理者が、My Organization API を介してこの接続を Cross App Access (XAA) のリソースアプリケーションとして動作するように設定できるかどうかを制御します。形式: `{ "status": { "default_value": "enabled" \| "disabled", "allowed_values": ["enabled", "disabled"] } }`。Connection Profile から省略された場合、Organization 管理者はこれを一切設定できません。`allowed_values` は任意ですが、設定する場合は少なくとも 2 つの値を含める必要があります。                                                         |

| Connection Profile の値         | Enable Connections`assign_membership_on_login`Value                                            |
| ----------------------------- | ---------------------------------------------------------------------------------------------- |
| `none`                        | `false`                                                                                        |
| `optional`                    | `false`                                                                                        |
| `required`                    | `true`                                                                                         |
| `organization`                | 接続の作成先となる organization に適用される設定を含むオブジェクト。                                                      |
| `organization.show_as_button` | organization の選択後に、その接続をログイン画面上でボタンとして表示するかどうかを指定します。これは、有効になっている接続の `show_as_button` 値に対応します。 |

| Connection Profile の値 | 接続 `show_as_button` の値 |
| --------------------- | ---------------------- |
| `none`                | `false`                |
| `optional`            | `true`                 |
| `required`            | `true`                 |

<h2 id="example-connection-profile">
  Connection Profile の例
</h2>

```json theme={null}
{
  "organization": {
    "show_as_button": "none",
    "assign_membership_on_login": "none"
  },
  "connection_name_prefix_template": "ec-{org_id}-",
  "enabled_features": [
    "scim",
    "universal_logout"
  ],
  "cross_app_access_resource_app": {
    "status": {
      "default_value": "disabled",
      "allowed_values": ["enabled", "disabled"]
    }
  }
}
```

<h2 id="create-and-manage-connection-profiles">
  Connection Profile の作成と管理
</h2>

Okta で [Express Configuration](/docs/ja-jp/authenticate/identity-providers/enterprise-identity-providers/okta/express-configuration) 機能を使用すると、Connection Profile が自動的に自動生成されます。また、Auth0 Management API を使用して Connection Profile を作成および管理することもできます。

<h3 id="configure-with-management-api">
  Management API で設定する
</h3>

Management API を使用するには、[Management API アクセストークン](/docs/ja-jp/secure/tokens/access-tokens/management-api-access-tokens)を取得する必要があります。Connection Profile を管理するには、次の Management API エンドポイントを使用できます。

* `POST` `/api/v2/connection-profiles`
* `GET` `/api/v2/connection-profiles`
* `PATCH` `/api/v2/connection-profiles/{id}`
* `GET` `/api/v2/connection-profiles/{id}`
* `GET` `/api/v2/connection-profiles/templates`

<h2 id="learn-more">
  詳しく見る
</h2>

* [Express Configuration](/docs/ja-jp/authenticate/identity-providers/enterprise-identity-providers/okta/express-configuration)
* [Management API を使用したユーザー管理](/docs/ja-jp/manage-users/user-accounts/manage-users-using-the-management-api)
* [My Organization API](/docs/ja-jp/manage-users/my-organization-api)