> For the complete documentation index, see [llms.txt](https://help.verkada.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.verkada.com/command/ja/sekyuriti/identity-providers/user-provisioning-field-requirements-and-formatting-rules.md).

# ユーザープロビジョニングのフィールド要件と書式ルール

この記事では、ユーザープロビジョニングのために Verkada が SCIM およびその他の連携を通じて受け付ける各フィールドの書式要件について説明します。同期を有効にする前に、値が有効であることを確認するためにご利用ください。IDプロバイダ固有の手順ごとの属性マッピングについては、次を参照してください:

* [Okta](/command/ja/sekyuriti/identity-providers/okta.md#user-provisioning)
* [Microsoft Entra ID](/command/ja/sekyuriti/identity-providers/microsoft-entra-id.md#user-provisioning)
* [Google Workspace](/command/ja/sekyuriti/identity-providers/google-workspace.md#user-provisioning) — 以下のフィールドの一部をサポートします: メールアドレス、名と姓、部署、部署 ID、従業員 ID、役職、電話番号

***

## フィールド要件 <a href="#field-requirements" id="field-requirements"></a>

以下の表には、Verkada が受け付けるすべてのフィールドが含まれています。マークされたフィールドは **必須** は、すべてのユーザー作成リクエストに含まれている必要があります。

<table><thead><tr><th width="169.14453125">フィールド</th><th width="174.45703125">SCIM 属性</th><th>スキーマ</th><th width="114.83984375">必須</th><th>使用可能な文字</th></tr></thead><tbody><tr><td>メールアドレス（ユーザー名）</td><td><code>userName</code></td><td>コア</td><td>はい</td><td>有効なメールアドレス。最大255文字。</td></tr><tr><td>名</td><td><code>name.givenName</code></td><td>コア</td><td>はい</td><td>英字、数字、スペースを使用できます、 <code>&#x26;</code> <code>'</code> <code>-</code> <code>.</code> <code>,</code> <code>(</code> <code>)</code> <code>/</code> <code>@</code>. 最大100文字。</td></tr><tr><td>姓</td><td><code>name.familyName</code></td><td>コア</td><td>はい</td><td>英字、数字、スペースを使用できます、 <code>&#x26;</code> <code>'</code> <code>-</code> <code>.</code> <code>,</code> <code>(</code> <code>)</code> <code>/</code> <code>@</code>. 最大100文字。</td></tr><tr><td>ミドルネーム</td><td><code>name.middleName</code></td><td>コア</td><td>いいえ</td><td>最大255文字。</td></tr><tr><td>勤務先電話番号*</td><td><code>phoneNumbers</code></td><td>コア</td><td>いいえ</td><td>E.164 形式で国コードを含む（例: +14155552671）ことが、確実な検証のために必要です。最大 32 文字です。</td></tr><tr><td>外部ID</td><td><code>外部ID</code></td><td>Verkada</td><td>いいえ</td><td>英字、数字、 <code>_</code> <code>@</code> <code>-</code> <code>.</code> <code>+</code>。最大 128 文字。</td></tr><tr><td>従業員の役職</td><td><code>役職</code></td><td>コア</td><td>いいえ</td><td>最大255文字。</td></tr><tr><td>部署</td><td><code>部署</code></td><td>企業</td><td>いいえ</td><td>最大255文字。</td></tr><tr><td>会社名</td><td><code>組織</code></td><td>企業</td><td>いいえ</td><td>最大255文字。</td></tr><tr><td>従業員ID</td><td><code>従業員番号</code></td><td>企業</td><td>いいえ</td><td>最大255文字。</td></tr><tr><td>部署ID</td><td><code>コストセンター</code></td><td>企業</td><td>いいえ</td><td>最大255文字。</td></tr><tr><td>有効ステータス</td><td><code>有効</code></td><td>コア</td><td>いいえ</td><td>サポート <code>真</code> または <code>偽</code></td></tr></tbody></table>

#### スキーマの種類

**コア:** `urn:ietf:params:scim:schemas:core:2.0:User`

**Verkada 拡張機能:** `urn:ietf:params:scim:schemas:extension:verkada:core:2.0:User`

**エンタープライズ拡張機能:** `urn:ietf:params:scim:schemas:extension:enterprise:2.0:User`

{% hint style="warning" %}
phone 属性の構文は IDプロバイダ によって異なります。

* Okta: `phoneNumbers.^[type==work].value`
* Entra ID: `phoneNumbers[type eq "work"].value`

Verkada は、次のようにマークされた電話番号も受け付けます `primary: true` を勤務先の電話番号として、 `型` が明示的に設定されていなくても。
{% endhint %}

***

## アクセスカード資格情報（Verkada Access 拡張機能） <a href="#access-card-credentials-verkada-access-extension" id="access-card-credentials-verkada-access-extension"></a>

お使いの組織で Verkada Access を使用している場合、SCIM を使用してアクセスカード資格情報をカスタムの **Verkada アクセス拡張機能:** `urn:ietf:params:scim:schemas:extension:verkada:access:2.0:User`

| フィールド       | SCIM 属性            | スキーマ           | 注意                                                                                    |
| ----------- | ------------------ | -------------- | ------------------------------------------------------------------------------------- |
| カード形式       | `cardFormat`       | Verkada access | お使いのハードウェアでサポートされている形式と一致する必要があります（例： `"Standard 26-bit Wiegand"`, `"HID 37-bit"`、など） |
| カード番号       | `cardNumber`       | Verkada access | 整数。カード形式で定義されたビット範囲内に収まる必要があります                                                       |
| カード番号（16進数） | `cardNumberHex`    | Verkada access | 16進文字列。カード形式で定義されたビット範囲内に収まる必要があります                                                   |
| 施設コード       | `facilityCode`     | Verkada access | 整数。カード形式で定義されたビット範囲内に収まる必要があります。使用する形式でのみ必須です                                         |
| 資格情報ステータス   | `credentialStatus` | Verkada access | `有効`, `無効化済み`, `削除済み`                                                                 |

***

## 一般的なユーザープロビジョニングのエラーを解決する

| エラーメッセージ                                                                    | 原因                                            | 修正                                                        |
| --------------------------------------------------------------------------- | --------------------------------------------- | --------------------------------------------------------- |
| *「このメールドメインのユーザーは管理できません」*                                                  | ユーザーのメールドメインは、IDプロバイダの許可リストに含まれていません。         | Command のオーガナイゼーション' 設定 > Login & Access でドメインを追加してください。  |
| *"無効な引数: 名前が有効な名前の制約に準拠していません"*                                             | 名または姓に許可されていない文字が含まれています。                     | ディレクトリ内の名前を更新するか、属性マッピングを調整してその文字を除去してください。               |
| *"無効な引数: external ID に無効な文字があります。使用できるのは英数字、@、-、+、および . のみです"*              | external ID にスペースまたはサポートされていない記号が含まれています。     | 文字と数字のみを使用してください、 `_` `@` `-` `.` `+`.                    |
| *"無効な引数: external ID が長すぎます。最大長は 128 文字です"*                                 | external ID は 128 文字を超えています。                  | 値を短くするか、別の属性を使用してください。                                    |
| *"無効な電話番号です。長すぎます"*                                                         | 電話番号の文字列が 32 文字を超えています。                       | フォーマット文字を削除するか、マッピング内の値を短くしてください。                         |
| *"フィールドに対するサポートされていない操作: \[...]. このエラーを修正するには、IDプロバイダでこれらのマッピングを解除してください。"* | あなたのIDプロバイダは、Verkada がサポートしていないフィールドを同期しています。 | IdP の属性マッピングから、一覧のフィールドを削除してください。                         |
| *"ユーザーはすでに存在します: {email}"*                                                  | このメールアドレスのユーザーは、すでにこの SCIM プロバイダによって管理されています。 | 対応は不要です。                                                  |
| *"ユーザーは管理できません {email}"*                                                    | このユーザーは、同じ組織内の別の SCIM プロバイダによって管理されています。      | 別の SCIM 連携が有効になっているか確認してください。                             |
| *"external id {id} を持つユーザーはすでに存在します"*                                       | 組織内の別のユーザーがすでにこの external ID を持っています。         | external ID は組織ごとに一意である必要があります。ディレクトリ内で重複する値がないか確認してください。 |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.verkada.com/command/ja/sekyuriti/identity-providers/user-provisioning-field-requirements-and-formatting-rules.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.