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

> User Attribute Profile を使用して、セルフサービス環境で SCIM プロビジョニング用にユーザーを設定する方法を学びます。

# User Attribute Profile

User Attribute Profile (UAP) は、[SCIM](/docs/ja-jp/authenticate/protocols/scim)、[SAML](/docs/ja-jp/authenticate/protocols/saml)、[OIDC](/docs/ja-jp/authenticate/login/oidc-conformant-authentication) などのプロトコル間でユーザー属性を定義、管理、マッピングするための一貫した仕組みを提供します。[Self-Service Enterprise Configuration](/docs/ja-jp/authenticate/enterprise-connections/self-service-enterprise-configuration) に対応した UAP を使用すると、管理者はユーザー属性を定義し、そのプロファイルを認証プロトコル全体に適用することで、ユーザーのアイデンティティデータをより的確に制御できます。

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

* **プロファイル定義**
  管理者は User Attribute Profile を作成し、次のような属性を定義します。
  * 属性の表示方法
  * 属性を必須にする方法
  * 属性を Auth0 や外部のアイデンティティシステムにどのようにマッピングするか

* **柔軟な適用範囲**
  プロファイルは Self-Service Enterprise Configuration フローに関連付けられていますが、プロビジョニング、オンボーディング、権限管理に対応できるよう設計されています。

* **統合マッピングレイヤー**
  各属性は認証プロトコル全体にわたるマッピングに対応しており、Okta や Entra ID などの特定のプロバイダーや接続戦略向けに値を上書きすることもできます。

<div id="attribute-mapping-and-override">
  ## 属性マッピングとオーバーライド
</div>

UAP は、プロバイダー固有の要件に対応するため、複数のプロトコルに対応した属性定義と認証ストラテジーのオーバーライドをサポートしています。

**属性マッピング**

| **Protocol**  | **Description**                                                                                                                                                           |
| ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Auth0 Mapping | Auth0 に保存される標準属性 (`email`、`name`、`app_metadata.department`) 。                                                                                                             |
| OIDC Mapping  | 標準の OIDC クレーム (`sub`、`preferred_username`、`zoneinfo`) 。OIDC の標準クレームの詳細は、[Standard Claims](https://openid.net/specs/openid-connect-core-1_0.html#StandardClaims)を参照してください。 |
| SAML Mapping  | 1 つ以上のアサーション URI をサポートします (`http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress`) 。                                                                        |
| SCIM Mapping  | プロビジョニング属性 (`name.familyName`、`addresses[type eq "work"].country`) 。                                                                                                      |

**認証ストラテジーのオーバーライド**

一部のプロバイダーでは、標準外のマッピングが使用されます。UAP ではオーバーライドを設定できます。

| **Protocol**    | **Description**                                                    |
| --------------- | ------------------------------------------------------------------ |
| SAML            | `externalId` の代わりに userName をマッピングします。                             |
| WAAD (Entra ID) | OIDC の識別子として `oid` を使用します。                                         |
| Okta            | Okta 固有のクレームを使って、`middleNam`e や `federated_groups` などの属性をマッピングします。 |

<div id="user-id">
  ### User ID
</div>

`user_id` プロパティは、OIDC クレーム、SAML 属性、または SCIM 属性を Auth0 の User ID にどのようにマッピングするかを定義します。Auth0 のすべてのユーザーには ID が必要なため、このマッピングは必須です。

* OIDC の場合、選択肢は固定されています (通常は `sub`、Azure AD では `oid`、Google では `email`) 。
  * SAML と SCIM の場合は、マッピングの自由度が高く、複数の属性候補を指定できます。

<div id="user-attributes">
  ### ユーザー属性
</div>

`user_attributes` プロパティには、システムが IdP から受信したクレームを解釈し、それらを Auth0 ユーザープロファイルの属性として保存するためのマッピング情報が含まれます。

各属性はキーと値のペアで指定する必要があります。

* キーは属性名に対応します。
  * 値は以下を含むオブジェクトです。
    * `label`
    * `description`
    * `profile_required`
    * `auth0_mapping`
    * `saml_mapping`
    * `scim_mapping`
    * `oidc_mapping` は、次のプロパティを持つオブジェクトです
      * `mapping` は IdP から受信するクレームを表します (固定値、動的な context object、またはその両方。`${variable}` 構文を使用し、[context object](/docs/ja-jp/authenticate/identity-providers/enterprise-identity-providers/configure-pkce-claim-mapping-for-oidc#context-object) をサポートします)
      * `display_name` はセルフサービス フローでエンドユーザーに表示されるラベルです

<div id="strategy-overrides">
  ### 認証ストラテジーのオーバーライド
</div>

`strategy_overrides` プロパティを使用すると、個々のアイデンティティプロバイダー (IdP) ごとに例外を指定できます。すべての IdP が同じ識別子やクレームを提供するわけではないためです。

各オーバーライドでは、`user_id` または `user_attributes` で定義されたデフォルトを置き換える、プロトコル固有のマッピングを定義します。

<div id="examples">
  ## 例
</div>

<div id="user-identifier">
  ### ユーザー識別子
</div>

```json theme={null}
"user_id": {
  "oidc_mapping": "sub",
  "saml_mapping": [
    "http://schemas.xmlsoap.org/ws/2005/05/identity/claims/nameidentifier",
    "http://schemas.xmlsoap.org/ws/2005/05/identity/claims/upn",
    "http://schemas.xmlsoap.org/ws/2005/05/identity/claims/name"
  ],
  "scim_mapping": "externalId",
  "strategy_overrides": {
    "waad": {
      "oidc_mapping": "oid"
    },
    "samlp": {
      "scim_mapping": "userName"
    },
    "google-apps": {
      "oidc_mapping": "email"
    }
  }
},
```

* **デフォルトの識別子**: SCIM 経由の `externalId`。
* **SAML**: 複数の識別子 URI に対応。
* **OIDC**: `sub` を使用。
* **上書き設定**: SAML と WAAD ではマッピングをカスタマイズできます。

<div id="email-attribute">
  ### メールアドレス属性
</div>

```json theme={null}
"email": {
  "description": "Email",
  "label": "Email",
  "profile_required": true,
  "auth0_mapping": "email",
  "scim_mapping": "emails[primary eq true].value",
  "oidc_mapping": {
    "mapping": "${context.tokenset.email}",
    "display_name": "email"
  },
  "saml_mapping": [
    "http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress"
  ],
  "strategy_overrides": {
    "waad": {
      "scim_mapping": "emails[type eq \"work\"].value"
    }
  }
}
```

* ほとんどのプロファイルで推奨されます。
* Auth0、OIDC、SAML、SCIM 間で統一されています。
* WAAD の上書きにより、勤務先メールへの正しいマッピングが確保されます。

<div id="create-a-user-attribute-profile">
  ## User Attribute Profile を作成する
</div>

Auth0 Dashboard または Management API を使用して、Self-Service Enterprise Configuration で UAP を定義できます。現在は、Self-Service Enterprise Configuration で設定できます。

<div id="configure-with-auth0-dashboard">
  ### Auth0 Dashboard で設定する
</div>

1. [**Authentication > Enterprise > Self-Service Enterprise Configuration**](http://manage.auth0.com/*/connections/enterprise/self-service-profiles) に移動します。
2. **+Create Profile** を選択します。
3. 新しいプロファイルの **Name** と、必要に応じて **Description** を入力します。
4. 既存のプロファイルを選択するか、**+Create New** を選択して、User Attribute Profile エントリを追加します。
   * 新しいプロファイルの場合は、**User Profile Attribute Name** を入力します。
   * プロファイル属性が希望する Auth0 属性にマッピングされていることを確認します。
5. **Create** を選択します。

新しい UAP を SSO 用に設定できるようになります。

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

User Attribute Profiles を管理するために、以下の [Management API](https://auth0.com/docs/api/management/v2/introduction) エンドポイントを利用できます。

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

<div id="learn-more">
  ## 詳細情報
</div>

* [Self-Service Enterprise Configuration](/docs/ja-jp/authenticate/enterprise-connections/self-service-enterprise-configuration)
* [OIDC 接続の PKCE とクレームマッピングを設定する](/docs/ja-jp/authenticate/identity-providers/enterprise-identity-providers/configure-pkce-claim-mapping-for-oidc)
* [Auth0 を IdP/SAML Add-on として使用する場合の SAML 属性のマッピング](/docs/ja-jp/authenticate/protocols/saml/saml-configuration/saml-attribute-mapping-examples)
* [AD/LDAP のプロファイル属性を Auth0 ユーザープロファイルにマッピングする](/docs/ja-jp/authenticate/protocols/saml/saml-configuration/saml-attribute-mapping-examples)