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

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

• Okta
• Microsoft Entra ID
• Google Workspace — 以下のフィールドの一部をサポートします: メールアドレス、名と姓、部署、部署 ID、従業員 ID、役職、電話番号

---

フィールド要件

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

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

スキーマの種類

コア: 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

phone 属性の構文は IDプロバイダ によって異なります。

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

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

---

アクセスカード資格情報（Verkada Access 拡張機能）

お使いの組織で 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 は組織ごとに一意である必要があります。ディレクトリ内で重複する値がないか確認してください。