Configuración de Nitrokey para Entra ID¶
Compatible Nitrokeys |
|||||||
|---|---|---|---|---|---|---|---|
✓ active |
✓ active |
⨯ inactive |
⨯ inactive |
⨯ inactive |
⨯ inactive |
⨯ inactive |
⨯ inactive |
El Nitrokey 3 y el Passkey de Nitrokey admiten el aprovisionamiento de credenciales para Microsoft Entra, lo que permite una incorporación fluida de los empleados en entornos empresariales.
Configurar¶
Se requiere una aplicación de Microsoft Entra para permitir el registro programático de las credenciales de los usuarios. A continuación te ofrecemos la guía para configurarla, siempre que dispongas de los privilegios adecuados para ello.
Login to Entra Admin portal. Take a note of the primary domain which you will need later. Go to App Registrations on the left blade.
Selecciona «Nuevo registro».
Crea una nueva aplicación y asígnale un nombre. Haz clic en «Registrar».
Anota aquí el ID de cliente y el ID de inquilino. Los necesitarás más adelante. Ve a «Permisos de API» en la pestaña de la aplicación.
Click on Add a permission.
Select Microsoft Graph.
Selecciona «Permisos de la aplicación».
Busca «UserAuthenticationMethod.ReadWrite.All» y selecciónalo.
Busca «User.ReadWrite.All» y selecciónalo (solo si quieres poder crear usuarios desde «pynitrokey»). Haz clic en el botón «Añadir permisos».
Comprueba los permisos concedidos.
Haz clic en «Conceder consentimiento de administrador» y apruébalo.
Vuelve a la página de inicio de la aplicación y selecciona «Certificados y secretos» en el panel de la izquierda.
Haz clic en «Nuevo secreto de cliente»
Introduce un nombre y una fecha de caducidad, y a continuación haz clic en «Añadir».
Anota el «Client Secret» (no podrás verlo más adelante).
Haz clic en «Métodos de autenticación» en el panel de la izquierda.
Select Passkey (FIDO2).
Click on the Configure tab.
Click on Default Passkey profile
Desmarca la casilla «Exigir certificación» (solo si utilizas un Nitrokey que no cuente con la certificación de la Alianza FIDO. En el momento de redactar este documento, solo el Nitrokey 3A Mini cuenta con dicha certificación).
Click Save.
Como parte del proceso, has anotado el ID de inquilino, el ID de cliente, el secreto de cliente y el dominio principal. Crea un archivo config.json con esta información. A continuación se muestra un ejemplo.
{ "tenant": "49d2c4c8-9144-49ea-b5f3-fc11b848cd72", "client": "e9f25c9c-3870-4aa8-9659-a40f09de093e", "secret": "************************************", "domain": "Cryptane.onmicrosoft.com" }
Uso¶
Puedes utilizar la utilidad pynitrokey para configurar una Nitrokey para un usuario de tu inquilino.
nitropy fido2 provision-credential entra -c config.json <username> --create-user
En este caso, <username> podría ser la dirección de correo electrónico del usuario (el «principal de usuario», en términos de Microsoft) o una parte de la misma hasta antes del signo @. El parámetro –create-user indica a la herramienta que cree el usuario si este no existe en el inquilino de Entra.
Verification¶
El usuario puede utilizar el Nitrokey recién configurado para iniciar sesión en su cuenta de Microsoft. Sigue el enlace . Ejemplo de inicio de sesión en Microsoft con Nitrokey para iniciar sesión con este Nitrokey recién configurado.
Puede verificar la credencial asignada desde el portal de administración de Entra siguiendo estos pasos.
Ve a la opción «Usuarios» en el panel de la izquierda del centro de administración de Entra.
Si el usuario se creó con el parámetro –create-user, es posible que encuentres la entrada en la lista. Si se trata de un usuario ya existente, también aparecerá allí. Haz clic en el usuario al que se asignó la credencial.
Click on Authentication methods on the user blade.
Se mostrará la credencial registrada con los 5 primeros caracteres del UUID de Nitrokey. Puedes hacer clic en los tres puntos y, a continuación, en «Ver detalles» para consultar la información detallada sobre la credencial registrada.
Se mostraría información adicional sobre la credencial. Puede verificarla.
