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

この記事では、SCIMおよびユーザープロビジョニングのためのその他の連携を通じてVerkadaが受け入れる各フィールドの書式要件について説明します。同期を有効にする前に、値が有効であることを確認するためにご利用ください。お使いの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	externalId	Verkada	いいえ	英字、数字、 _ @ - . +最大128文字。
役職名	title	コア	いいえ	最大255文字までです。
部署	department	エンタープライズ	いいえ	最大255文字までです。
会社名	組織	エンタープライズ	いいえ	最大255文字までです。
従業員ID	employeeNumber	エンタープライズ	いいえ	最大255文字までです。
部署ID	costCenter	エンタープライズ	いいえ	最大255文字までです。
有効状態	有効	コア	いいえ	対応 true または false

スキーマタイプ

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

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

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

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

---

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

お使いの組織がVerkada Accessを使用している場合、カスタムの Verkada Access 拡張: 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	整数。カード形式で定義されたビット範囲内に収まる必要があります。1つを使用する形式でのみ必須です
資格情報ステータス	credentialStatus	Verkada Access	有効, 無効化済み, 削除済み

---

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

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