For the complete documentation index, see llms.txt. This page is also available as Markdown.

Microsoft Entra ID

Konfigurieren Sie SSO und Benutzerbereitstellung mit Microsoft Entra ID (Azure AD)

Je nach Anwendungsfall, Verkada Command kann sich unter anderem in Microsoft Entra ID und andere Identity Provider [IdPs] in den folgenden Bereichen integrieren:

  • OpenID Connect (OIDC)

  • Security Assertion Markup Language (SAML)

  • System for Cross-Domain Identity Management (SCIM)

OIDC und SAML beide übernehmen die Authentifizierung und ermöglichen es Microsoft Entra ID, den Zugriff auf Command auf dieselbe Weise zu verwalten, wie es den Zugriff auf andere SaaS-Anwendungen in Ihrer Umgebung verwaltet. Beide Protokolle ermöglichen es Ihnen, Command in Ihr bestehendes Identitäts-Framework zu integrieren und Benutzer gemäß Ihren aktuellen Richtlinien zu autorisieren.

SCIM ermöglicht es Ihnen, Ihre vorhandenen Benutzer und Gruppen in Microsoft Entra ID zu nutzen und mit Command zu synchronisieren. So können Sie den aktuellen zentralen IdP beibehalten und Berechtigungen in Command mithilfe Ihrer vorhandenen Benutzer und Gruppen konfigurieren.

Verkada empfiehlt OIDC gegenüber SAML für höhere Sicherheit und einfachere Konfiguration. OIDC ermöglicht außerdem Unternehmensgesteuerte Verschlüsselung.

Funktion
Unterstützt

OIDC-SSO

Ja

SAML-SSO

Ja

SCIM-Benutzerbereitstellung

Ja

ECE-Unterstützung

Ja


OIDC-basiertes SSO für Microsoft Entra ID

Verkada Command unterstützt Single Sign-On (SSO) über OpenID Connect (OIDC) mit Microsoft Entra ID. Diese Integration ermöglicht es unseren Benutzern, sich nahtlos und sicher mit ihren vorhandenen Microsoft-Entra-ID-Anmeldeinformationen zu authentifizieren, den Zugriff auf Command zu vereinfachen und die Gesamtsicherheit zu erhöhen.

Aktivieren Unternehmensgesteuerte Verschlüsselung (ECE) für erhöhte Sicherheit.


Microsoft Entra ID-Konfiguration

1

Melden Sie sich bei Ihrem Microsoft Entra ID-Portal.

2

Suchen Sie nach App-Registrierungen und wählen Sie diese aus.

3

Klicken Sie auf Neue Registrierung.

a. Benennen Sie die Anwendung Verkada SSO OIDC. b. Unter Unterstützte Kontotypen, wählen Sie Konten in diesem Organisationsverzeichnis nur (nur - Einzelmandant). c. Unter Umleitungs-URI, wählen Sie Einzelseitenanwendung (SPA) als Plattform und fügen Sie die folgenden Callback-URLs hinzu:

  1. https://org-short-name.command.verkada.com/oidc/aad/callback (ersetzen Sie org-short-name in der URI durch den Kurznamen Ihrer Command-Organisation.)

4

Klicken Sie auf Registrieren.

5

Kopieren und speichern Sie Ihre Anwendungs-(Client-)ID und Verzeichnis-(Mandanten-)ID an einem sicheren Ort. Sie werden sie benötigen, um das Setup in Verkada Command abzuschließen.

6

Klicken Sie links auf Verwalten > Eine API verfügbar machen.

a. Klicken Sie auf Fügen Sie einen Bereich hinzu. b. Klicken Sie auf Speichern und fortfahren. c. Geben Sie verkada_ece für die folgenden Felder ein:

  • Bereichsname

  • Name der Administratorzustimmung

  • Beschreibung der Administratorzustimmung

  • Anzeigename für Benutzerzustimmung

  • Beschreibung der Benutzerzustimmung

d. Setzen Sie Wer kann zustimmen? auf Administratoren und Benutzer. e. Klicken Sie auf Bereich hinzufügen.


Verkada Command-Konfiguration

1

Gehen Sie in Verkada Command zu Alle Produkte > Admin.

2

Wählen Sie in der linken Navigation Login & Access aus.

3

Wählen Sie Single Sign-On Configuration aus.

4

Klicken Sie unter OIDC Configuration auf Add New.

a. Aktivieren Sie Aktivieren. b. (Optional) Aktivieren Sie OIDC-SSO erforderlich. c. Unter Wählen Sie Anbieter, wählen Sie Microsoft Entra ID. d. Unter Client und Mandant hinzufügen, klicken Sie auf :plus:.

  1. In das Client-ID Feld fügen Sie die Client-ID ein, die Sie von Microsoft Entra ID kopiert haben.

  2. In das Mandanten-ID Feld fügen Sie die Mandanten-ID ein, die Sie von Microsoft Entra ID kopiert haben.

  3. Klicken Sie auf Fertig.

e. Unter E-Mail-Domänen, klicken Sie auf :plus:.

  1. Geben Sie Ihre vorhandene Domänenname ein (z. B. @verkada.com).

  2. Klicken Sie auf Fertig.

5

Klicken Sie auf Login-Test ausführen.

6

Ein erfolgreicher Login-Test sollte zur OIDC-Konfigurationsseite weiterleiten. Sobald Sie angemeldet sind, fügen Sie die Domäne hinzu, die Sie auf die Whitelist setzen müssen.

7

Sobald Ihre Domäne hinzugefügt wurde, führen Sie den Login-Test erneut aus. SSO wird erst aktiviert, wenn dieser zweite Login-Test erfolgreich abgeschlossen wurde.

8

Sobald Ihre Domäne verifiziert ist, sollten Sie sehen, dass sie erfolgreich validiert wurde.


Anmeldung über die mobile Anwendung

Die Android- und iOS-Apps von Command unterstützen die OIDC-basierte Anmeldung.

1

Öffnen Sie Ihre Command-App.

2

Geben Sie im Feld für die E-Mail-Adresse Ihre E-Mail-Adresse ein und klicken Sie auf Weiter.

3

Sie sollten zu Ihrem IdP (Microsoft Entra ID) weitergeleitet werden, um den Anmeldevorgang abzuschließen.

Microsoft Entra ID SAML-Integration


SAML in Microsoft Entra ID einrichten

Verkada Command ist als Gallery-Anwendung registriert und im Microsoft Entra ID Marketplace zu finden; mit anderen Worten, Sie können es mit Microsoft-Entra-ID-Free-, Microsoft-Entra-ID-P1- und Microsoft-Entra-ID-P2-Lizenzen nutzen.

1

Fügen Sie Verkada Command als Enterprise-Anwendung in Ihrem Microsoft-Entra-ID-Verzeichnis hinzu: Gehen Sie zu Ihrer Microsoft-Entra-ID-Übersichtsseite und wählen Sie Enterprise-Anwendungen aus.

2

Wählen Sie oben auf der Seite Neue Anwendung und suchen Sie nach Verkada Command.

3

Wählen Sie Verkada Command aus und klicken Sie auf Erstellen. Haben Sie Geduld, denn das Hinzufügen der Anwendung zu Ihrem Microsoft Entra ID Mandanten.

Sobald die Seite aktualisiert wurde, sollten Sie ein ähnliches Menü sehen (wie unten gezeigt).

4

Klicken Sie bei Set up single sign-on auf Get started.

5

Wählen Sie SAML als Single-Sign-On-Methode aus.

6

Klicken Sie bei Bedarf auf Bearbeiten, um Ihre SAML-Verbindung weiter zu konfigurieren.

7

Konfigurieren Sie die folgenden Felder. Sie müssen Ihre Client-ID an das Ende jeder URL anhängen, bevor Sie sie zu Microsoft Entra ID hinzufügen. Siehe Beispiel unterhalb des Hinweises.

a. Für Bezeichner: Für US-Organisationen: https://vauth.command.verkada.com/saml/sso Für EU-Organisationen: https://saml.prod2.verkada.com/saml/ssoFür AUS-Organisationen: https://saml.prod-ap-syd.verkada.com/saml/sso

b. Für Antwort-URL: Für US-Organisationen: https://vauth.command.verkada.com/saml/sso Für EU-Organisationen: https://saml.prod2.verkada.com/saml/sso Für AUS-Organisationen: https://saml.prod-ap-syd.verkada.com/saml/sso

c. Für Anmelde-URL: Für US-Organisationen: https://vauth.command.verkada.com/saml/login Für EU-Organisationen: https://saml.prod2.verkada.com/saml/login Für AUS-Organisationen: https://saml.prod-ap-syd.verkada.com/saml/sso

8

Klicken Sie auf Speichern.

9

Klicken Sie bei Attribute & Claims auf Bearbeiten, um diese Attribute zu übernehmen:

10

Importieren Sie auf SAML Signing Certificate dieses Federation Metadata XML in Command.

11

Klicken Sie auf Herunterladen, um es für später zu speichern.

Die nächsten angezeigten Dialoge enthalten Tools, die Sie nach Abschluss der Integration verwenden können.

12

Fahren Sie mit Verkada Command fort, um die Konfiguration abzuschließen.


Testen Sie die SAML-Verbindung in Microsoft Entra ID

1

Sobald die Datei hochgeladen wurde, klicken Sie in Ihrem Microsoft Entra ID auf Testen, um die Integration zu testen. Eine Benachrichtigung wird an alle Benutzer gesendet, die ein Command-Konto haben (Einladung zur Organisation).

2

Melden Sie sich mit Als aktueller Benutzer anmelden an. Wenn alles korrekt eingerichtet ist, sollten Sie zur Command-Plattform weitergeleitet werden.

3

Melden Sie sich mit Single Sign-On an, um den Zugriff auf Command zu verifizieren.


Anmeldung über die mobile Anwendung

Die Android- und iOS-Apps von Command unterstützen die SAML-basierte Anmeldung.

1

Öffnen Sie Ihre Command-App.

2

Geben Sie im Feld für die E-Mail-Adresse Ihre E-Mail-Adresse ein und klicken Sie auf Weiter.

3

Sie sollten zu Ihrem IdP (Microsoft Entra ID) weitergeleitet werden, um den Anmeldevorgang abzuschließen.

Microsoft Entra ID SCIM-Integration

Verkada Command integriert sich mit Microsoft Entra ID unter Verwendung von System for Cross-Domain Identity Management (SCIM) für die automatisierte Bereitstellung von Benutzern und Gruppen.

SCIM synchronisiert Benutzer und Gruppen direkt von Microsoft Entra ID in Command. Dadurch können Sie:

  • Microsoft Entra ID als Ihren zentralen IdP beibehalten.

  • Benutzer und Gruppen in Command automatisch aktualisieren, wenn Änderungen in Entra ID auftreten.

  • Berechtigungen in Command mithilfe Ihrer bestehenden Identitätsstruktur zuweisen und verwalten.

Wenn Ihre Organisation SCIM verwendet, können Telefonnummern nur über SCIM bereitgestellt werden. Sie können Ihre Telefonnummer nicht direkt in Command bearbeiten.


SCIM in Microsoft Entra ID-Konfiguration

Bevor Sie SCIM in Microsoft Entra ID konfigurieren, müssen Sie Ihr geheimes Token in Command generieren.

1

Gehen Sie in Verkada Command zu Alle Produkte > Admin.

2

Wählen Sie unter Org-Einstellungen Login & Access & Logs > SCIM Users Provisioning aus.

3

Klicken Sie auf Domain hinzufügen und geben Sie alle relevanten E-Mail-Domänen ein, die Sie mit SCIM verwenden möchten.

Dadurch wird ein SCIM-Token generiert, das nur einmal sichtbar ist.

a. Klicken Sie auf Kopieren und speichern Sie das Token an einem sicheren Ort, um es später in der Konfiguration zu verwenden. b. Klicken Sie auf Aktualisieren um ein neues Token zu generieren, wenn Sie Ihr Token nicht kopiert haben oder es nicht sichtbar ist.

4

Wählen Sie auf der Microsoft-Entra-ID-Startseite Enterprise-Anwendungen > Neue Anwendung > Eigene Anwendung erstellen aus.

5

Geben Sie im Seitenbereich Eigene Anwendung erstellen den Namen der Anwendung ein, wählen Sie "Integrieren Sie jede andere Anwendung, die Sie in der Galerie nicht finden (Nicht-Galerie)", und klicken Sie auf Erstellen.

6

Klicken Sie unter Benutzerkonten bereitstellen auf Erste Schritte.

7

Wählen Sie Verwalten > Bereitstellung aus.

8

Auf der Bereitstellungsseite:

a. Setzen Sie den Bereitstellungsmodus auf Automatisch. b. Setzen Sie die Mandanten-URL auf:

f. Füllen Sie das SCIM Token aus, das in Verkada Command generiert wurde (Schritt 2), als geheimes Token.

9

Klicken Sie auf Verbindung testen. Sie sollten eine Bestätigung sehen, dass die SCIM-Verbindung erfolgreich ist.

10

Klicken Sie auf Speichern.


Attribute für Microsoft Entra ID-Gruppen konfigurieren

1

Klicken Sie im Entra-ID-Portal auf das Dropdown-Menü Zuordnungen, um es zu erweitern, und wählen Sie Microsoft Entra ID-Gruppen bereitstellen aus.

2

Konfigurieren Sie Ihre Zuordnungen so, dass sie mit diesem Screenshot der Datentabelle übereinstimmen:

3

(Optional) Wenn Sie eine Zuordnung hinzufügen müssen:

a. Klicken Sie auf Neue Zuordnung hinzufügen > wählen Sie das Quellattribut aus, damit es mit dem oben genannten Microsoft-Entra-ID-Attribut übereinstimmt. b. Setzen Sie das Zielattribut so, dass es mit dem customappsso oben genannten Attribut übereinstimmt. c. Klicken Sie auf OK.

4

Klicken Sie auf Speichern und bestätigen Sie die Änderungen bei Bedarf.

5

Wählen Sie oben auf der Seite Bereitstellung aus, um zur Bereitstellungsseite zurückzukehren.


Attribute für Microsoft Entra ID-Benutzer konfigurieren

1

Klicken Sie im Entra-ID-Portal auf das Dropdown-Menü Zuordnungen, um es zu erweitern, und wählen Sie dann Microsoft Entra ID-Benutzer bereitstellen aus, um die Benutzerzuordnungen zu ändern.

2

Aktualisieren Sie Ihre Zuordnungen so, dass sie mit der Attributtabelle unten übereinstimmen.

customappsso-Attribut
Microsoft Entra ID-Attribut

userName

mail

active

Switch([IsSoftDeleted], , "False", "True", "True", "False")

title

jobTitle

name.givenName

givenName

name.familyName

surname

phoneNumbers[type eq "work"].value

telephoneNumber

urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:employeeNumber

employeeId

urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:organization

companyName

urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:department

department

urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:costCenter

costCenter

3

Klicken Sie auf Speichern, um die Änderungen zu bestätigen.

4

Wählen Sie oben Bereitstellung aus und aktivieren Sie den Bereitstellungsstatus.

5

Passen Sie den Umfang je nach Anforderung an eine der erforderlichen Optionen an:

  • Alle Benutzer und Gruppen synchronisieren.

  • Nur zugewiesene Benutzer und Gruppen synchronisieren.

6

Überprüfen Sie, ob Benutzer der Anwendung zugewiesen sind. Nachdem der erste Bereitstellungszyklus abgeschlossen ist:

a. Sie sollten die Gesamtzahl der Benutzer und Gruppen sehen, die erfolgreich bereitgestellt wurden unter Übersicht. b. In Command sollten Sie sehen, dass diese Benutzer und Gruppen mit dem zugehörigen SCIM-Verwaltet Tag gefüllt sind. Diese synchronisierten Benutzer und Gruppen können nun in Command verwendet und mit Berechtigungen versehen werden, um den Zugriff auf die Command-Plattform zu steuern.

SCIM-verwaltete Benutzer aus Command löschen

Wenn ein SCIM-verwalteter Benutzer in Ihrem Identity Provider deaktiviert wird, können Sie den Benutzer auf zwei Arten aus Command entfernen:

  • Benutzer löschen – Das Konto wird auf die Seite Gelöschte Benutzer verschoben, behält jedoch historische Datensätze, Rollen und Berechtigungen bei.

  • Benutzer dauerhaft entfernen – Alle Rollen, Anmeldedaten, Zugriffsprotokolle und zugehörigen Daten werden gelöscht. Wenn der Benutzer per SCIM erneut bereitgestellt wird, erstellt Command einen neuen Benutzerdatensatz.


(Optional) Zugriffsdaten zu SCIM-Benutzern hinzufügen

1

Melden Sie sich bei Ihrem Azure-Portal.

2

Geben Sie in der Suchleiste Enterprise Applications ein und wählen Sie sie aus.

3

Wählen Sie Ihre Verkada-SCIM-Anwendung aus.

4

Klicken Sie im linken Bereich auf Verwalten > Bereitstellung.

5

Erweitern Sie das Untermenü Zuordnungen und wählen Sie Microsoft Entra ID-Benutzer bereitstellen aus.

6

Klicken Sie unten auf Erweiterte Optionen anzeigen > Attributliste für customappsso bearbeiten.

a. Fügen Sie die Attribute aus der folgenden Tabelle hinzu. b. Klicken Sie auf Speichern.

7

Gehen Sie zurück zu Microsoft Entra ID-Benutzer bereitstellen und wählen Sie Neue Zuordnung hinzufügen aus.

a. Verwenden Sie extensionAttributes 1-5 als Quellattribute und ordnen Sie sie den neuen Attributen zu, die für Kartenformat, Kartennummer, Kartennummer Hex, Anmeldestatus, und Anlagenkennung als Zielattribute erstellt wurden.

  1. Referenz Zulässige Kartenformate für zulässige Kartenformate und die zugehörigen Längen für Anlagenkennung, Kartennummer und/oder Kartennummer Hex.

  2. Anmeldestatus kann "active", "deactivated" oder "deleted" sein

  3. Klicken Sie auf Speichern.

b. Um eine Abteilungskennung zu synchronisieren, fügen Sie eine neue Zuordnung mit Ihrem gewünschten Quellattribut hinzu (z. B. department oder ein benutzerdefiniertes Erweiterungsattribut) und setzen Sie das Zielattribut auf costCenter (urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:costCenter). Dadurch wird ein Abteilungs-ID-Wert an Command synchronisiert.

Attributtabelle

Name
Typ

urn:ietf:params:scim:schemas:extension:verkada:access:2.0:User:cardFormat

Zeichenfolge

urn:ietf:params:scim:schemas:extension:verkada:access:2.0:User:cardNumber

Zeichenfolge

urn:ietf:params:scim:schemas:extension:verkada:access:2.0:User:cardNumberHex

Zeichenfolge

urn:ietf:params:scim:schemas:extension:verkada:access:2.0:User:credentialStatus

Zeichenfolge

urn:ietf:params:scim:schemas:extension:verkada:access:2.0:User:facilityCode

Zeichenfolge

urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:costCenter

Zeichenfolge

Die App-Registrierung bearbeiten

Jede SCIM-fähige Enterprise-Anwendung, die in Entra AD erstellt wurde, erfordert in der Regel eine eigene App-Registrierung.

1

Geben Sie in der Suchleiste App-Registrierungen ein und wählen Sie sie aus.

2

Wechseln Sie zur Registerkarte Alle Anwendungen und suchen Sie nach dem Namen Ihrer Verkada-SCIM-Anwendung.

3

Notieren Sie sich unter Übersicht die Anwendungs-(Client-)ID und die Verzeichnis-(Mandanten-)ID Ihrer App-Registrierung. Sie benötigen diese später, um Anmeldedaten für Ihre Command-Anwendung aus Ihrer App-Registrierung zu konfigurieren.

4

Klicken Sie in der linken Navigation auf Verwalten.

a. Unter Zertifikate & Geheimnisse:

  1. Klicken Sie auf Neues Client-Geheimnis.

  2. Setzen Sie das Beschreibung auf "Verkada SCIM-Anmeldeinformationen" und legen Sie das von Ihnen bevorzugte Ablaufdatum des Zertifikats fest.

  3. Kopieren Sie den im Wert des neu erstellten Client-Geheimnisses angezeigten Wert und speichern Sie ihn. Dieser wird nur einmal angezeigt.

e. Unter API-Berechtigungen:

  1. Klicken Sie auf Berechtigungen hinzufügen > Microsoft Graph.

  2. Wählen Sie Anwendungsberechtigungen und suchen Sie nach "User.ReadWrite.All".

    1. Aktivieren Sie das Kontrollkästchen, um die Berechtigungen zuzuweisen.

    2. Klicken Sie auf Berechtigungen hinzufügen.

  3. Um zu vermeiden, dass Sie alle zwischen Microsoft Entra ID und Ihrer Command-Anwendung übermittelten Stufenänderungen manuell überprüfen und genehmigen müssen, wählen Sie Administratorzustimmung für Standardverzeichnis erteilen.

Greifen Sie auf Ihre Berechtigungsnachweise zu und aktualisieren Sie sie

Um die Erweiterungsattribute und die Berechtigungsnachweisinformationen für einen bestimmten Benutzer festzulegen, verwenden Sie die Graph-API-Anweisungen unter: https://learn.microsoft.com/en-us/graph/extensibility-overview.

Beispiel:


Externe ID mit Verkada synchronisieren

Die externalId Das Feld ermöglicht es Ihnen, Ihren Benutzern über Microsoft Entra einen persistenten, global eindeutigen Bezeichner zuzuweisen, auf den Verkada integrationsübergreifend verweisen kann. Dies ist besonders nützlich in großen Unternehmensumgebungen, in denen Benutzer systemübergreifend eindeutig unterschieden werden müssen oder die Synchronisierung von Berechtigungsnachweisen (z. B. Zugangskarten) an einen eindeutigen Identitätsschlüssel gebunden sein muss. Verkada unterstützt den Empfang und die Speicherung dieses Werts als Teil seines SCIM-Benutzerschemas. Das Feld ist groß-/kleinschreibungssensitiv und wird in der Regel so konfiguriert, dass es einen Zeichenfolgenwert aus einem definierten Attribut in Ihrer Microsoft-Entra-Instanz akzeptiert. Diese Funktion unterstützt erweiterte Workflows wie benutzerdefiniertes Berechtigungsnachweismanagement, Automatisierung des Mitarbeiter-Lebenszyklus und konsistente Benutzerzuordnung über Organisationen hinweg.

externalId von Azure zu Verkada zuordnen

Um einen benutzerdefinierten externalId-Wert von Microsoft Entra ID (Azure) zu Verkada zu synchronisieren, befolgen Sie diese Schritte:

1

Melden Sie sich bei Ihrem Azure-Portal.

2

Geben Sie in der Suchleiste ein und wählen Sie Unternehmensanwendungen.

3

Wählen Sie Ihre Verkada-SCIM-Anwendung aus.

4

Klicken Sie im linken Bereich auf Verwalten > Bereitstellung.

5

Erweitern Sie das Zuordnungen Untermenü und wählen Sie Microsoft Entra ID-Benutzer bereitstellen.

6

Scrollen Sie nach unten und klicken Sie auf Erweiterte Optionen anzeigen > Attributliste für customappsso bearbeiten.

7

Fügen Sie das folgende neue Attribut hinzu:

urn:ietf:params:scim:schemas:extension:verkada:core:2.0:User:externalId

  • Typ: Zeichenfolge

  • Groß-/Kleinschreibung beachten: Ja

8

Klicken Sie auf Speichern.

9

Gehen Sie zurück zu Microsoft Entra ID-Benutzer bereitstellen und klicken Sie auf Neue Zuordnung hinzufügen.

10

Für Quellattribut, wählen Sie das Feld aus Azure AD aus, in dem Ihre externe ID gespeichert ist (z. B. extensionAttribute1, employeeId, usw.).

11

Für Zielattribut, verwenden Sie: urn:ietf:params:scim:schemas:extension:verkada:core:2.0:User:externalId

12

Klicken Sie auf OK und dann auf Speichern.

Nach der Bereitstellung wird der Wert external_id im SCIM-Datensatz des Benutzers in Verkada gespeichert. Dadurch erhalten Benutzer eine flexible, per API abfragbare ID, die in ihrer Organisation eindeutig bleibt und vollständig unter ihrer Kontrolle steht, ohne an die internen Kennungen von Verkada gebunden oder in der Benutzeroberfläche angezeigt zu werden.

Zuletzt aktualisiert

War das hilfreich?