> For the complete documentation index, see [llms.txt](https://help.verkada.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.verkada.com/command/de/sicherheit/identity-providers/microsoft-entra-id.md). # Microsoft Entra ID Konfigurieren Sie SSO und Benutzerbereitstellung mit Microsoft Entra ID (Azure AD) Je nach Anwendungsfall, [Verkada Command](/command/de/erste-schritte/get-started-with-verkada-command.md) kann unter anderem in den folgenden Funktionen mit Microsoft Entra ID und anderen Identitätsanbietern \[IdPs] integriert werden: * OpenID Connect (OIDC) * Security Assertion Markup Language (SAML) * System für Cross-Domain Identity Management (SCIM) **OIDC** und **SAML** übernehmen beide die Authentifizierung und ermöglichen es Microsoft Entra ID, den Zugriff auf Command genauso zu verwalten wie den Zugriff auf andere SaaS-Anwendungen in Ihrer Umgebung. 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. {% hint style="info" %} Verkada empfiehlt OIDC gegenüber SAML für erhöhte Sicherheit und einfachere Konfiguration. OIDC ermöglicht außerdem [Unternehmensgesteuerte Verschlüsselung](/command/de/sicherheit/enterprise-controlled-encryption.md). {% endhint %} | Funktion | Unterstützt | | --------------------------- | :---------: | | OIDC-SSO | Ja | | SAML-SSO | Ja | | SCIM-Benutzerbereitstellung | Ja | | ECE-Unterstützung | Ja | *** {% tabs %} {% tab title="OIDC (empfohlen)" %} #### 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-Anmeldedaten zu authentifizieren, wodurch der Zugriff auf Command vereinfacht und die allgemeine Sicherheit verbessert wird. {% hint style="info" %} Aktivieren [Unternehmensgesteuerte Verschlüsselung (ECE)](/command/de/sicherheit/enterprise-controlled-encryption.md) für erhöhte Sicherheit. {% endhint %} *** **Microsoft Entra ID-Konfiguration** {% stepper %} {% step %} **Melden Sie sich bei Ihrem** [**Microsoft Entra ID-Portal**](https://portal.azure.com)**.** {% endstep %} {% step %} **Suchen Sie nach App-Registrierungen und wählen Sie diese aus.** {% endstep %} {% step %} **Klicken Sie auf Neue Registrierung.** a. Benennen Sie die Anwendung **Verkada SSO OIDC.**\ b. Unter **Unterstützte Kontotypen,** wählen Sie **Konten nur in diesem Verzeichnis (nur – einzelner Mandant).**\ c. Unter **Umleitungs-URI**, wählen Sie **Einzelne Seitenanwendung** (SPA) als Plattform und fügen Sie die folgenden Callback-URLs hinzu: 1. 2. [https://org-short-name.command.verkada.com/oidc/aad/callback](http://org-short-name.command.verkada.com/oidc/aad/callback) (ersetzen Sie org-short-name in der URI durch den Kurzname Ihrer Command-Organisation.) {% hint style="warning" %} Achten Sie darauf, dass die Callback-URI keinen abschließenden Schrägstrich hat. {% endhint %} {% endstep %} {% step %} **Klicken Sie auf Registrieren.** {% endstep %} {% step %} **Kopieren und speichern Sie Ihre Anwendungs- (Client-) ID und Ihre Verzeichnis- (Mandanten-) ID an einem sicheren Ort. Sie benötigen sie, um die Einrichtung in Verkada Command abzuschließen.** {% endstep %} {% step %} **Klicken Sie links auf Verwalten > API freigeben.** a. Klicken Sie auf **Bereich hinzufügen.**\ b. Klicken Sie auf **Speichern und fortfahren**.\ c. Geben Sie *verkada\_ece* für die folgenden Felder ein: * Bereichsname * Name der Admin-Zustimmung * Beschreibung der Admin-Zustimmung * Name der Benutzerzustimmung * Beschreibung der Benutzerzustimmung d. Legen Sie **Wer kann zustimmen?** auf **Administratoren und Benutzer.**\ e. Klicken Sie auf **Bereich hinzufügen.**
{% endstep %} {% endstepper %} *** **Verkada-Command-Konfiguration** {% stepper %} {% step %} **Gehen Sie in Verkada Command zu Alle Produkte > Admin.** {% endstep %} {% step %} **Wählen Sie in der linken Navigation Anmeldung & Zugriff.** {% endstep %} {% step %} **Wählen Sie Single-Sign-On-Konfiguration.** {% endstep %} {% step %} **Klicken Sie unter OIDC-Konfiguration auf Neu hinzufügen.** a. Aktivieren Sie **Aktivieren.**\ b. (Optional) Aktivieren Sie **OIDC-SSO anfordern.**\ 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 aus Microsoft Entra ID kopiert haben. 2. In das **Mandanten-ID** Feld fügen Sie die Mandanten-ID ein, die Sie aus Microsoft Entra ID kopiert haben. 3. Klicken Sie auf **Fertig**. e. Unter **E-Mail-Domains,** klicken Sie auf :plus:**.** 1. Geben Sie Ihren vorhandenen Domainnamen ein (z. B. @verkada.com). 2. Klicken Sie auf **Fertig**.
{% endstep %} {% step %} **Klicken Sie auf Anmelde-Test ausführen.** {% endstep %} {% step %} **Ein erfolgreicher Anmelde-Test sollte zur OIDC-Konfigurationsseite weiterleiten. Sobald Sie angemeldet sind, fügen Sie die Domain hinzu, die Sie auf die Zulassungsliste setzen müssen.** {% endstep %} {% step %} **Sobald Ihre Domain hinzugefügt wurde, führen Sie den Anmelde-Test erneut aus. SSO wird erst aktiviert, wenn dieser zweite Anmelde-Test erfolgreich abgeschlossen wurde.** {% endstep %} {% step %} **Sobald Ihre Domain verifiziert wurde, sollten Sie sehen, dass sie erfolgreich validiert wurde.** {% endstep %} {% endstepper %} *** #### Über die mobile Anwendung anmelden {% hint style="info" %} Die Android- und iOS-Command-Apps unterstützen die OIDC-basierte Anmeldung. {% endhint %} {% stepper %} {% step %} **Öffnen Sie Ihre Command-App.** {% endstep %} {% step %} **Geben Sie im Feld für die E-Mail-Adresse Ihre E-Mail ein und klicken Sie auf Weiter.** {% endstep %} {% step %} **Sie sollten zu Ihrem IdP (Microsoft Entra ID) weitergeleitet werden, um den Anmeldevorgang abzuschließen.** {% endstep %} {% endstepper %} {% endtab %} {% tab title="SAML" %} ### Microsoft Entra ID SAML-Integration *** #### SAML in Microsoft Entra ID einrichten Verkada Command ist als Galerieanwendung registriert und im Microsoft Entra ID-Marktplatz zu finden; mit anderen Worten, Sie können sie mit Microsoft Entra ID Free-, Microsoft Entra ID P1- und Microsoft Entra ID P2-Lizenzen nutzen. {% hint style="danger" %} Zum Start benötigen Sie Ihre `Client-ID`. Erfahren Sie, wie Sie [sie generieren und Ihre E-Mail-Domains konfigurieren](/command/de/sicherheit/identity-providers.md#generate-client-id), und kehren Sie dann zu diesem Artikel zurück, um den Rest dieses Prozesses abzuschließen. {% endhint %} {% stepper %} {% step %} **Fügen Sie Verkada Command als Unternehmensanwendung in Ihrem Microsoft Entra ID-Verzeichnis hinzu: Gehen Sie zur Übersichtsseite Ihres Microsoft Entra ID und wählen Sie Unternehmensanwendungen aus.**
{% endstep %} {% step %} **Wählen Sie oben auf der Seite Neue Anwendung und suchen Sie nach Verkada Command.** {% endstep %} {% step %} **Wählen Sie Verkada Command aus und klicken Sie auf Erstellen. *****Seien Sie geduldig, da es einige Minuten dauern kann, die Anwendung zu Ihrem***** Microsoft Entra ID *****Mandanten*****.**
hinzuzufügen {% endstep %} {% step %} **Sobald die Seite aktualisiert wurde, sollten Sie ein ähnliches Menü sehen (wie unten gezeigt).**
{% endstep %} {% step %} **Wählen Sie SAML als Single-Sign-On-Methode.**
{% endstep %} {% step %} **Wenn nötig, klicken Sie auf Bearbeiten, um Ihre SAML-Verbindung weiter zu konfigurieren.** {% endstep %} {% step %} **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 der Notiz.** a. Für **Bezeichner**:\ Für US-Organisationen: \ Für EU-Organisationen: Für AUS-Organisationen: b. Für **Antwort-URL**:\ Für US-Organisationen: \ Für EU-Organisationen: \ Für AUS-Organisationen: c. Für **Anmelde-URL**:\ Für US-Organisationen: \ Für EU-Organisationen: [https://saml.prod2.verkada.com/saml/login](https://saml.prod2.verkada.com/saml/login/)\ Für AUS-Organisationen: {% hint style="warning" %} Um zu bestätigen, in welcher Region Sie sich befinden, beachten Sie bitte, wo [Ihre Organisation für Verkada erstellt wurde](/command/de/erste-schritte/get-started-with-verkada-command.md). {% endhint %}
{% endstep %} {% step %} **Klicken Sie auf Speichern.** {% endstep %} {% step %} **Klicken Sie unter Attribute & Claims auf Bearbeiten, um diese Attribute zu übernehmen:**
{% hint style="warning" %} Wenn Sie für E-Mail ein anderes Quellattribut verwenden, konfigurieren Sie die Attribute entsprechend dem Quellattribut, das Sie verwenden möchten. {% endhint %} {% endstep %} {% step %} **Importieren Sie auf dem SAML-Signaturzertifikat dieses Föderationsmetadaten-XML in Command.** {% endstep %} {% step %} **Klicken Sie auf Herunterladen, um es für später zu speichern.**
{% hint style="info" %} Die nächsten angezeigten Dialoge enthalten Tools, die Sie nach Abschluss der Integration verwenden können. {% endhint %} {% endstep %} {% step %} **Weiter zu Verkada Command, um** [**die Konfiguration abzuschließen**](/command/de/sicherheit/identity-providers.md#command-sso-configuration)**.** {% endstep %} {% endstepper %} *** #### Testen Sie die SAML-Verbindung in Microsoft Entra ID {% stepper %} {% step %} **Sobald die Datei hochgeladen wurde, klicken Sie in Ihrem Microsoft Entra ID auf Testen, um die Integration zu testen. Alle Benutzer, die über ein Command-Konto verfügen (Einladung zur Organisation), erhalten eine Benachrichtigung.**
{% endstep %} {% step %} **Melden Sie sich mit Als aktueller Benutzer anmelden an. Wenn alles korrekt eingerichtet ist, sollten Sie zur Command-Plattform weitergeleitet werden.** {% endstep %} {% step %} **Melden Sie sich mit Single Sign-On an, um den Zugriff auf Command zu überprüfen.** {% endstep %} {% endstepper %} {% hint style="warning" %} Microsoft Entra ID unterstützt derzeit keine verschachtelten Gruppen für den App-Zugriff. Alle Benutzer müssen direkte Mitglieder von Gruppen sein, um zugewiesen werden zu können. {% endhint %} *** #### Über die mobile Anwendung anmelden {% hint style="info" %} Die Android- und iOS-Command-Apps unterstützen die SAML-basierte Anmeldung. {% endhint %} {% stepper %} {% step %} **Öffnen Sie Ihre Command-App.** {% endstep %} {% step %} **Geben Sie im Feld für die E-Mail-Adresse Ihre E-Mail ein und klicken Sie auf Weiter.** {% endstep %} {% step %} **Sie sollten zu Ihrem IdP (Microsoft Entra ID) weitergeleitet werden, um den Anmeldevorgang abzuschließen.** {% endstep %} {% endstepper %} {% endtab %} {% tab title="Benutzerbereitstellung (SCIM)" %} #### Microsoft Entra ID SCIM-Integration Verkada Command integriert sich mit Microsoft Entra ID mithilfe von 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 sich in Entra ID Änderungen ergeben. * Berechtigungen in Command mithilfe Ihrer vorhandenen Identitätsstruktur zuweisen und verwalten. {% hint style="info" %} Wenn Ihre Organisation SCIM verwendet, können Telefonnummern nur über SCIM bereitgestellt werden. Sie können Ihre Telefonnummer nicht direkt in Command bearbeiten. {% endhint %} *** **SCIM-Konfiguration in Microsoft Entra ID** Bevor Sie SCIM in Microsoft Entra ID konfigurieren, müssen Sie Ihr geheimes Token in Command generieren. {% stepper %} {% step %} **Gehen Sie in Verkada Command zu Alle Produkte > Admin.** {% endstep %} {% step %} **Wählen Sie unter Org-Einstellungen Anmeldung & Zugriff & Protokolle > SCIM-Benutzerbereitstellung.** {% endstep %} {% step %} **Klicken Sie auf Domain hinzufügen und geben Sie alle relevanten E-Mail-Domains 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 bewahren Sie das Token an einem sicheren Ort auf, um es später in der Konfiguration zu verwenden.\ b. Klicken Sie auf [**Aktualisieren**](/command/de/sicherheit/identity-providers/scim-token-management.md) um ein neues Token zu generieren, wenn Sie Ihr Token nicht kopiert haben oder es nicht sichtbar ist. {% endstep %} {% step %} **Wählen Sie auf der Microsoft Entra ID-Startseite Unternehmensanwendungen > Neue Anwendung > Eigene Anwendung erstellen aus.** {% endstep %} {% step %} **Geben Sie im Seitenbereich "Eigene Anwendung erstellen" den Namen der Anwendung ein, wählen Sie "Integrieren Sie alle anderen Anwendungen, die Sie nicht in der Galerie finden (Nicht-Galerie)" und klicken Sie auf Erstellen.** {% hint style="warning" %} Wählen Sie nicht die Anwendung Verkada Command aus. Dies ist eine vorkonfigurierte reine SAML-Anwendung. {% endhint %}
{% endstep %} {% step %} **Klicken Sie unter Benutzerkonten bereitstellen auf Los geht's.**
{% endstep %} {% step %} **Wählen Sie Verwalten > Bereitstellung.** {% endstep %} {% step %} **Auf der Bereitstellungsseite:** a. Setzen Sie den Bereitstellungsmodus auf Automatisch. b. In Verkada Command, kehren Sie zurück zu **Admin > Anmeldung & Zugriff & Protokolle > SCIM-Benutzerbereitstellung**. Kopieren Sie die in der SCIM-Konfiguration angezeigte Mandanten-URL. c. Fügen Sie diesen Wert in das Feld Mandanten-URL in Microsoft Entra ID ein. d. Füllen Sie das in Verkada Command generierte SCIM-Token (Schritt 2) als geheimes Token aus.
{% endstep %} {% step %} **Klicken Sie auf Verbindung testen. Sie sollten eine Bestätigung sehen, dass die SCIM-Verbindung erfolgreich ist.**
{% endstep %} {% step %} **Klicken Sie auf Speichern.** {% endstep %} {% endstepper %} *** **Attribute für Microsoft Entra ID-Gruppen konfigurieren** {% stepper %} {% step %} **Klicken Sie im Entra ID-Portal auf das Dropdown-Menü Zuordnungen, um es zu erweitern, und wählen Sie Microsoft Entra ID-Gruppen bereitstellen.**
{% endstep %} {% step %} **Konfigurieren Sie Ihre Zuordnungen so, dass sie dieser Screenshot der Datentabelle entsprechen:**
{% hint style="warning" %} Das **externalId** Attribut wird standardmäßig hinzugefügt. Entfernen Sie dieses Attribut, um Probleme mit der Konfiguration zu vermeiden. {% endhint %} {% endstep %} {% step %} **(Optional) Wenn Sie eine Zuordnung hinzufügen müssen:** a. Klicken Sie auf **Neue Zuordnung hinzufügen** > wählen Sie das **Quellattribut** aus, um es an das Microsoft Entra ID-Attribut oben anzupassen.\ b. Legen Sie das **Zielattribut** so fest, dass es mit dem **customappsso** Attribut oben übereinstimmt.\ c. Klicken Sie auf **OK**. {% endstep %} {% step %} **Klicken Sie auf Speichern und bestätigen Sie die Änderungen, falls erforderlich.** {% endstep %} {% step %} **Wählen Sie oben auf der Seite Bereitstellung aus, um zur Bereitstellungsseite zurückzukehren.** {% endstep %} {% endstepper %} *** **Attribute für Microsoft Entra ID-Benutzer konfigurieren** {% stepper %} {% step %} **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.** {% endstep %} {% step %} **Aktualisieren Sie Ihre Zuordnungen, damit sie der folgenden Attributtabelle entsprechen.** | 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 | {% hint style="warning" %} Das **Switch** Attribut unter Microsoft Entra ID-Attribut wird als **Ausdruck** Zuordnungstyp hinzugefügt. {% endhint %} {% hint style="warning" %} Das Quellattribut ist das Microsoft Entra ID-Attribut, und das Zielattribut ist das customappsso-Attribut. Wenn eines der **customappsso** Attribute nicht als Zielattribute verfügbar ist, müssen Sie sie möglicherweise Ihrer Microsoft Entra ID-Plattform als Optionen hinzufügen. Aktivieren Sie dazu das **Erweiterte Optionen anzeigen** Feld und klicken Sie auf **Attributliste für customappsso bearbeiten**. {% endhint %} {% endstep %} {% step %} **Klicken Sie auf Speichern, um die Änderungen zu bestätigen.** {% endstep %} {% step %} **Wählen Sie oben Bereitstellung aus und aktivieren Sie den Bereitstellungsstatus.**
{% endstep %} {% step %} **Je nach den Anforderungen passen Sie den Umfang auf eine der erforderlichen Optionen an:** * Alle Benutzer und Gruppen synchronisieren. * Nur zugewiesene Benutzer und Gruppen synchronisieren. {% hint style="warning" %} Stellen Sie sicher, dass Benutzer und Gruppen der Unternehmensanwendung unter Benutzer und Gruppen zugewiesen sind. Die zugewiesenen sind diejenigen, die bereitgestellt werden und in Command vorhanden sind. {% endhint %} {% endstep %} {% step %} **Überprüfen Sie, ob Benutzer der Anwendung zugewiesen sind. Sobald der anfängliche Bereitstellungszyklus abgelaufen ist:** a. Sie sollten unter **Übersicht**.\ b. In Command sollten Sie sehen, dass diese Benutzer und Gruppen mit dem zugehörigen **SCIM-Verwaltet** -Tag ausgefü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.
{% endstep %} {% endstepper %} **SCIM-verwaltete Benutzer aus Command löschen** Wenn ein 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, Anmeldedaten, Zugriffsprotokolle und zugehörigen Daten werden gelöscht. Wenn der Benutzer erneut über SCIM bereitgestellt wird, erstellt Command einen neuen Benutzerdatensatz. {% hint style="warning" %} Sie müssen den Benutzer in Ihrem Identitätsanbieter (IdP) deaktivieren, bevor eine der Löschoptionen in Command verfügbar ist. {% endhint %} *** **(Optional) Zugriffsdaten zu SCIM-Benutzern hinzufügen** {% stepper %} {% step %} **Melden Sie sich bei Ihrem** [**Azure-Portal**](https://portal.azure.com)**.** {% endstep %} {% step %} **Geben Sie in der Suchleiste Unternehmensanwendungen ein und wählen Sie sie aus.** {% endstep %} {% step %} **Wählen Sie Ihre Verkada SCIM-Anwendung aus.** {% endstep %} {% step %} **Klicken Sie im linken Bereich auf Verwalten > Bereitstellung.** {% endstep %} {% step %} **Erweitern Sie das Untermenü Zuordnungen und wählen Sie Microsoft Entra ID-Benutzer bereitstellen.** {% endstep %} {% step %} **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**. {% endstep %} {% step %} **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 **Einrichtungscode** als Zielattribute erstellt wurden. 1. Referenz [Akzeptable Kartenformate](/access-control/de/installation/badge-reader-support/supported-card-formats.md) für akzeptierte Kartenformate und die zugehörigen Längen für Einrichtungscode, 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 dem gewünschten Quellattribut hinzu (z. B. department oder ein benutzerdefiniertes Erweiterungsattribut) und legen Sie das Zielattribut auf costCenter (`urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:costCenter`). Dadurch wird ein Wert für die Abteilungs-ID mit Command synchronisiert. {% endstep %} {% endstepper %} **Attributtabelle** | Name | Typ | | --------------------------------------------------------------------------------- | ------ | | `urn:ietf:params:scim:schemas:extension:verkada:access:2.0:User:cardFormat` | String | | `urn:ietf:params:scim:schemas:extension:verkada:access:2.0:User:cardNumber` | String | | `urn:ietf:params:scim:schemas:extension:verkada:access:2.0:User:cardNumberHex` | String | | `urn:ietf:params:scim:schemas:extension:verkada:access:2.0:User:credentialStatus` | String | | `urn:ietf:params:scim:schemas:extension:verkada:access:2.0:User:facilityCode` | String | | `urn:ietf:params:scim:schemas:extension:enterprise:2.0:User:costCenter` | String | **Die App-Registrierung bearbeiten** Für jede auf Entra AD erstellte SCIM-fähige Unternehmensanwendung ist in der Regel eine eigene App-Registrierung erforderlich. {% stepper %} {% step %} **Geben Sie in der Suchleiste App-Registrierungen ein und wählen Sie sie aus.** {% endstep %} {% step %} **Wechseln Sie zur Registerkarte Alle Anwendungen und suchen Sie nach dem Namen Ihrer Verkada SCIM-Anwendung.** {% endstep %} {% step %} **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.** {% endstep %} {% step %} **Klicken Sie in der linken Navigation auf Verwalten.** a. Unter **Zertifikate & Geheimnisse:** 1. Klicken Sie auf **Neuer Client-Geheimschlüssel**. 2. Legen Sie die **Beschreibung** auf "*Verkada SCIM-Anmeldedaten"* und legen Sie das von Ihnen bevorzugte Ablaufdatum für das Zertifikat fest. 3. Kopieren und speichern Sie den angezeigten Wert in der **Wert** des neu erstellten Client-Secrets. **Dies wird nur einmal angezeigt.** e. Unter **API-Berechtigungen**: 1. Klicken Sie auf **Berechtigungen hinzufügen > Microsoft Graph.** 2. Auswählen **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 kommunizierten Stufenänderungen manuell überprüfen und genehmigen müssen, wählen Sie **Administratorzustimmung für das Standardverzeichnis erteilen**.
{% endstep %} {% endstepper %} {% hint style="warning" %} Verweisen Sie auf diese Liste von Anmeldedaten für [zulässige Kartenformate](/access-control/de/installation/badge-reader-support/supported-card-formats.md). {% endhint %} **Greifen Sie auf Ihre Anmeldedaten zu und aktualisieren Sie sie** Um die Erweiterungsattribute und die Anmeldedateninformationen für einen bestimmten Benutzer festzulegen, verwenden Sie die Graph-API-Anweisungen unter: . {% hint style="warning" %} Festlegen des **credentialStatus** Attributs auf **active** beim Einrichten von Anmeldedaten für einen Benutzer erforderlich, um Anmeldedaten erfolgreich mit Command zu synchronisieren. Wobei der Anmeldedatenstatus (credentialStatus) extensionAttribute4 ist. {% endhint %} Beispiel: ``` curl --location --request PATCH 'https://graph.microsoft.com/v1.0/users/' \\ --header 'Authorization: Bearer ' \\ --header 'Content-Type: application/json' \\ --data '{ "onPremisesExtensionAttributes": { "extensionAttribute1": "Standard 26-bit Wiegand", "extensionAttribute2": "7777", "extensionAttribute3": "7", "extensionAttribute4": "active", "extensionAttribute5": "111" } }' ``` *** **External ID zu Verkada synchronisieren** Das `externalId` Das Feld ermöglicht es Ihnen, Ihren Benutzern über Microsoft Entra eine persistente, global eindeutige Kennung zuzuweisen, auf die Verkada über Integrationen hinweg referenzieren kann. Dies ist besonders nützlich für große Unternehmensumgebungen, in denen Benutzer systemübergreifend unterschieden werden müssen oder wenn synchronisierte Anmeldedaten (z. B. Zutrittskarten) an einen eindeutigen Identitätsschlüssel gebunden sein müssen. 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 bestimmten Attribut in Ihrer Microsoft-Entra-Instanz akzeptiert. Diese Funktion unterstützt erweiterte Workflows wie benutzerdefiniertes Anmeldedatenmanagement, Automatisierung des Mitarbeiterlebenszyklus und konsistente Benutzerzuordnung über Organisationsgrenzen 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: {% stepper %} {% step %} Melden Sie sich bei Ihrem **Azure-Portal.** {% endstep %} {% step %} Geben Sie in der Suchleiste Folgendes ein und wählen Sie **Unternehmensanwendungen.** {% endstep %} {% step %} Wählen Sie Ihre **Verkada-SCIM-Anwendung.** {% endstep %} {% step %} Klicken Sie im linken Bereich auf **Verwalten > Bereitstellung.** {% endstep %} {% step %} Erweitern Sie das **Zuordnungen** Untermenü und wählen Sie **Microsoft Entra ID-Benutzer bereitstellen.** {% endstep %} {% step %} Scrollen Sie nach unten und klicken Sie auf **Erweiterte Optionen anzeigen > Attributliste für customappsso bearbeiten.** {% endstep %} {% step %} **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 {% endstep %} {% step %} **Klicken Sie auf Speichern.** {% endstep %} {% step %} Gehen Sie zurück zu **Microsoft Entra ID-Benutzer bereitstellen** und klicken Sie auf **Neue Zuordnung hinzufügen.** {% endstep %} {% step %} Für **Quellattribut**, wählen Sie das Feld aus Azure AD aus, in dem Ihre externe ID gespeichert ist (z. B. `extensionAttribute1`, `employeeId`, usw.). {% endstep %} {% step %} Für **Zielattribut**, verwenden Sie: `urn:ietf:params:scim:schemas:extension:verkada:core:2.0:User:externalId` {% endstep %} {% step %} **Klicken Sie auf OK und dann auf Speichern.** {% endstep %} {% endstepper %} Sobald die Bereitstellung erfolgt ist, wird der external\_id-Wert im SCIM-Datensatz des Benutzers innerhalb von Verkada gespeichert. Dies bietet den Benutzern 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 oder in der Benutzeroberfläche angezeigt zu werden. ![](https://991790237-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNRq5qDDjsYNxwNzF1bcB%2Fuploads%2Fgit-blob-ad87e0166a1792938d4c35d10f1172332fbfa36e%2Fa1cab99d0a59e02d8322c174969b568cb1519438.png?alt=media) {% endtab %} {% endtabs %} --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://help.verkada.com/command/de/sicherheit/identity-providers/microsoft-entra-id.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.