Microsoft Entra ID SAML-Integration
Konfigurieren Sie SSO und Benutzerbereitstellung mit Microsoft Entra ID (Azure AD) für Ihre Behördenlösungen-Organisation
Verkada Command kann sich auf zwei Arten mit Microsoft Entra ID integrieren:
Sicherheits-Assertions-Markup-Sprache (SAML)
System für Cross-Domain Identity Management (SCIM)
SAML übernimmt die Authentifizierung und ermöglicht Microsoft Entra ID, den Zugriff auf Command zu verwalten, genau wie es den Zugriff auf andere Software-as-a-Service-(SaaS)-Anwendungen verwaltet, die bereits mit Ihrem Microsoft Entra ID-Mandanten integriert sind. Das bedeutet, dass Sie Command in Ihr vorhandenes Identitätsframework integrieren und Benutzer gemäß Ihren aktuellen Richtlinien autorisieren können.
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 mit Ihren vorhandenen Benutzern und Gruppen konfigurieren.
Bevor Sie beginnen
Für eine erfolgreiche Integration stellen Sie sicher, dass Sie Folgendes haben:
Administratorzugriff auf Ihren Microsoft Entra ID-Mandanten
Generieren Sie eine Client-ID
SAML in Microsoft Entra ID einrichten
Verkada Command ist im Microsoft Entra ID-Marktplatz als Galerieanwendung verfügbar und kann mit Microsoft Entra ID Free-, P1- und P2-Lizenzen verwendet werden.
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.
Wählen Sie oben auf der Seite Neue Anwendung aus und suchen Sie nach Verkada Command.
Wählen Sie Verkada Command aus und klicken Sie auf Erstellen. Bitte haben Sie etwas Geduld, da es einige Minuten dauern kann, die Anwendung zu Ihrem Microsoft Entra ID Mandanten hinzuzufügen.
Sobald die Seite aktualisiert wurde, sollten Sie ein ähnliches Menü sehen (wie unten gezeigt).
Klicken Sie bei Single Sign-On einrichten auf Erste Schritte.
Wählen Sie SAML als Single-Sign-On-Methode aus.
Klicken Sie bei Bedarf auf Bearbeiten, um Ihre SAML-Verbindung weiter zu konfigurieren.
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 unter dem Hinweis.
a. Für Identifikator: https://saml.prod-govus-pine.verkadagov.com/saml/sso b. Für Antwort-URL: https://saml.prod-govus-pine.verkadagov.com/saml/sso c. Für Anmelde-URL: https://saml.prod-govus-pine.verkadagov.com/saml/login
Klicken Sie auf Speichern.
Klicken Sie bei Attribute & Claims auf Bearbeiten, um diese Attribute zu übernehmen:
Wenn Sie für E-Mail ein anderes Quellattribut verwenden, konfigurieren Sie die Attribute entsprechend dem Quellattribut, das Sie verwenden möchten.
Klicken Sie unter SAML Signing Certificate > Federation Metadata XML auf Herunterladen. Speichern Sie die XML-Datei, um sie in Command hochzuladen.
Die nächsten angezeigten Dialoge enthalten Tools, die Sie nach Abschluss der Integration verwenden können.
Fahren Sie in Verkada Command fort, um die Konfiguration abzuschließen.
Testen Sie die SAML-Verbindung in Microsoft Entra ID
Sobald Sie die XML-Metadatendatei in Command hochgeladen haben, klicken Sie in Ihrem Microsoft Entra ID-Konto auf Testen, um die Integration zu verifizieren. Dadurch wird eine Benachrichtigung an alle Benutzer mit einem Command-Konto gesendet, mit der sie zur Organisation eingeladen werden.
Melden Sie sich mit „Als aktueller Benutzer anmelden“ an. Wenn alles korrekt eingerichtet ist, sollten Sie zur Command-Plattform weitergeleitet werden.
Melden Sie sich mit Single Sign-On an, um den Zugriff auf Command zu überprüfen.
Microsoft Entra ID unterstützt verschachtelte Gruppen für den App-Zugriff derzeit nicht. Alle Benutzer müssen direkte Mitglieder von Gruppen sein, um zugewiesen werden zu können.
Über die mobile Anwendung anmelden
Die Command-Apps für Android und iOS unterstützen SAML-basiertes Anmelden.
Öffnen Sie Ihre Command-App.
Geben Sie im Feld für die E-Mail-Adresse Ihre E-Mail-Adresse ein und klicken Sie auf Weiter.
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 über System for Cross-Domain Identity Management (SCIM) für die automatische 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 vorgenommen werden.
Berechtigungen in Command anhand Ihrer vorhandenen Identitätsstruktur zuweisen und verwalten.
Wenn Ihre Organisation SCIM verwendet, können Telefonnummern nur über SCIM bereitgestellt werden. Sie können Ihre Telefonnummer in Command nicht direkt bearbeiten.
SCIM-Konfiguration in Microsoft Entra ID
Bevor Sie SCIM in Microsoft Entra ID konfigurieren, müssen Sie Ihr geheimen Token in Command generieren.
Gehen Sie in Verkada Command zu Alle Produkte > Admin.
Wählen Sie unter Organisationseinstellungen Anmeldung & Zugriff & Protokolle > SCIM-Benutzerbereitstellung aus.
Klicken Sie auf Domäne 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 angezeigt werden kann.
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.
Wählen Sie auf der Microsoft Entra ID-Startseite Enterprise-Anwendungen > Neue Anwendung > Eigene Anwendung erstellen aus.
Geben Sie im Bereich Eigene Anwendung erstellen den Namen der Anwendung ein, wählen Sie die Nicht-Galerieanwendung aus und klicken Sie auf Erstellen.
Klicken Sie unter Benutzerkonten bereitstellen auf Erste Schritte.
Wählen Sie Verwalten > Bereitstellung aus.
Auf der Bereitstellungsseite:
Setzen Sie den Bereitstellungsmodus auf Automatisch.
Setzen Sie die Mandanten-URL für US-Organisationen: https://vprovision.prod-govus-pine.verkadagov.com/scim
Um zu bestätigen, in welcher Region Sie sich befinden, verweisen Sie darauf, wo Ihre Organisation für Verkada erstellt wurde.
f. Füllen Sie das SCIM- Token aus, das in Verkada Command (Schritt 2) als geheimen Token generiert wurde.
Klicken Sie auf Verbindung testen. Sie sollten eine Bestätigung sehen, dass die SCIM-Verbindung erfolgreich ist.
Klicken Sie auf Speichern.
Attribute für Microsoft Entra ID-Gruppen konfigurieren
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.
Konfigurieren Sie Ihre Zuordnungen so, dass sie dem folgenden Screenshot der Datentabelle entsprechen:
Das externalId Attribut wird standardmäßig hinzugefügt. Entfernen Sie dieses Attribut, um Probleme mit der Konfiguration zu vermeiden.
(Optional) Wenn Sie eine Zuordnung hinzufügen müssen:
a. Klicken Sie auf Neue Zuordnung hinzufügen > wählen Sie das Quellattribut aus, sodass es dem Microsoft Entra ID-Attribut oben entspricht. b. Legen Sie das Zielattribut so fest, dass es dem customappsso Attribut oben entspricht. c. Klicken Sie auf OK.
Klicken Sie auf Speichern und bestätigen Sie die Änderungen gegebenenfalls.
Wählen Sie oben auf der Seite Bereitstellung aus, um zur Bereitstellungsseite zurückzukehren.
Attribute für Microsoft Entra ID-Benutzer konfigurieren
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.
Aktualisieren Sie Ihre Zuordnungen so, dass sie mit der Attributtabelle unten übereinstimmen.
Das Wechseln Sie Attribut unter Microsoft Entra ID-Attribut wird als Ausdrucks Zuordnungstyp hinzugefügt.
Switch([IsSoftDeleted], "False", "True", "True", "False")
userName
userPrincipalName
active
Switch([IsSoftDeleted], , "False", "True", "True", "False")
Titel
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:verkada:core:2.0:User:costCenter
costCenter
Das Source-Attribut ist das Microsoft Entra ID-Attribut, und das Zielattribut ist das customappsso-Attribut. Wenn einige der customappsso Attribute nicht als Zielattribute verfügbar sind, müssen Sie sie möglicherweise als Optionen zu Ihrer Microsoft Entra ID-Plattform hinzufügen. Aktivieren Sie dazu das Kontrollkästchen Erweiterte Optionen anzeigen und klicken Sie auf Attributliste für customappsso bearbeiten.
Von SCIM verwaltete Benutzer haben nicht mehr die Möglichkeit, ihre Telefonnummer in Command zu bearbeiten; stattdessen können sie nur über SCIM bereitgestellt werden. Auf der IdP-Seite können Sie Ihr Attribut-Mapping so einrichten, dass jedes Feld in Ihrer IdP-Instanz dem Telefonnummer Feld in Command zugeordnet wird. Sie können es auch so einrichten, dass das no Feld im IdP dem Telefonnummer Feld in Command zugeordnet wird. In diesem Fall bleiben Telefonnummern jedoch auch in Command gesperrt und können nur über SCIM bearbeitet werden.
Klicken Sie auf Speichern, um die Änderungen zu bestätigen.
Wählen Sie oben Bereitstellung aus und aktivieren Sie den Bereitstellungsstatus.
Passen Sie den Geltungsbereich je nach Anforderung auf eine der erforderlichen Optionen an:
Alle Benutzer und Gruppen synchronisieren.
Nur zugewiesene Benutzer und Gruppen synchronisieren.
Stellen Sie sicher, dass Benutzer und Gruppen der Enterprise-Anwendung unter Benutzer und Gruppen zugewiesen sind. Die zugewiesenen Benutzer und Gruppen werden bereitgestellt und in Command angezeigt.
Überprüfen Sie, ob Benutzer der Anwendung zugewiesen sind. Sobald 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 versehen 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 von SCIM verwalteter Benutzer in Ihrem Identitätsanbieter 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, Anmeldeinformationen, Zugriffsprotokolle und zugehörigen Daten werden gelöscht. Wenn der Benutzer erneut über SCIM bereitgestellt wird, erstellt Command einen neuen Benutzerdatensatz.
Sie müssen den Benutzer in Ihrem Identitätsanbieter (IdP) deaktivieren, bevor in Command eine der beiden Löschoptionen verfügbar ist.
(Optional) Zugriffsdaten zu SCIM-Benutzern hinzufügen
Melden Sie sich bei Ihrem Azure-Portal.
Geben Sie in der Suchleiste Enterprise-Anwendungen ein und wählen Sie sie aus.
Wählen Sie Ihre Verkada-SCIM-Anwendung aus.
Klicken Sie im linken Bereich auf Verwalten > Bereitstellung.
Erweitern Sie das Untermenü Zuordnungen und wählen Sie Microsoft Entra ID-Benutzer bereitstellen aus.
Klicken Sie unten auf Erweiterte Optionen anzeigen > Attributliste für customappsso bearbeiten.
a. Fügen Sie die Attribute aus der Tabelle unten hinzu. b. Klicken Sie auf Speichern.
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 Facility Code als Zielattribute erstellt wurden.
Referenz Zulässige Kartenformate für zulässige Kartenformate und die zugehörige Länge des Facility Codes, der Kartennummer und/oder der Kartennummer in Hex.
Anmeldestatus kann „aktiv“, „deaktiviert“ oder „gelöscht“ sein
Klicken Sie auf Speichern.
b. Um einen Abteilungsbezeichner zu synchronisieren, fügen Sie eine neue Zuordnung mit dem gewünschten Quellattribut hinzu (z. B. department oder ein benutzerdefiniertes Erweiterungsattribut) und setzen Sie das Zielattribut auf costCenter (urn:ietf:params:scim:schemas:extension:verkada:core:2.0:User:costCenter). Dadurch wird ein Abteilungs-ID-Wert mit 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:verkada:core:2.0:User:costCenter
Zeichenfolge
Bearbeiten Sie die App-Registrierung
Für jede für SCIM aktivierte Enterprise-Anwendung, die auf Entra AD erstellt wurde, ist in der Regel eine eigene App-Registrierung erforderlich.
Geben Sie in der Suchleiste App-Registrierungen ein und wählen Sie sie aus.
Wechseln Sie zur Registerkarte Alle Anwendungen und suchen Sie nach dem Namen Ihrer Verkada-SCIM-Anwendung.
Notieren Sie auf der Übersichtsseite die Anwendungs-(Client-)ID und die Verzeichnis-(Mandanten-)ID Ihrer App-Registrierung. Sie benötigen diese später, um Anmeldeinformationen für Ihre Command-Anwendung aus Ihrer App-Registrierung zu konfigurieren.
Klicken Sie in der linken Navigation auf Verwalten.
a. Unter Zertifikate & Geheimnisse:
Klicken Sie auf Neues Client-Secret.
Setzen Sie die Beschreibung auf "Verkada SCIM-Anmeldeinformationen" und setzen Sie das von Ihnen bevorzugte Ablaufdatum für das Zertifikat.
Kopieren Sie den angezeigten Wert und speichern Sie ihn in Wert des neu erstellten Client-Secrets. Dieser wird nur einmal angezeigt.
e. Unter API-Berechtigungen:
Klicken Sie auf Berechtigungen hinzufügen > Microsoft Graph.
Wählen Sie Anwendungsberechtigungen aus und suchen Sie nach "User.ReadWrite.All".
Aktivieren Sie das Kontrollkästchen, um die Berechtigungen zuzuweisen.
Klicken Sie auf Berechtigungen hinzufügen.
Um zu vermeiden, dass Sie alle zwischen Microsoft Entra ID und Ihrer Command-Anwendung übermittelten Übergangsänderungen manuell prüfen und genehmigen müssen, wählen Sie Administratorzustimmung für das Standardverzeichnis erteilen.
Verweisen Sie auf diese Liste der Anmeldeinformationen für zulässige Kartenformate.
Greifen Sie auf Ihre Anmeldeinformationen zu und aktualisieren Sie sie
Um die Erweiterungsattribute und die Anmeldeinformationen für einen bestimmten Benutzer festzulegen, verwenden Sie die Graph-API-Anweisungen unter: https://learn.microsoft.com/en-us/graph/extensibility-overview.
Das Festlegen des credentialStatus Attributs auf active wenn Sie eine Anmeldeinformation für einen Benutzer einrichten, ist erforderlich, um Anmeldeinformationen erfolgreich mit Command zu synchronisieren. Wenn der Anmeldestatus (credentialStatus) extensionAttribute4 ist.
Beispiel:
Externe ID mit Verkada synchronisieren
Das Feld externalId ermöglicht es Ihnen, Ihren Benutzern über Microsoft Entra eine dauerhafte, weltweit eindeutige Kennung zuzuweisen, auf die Verkada integrationsübergreifend verweisen kann. Dies ist besonders nützlich für große Unternehmensumgebungen, in denen Benutzer systemübergreifend eindeutig unterscheidbar sein müssen oder in denen synchronisierte Anmeldeinformationen (z. B. Zugangskarten) an einen eindeutigen Identitätsschlüssel gebunden werden müssen. Verkada unterstützt das Empfangen und Speichern dieses Werts als Teil seines SCIM-Benutzerschemas. Das Feld ist groß-/kleinschreibungsempfindlich und wird normalerweise so konfiguriert, dass es einen Zeichenfolgenwert aus einem bestimmten Attribut in Ihrer Microsoft Entra-Instanz akzeptiert. Diese Funktion unterstützt erweiterte Workflows wie benutzerdefiniertes Anmeldeinformationsmanagement, Automatisierung des Mitarbeiter-Lebenszyklus und konsistente Benutzerzuordnung über mehrere Organisationen hinweg.
externalId von Azure zu Verkada zuordnen
Um einen benutzerdefinierten externalId-Wert von Microsoft Entra ID (Azure) mit Verkada zu synchronisieren, gehen Sie wie folgt vor:
Melden Sie sich bei Ihrem Azure-Portal an.
Geben Sie in der Suchleiste Enterprise-Anwendungen ein und wählen Sie sie aus.
Wählen Sie Ihre Verkada-SCIM-Anwendung aus.
Klicken Sie im linken Bereich auf Verwalten > Bereitstellung.
Erweitern Sie das Untermenü Zuordnungen und wählen Sie Microsoft Entra ID-Benutzer bereitstellen aus.
Scrollen Sie nach unten und klicken Sie auf Erweiterte Optionen anzeigen > Attributliste für customappsso bearbeiten.
Fügen Sie das folgende neue Attribut hinzu:
urn:ietf:params:scim:schemas:extension:verkada:core:2.0:User:externalId
Typ: Zeichenfolge
Groß-/Kleinschreibung: Ja
Klicken Sie auf Speichern.
Gehen Sie zurück zu Microsoft Entra ID-Benutzer bereitstellen und klicken Sie auf Neue Zuordnung hinzufügen.
Wählen Sie für Quellattribut das Feld aus Azure AD aus, in dem Ihre externe ID gespeichert ist (z. B. extensionAttribute1, employeeId usw.).
Verwenden Sie für Zielattribut: urn:ietf:params:scim:schemas:extension:verkada:core:2.0:User:externalId
Klicken Sie auf OK und dann auf Speichern.
Nach der Bereitstellung wird der external_id-Wert im SCIM-Datensatz des Benutzers innerhalb von Verkada gespeichert. Dadurch erhalten Benutzer eine flexible, per API abfragbare ID, die für ihre Organisation eindeutig bleibt und vollständig unter ihrer Kontrolle steht, ohne an die internen Kennungen von Verkada gebunden zu sein oder in der Benutzeroberfläche angezeigt zu werden.
Möchten Sie es in Aktion sehen? Sehen Sie sich das Video-Tutorial an.
Zuletzt aktualisiert
War das hilfreich?