> ## 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 プロビジョニング用にユーザーを設定する方法を説明します。

# ユーザー属性プロファイル

export const ReleaseStageNotice = ({feature, stage, plans, contact, terms}) => {
  const stageTextMap = {
    "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>;
};

<ReleaseStageNotice feature="Self-Service Enterprise Configuration を使用するユーザー属性プロファイル" stage="ea" plans="B2B Professional and B2B Enterprise" terms="true" />

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

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

* **プロファイル定義**
  管理者は、以下を含む属性を定義するために ユーザー属性プロファイル を作成します。
  * 属性の表示方法
  * 属性を必須にする方法
  * 属性を Auth0 や外部 ID システムにマッピングする方法

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

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

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

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

**属性マッピング**

| **プロトコル**     | **説明**                                                                                                                                                                        |
| ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 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 では、これらをオーバーライドできます。

| **プロトコル**       | **説明**                                                              |
| --------------- | ------------------------------------------------------------------- |
| SAML            | `externalId` ではなく userName をマッピングします。                               |
| WAAD (Entra ID) | OIDC 識別子として `oid` を使用します。                                           |
| Okta            | Okta 固有のクレームを使用して、`middleNam`e や `federated_groups` などの属性をマッピングします。 |

<div id="user-id">
  ### ユーザーID
</div>

`user_id` プロパティは、OIDC クレーム、SAML 属性、または SCIM 属性を Auth0 のユーザー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](/ja/docs/authenticate/identity-providers/enterprise-identity-providers/configure-pkce-claim-mapping-for-oidc#context-object) をサポートする `${variable}` 構文を使用したリテラル値、動的コンテキストオブジェクト、またはその両方)
      * `display_name` は、セルフサービスフローでエンドユーザーに表示されるラベルです

<div id="strategy-overrides">
  ### 戦略オーバーライド
</div>

`strategy_overrides` プロパティを使用すると、個々のIDプロバイダー (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">
  ## ユーザー属性プロファイルを作成する
</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. 新しいプロファイルの **名前** と、必要に応じて **説明** を入力します。
4. 既存のプロファイルを選択するか、**+Create New** を選択して、ユーザー属性プロファイルのエントリを追加します。
   * 新しいプロファイルの場合は、**User Profile Attribute Name** を入力します。
   * プロファイル属性が、使用する Auth0 属性に適切にマッピングされていることを確認します。
5. **Create** を選択します。

新しい UAP を SSO 用に設定できます。

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

ユーザー属性プロファイルを管理するには、次の [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](/ja/docs/authenticate/enterprise-connections/self-service-enterprise-configuration)
* [OIDC 接続の PKCE とクレームマッピングを設定する](/ja/docs/authenticate/identity-providers/enterprise-identity-providers/configure-pkce-claim-mapping-for-oidc)
* [Auth0 を IdP/SAML アドオンとして使用して SAML 属性をマッピングする](/ja/docs/authenticate/protocols/saml/saml-configuration/saml-attribute-mapping-examples)
* [AD/LDAP プロファイル属性を Auth0 ユーザープロファイルにマッピングする](/ja/docs/authenticate/protocols/saml/saml-configuration/saml-attribute-mapping-examples)