Feldanforderungen und Formatierungsregeln für die Benutzerbereitstellung

Dieser Artikel beschreibt die Formatierungsanforderungen für jedes Feld, das Verkada über SCIM und andere Integrationen für die Benutzerbereitstellung akzeptiert. Verwenden Sie ihn, um zu überprüfen, ob Ihre Werte gültig sind, bevor Sie die Synchronisierung aktivieren. Schritt-für-Schritt-Anweisungen zur Attributzuordnung speziell für Ihren Identitätsanbieter finden Sie unter:

• Okta
• Microsoft Entra ID
• Google Workspace — unterstützt eine Teilmenge der folgenden Felder: E-Mail, Vor- und Nachname, Abteilung, Abteilungs-ID, Mitarbeiter-ID, Berufsbezeichnung und Telefonnummer

---

Feldanforderungen

Die folgende Tabelle deckt alle Felder ab, die Verkada akzeptiert. Felder, die mit Erforderlich gekennzeichnet sind, müssen in jeder Anfrage zur Benutzererstellung enthalten sein.

Feld	SCIM-Attribut	Schema	Erforderlich	Zulässige Zeichen
E-Mail-Adresse (Benutzername)	userName	Kern	Ja	Gültige E-Mail-Adresse. Maximal 255 Zeichen.
Vorname	name.givenName	Kern	Ja	Unterstützt Buchstaben, Zahlen, Leerzeichen, & ' - . , ( ) / @. Maximal 100 Zeichen.
Nachname	name.familyName	Kern	Ja	Unterstützt Buchstaben, Zahlen, Leerzeichen, & ' - . , ( ) / @. Maximal 100 Zeichen.
Zweiter Vorname	name.middleName	Kern	Nein	Maximal 255 Zeichen.
Geschäftstelefon*	phoneNumbers	Kern	Nein	Das E.164-Format mit Ländervorwahl (z. B. [phone]) ist für eine zuverlässige Verifizierung erforderlich. Maximal 32 Zeichen.
Externe ID	externalId	Verkada	Nein	Unterstützt Buchstaben, Zahlen, _ @ - . +. Maximal 128 Zeichen.
Berufsbezeichnung	title	Kern	Nein	Maximal 255 Zeichen.
Abteilung	department	Enterprise	Nein	Maximal 255 Zeichen.
Firmenname	organization	Enterprise	Nein	Maximal 255 Zeichen.
Mitarbeiter-ID	employeeNumber	Enterprise	Nein	Maximal 255 Zeichen.
Abteilungs-ID	costCenter	Enterprise	Nein	Maximal 255 Zeichen.
Aktivstatus	active	Kern	Nein	Unterstützt true oder false

Schema-Typen

Kern: urn:ietf:params:scim:schemas:core:2.0:User

Verkada-Erweiterung: urn:ietf:params:scim:schemas:extension:verkada:core:2.0:User

Enterprise-Erweiterung: urn:ietf:params:scim:schemas:extension:enterprise:2.0:User

Die Syntax des Telefon-Attributs unterscheidet sich je nach Identitätsanbieter.

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

Verkada akzeptiert auch eine Telefonnummer, die mit primary: true als Geschäftstelefon gekennzeichnet ist, auch wenn der Typ nicht explizit festgelegt ist.

---

Zugangskartendaten (Verkada Access-Erweiterung)

Wenn Ihre Organisation Verkada Access verwendet, können Sie Zugangskartendaten per SCIM mithilfe der benutzerdefinierten Verkada-Access-Erweiterung: urn:ietf:params:scim:schemas:extension:verkada:access:2.0:User

Feld	SCIM-Attribut	Schema	Hinweise
Kartenformat	cardFormat	Verkada Access	Muss einem von Ihrer Hardware unterstützten Format entsprechen (z. B., "Standard 26-bit Wiegand", "HID 37-bit", usw.)
Kartennummer	cardNumber	Verkada Access	Ganzzahl; muss in den durch das Kartenformat definierten Bitbereich passen
Kartennummer (Hex)	cardNumberHex	Verkada Access	Hex-String; muss in den durch das Kartenformat definierten Bitbereich passen
Facility-Code	facilityCode	Verkada Access	Ganzzahl; muss in den durch das Kartenformat definierten Bitbereich passen; nur für Formate erforderlich, die einen verwenden
Anmeldedatenstatus	credentialStatus	Verkada Access	active, deaktiviert, gelöscht

---

Häufige Fehler bei der Benutzerbereitstellung beheben

Fehlermeldung	Ursache	Lösung
"Benutzer mit dieser E-Mail-Domäne kann nicht verwaltet werden"	Die E-Mail-Domäne des Benutzers ist nicht in der Zulassungsliste Ihres Identitätsanbieters enthalten.	Fügen Sie die Domain in Command unter Organisationseinstellungen > Anmeldung & Zugriff hinzu.
"Ungültiges Argument: Der Name entspricht nicht den gültigen Namensbeschränkungen"	Vor- oder Nachname enthält ein nicht zulässiges Zeichen.	Aktualisieren Sie den Namen in Ihrem Verzeichnis oder passen Sie Ihre Attributzuordnung an, um das Zeichen zu entfernen.
"Ungültiges Argument: ungültige Zeichen in externer ID, nur alphanumerische Zeichen, @, -, + und . zulässig"	Externe ID enthält ein Leerzeichen oder ein nicht unterstütztes Symbol.	Verwenden Sie nur Buchstaben, Zahlen, _ @ - . +.
"Ungültiges Argument: Externe ID ist zu lang, maximale Länge 128 Zeichen"	Externe ID überschreitet 128 Zeichen.	Kürzen Sie den Wert oder verwenden Sie ein anderes Attribut.
"Ungültige Telefonnummer, zu lang"	Der Telefonnummern-String überschreitet 32 Zeichen.	Entfernen Sie Formatierungszeichen oder kürzen Sie den Wert in Ihrer Zuordnung.
"Nicht unterstützte Vorgänge für Felder: [...]. Heben Sie deren Zuordnung in Ihrem IdP auf, um diesen Fehler zu beheben."	Ihr Identitätsanbieter synchronisiert ein Feld, das Verkada nicht unterstützt.	Entfernen Sie die aufgeführten Felder aus der Attributzuordnung Ihres IdP.
"Benutzer ist bereits vorhanden: {email}"	Ein Benutzer mit dieser E-Mail-Adresse wird bereits von diesem SCIM-Anbieter verwaltet.	Keine Aktion erforderlich.
"Benutzer kann nicht verwaltet werden {email}"	Der Benutzer wird von einem anderen SCIM-Anbieter in derselben Organisation verwaltet.	Prüfen Sie, ob eine andere SCIM-Integration aktiv ist.
"Benutzer mit externer ID {id} existiert bereits"	Ein anderer Benutzer in Ihrer Organisation hat bereits diese externe ID.	Externe IDs müssen organisationsweit eindeutig sein. Prüfen Sie Ihr Verzeichnis auf doppelte Werte.