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

# Connection プロファイル

Auth0 は、Okta、Microsoft Entra ID、Google Workspace などの外部のフェデレーション型アイデンティティ プロバイダー（IdP（アイデンティティ プロバイダー））でユーザーを認証するための Enterprise Connection を提供します。設定済みの接続には、外部 IdP とのシングル サインオン（SSO）、ユーザー プロビジョニング、およびログアウト連携を統合するためのプロトコル固有の設定に加え、その接続が Auth0 の Universal Login や組織機能とどのように連携するかを制御するプライベート設定が含まれます。
Connection プロファイル（CP）により、Auth0 開発者は、サードパーティによって作成される Auth0 の Connection のプライベート設定をどのように構成するかを指定できます。

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

* **プロファイル定義**<p />
  管理者は Connection プロファイルを作成し、Auth0 の委任管理機能のいずれかを使用して接続が作成されるたびに、その接続に書き込まれるべきプロパティ値を定義します。

* **柔軟なスコープ**<p />
  プロファイルは現在、セルフサービス SSO と Okta Express Configuration のフローに関連付けられていますが、プロビジョニング、オンボーディング、権限管理、将来の Auth0 機能など、より幅広い用途で再利用できるように設計されています。

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

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

| **Property**                              | **Description**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| ----------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `connection_name_prefix_template`         | 接続の名前付けに使用しなければならないプレフィックスを表します。接続の `name` パラメータにマッピングされます。この値は、組織 ID と組織名に対する変数置換をサポートします。最終的なプレフィックスを生成するために、OIN ワークフローがこれらの値を置換する必要があります。変数は中括弧 ({}) で囲みます。<p /> サポートされる変数: <p /> <ul><li><code>org\_id</code>: 組織 ID</li><li><code>org\_name</code>: <a href="https://auth0.com/docs/manage-users/organizations/configure-organizations/create-organizations#auth0-dashboard">組織名</a></li></ul> <p /> 例: `con-{org_id}-`                                                                                                                                                                                                            |
| `enabled_features`                        | このリストは、構成済み接続でサポートされる機能を指定します。リストにない機能は許可されません。<p /> サポートされる値: <ul><li><code>scim</code>: 指定されている場合、SCIM を接続で構成できます。</li><li><code>universal\_logout</code>: 指定されている場合、この接続で Universal Logout 機能を使用できます。</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                      |
| `organization.assign_membership_on_login` | ログイン時に、ユーザーを自動的にその組織のメンバーとして割り当てるかどうかを指定します。これは、組織の `enabled_connections` サブリソースの `assign_membership_on_login` プロパティにマッピングされます。<Note> Okta との Express Configuration 連携では、`optional` は `required` として扱われます</Note> <p /><table class="table"><thead><tr><th><strong>Connection Profile の値</strong></th><th><strong>Enabled Connections の <code>assign\_membership\_on\_login</code> の値</strong></th></tr></thead><tbody><tr><td><code>none</code></td><td><code>false</code></td></tr><tr><td><code>optional</code></td><td><code>false</code></td></tr><tr><td><code>required</code></td><td><code>true</code></td></tr></tbody></table> |
| `organization`                            | 接続が作成される組織に適用される設定を含むオブジェクトです。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| `organization.show_as_button`             | 組織が選択された後に、ログイン画面で接続をボタンとして表示するかどうかを指定します。これは、有効化された接続の `show_as_button` 値にマッピングされます。<table class="table"><thead><tr><th><strong>Connection Profile の値</strong></th><th><strong>接続の <code>show\_as\_button</code> の値</strong> </th></tr></thead><tbody><tr><td><code>none</code></td><td><code>false</code></td></tr><tr><td><code>optional</code></td><td><code>true</code></td></tr><tr><td><code>required</code></td><td><code>true</code></td></tr></tbody></table>                                                                                                                                                                 |

<div id="example-connection-profile">
  ## Connection プロファイルの例
</div>

```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"
  ]
}
```

<div id="create-and-manage-connection-profiles">
  ## Connection プロファイルの作成と管理
</div>

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

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

Management API を使用するには、[Management API アクセストークン](/docs/ja-JP/secure/tokens/access-tokens/management-api-access-tokens) を取得する必要があります。Connection プロファイルを管理するために、次の 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`

<div id="learn-more">
  ## 関連情報
</div>

* [Express の構成](/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)
