> 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/government-solutions/es/inicio-de-sesion-unico-sso/proveedores-de-identidades-de-soluciones-gubernamentales/microsoft-entra-id-saml-integration-government-solutions.md). # Integración SAML de Microsoft Entra ID Verkada Command tiene la capacidad de integrarse con Microsoft Entra ID de dos maneras: * Lenguaje de marcado de aserción de seguridad (SAML) * Sistema para la gestión de identidades entre dominios (SCIM) **SAML** gestiona la autenticación, lo que permite que Microsoft Entra ID administre el acceso a Command, igual que administra el acceso a otras aplicaciones de software como servicio (SaaS) ya integradas con tu inquilino de Microsoft Entra ID. Esto significa que puedes integrar Command en tu marco de identidades existente y autorizar a los usuarios de acuerdo con tus políticas actuales. **SCIM** te permite aprovechar tus usuarios y grupos existentes en Microsoft Entra ID y sincronizarlos con Command. Esto te permite conservar el IdP central actual y configurar permisos en Command usando tus usuarios y grupos existentes. *** ### Antes de comenzar Para una integración exitosa, asegúrate de tener lo siguiente: * Acceso de administrador a tu inquilino de Microsoft Entra ID * Genera un [ID de cliente](/government-solutions/es/inicio-de-sesion-unico-sso/proveedores-de-identidades-de-soluciones-gubernamentales.md#generate-client-id) *** {% tabs %} {% tab title="SAML" %} ## Configurar SAML en Microsoft Entra ID Verkada Command está disponible como una aplicación de galería en el mercado de Microsoft Entra ID y puede usarse con licencias Microsoft Entra ID Free, P1 y P2. {% stepper %} {% step %} **Agrega Verkada Command como una aplicación empresarial en tu directorio de Microsoft Entra ID: Ve a la página de resumen de Microsoft Entra ID y selecciona Aplicaciones empresariales.**
{% endstep %} {% step %} **En la parte superior de la página, selecciona Nueva aplicación y busca Verkada Command.** {% endstep %} {% step %} **Selecciona Verkada Command y haz clic en Crear. *****Ten paciencia, ya que puede tardar unos minutos en agregar la aplicación a tu***** Microsoft Entra ID *****inquilino*****.**
Una vez que la página se actualice, deberías ver un menú similar (como se muestra a continuación).\ ​ {% endstep %} {% step %} **En Configurar inicio de sesión único, haz clic en Comenzar.**
{% endstep %} {% step %} **Elige SAML como método de inicio de sesión único.**
{% endstep %} {% step %} **Si es necesario, haz clic en Editar para configurar más a fondo tu conexión SAML.** {% endstep %} {% step %} **Configura los siguientes campos. Debes agregar tu ID de cliente al final de cada URL antes de agregarlas a Microsoft Entra ID. Consulta el ejemplo debajo de la nota.** a. Para **Identificador**: [https://saml.prod-govus-pine.verkadagov.com/saml/sso](https://saml.prod-govus-pine.verkadagov.com/saml/sso/)\ b. Para **URL de respuesta**: \ c. Para **URL de inicio de sesión**: {% endstep %} {% step %} **Haz clic en Guardar.** {% endstep %} {% step %} **En Atributos y reclamaciones, haz clic en Editar para que coincida con estos atributos:**
{% hint style="warning" %} Si usas un atributo de origen diferente para el correo electrónico, configura los atributos de acuerdo con el atributo de origen que quieras usar. {% endhint %} {% endstep %} {% step %} **En Certificado de firma SAML > XML de metadatos de federación, haz clic en Descargar. Guarda el archivo XML para subirlo a Command.**
{% hint style="info" %} Los siguientes cuadros de diálogo que aparezcan contendrán herramientas que podrás usar una vez que la integración se haya finalizado. {% endhint %} {% endstep %} {% step %} **Continúa a Verkada Command para** [**completar la configuración**](/government-solutions/es/inicio-de-sesion-unico-sso/proveedores-de-identidades-de-soluciones-gubernamentales.md#command-configuration)**.** {% endstep %} {% endstepper %} *** ### Probar la conexión SAML en Microsoft Entra ID {% stepper %} {% step %} **Una vez que subas el archivo XML de metadatos en Command, haz clic en Probar en tu cuenta de Microsoft Entra ID para verificar la integración. Esta acción envía una notificación a todos los usuarios con una cuenta de Command, invitándolos a la organización.**
{% endstep %} {% step %} **Inicia sesión con Iniciar sesión como usuario actual. Si todo está configurado correctamente, deberías ser redirigido a la plataforma Command.** {% endstep %} {% step %} **Inicia sesión con inicio de sesión único para verificar el acceso a Command.** {% endstep %} {% endstepper %} {% hint style="warning" %} Microsoft Entra ID no admite grupos anidados para el acceso a aplicaciones en este momento. Todos los usuarios deben ser miembros directos de los grupos para poder asignarse. {% endhint %} *** ### Iniciar sesión mediante la aplicación móvil {% hint style="info" %} Las aplicaciones Command para Android e iOS admiten el inicio de sesión basado en SAML. {% endhint %} {% stepper %} {% step %} **Abre tu aplicación Command.** {% endstep %} {% step %} **En el campo de dirección de correo electrónico, escribe tu correo y haz clic en Siguiente.** {% endstep %} {% step %} **Deberías ser redirigido a tu IdP (Microsoft Entra ID) para completar el proceso de inicio de sesión.** {% endstep %} {% endstepper %} {% endtab %} {% tab title="SCIM" %} #### Integración SCIM de Microsoft Entra ID Verkada Command se integra con Microsoft Entra ID usando el Sistema para la gestión de identidades entre dominios (SCIM) para el aprovisionamiento automatizado de usuarios y grupos. SCIM sincroniza usuarios y grupos desde Microsoft Entra ID directamente en Command. Esto te permite: * Conservar Microsoft Entra ID como tu IdP central. * Actualizar automáticamente usuarios y grupos en Command a medida que ocurren cambios en Entra ID. * Asignar y administrar permisos en Command usando tu estructura de identidades existente. {% hint style="info" %} Si tu organización usa SCIM, los números de teléfono solo pueden aprovisionarse a través de SCIM. No podrás editar tu número de teléfono directamente en Command. {% endhint %} *** **Configuración de SCIM en Microsoft Entra ID** Antes de configurar SCIM en Microsoft Entra ID, debes generar tu token secreto en Command. {% stepper %} {% step %} **En Verkada Command, ve a Todos los productos > Admin.** {% endstep %} {% step %} **En Configuración de la organización, selecciona Inicio de sesión y acceso y registros > Aprovisionamiento de usuarios SCIM.** {% endstep %} {% step %} **Haz clic en Agregar dominio e introduce todos los dominios de correo electrónico relevantes que planeas usar con SCIM.** Esto genera un token SCIM, **que solo se puede ver una vez.** a. Haz clic en **Copiar** y guarda el token en un lugar seguro para usarlo más adelante en la configuración.\ b. Haz clic en [**Actualizar**](broken://pages/1128a57875f2d3e7580040fda4fdfdd3fa4e9594) para generar un nuevo token si no copiaste tu token o si no es visible. {% endstep %} {% step %} **Desde la página de inicio de Microsoft Entra ID, selecciona Aplicaciones empresariales > Nueva aplicación > Crear tu propia aplicación.** {% endstep %} {% step %} **En el panel lateral Crear tu propia aplicación, escribe el nombre de la aplicación, selecciona la aplicación que no está en la galería y haz clic en Crear.**
{% endstep %} {% step %} **En Aprovisionar cuentas de usuario, haz clic en Comenzar.**
{% endstep %} {% step %} **Selecciona Administrar > Aprovisionamiento.** {% endstep %} {% step %} **En la página de aprovisionamiento:** 1. Establece el modo de aprovisionamiento en Automático. 2. Establece la URL del inquilino para organizaciones de EE. UU.: {% hint style="warning" %} Para confirmar en qué región te encuentras, [consulta dónde se creó tu organización para Verkada](broken://pages/44138b75ef7894dcbb3b43f56bf3415685c4090e). {% endhint %} f. Completa el *token* SCIM generado en Verkada Command (paso 2) como el token secreto.
{% endstep %} {% step %} **Haz clic en Probar conexión. Deberías ver una confirmación de que la conexión SCIM es exitosa.**
{% endstep %} {% step %} **Haz clic en Guardar.** {% endstep %} {% endstepper %} *** **Configurar atributos para grupos de Microsoft Entra ID** {% stepper %} {% step %} **En el portal de Entra ID, haz clic para expandir el menú desplegable de asignaciones y selecciona Aprovisionar grupos de Microsoft Entra ID.**
{% endstep %} {% step %} **Configura tus asignaciones para que coincidan con esta captura de pantalla de la tabla de datos:**
{% hint style="warning" %} El **externalId** atributo se agrega de forma predeterminada. Elimina este atributo para evitar problemas con la configuración. {% endhint %} {% endstep %} {% step %} **(Opcional) Si necesitas agregar una asignación:** a. Haz clic en **Agregar nueva asignación** > selecciona el **Atributo de origen** para que coincida con el atributo de Microsoft Entra ID anterior.\ b. Establece el **Atributo de destino** para que coincida con el **customappsso** atributo anterior.\ c. Haz clic en **OK**. {% endstep %} {% step %} **Haz clic en Guardar y confirma los cambios, si es necesario.** {% endstep %} {% step %} **En la parte superior de la página, selecciona Aprovisionamiento para volver a la página de Aprovisionamiento.** {% endstep %} {% endstepper %} *** **Configurar atributos para usuarios de Microsoft Entra ID** {% stepper %} {% step %} **En el portal de Entra ID, haz clic para expandir el menú desplegable de asignaciones y luego selecciona Aprovisionar usuarios de Microsoft Entra ID para cambiar las asignaciones de usuario.** {% endstep %} {% step %} **Actualiza tus asignaciones para que coincidan con la tabla de atributos a continuación.** {% hint style="warning" %} El **Switch** atributo en Microsoft Entra ID se agrega como un **Expresión** tipo de asignación. {% endhint %} Switch(\[IsSoftDeleted], "False", "True", "True", "False") | Atributo customappsso | Atributo de Microsoft Entra ID | | ------------------------------------------------------------------------- | ------------------------------------------------------------ | | userName | userPrincipalName | | activo | 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:verkada:core:2.0:User:costCenter | costCenter | {% hint style="warning" %} Source Attribute es el Atributo de Microsoft Entra ID, y Target Attribute es el Atributo customappsso. Si alguno de los **customappsso** atributos no está disponible como Atributo de destino, es posible que debas agregarlos a tu plataforma Microsoft Entra ID como opciones. Para hacerlo, marca la **Mostrar opciones avanzadas** casilla y haz clic en **Editar lista de atributos para customappsso**. {% endhint %} {% hint style="warning" %} Los usuarios administrados por SCIM ya no tienen la opción de editar su número de teléfono en Command; en su lugar, solo pueden aprovisionarse mediante SCIM. En el lado del IDP, puedes configurar la asignación de atributos de modo que cualquier campo en tu instancia de IDP se asigne al **número de teléfono** campo en Command. También puedes configurarlo de modo que el **no** campo del IDP se asigne al **número de teléfono** campo en Command. Sin embargo, incluso en este caso, los números de teléfono permanecen bloqueados en Command y solo se pueden editar mediante SCIM. {% endhint %} {% endstep %} {% step %} **Haz clic en Guardar para confirmar los cambios.** {% endstep %} {% step %} **En la parte superior, selecciona Aprovisionamiento y activa el Estado de aprovisionamiento.**
{% endstep %} {% step %} **Dependiendo de los requisitos, ajusta el alcance a una de las opciones requeridas:** * Sincronizar todos los usuarios y grupos. * Sincronizar solo los usuarios y grupos asignados. {% hint style="warning" %} Asegúrate de que los usuarios y grupos estén asignados a la aplicación empresarial en Usuarios y grupos. Los asignados son los que se aprovisionan y aparecen en Command. {% endhint %} {% endstep %} {% step %} **Verifica que los usuarios estén asignados a la aplicación. Una vez que haya transcurrido el ciclo inicial de aprovisionamiento:** a. Deberías ver el número total de usuarios y grupos que se han aprovisionado correctamente en **Descripción general**.\ b. En Command, deberías ver estos usuarios y grupos poblados con la etiqueta asociada **Administrado por SCIM** . Estos usuarios y grupos sincronizados ahora pueden usarse en Command y asignarse permisos para controlar el acceso a la plataforma Command.
{% endstep %} {% endstepper %} **Eliminar usuarios administrados por SCIM de Command** Cuando un usuario administrado por SCIM se desactiva en tu proveedor de identidades, puedes eliminar al usuario de Command de dos maneras: * **Eliminar el usuario** – La cuenta se mueve a la página Usuarios eliminados pero conserva los registros históricos, roles y permisos. * **Eliminar permanentemente al usuario** – Se borran todos los roles, credenciales, registros de acceso y datos asociados. Si el usuario se vuelve a aprovisionar mediante SCIM, Command crea un nuevo grabar de usuario. {% hint style="warning" %} Debes desactivar al usuario en tu proveedor de identidades (IdP) antes de que cualquiera de las opciones de eliminación esté disponible en Command. {% endhint %} *** **(Opcional) Agregar credenciales de acceso a usuarios SCIM** {% stepper %} {% step %} **Inicia sesión en tu** [**portal de Azure**](https://portal.azure.com)**.** {% endstep %} {% step %} **En la barra de búsqueda, escribe y selecciona Aplicaciones empresariales.** {% endstep %} {% step %} **Selecciona tu aplicación Verkada SCIM.** {% endstep %} {% step %} **En el panel izquierdo, haz clic en Administrar > Aprovisionamiento.** {% endstep %} {% step %} **Expande el submenú Asignaciones y selecciona Aprovisionar usuarios de Microsoft Entra ID.** {% endstep %} {% step %} **En la parte inferior, haz clic en Mostrar opciones avanzadas > Editar lista de atributos para customappsso.** a. Agrega los atributos de la tabla a continuación.\ b. Haz clic en **Guardar**. {% endstep %} {% step %} **Vuelve a Aprovisionar usuarios de Microsoft Entra ID y selecciona Agregar nueva asignación.** a. Usa extensionAttributes 1-5 como **Atributos de origen** y asígnalos a los nuevos atributos creados para **Formato de tarjeta, Número de tarjeta, Número de tarjeta hexadecimal, Estado de la credencial,** y **Código de instalación** como los atributos de destino. 1. Referencia [Formatos de tarjeta aceptables](/access-control/es/instalacion/badge-reader-support/supported-card-formats.md) para los formatos de tarjeta aceptados y sus longitudes asociadas de código de instalación, número de tarjeta y/o número de tarjeta hexadecimal. 2. **Estado de la credencial** puede ser "activo", "desactivado" o "eliminado" 3. Haz clic en **Guardar**. b. Para sincronizar un identificador de departamento, agrega una nueva asignación con el atributo de origen que desees (p. ej., department o un atributo de extensión personalizado) y establece el atributo de destino en costCenter (urn:ietf:params:scim:schemas:extension:verkada:core:2.0:User:costCenter). Esto sincroniza un valor de ID de departamento con Command. {% endstep %} {% endstepper %} **Tabla de atributos** | | | | ------------------------------------------------------------------------------- | -------- | | **Nombre** | **Tipo** | | urn:ietf:params:scim:schemas:extension:verkada:access:2.0:User:cardFormat | Cadena | | urn:ietf:params:scim:schemas:extension:verkada:access:2.0:User:cardNumber | Cadena | | urn:ietf:params:scim:schemas:extension:verkada:access:2.0:User:cardNumberHex | Cadena | | urn:ietf:params:scim:schemas:extension:verkada:access:2.0:User:credentialStatus | Cadena | | urn:ietf:params:scim:schemas:extension:verkada:access:2.0:User:facilityCode | Cadena | | urn:ietf:params:scim:schemas:extension:verkada:core:2.0:User:costCenter | Cadena | **Editar el registro de la aplicación** Cada aplicación empresarial habilitada para SCIM creada en Entra AD normalmente requiere su propio registro de aplicación. {% stepper %} {% step %} **En la barra de búsqueda, escribe y selecciona Registros de aplicaciones.** {% endstep %} {% step %} **Cambia a la pestaña Todas las aplicaciones y busca el nombre de tu aplicación Verkada SCIM.** {% endstep %} {% step %} **En Resumen, anota el ID de aplicación (cliente) y el ID de directorio (inquilino) de tu registro de aplicación. Los necesitarás más adelante para configurar las credenciales de tu aplicación Command desde tu registro de aplicación.** {% endstep %} {% step %} **En la navegación izquierda, haz clic en Administrar.** a. En **Certificados y secretos:** 1. Haz clic en **Nuevo secreto de cliente**. 2. Establece la **Descripción** a "*Credenciales SCIM de Verkada"* y establece la fecha de vencimiento del certificado que prefieras. 3. Copia y guarda el valor que aparece en el **Valor** del nuevo secreto de cliente creado. **Esto solo se mostrará una vez.** e. En **Permisos de API**: 1. Haz clic en **Agregar permisos > Microsoft Graph.** 2. Selecciona **Permisos de aplicación** y busca "*User.ReadWrite.All*". 1. Marca la casilla para asignar los permisos. 2. Haz clic en **Agregar permisos**.
3. Para evitar tener que revisar y aprobar manualmente todos los cambios de fase comunicados entre Microsoft Entra ID y tu aplicación Command, selecciona **Conceder consentimiento de administrador para el directorio predeterminado**.
{% endstep %} {% endstepper %} {% hint style="warning" %} Consulta esta lista de credenciales para [formatos de tarjeta aceptables](/access-control/es/instalacion/badge-reader-support/supported-card-formats.md). {% endhint %} **Accede y actualiza tus credenciales** Para establecer los atributos de extensión y la información de credenciales para un usuario determinado, usa las instrucciones de la API de Graph en: . {% hint style="warning" %} Establecer el **credentialStatus** atributo en **activo** al configurar una credencial para un usuario es necesario para sincronizar correctamente las credenciales con Command. Donde el estado de la credencial (credentialStatus) es extensionAttribute4. {% endhint %} Ejemplo: ``` 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" } }' ``` *** **Sincronizar ID externa con Verkada** El campo externalId te permite asignar a tus usuarios un identificador persistente y único a nivel global a través de Microsoft Entra, que Verkada puede usar como referencia en todas las integraciones. Esto es especialmente útil en entornos empresariales grandes donde puede ser necesario desambiguar a los usuarios entre sistemas, o donde la sincronización de credenciales (p. ej., tarjetas de acceso) debe vincularse a una clave de identidad única. Verkada admite recibir y almacenar este valor como parte de su esquema de usuario SCIM. El campo distingue mayúsculas y minúsculas y, por lo general, se configura para aceptar un valor de cadena de un atributo designado en tu instancia de Microsoft Entra. Esta función admite flujos de trabajo avanzados, como la administración personalizada de credenciales, la automatización del ciclo de vida del empleado y una asignación coherente de usuarios entre organizaciones. **Mapear externalId de Azure a Verkada** Para sincronizar un valor externalId personalizado desde Microsoft Entra ID (Azure) a Verkada, sigue estos pasos: {% stepper %} {% step %} **Inicia sesión en tu portal de Azure.** {% endstep %} {% step %} **En la barra de búsqueda, escribe y selecciona Aplicaciones empresariales.** {% endstep %} {% step %} **Selecciona tu aplicación Verkada SCIM.** {% endstep %} {% step %} **En el panel izquierdo, haz clic en Administrar > Aprovisionamiento.** {% endstep %} {% step %} **Expande el submenú Asignaciones y selecciona Aprovisionar usuarios de Microsoft Entra ID.** {% endstep %} {% step %} **Desplázate hasta el final y haz clic en Mostrar opciones avanzadas > Editar lista de atributos para customappsso.** {% endstep %} {% step %} **Agrega el siguiente atributo nuevo:** `urn:ietf:params:scim:schemas:extension:verkada:core:2.0:User:externalId` * Tipo: Cadena * Distinción entre mayúsculas y minúsculas: Sí {% endstep %} {% step %} **Haz clic en Guardar.** {% endstep %} {% step %} **Vuelve a Aprovisionar usuarios de Microsoft Entra ID y haz clic en Agregar nueva asignación.** {% endstep %} {% step %} **Para Atributo de origen, selecciona el campo de Azure AD donde se almacena tu ID externa (p. ej., extensionAttribute1, employeeId, etc.).** {% endstep %} {% step %} **Para Atributo de destino, usa: urn:ietf:params:scim:schemas:extension:verkada:core:2.0:User:externalId** {% endstep %} {% step %} **Haz clic en OK y luego en Guardar.** {% endstep %} {% endstepper %} Una vez aprovisionado, el valor external\_id se almacenará en el grabar SCIM del usuario dentro de Verkada. Esto proporciona a los usuarios un ID flexible que se puede consultar mediante API y que sigue siendo único para su organización y está totalmente bajo su control, sin estar vinculado a los identificadores internos de Verkada ni expuesto en la interfaz de usuario. ![](/files/7a14a0f3e9edbd48e3b6087b399fafe3dc713330) {% hint style="info" %} **¿Prefieres verlo en acción?** Consulta el [tutorial en video](https://www.youtube.com/watch?v=YSMzqFwWlW4). {% endhint %} {% 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 dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://help.verkada.com/government-solutions/es/inicio-de-sesion-unico-sso/proveedores-de-identidades-de-soluciones-gubernamentales/microsoft-entra-id-saml-integration-government-solutions.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.