Ir al contenido

Plataforma de identidad: documentación completa

docs.ironchip.com/identidad/

Generado el 4 de noviembre de 2026

Esta página reúne las 88 páginas de la sección, en el orden del menú. Quita los capítulos que no necesites y pulsa «Descargar PDF». Es un documento largo: el navegador puede tardar un poco en preparar la vista previa.

Capítulos incluidos

Introducción

Plataforma de identidad

IAM sin contraseñas con zonas seguras, ITDR y reglas dinámicas. Consola, apps móvil y de escritorio, protocolos OIDC, SAML y RADIUS, y más de 35 integraciones.

Cada acceso comprueba quién eres, con qué equipo entras y desde dónde. Sin contraseñas que filtrar ni códigos que interceptar, y encima del directorio y del proveedor de identidad que tu equipo ya administra.

Presentación del producto: plataforma de identidad sin contraseñas de Ironchip.

La plataforma se compone de una consola de administración, las aplicaciones de autenticación (móvil, escritorio y autenticadores físicos), los agentes que la conectan con el directorio y con los puestos, y un motor de políticas que evalúa cada acceso con su contexto. Puede actuar como proveedor de identidad completo o como segundo factor del que ya tienes. Arquitectura.

Sección Contenido
Administración Consola, usuarios y grupos, dispositivos, aplicaciones, permisos, sincronización con el directorio, distribución de la app, ITDR y exportación de eventos.
Guía de usuario Alta, app móvil y de escritorio, autenticador de Windows, FIDO2, token USB, tarjeta RFID y escritorios virtuales.
Protocolos Configuración de OIDC, SAML, RADIUS y autenticación HTTP para aplicaciones propias.
Integraciones Guías para Windows, macOS, Linux, Entra ID, Microsoft 365, Google Workspace, cortafuegos y VPN.
Referencia Arquitectura, historial de versiones y acuerdo de nivel de servicio.

Primeros pasos con la plataforma de identidad

Las tareas con las que arranca un despliegue en la consola: primer usuario, segundo administrador, sincronización, zonas seguras, políticas y aplicación.

Esta guía recorre, en orden, lo que hace un administrador la primera vez que entra en la consola de Ironchip. Cada paso enlaza con la guía detallada correspondiente. Cuando termines tendrás una aplicación protegida y un primer grupo de usuarios autenticándose desde sus zonas seguras.

  • Una cuenta de administrador en la consola. Ironchip la crea al dar de alta la compañía, en una reunión de arranque, con los correos y nombres de las primeras personas que la administrarán.
  • La app de Ironchip instalada en el móvil del administrador (App Store o Google Play).
  • Acceso al directorio de la organización (Active Directory, Entra ID o LDAP) si vas a sincronizar usuarios.

La consola abre con la pantalla Get started, que tiene una tarjeta por tarea: cada botón Let’s go! lleva al apartado donde se hace. Estas son las tareas con las que se empieza, con la tarjeta que las abre; el resto de tarjetas se describen en La pantalla Get started.

Pantalla Get started de la consola, con una tarjeta y un botón Let’s go! por tarea

  1. Añade un usuario (Add a new user). Crea a mano el primer usuario (puede ser otra persona del equipo de IT) para probar el flujo completo de alta antes de traer a toda la plantilla. Añadir un usuario.

  2. Nombra a un segundo administrador (Add a new Administrator). La tarjeta abre el grupo Ironchip Administrators: añade al menos a otra persona, para no depender de una sola cuenta. Asignar un administrador.

  3. Trae al resto de usuarios (Import users o Synchronize users). Impórtalos desde un archivo CSV o sincronízalos con SCIM; para Active Directory usa AD Connect, y para Entra ID, su aplicación empresarial. Sincronización de identidades.

  4. Define las zonas seguras (Manage corporate safe zones). Dibuja las zonas corporativas (sedes, plantas, centro de datos) desde las que se podrá entrar. Zonas seguras.

  5. Revisa las políticas de autenticación. Agrupa dispositivos y zonas seguras en las políticas que exigirás en cada acceso. Políticas de autenticación.

  6. Crea la primera aplicación (Create a new application) y da acceso a un grupo. Elige el tipo: OIDC o SAML para aplicaciones web, un servidor NPS o Passwordless RADIUS para VPN y red, el inicio de sesión de Windows, macOS o Linux para los equipos, o Custom code para aplicaciones propias. Crear una aplicación y Dar acceso a usuarios y grupos.

Conceptos

Zonas seguras y geofencing

Qué es una zona segura, cómo crear zonas personales y corporativas en la consola, qué significa cada nivel de verificación y cómo exigirlas en un acceso.

Una zona segura es un lugar, o un conjunto de lugares, desde el que una política permite una acción. Las zonas seguras son ubicaciones geográficas desde las que los usuarios suelen operar, y se usan para garantizar la seguridad de los accesos y evitar operaciones fraudulentas desde ubicaciones no autorizadas. Los administradores las gestionan desde la consola de administración y las exigen en los accesos a las aplicaciones a través de las políticas de zonas seguras.

Una zona segura es una zona desde la que el usuario suele operar. Una operación fraudulenta tiende a realizarse desde un lugar alejado de las zonas seguras.

Además, una zona segura es una localización geográfica única e insuplantable. Un administrador puede forzar que los usuarios solo puedan autenticarse desde la zona segura que se haya establecido.

El concepto de zona segura se complementa con el sistema de reconocimiento de dispositivos de Ironchip.

Las zonas seguras se ven en el apartado Directory > Safe zone de la consola, dividido en dos secciones: Personal y Corporate.

  • Las personales las crea cada usuario desde la app de Ironchip, en el lugar en el que está.
  • Las corporativas las dibuja el administrador en un mapa de la consola.

Una zona segura solo se exige en un acceso cuando forma parte de una política de zonas seguras que ese acceso usa. Consulta Exigir una zona segura en un acceso.

Cada usuario puede crear su propia zona segura desde su dispositivo enrolado:

  1. En la aplicación de Ironchip, abre el menú izquierdo y selecciona Llaves.
  2. Pulsa el icono +.
  3. Asigna un nombre a la clave para generar la zona segura personal.

Los pasos completos están en Crear una zona segura.

En la consola, Directory > Safe zone > Personal lista las zonas seguras personales de la compañía con las columnas Name, Created by, Platform, Access (Private o Public) y Manage.

Listado Directory > Safe zone > Personal con las columnas Name, Created by, Platform y Access

El administrador define las zonas seguras corporativas para toda la organización, dibujándolas en un mapa:

  1. Ve a Directory > Safe zone > Corporate y haz clic en Add corporate safe zone. Se abre la ventana Add a new corporate safe zone.
  2. Define el área de la zona. Puedes combinar varias formas:
    • Busca una población, una región o un país en Search location. Al elegir un resultado, su contorno se añade como un polígono.
    • Dibuja polígonos o círculos con las herramientas del mapa.
  3. Revisa la lista de formas, bajo Corporate safe zone. En cada forma puedes cambiar el nombre y el color, acercar el mapa a ella (Zoom to area) o quitarla (Remove). Clear all quita todas las formas tras confirmar en la ventana Clear all shapes.
  4. Escribe un nombre en Name, de 3 a 60 caracteres.
  5. Elige el nivel de verificación en Verification level: Strict (por defecto), Standard o Lenient. Consulta Niveles de verificación.
  6. Haz clic en Add.

Ventana Add a new corporate safe zone con el mapa, la lista de formas, el nombre y el desplegable Verification level

Si la consola muestra The corporate safe zone geometry is too large to be processed, simplifica los polígonos o divide el área en zonas más pequeñas.

El listado Corporate muestra cada zona con las columnas Name, Verification level y Manage. Al seleccionar una, el panel de la derecha muestra Safe zone information (el nombre y el nivel de verificación), Locations (los nombres de sus formas) y Overview (el mapa). Desde el menú Options de cada zona puedes:

  • Edit safe zone: abre la ventana Edit corporate safe zone, con los mismos campos. Guarda los cambios con Edit.
  • Delete safe zone: elimina la zona tras confirmarlo.

Listado Directory > Safe zone > Corporate con una zona seleccionada y su panel Safe zone information, Locations y Overview

Las zonas corporativas nuevas entran solas en las políticas predeterminadas Any corporate safe zone y Any user safezones.

El nivel de verificación de una zona corporativa decide con qué precisión se comprueba que el usuario está dentro de ella.

Nivel Cómo se verifica, según la consola
Strict Para una mayor precisión dentro del área, exige un dispositivo con servicios de localización precisos.
Standard Se basa solo en las señales electromagnéticas (EM), sin GPS. Equilibra la facilidad de uso con la confianza en la ubicación.
Lenient Usa solo la ubicación por IP. Es el que más cobertura da y el que menos garantía ofrece.

Una zona segura personal puede hacerse visible para todos los usuarios de la compañía. Por ejemplo, una zona común pública sería la oficina.

  1. Crea la zona segura desde tu dispositivo móvil, como de costumbre.
  2. En la consola, ve a Directory > Safe zone > Personal.
  3. En la fila de la zona, haz clic en Options y después en Make public.
  4. Confirma en la ventana Make personal safe zone public con Make.

La columna Access pasa a Public. Para deshacerlo, usa Options > Make private. Desde el mismo menú, Delete safe zone elimina la zona.

Si el usuario que creó la zona se ha eliminado, estas opciones quedan desactivadas. Hacer públicas zonas seguras puede estar limitado por el plan de la compañía: si llegas al límite, la consola te lo indica.

Una zona segura no tiene efecto por sí sola: se exige cuando una política de zonas seguras que la contiene se usa en el acceso de un grupo a una aplicación.

  1. Elige la política:
    • Una predeterminada: Any user safezones (todas las zonas), Any personal safe zone o Any corporate safe zone.
    • Una propia, con solo las zonas que quieras, creada en Authentication policies > Safe zone policies. Consulta Políticas de zonas seguras.
  2. Añade la política al acceso del grupo, en el paso Select authentication policies, normalmente en la misma fila que una política de dispositivos (AND). Consulta Cómo se combinan las políticas en un acceso.

Estas son las preguntas que más se repiten al definir las zonas seguras.

¿Se puede crear una zona segura y aplicarla solo a un grupo crítico de usuarios?

Sección titulada «¿Se puede crear una zona segura y aplicarla solo a un grupo crítico de usuarios?»

Sí. Las zonas seguras se exigen a través de los accesos, y cada acceso es de un grupo concreto:

  1. Crea la zona segura del entorno físico deseado (sala de servidores, sala de dirección, planta específica).
  2. Crea una política de zonas seguras que contenga solo esa zona.
  3. En el acceso de ese grupo (por ejemplo, «Equipo IT» o «Directivos») a la aplicación, exige la política junto con la de dispositivos. Los accesos de otros grupos no se ven afectados.

Ejemplo práctico: el equipo IT solo puede acceder a los sistemas críticos desde la sala de servidores; los empleados estándar tienen zonas más amplias.

¿Cómo funciona el geofencing de Ironchip sin GPS?

Sección titulada «¿Cómo funciona el geofencing de Ironchip sin GPS?»

Ironchip crea una huella electromagnética única del entorno físico: captura las señales wifi, GSM, LTE y Bluetooth y genera un «mapa de ondas» del espacio.

Al autenticarse, el dispositivo genera una nueva muestra y la compara con el mapa almacenado.

  • Con el nivel Standard no depende del GPS: le bastan las señales del entorno.
  • Un GPS falso o una VPN no lo engañan, porque compara señales y no coordenadas ni direcciones IP. La excepción es el nivel Lenient, que solo usa la ubicación por IP.
  • Funciona en interiores, donde el GPS falla.
  • Permite granularidad de sala dentro de un edificio.

En las zonas corporativas, el nivel de verificación decide qué se comprueba: Strict exige servicios de localización precisos, Standard usa solo las señales electromagnéticas y Lenient, solo la ubicación por IP. Consulta Niveles de verificación.

¿Se puede definir una zona por sala, por planta o por edificio?

Sección titulada «¿Se puede definir una zona por sala, por planta o por edificio?»

Sí, las tres opciones. La granularidad depende de las diferencias electromagnéticas del espacio. Una sala de servidores tiene señales muy distintas a las de la sala contigua, lo que permite esa precisión. La calibración se hace in situ durante la puesta en marcha.

En la consola puedes crear las zonas corporativas de dos formas, que se pueden combinar en la misma zona:

  • Por poblaciones, regiones y países, con Search location.
  • Con ubicaciones personalizadas, dibujando polígonos o círculos en el mapa.

¿Qué pasa si un usuario intenta autenticarse fuera de su zona segura?

Sección titulada «¿Qué pasa si un usuario intenta autenticarse fuera de su zona segura?»

La política de zonas seguras no se cumple, así que no vale ninguna fila del acceso que la exija:

  • Si el acceso tiene otra fila (OR) que no exige la zona, el usuario puede entrar cumpliendo esa fila. Por ejemplo, «dispositivo AND zona segura» OR «passkey AND contraseña».
  • Si todas las filas exigen la zona, se deniega el acceso.

Además, las reglas del ITDR pueden denegar el acceso o bloquear al usuario según el contexto de la autenticación.

¿Puede un usuario trabajar desde casa y autenticarse en Ironchip?

Sección titulada «¿Puede un usuario trabajar desde casa y autenticarse en Ironchip?»
  • Con una zona segura de domicilio incluida en la política que exige el acceso: Ironchip valida que el usuario está en su casa.
  • Sin zona de casa: si todas las filas del acceso exigen una zona segura, el usuario no puede entrar desde casa. Añade una fila alternativa (OR) para el teletrabajo con los factores que quieras exigir.
  • Con VPN e Ironchip: doble capa de protección para el acceso remoto.

Métodos de autenticación

Métodos de autenticación de Ironchip: app móvil, escritorio, passkeys y FIDO2, token USB, RFID, offline y magic link, y para qué puesto sirve cada uno.

La misma política sirve para quien lleva móvil, quien comparte terminal en planta y el proveedor que entra una vez al mes. Cada método verifica al usuario de forma distinta; casi todos pueden combinarse con la firma de ubicación.

Método Para quién Cómo se verifica Ubicación
App móvil Plantilla con teléfono propio o de empresa Notificación en el móvil, huella o cara y la firma del lugar, en un solo toque Con firma de ubicación
App de escritorio Oficinas donde el móvil no está permitido Clave guardada en el propio ordenador más un código temporal Con firma de ubicación
Passkeys y FIDO2 Servicios web y equipos con llave física Credencial criptográfica que no viaja al servidor, con la biometría del equipo Con firma de ubicación
Reconocimiento facial Puestos donde no se quiere tocar nada La cámara del equipo o del móvil, ligada a ese dispositivo concreto Con firma de ubicación
Token USB Salas limpias, planta y entornos sin biometría La clave se parte entre el token y el equipo: hacen falta los dos Con firma de ubicación
Tarjeta NFC / RFID Turnos y terminales compartidos La misma tarjeta de fichar, acercada a un lector Con firma de ubicación
Magic link / SMS Colaboradores que entran de forma puntual Enlace o código que caduca tras un uso Ubicación opcional
Sin agentes Servidores y equipos que no admiten instalaciones La red de origen y la credencial que ya usaban, evaluadas en el servidor Con firma de ubicación

Cada método enlaza con su guía de uso. El resto de guías están en la guía de usuario.

Factor Descripción
Ubicación (Location) La zona segura del usuario como factor de identidad contextual, continuo y silencioso.
Push Notification Notificación en el móvil o el escritorio del usuario para aprobar o rechazar accesos.
Software OTP Código de un solo uso generado por la app móvil o de escritorio de Ironchip.
Hardware OTP / USB Token Token físico para entornos que requieren un segundo factor tangible.
Tarjeta NFC/RFID Con un lector integrado en el teclado o un lector NFC conectado por USB, se puede integrar cualquier tarjeta o elemento NFC/RFID.
Email / SMS Métodos adicionales como factor secundario configurable por perfil.
Contraseña (opcional) Puede mantenerse o eliminarse por completo en modelos sin contraseña (passwordless).

La app móvil es el método de autenticación más habitual. Está disponible para iOS y Android, con descarga en App Store y Google Play. Actúa como segundo factor mediante notificación push y verificación de localización electromagnética.

  1. El administrador da de alta al usuario en la consola de administración.
  2. El usuario recibe un correo con el botón Verify my account.
  3. Pulsa Continue y descarga la app si todavía no la tiene.
  4. Acepta los permisos que pide la app.
  5. Opcionalmente, activa la biometría (huella o reconocimiento facial).
  6. Escanea con la app de Ironchip el código QR que aparece en pantalla. El alta queda completada.
  1. El usuario introduce sus credenciales en el servicio al que quiere acceder.
  2. Llega una notificación push al móvil a través de la app de Ironchip.
  3. Al pulsar la notificación se abre la app. Si hay biometría configurada, se valida.
  4. Al pulsar Authorize, la app escanea las señales electromagnéticas del entorno y verifica si el usuario está en la zona segura autorizada.
  5. Si la verificación es correcta, se concede el acceso al servicio.
  1. El usuario introduce sus credenciales en el servicio.
  2. En lugar de pulsar la notificación push, abre directamente la app de Ironchip.
  3. En la pestaña Servicios, sobre el servicio al que ha intentado acceder, aparece una cuenta atrás.
  4. Pulsa la tarjeta del servicio antes de que se agote el tiempo.
  5. Pulsa Authorize: el sistema escanea las señales y verifica la localización. Se concede el acceso si está en una zona autorizada.

Guía de uso: Aplicación móvil.

Aplicación de escritorio (Windows, Linux y macOS)

Sección titulada «Aplicación de escritorio (Windows, Linux y macOS)»

La app de escritorio permite autenticarse sin móvil. Funciona en Windows, Linux y macOS y actúa como segundo factor mediante una notificación local en el propio equipo.

  1. El administrador da de alta al usuario en la consola de administración.
  2. El usuario recibe el correo y pulsa Verify my account.
  3. Con la app de escritorio ya instalada, pulsa Continue.
  4. El usuario copia el código de seguridad que aparece en pantalla y lo introduce en la app de escritorio de Ironchip. El alta queda completada.

Variante: identidad en un dispositivo externo (USB de datos)

Sección titulada «Variante: identidad en un dispositivo externo (USB de datos)»

Es posible llevar las credenciales de identidad en un dispositivo de almacenamiento externo (USB). Así el usuario puede autenticarse en cualquier equipo que tenga instalados los servicios de escritorio de Ironchip.

  1. Durante el alta, el usuario inserta el dispositivo externo de almacenamiento.
  2. Pulsa el botón de refrescar para que se detecte el dispositivo.
  3. Selecciona el dispositivo en la lista desplegable.

El dispositivo externo debe permanecer conectado para usar la app de escritorio.

  1. El usuario introduce sus credenciales en el servicio.
  2. La app de escritorio muestra una notificación local.
  3. Al pulsar la notificación se abre la app de Ironchip en el escritorio.
  4. Al pulsar Authorize, el sistema verifica la localización y el dispositivo. Se concede el acceso si se cumplen las condiciones.

Guía de uso: Aplicación de escritorio.

El método RFID permite autenticar usuarios con tarjetas o tags RFID/NFC y un lector conectado al equipo. Es ideal para entornos industriales, hospitalarios, hoteleros o cualquier puesto con alta rotación en el que el usuario no puede o no debe usar el móvil.

  1. Descarga el agente RFID Authenticator desde Plugins > Authenticators en la consola de administración.

  2. Crea una política RFID para obtener la API key: ve a Authentication policies > Device policies y haz clic en Add device policy. Escribe el nombre, elige RFID protocol en Policy type y haz clic en Add. La ventana Credentials for your new RFID group muestra la API key: cópiala o descárgala con Download credentials, porque no vuelve a mostrarse. Si necesitas más claves, créalas después en la pestaña Credentials de la política. Consulta Políticas de dispositivos.

  3. Crea el acceso de cada usuario: en el servicio creado, haz clic en Add access, selecciona el usuario autenticador e indica el usuario a proteger (formato DOMINIO\usuario o EQUIPO\usuario).

  4. Registra las tarjetas RFID: ve a Directory > Devices > RFID > Synchronize. Descarga la plantilla CSV, completa los campos y súbela. Selecciona la política RFID, revisa el resumen, marca la casilla de confirmación y haz clic en Add.

  5. Configura el agente: abre PowerShell como administrador en el directorio del agente descargado y ejecuta:

    Ventana de terminal
    .\IronchipRFID.exe c --api_key <API_KEY>
  1. El empleado acerca su tarjeta RFID o NFC al lector conectado al equipo.
  2. El lector captura el UUID único del chip.
  3. El agente de Ironchip valida el UUID contra el usuario emparejado y comprueba las condiciones de acceso (zona, horario, política).
  4. Si la validación es correcta, se concede el acceso sin contraseña, PIN ni móvil.

Guía completa: Tarjeta NFC / RFID.

El método Offline permite autenticarse sin conexión a internet con un código OTP generado en local. Es especialmente útil en entornos industriales, zonas sin cobertura o redes aisladas (air-gapped).

  • La app móvil o de escritorio genera un código OTP de un solo uso sin necesidad de conexión.
  • En Windows Logon, el servicio OTP se instala como componente adicional durante la instalación del plugin.
  • El código OTP tiene una validez temporal limitada y es único por dispositivo.
  • No requiere autorización del servidor de Ironchip en el momento del acceso.

Más información: Autenticarse con Ironchip.

¿Puedo autenticarme en servicios de manera offline?

Sección titulada «¿Puedo autenticarme en servicios de manera offline?»

Sí. Ironchip ofrece la función Offline, que te permite acceder al dispositivo sin autorización desde el móvil. La función usa un código offline para verificar tu identidad y permitir el acceso a los servicios aunque no tengas conexión a internet.

El magic link es un enlace seguro de un solo uso que se envía por email y permite autenticarse sin instalar ningún agente ni registrar ningún dispositivo. Es ideal para proveedores externos, usuarios ocasionales o accesos puntuales.

  1. El usuario intenta acceder al servicio.
  2. Ironchip envía automáticamente un email al usuario con un enlace de autenticación.
  3. El usuario hace clic en el enlace y se concede el acceso sin contraseña adicional.
  4. El enlace caduca tras un solo uso o al cabo de un tiempo.
  • No requiere instalar ningún agente ni app en el dispositivo del usuario.
  • Es compatible con cualquier dispositivo que tenga acceso al correo electrónico.

Biometría (huella dactilar y reconocimiento facial)

Sección titulada «Biometría (huella dactilar y reconocimiento facial)»

¿La aplicación de autenticación utiliza biometría?

Sección titulada «¿La aplicación de autenticación utiliza biometría?»

Sí. La aplicación de autenticación de Ironchip puede usar la biometría como factor adicional de seguridad. Los usuarios pueden configurarla en la aplicación y autenticarse con características físicas o de comportamiento únicas, como las huellas dactilares o el reconocimiento facial.

La biometría actúa como capa de desbloqueo de la app móvil, no como factor de autenticación independiente. El usuario la configura durante el alta para no tener que introducir un PIN cada vez que aprueba una autenticación.

  • Métodos disponibles: huella dactilar y reconocimiento facial, según el dispositivo móvil.
  • La biometría se configura de forma opcional durante el alta en la app móvil.
  • Ironchip no guarda ningún dato biométrico en sus servidores: la validación ocurre únicamente en el dispositivo del usuario.
  • Cumple con el RGPD, porque no se transmiten ni se almacenan datos biométricos de forma centralizada.
Método Dispositivo Sin móvil Offline Sin instalación Caso de uso principal
App móvil iOS / Android ✗ ✗ ✗ Usuario estándar con móvil corporativo
App de escritorio Windows / Linux / macOS ✓ ✗ ✗ Usuario sin móvil corporativo
Windows Logon Windows ✓ ✓ (OTP) ✗ Proteger el inicio de sesión del sistema operativo Windows
Linux PAM Linux ✓ ✗ ✗ Servidores, bastiones y SSH
macOS PAM macOS ✓ ✗ ✗ Equipos Apple corporativos
RFID / NFC Cualquier PC ✓ ✓ ✗ Puestos compartidos, entornos hospitalarios e industriales
OTP offline Móvil / escritorio ✓ ✓ ✗ Zonas sin cobertura, redes aisladas
Magic link Cualquier dispositivo ✓ ✗ ✓ Proveedores externos, usuarios ocasionales
Biometría Móvil ✗ ✗ ✗ Complemento de seguridad en la app móvil

¿Es necesario usar un dispositivo móvil para autenticarse con Ironchip?

Sección titulada «¿Es necesario usar un dispositivo móvil para autenticarse con Ironchip?»

No. Además de la notificación push en el móvil, existe una aplicación de escritorio que funciona en Windows, Linux y macOS. La plataforma también ofrece otros métodos, como la función Offline y la función USB. Con ellos puedes acceder al dispositivo sin autorización desde el móvil, usando un código offline o un USB.

Políticas de autenticación

Agrupa dispositivos, passkeys, tarjetas RFID, zonas seguras y contraseñas LDAP en políticas, combínalas en los accesos y consulta las reglas de riesgo.

Las políticas de autenticación deciden qué tiene que presentar un usuario para entrar en una aplicación: uno de sus dispositivos, una passkey, una tarjeta RFID, estar en una zona segura o la contraseña de su directorio. Esta página es para quien administra la consola: cómo se crean las políticas, qué contienen las predeterminadas y cómo se combinan en un acceso.

En la consola están en Authentication policies, que tiene tres apartados:

  • Device policies: dispositivos de los usuarios (móvil, escritorio o USB), tarjetas RFID y passkeys.
  • Safe zone policies: zonas seguras personales y corporativas.
  • Password policies: conexiones con un servidor LDAP que comprueban la contraseña del usuario.

Las políticas se exigen al dar acceso a una aplicación, en el paso Select authentication policies. Consulta Cómo se combinan las políticas en un acceso y Dar acceso a usuarios y grupos.

En Authentication policies > Device policies están las políticas que agrupan dispositivos, tarjetas RFID o passkeys. El listado muestra cada política con su tipo en la columna Type (DO para los dispositivos personales, RFID o FIDO2) e incluye las políticas predeterminadas y las que hayas creado.

Listado Device policies con las políticas predeterminadas, la columna Type y el botón Add device policy

  1. En Authentication policies > Device policies, haz clic en Add device policy. Se abre la ventana Add a new device policy.

  2. Escribe el nombre en Device policy name, de 3 a 60 caracteres. No puede coincidir con el de otra política de la compañía.

  3. Elige el tipo en Policy type:

    • Personal device: los dispositivos de los usuarios con la app de Ironchip (móvil, escritorio o USB).
    • RFID protocol: las tarjetas o tags RFID/NFC que lee el agente RFID Authenticator.
    • Passkey / security key (FIDO2): las passkeys y las llaves de seguridad FIDO2.

    Ventana Add a new device policy con el desplegable Policy type abierto y sus tres opciones

  4. Si la política es de passkeys, despliega Advanced settings para ajustar la política de passkeys. Si no lo haces, se usan los valores por defecto.

  5. Haz clic en Add.

Si elegiste RFID protocol, se abre la ventana Credentials for your new RFID group con la API KEY de la política. Cópiala o descárgala con Download credentials: la consola no vuelve a mostrarla y la necesitas para configurar el agente RFID. El botón View installation guide descarga el agente RFID Authenticator. Consulta Tarjeta NFC / RFID.

Desde el menú Options de cada política puedes abrirla (Configure device policy) o eliminarla (Delete device policy).

Menú Options de una política con las opciones Configure device policy y Delete device policy

Para abrir una política, haz clic en su nombre o en Options > Configure device policy. La página de la política tiene estas pestañas:

  • General: los elementos de la compañía del tipo de la política (dispositivos, tarjetas RFID o passkeys), con las columnas Manage, Name, Created by y Platform. Puedes filtrar por nombre, por quién lo creó y, en los dispositivos, por plataforma.
  • Credentials: solo en las políticas RFID. Son las API keys con las que el agente RFID usa la política. Consulta Credenciales de una política RFID.
  • Details: el nombre de la política, en Authentication policy name, y en las políticas de passkeys la sección Passkey policy. Guarda los cambios con Save.

Para elegir qué elementos forman la política:

  1. En la pestaña General, marca en la columna Manage los dispositivos, tarjetas o passkeys que quieres incluir y desmarca los que quieres quitar.
  2. Haz clic en Apply. La ventana Apply authentication policy resume cuántos elementos se añaden y cuántos se quitan.
  3. Confirma con Apply.

Las políticas predeterminadas no se pueden modificar: se rellenan solas.

La pestaña Credentials de una política RFID lista sus API keys con las columnas Hint, Date y Manage. Para crear otra, por ejemplo para un segundo equipo con lector:

  1. Haz clic en Add credential y confirma con Add en la ventana Add a new credential.
  2. Copia la API KEY o descárgala con Download credentials. Por seguridad, la consola no vuelve a mostrarla.

Para retirar una API key, haz clic en Delete en su fila y confirma.

Las políticas de tipo Passkey / security key (FIDO2) definen cómo se registran y se usan sus passkeys. Ajusta la política en Advanced settings al crearla, o después en la pestaña Details, sección Passkey policy, y guarda con Save.

Campo Qué hace Por defecto
Relying Party ID El dominio al que queda ligada la credencial. Debe coincidir con el dominio en el que inician sesión los usuarios. ironchip.com
Allowed origins Los orígenes desde los que se acepta la passkey, uno por línea. Vacío: https://<rp_id>
User verification Si se pide PIN o biometría: Required (siempre), Preferred (cuando el autenticador lo admite) o Discouraged (no se pide). Required
Allow synced passkeys (iCloud Keychain, Google Password Manager) Acepta las passkeys sincronizadas en la nube. Si lo desmarcas, solo valen las ligadas a un dispositivo, como las de una llave de seguridad. Marcado
Timeout (ms) El tiempo que tiene el usuario para completar la operación con la passkey, entre 10000 y 600000 milisegundos. 60000

Pestaña Details de una política FIDO2 con el nombre y la sección Passkey policy

En Authentication policies > Safe zone policies se agrupan las zonas seguras que se pueden exigir en un acceso. El listado incluye las políticas predeterminadas y las que hayas creado.

Listado Safe zone policies con las políticas predeterminadas y el botón Add safe zone policy

  1. En Authentication policies > Safe zone policies, haz clic en Add safe zone policy. Se abre la ventana Add a new safe zone policy.
  2. Escribe el nombre en Safe zone policy name, de 3 a 60 caracteres.
  3. Haz clic en Add.
  1. Haz clic en el nombre de la política o en Options > Configure safe zone policy.
  2. En la pestaña Corporate, marca en la columna Manage las zonas seguras corporativas que quieres incluir y desmarca las que quieres quitar. Puedes buscar por nombre (Search by safe zone name) y filtrar por quién la creó.
  3. Haz clic en Apply y confirma en la ventana Apply authentication policy.
  4. Haz lo mismo en la pestaña Personal con las zonas seguras personales. Ahí también puedes filtrar por plataforma.

En la pestaña Details cambias el nombre de la política. Para eliminarla, usa Options > Delete safe zone policy.

Cada compañía tiene estas políticas desde el principio. Se rellenan solas: cada dispositivo, passkey o zona segura nueva entra en las que le corresponden.

Política Apartado Contiene
Any user devices Device policies Todos los dispositivos de los usuarios: móviles, de escritorio y USB
Mobile devices Device policies Los móviles Android e iOS
Desktop devices Device policies Los equipos Windows, macOS y Linux
USB Devices Device policies Las identidades guardadas en un dispositivo USB
Any FIDO2 devices Device policies Las passkeys y llaves de seguridad registradas
Any user safezones Safe zone policies Todas las zonas seguras, personales y corporativas
Any personal safe zone Safe zone policies Las zonas seguras personales
Any corporate safe zone Safe zone policies Las zonas seguras corporativas

Las políticas predeterminadas no se pueden renombrar, modificar ni eliminar. Para limitar un acceso a unos dispositivos o unas zonas concretos, crea tu propia política.

Las políticas de Password policies comprueban la contraseña del usuario contra un servidor LDAP, por ejemplo tu Active Directory. Úsalas en un acceso para pedir la contraseña del directorio, sola o junto a otros factores.

  1. Ve a Authentication policies > Password policies y haz clic en Add password policy.

    Listado Password policies con el botón Add password policy

  2. En la ventana Add a new password policy, escribe el nombre en LDAP name, de 3 caracteres como mínimo, y la dirección del servidor LDAP en Server host.

  3. En Encryption:, elige Enable TLS, la opción por defecto, o Insecure, que conecta sin TLS.

  4. Si elegiste Enable TLS, añade el certificado TLS del servidor en Add your TLS Certificate. En Source:, elige Select local file para subir un fichero .cer o .crt, o Paste certificate para pegar su contenido. El botón Add no se activa hasta que añades el certificado.

    Ventana Add a new password policy con LDAP name, Server host, Encryption y el certificado TLS

  5. Haz clic en Add. Se abre la ventana Test con el nombre de la política: escribe el usuario (UPN or email) y la contraseña (LDAP password) de una cuenta del directorio y haz clic en Test. La política solo se crea si la prueba es correcta.

Las credenciales de prueba no se guardan: solo sirven para comprobar la conexión.

El menú Options de cada política de contraseña tiene estas opciones:

  • Configure password policy: abre la ventana Configure con el nombre de la política, donde cambias el nombre, el servidor, el cifrado o el certificado. Al hacer clic en Configure, la consola vuelve a pedirte una cuenta de prueba antes de guardar.
  • Test password policy: prueba la conexión con otra cuenta del directorio.
  • Delete password policy: elimina la política.

Cuando un acceso exige una política de contraseña, el usuario escribe la contraseña de su cuenta del directorio durante la autenticación.

  1. El usuario inicia la autenticación en el servicio como siempre, con el Username que se configuró.

    Pantalla de autenticación de Ironchip que pide el correo del usuario para enviar la notificación

  2. Si el acceso exige una política de contraseña, aparece un aviso para que introduzca la contraseña de su correo.

    Aviso Authentication warning: password required con el campo de contraseña

  3. Si el acceso exige además otras políticas, como un dispositivo, el usuario abre su aplicación de Ironchip para terminar el proceso y entrar en el servicio.

Cómo se combinan las políticas en un acceso

Sección titulada «Cómo se combinan las políticas en un acceso»

Al dar acceso a una aplicación, el paso Select authentication policies, con el título Configure authentication factors, define qué políticas se exigen:

  • Cada fila es una combinación de políticas unidas con AND: el usuario tiene que cumplirlas todas.
  • Las filas se unen con OR: basta con cumplir una de ellas.
  • Añade políticas a una fila en + Select authentication policy, añade filas con + y quítalas con la x roja. Next no se activa hasta que todas las filas tienen al menos una política.

Paso Select authentication policies con dos filas: políticas unidas con AND dentro de cada fila y las filas unidas con OR

Por ejemplo, con estas dos filas el usuario entra con su móvil o su equipo desde una zona corporativa, o con una passkey y la contraseña de su directorio:

  1. Any user devices AND Any corporate safe zone.
  2. Any FIDO2 devices AND una política de contraseña.

Ten en cuenta estas reglas:

  • Una política se cumple con cualquiera de los elementos del usuario que contiene; por ejemplo, con cualquiera de sus dispositivos incluidos en la política.
  • Si un usuario tiene varios accesos a la misma aplicación a través de distintos grupos, valen las filas de todos ellos. Cada acceso solo cuenta si el usuario está en su grupo y si el nombre de usuario con el que se autentica coincide con la plantilla de ese acceso.
  • Los usuarios que no están protegidos por Ironchip (columna Protection de Directory > Users) solo pueden usar filas formadas únicamente por políticas de contraseña. Las filas con cualquier otro factor no cuentan para ellos. Consulta Usuarios y grupos.
  • Las políticas predeterminadas no se pueden modificar ni eliminar.
  • Una política que se usa en algún acceso no se puede eliminar: la consola muestra Cannot delete this authentication policy because it is currently in use. Quítala antes de los accesos que la usan.
  • Los nombres de las políticas no se pueden repetir en la compañía.

Además de las políticas de autenticación, el ITDR evalúa cada intento de autenticación con un conjunto de reglas que gestionas en ITDR > Ruleset. Cada regla detecta una condición (red Tor, dispositivo con root, GPS falseado, conexiones desde países distintos…), le asigna un riesgo de 0 a 100 y, si quieres, una o dos acciones: Deny the access, que deniega el acceso en curso, y Lock the user, que bloquea la cuenta del usuario hasta que un administrador la desbloquee.

  • Cada regla que se cumple queda escrita en el informe del intento, aunque su riesgo sea 0 y no tenga acciones.
  • El intento toma el riesgo más alto de las reglas que se cumplen, nunca la suma. Ese riesgo decide el nivel: Clear, Low, High o Fraud.
  • Si alguna de las reglas que se cumplen pide Deny the access, se deniega el acceso. Si alguna pide Lock the user, se bloquea al usuario.

Las reglas son de cada compañía. Una compañía que nunca las ha configurado empieza con este conjunto:

Regla Detecta Riesgo Acción
Malware on the phone El teléfono tiene instalada una aplicación maliciosa conocida High 50 —
Tor network La conexión llega desde la red Tor Fraud 100 Deny the access
IPs in different countries El navegador y el teléfono se conectan desde países distintos High 50 Deny the access
VPN network La conexión pasa por una VPN, un proxy, un relay o un proveedor de hosting Low 10 Deny the access
Tampered device El teléfono tiene root o jailbreak Fraud 100 —
Known device El usuario ya ha usado este dispositivo Clear 0 —
Habitual location El intento usa la app y hay al menos 10 operaciones previas desde este lugar Clear 0 —
On a phone call El usuario está en una llamada telefónica High 50 —
Location tampering: gps spoofed La ubicación GPS está falseada Fraud 100 Deny the access

Ninguna de estas reglas bloquea al usuario. Las de riesgo 0 (Clear 0) no suben la puntuación, pero dejan constancia en el informe. Para cambiarlas, añadir otras o probarlas antes de guardar, consulta Reglas del ITDR.

Consola y usuarios

La consola de administración

Accede a la consola de administración de Ironchip y conoce la pantalla Get started, el menú, la barra superior, el idioma y los plugins que puedes descargar.

La consola de administración de Ironchip es la herramienta con la que gestionas la seguridad y el acceso de los usuarios de tu compañía: aplicaciones, usuarios, grupos, dispositivos, zonas seguras, políticas y permisos. Esta página es para quien la administra: explica cómo entrar, qué ofrece la pantalla Get started, qué hay en cada sección del menú y en la barra superior, y qué plugins puedes descargar.

Con la consola gestionas todos los servicios y usuarios de la compañía y controlas todos los accesos. También puedes:

  • Seguir las autenticaciones en tiempo real, con métricas y registros de actividad.
  • Detectar amenazas sobre las identidades con el ITDR de Ironchip.
  • Consultar la licencia contratada y su uso.
  1. Entra en https://app.ironchip.com/.
  2. En Access to dashboard, escribe tu correo en Enter email y haz clic en Submit.
  3. Completa la autenticación que te pide Ironchip.

Si has perdido el acceso, usa el enlace help me de la misma pantalla (I need to recover my account, help me). Si tu compañía tiene una lista blanca de IP y entras desde otra dirección, la consola muestra Access Denied en lugar de dejarte entrar.

Después de una actualización, al entrar puede aparecer la ventana What’s new since your last visit con las novedades. View full version history abre el historial de versiones y Got it la cierra.

Al entrar en la consola, la pantalla Get started muestra una tarjeta por cada tarea principal. El botón Let’s go! de cada tarjeta lleva directamente al apartado donde se hace.

Pantalla Get started de la consola con una tarjeta y un botón Let’s go! por cada tarea

Tarjeta Para qué sirve Más información
Add a new user Añadir usuarios a la compañía. Añadir un usuario
Create a new application Dar de alta una aplicación protegida. Crear una aplicación
Manage permissions Controlar las acciones de los administradores mediante permisos. Roles y permisos
Add a new Administrator Dar acceso a la consola a un usuario. Abre la página del grupo Ironchip Administrators. Asignar un administrador
Import users Importar usuarios desde un archivo CSV. Sincronización de identidades
Synchronize users Sincronizar usuarios con SCIM. Sincronización de identidades
Recover an account Recuperar la cuenta de un usuario en el dispositivo que elijas. Lleva a Directory > Users. Recuperar un dispositivo
Update your billing details Mantener al día los datos de facturación. Facturación y licencias
Manage groups Organizar a los usuarios en grupos. Grupos
Seamless integration with our plugins Descargar los plugins de las integraciones. Plugins
Real-time company activity tracking Ver los gráficos diarios y la línea temporal de la actividad de la compañía. Métricas
Advanced security logs overview Consultar los registros detallados de acciones, accesos y cambios de configuración. Registros de actividad
Real-Time Security Monitoring Seguir las acciones de los usuarios y sus niveles de riesgo en tiempo real. ITDR
Manage devices Consultar y gestionar los dispositivos de la compañía. Lleva a Directory > Devices > Mobile. Dispositivos
Manage personal safe zones Consultar y gestionar las zonas seguras personales. Zonas seguras
Manage corporate safe zones Consultar y gestionar las zonas seguras corporativas. Zonas seguras

Si es la primera vez que despliegas Ironchip, sigue la guía Primeros pasos: reúne, en orden, las tareas con las que arranca un despliegue.

El menú lateral de la consola tiene esta estructura. Las etiquetas NEW y BETA son las que muestra el propio menú.

Menú lateral de la consola con todos los grupos desplegados

Get started
Applications
Directory
Users
Groups
Devices
Mobile
Desktop
USB
RFID
Passkeys NEW
Safe zone
Corporate
Personal
Synchronization
CSV
SCIM
Authentication policies
Device policies
Safe zone policies
Password policies
Security
Permissions
IP allowlist
Credentials
Monitoring
Logs
Metrics
SIEM integration
PAM solo si el plan incluye el acceso privilegiado
ITDR
Realtime feed
Threat analysis
Confirmed
Suspected
Ruleset BETA
Phishing Shield BETA, se abre en otra pestaña
Plugins
Account settings
Billing
Look & feel

Algunas entradas pueden aparecer desactivadas. Al pasar el ratón, la consola explica por qué: Contact sales to activate this feature si el plan de la compañía no la incluye, o You don’t have permissions si tus permisos no te dan acceso. Si la licencia ha caducado, la mayoría de las entradas se desactivan y la consola te lleva a Account settings > Billing.

Las secciones siguen el orden del menú.

Sección Qué puedes hacer Más información
Applications Crear aplicaciones (OIDC, SAML, con API key y servidores NPS) y dar acceso a usuarios y grupos. Aplicaciones
Directory > Users Añadir usuarios, ver su estado de protección y gestionar sus cuentas. Usuarios y grupos
Directory > Groups Organizar a los usuarios en grupos y subgrupos. Grupos
Directory > Devices Consultar los dispositivos móviles, de escritorio y USB, las tarjetas RFID y las passkeys de los usuarios. Dispositivos
Directory > Safe zone Crear y gestionar las zonas seguras corporativas y personales. Zonas seguras
Directory > Synchronization Sincronizar usuarios con un archivo CSV o con SCIM. Sincronización de identidades
Authentication policies Definir las políticas de dispositivos, de zonas seguras y de contraseñas que se exigen en los accesos. Políticas de autenticación
Security > Permissions Definir qué grupos de administradores acceden a qué recursos de la consola. Roles y permisos
Security > IP allowlist Limitar desde qué direcciones IP se puede usar la consola. Lista blanca de IP
Security > Credentials Ver y borrar las credenciales de las aplicaciones de la compañía. Credenciales
Monitoring > Logs y Metrics Revisar los registros de actividad y las métricas de autenticación. Actividad y métricas
Monitoring > SIEM integration Enviar los eventos de autenticación a tu SIEM. Integración con un SIEM
PAM Gestionar el acceso privilegiado. Aparece cuando el plan de la compañía lo incluye. Acceso privilegiado
ITDR Seguir en tiempo real las anomalías de las autenticaciones (Realtime feed) y las amenazas confirmadas y sospechosas (Threat analysis). ITDR
ITDR > Ruleset Decidir qué cuenta como amenaza, cuánto pesa y qué pasa cuando se detecta. Reglas del ITDR
Phishing Shield Abrir la consola de Phishing Shield, en otra pestaña. Phishing Shield
Plugins Descargar los plugins de inicio de sesión, los autenticadores de escritorio y los conectores. Plugins
Account settings > Billing Consultar el plan contratado, su uso y los datos de facturación. Facturación y licencias
Account settings > Look & feel Poner los logotipos y colores de la compañía en las páginas web de Ironchip y en la app móvil. Aspecto

A la derecha de la barra superior están, en este orden:

  • El globo: el idioma de la consola. Consulta la nota de Acceder a la consola.

  • La campana: las notificaciones, por ejemplo cuando termina una sincronización (User synchronization finished) o una exportación (User export completed, ITDR report export completed). Si no hay ninguna, muestra No unread notifications.

  • Help (el icono ?): la versión de la consola (Version x.y.z) y los enlaces Release notes (el historial de versiones), Billing, Documentation, Support y FAQs.

    Menú Help de la barra superior con la versión de la consola y los enlaces de ayuda

  • El menú de tu cuenta (Account information): tu nombre, tu correo y la compañía en la que estás. Ofrece:

    • Manage account: abre tu página de usuario.
    • Switch account: aparece si tu usuario pertenece a más de una compañía. Elige la otra compañía en Select an account y confirma en Switch to another account: se cierra la sesión actual y entras en la otra compañía.
    • Log out: cierra la sesión.

En Plugins descargas los plugins y conectores que integran Ironchip con tus sistemas. Están agrupados en cuatro secciones:

Sección Plugins Más información
Logon Windows Logon (Download ARM y Download x64), Linux Logon, MacOS Logon Windows, Linux, macOS
Authenticators Windows Authenticator, Linux Authenticator, Mac OS Authenticator (Download ARM y Download x86), RFID Authenticator App de escritorio, Tarjeta RFID
Windows Integrations Windows NPS, ADFS, LDAP, AD Connect, Passwordless RADIUS Microsoft NPS, ADFS, Proxy LDAP, AD Connect, Ironchip RADIUS server
Linux Integrations AD Connect, Passwordless RADIUS AD Connect, Ironchip RADIUS server

Cada tarjeta tiene un icono ? que abre su documentación y un botón Download, o uno por arquitectura. Si un plugin aún no tiene descarga, el botón dice Coming soon.

Página Plugins con las secciones Logon y Authenticators

La mayoría necesitan una credencial de la compañía: los de inicio de sesión, ADFS, LDAP y Passwordless RADIUS, la API key de una aplicación; Windows NPS, la de un servidor NPS; AD Connect, la clave de sincronización SCIM; y RFID Authenticator, la de una política de dispositivos RFID.

Usuarios y grupos

Añade usuarios, interpreta su estado de protección, edita sus datos, nombra administradores, exporta el directorio en CSV y organiza grupos y subgrupos.

En Directory > Users y Directory > Groups gestionas a las personas de la compañía: las añades, controlas la protección de sus cuentas, editas sus datos y las organizas en grupos para darles accesos y permisos de forma conjunta. Esta página es para quien administra la consola.

En Directory > Users están todos los usuarios de la compañía, con las columnas User, Email, External email, Protection y Manage. El icono de columnas de la cabecera de la tabla muestra u oculta columnas con más datos: User Name, Sam Account Name, Display Name, Preferred Language, ID y los atributos personalizados de la compañía, entre otros.

Para filtrar, usa Select a search filter y elige Name, Surname, Email, Protection o una de las columnas de atributos visibles. Protection filtra por estado: Enrolled, Invited, Protected, Not protected, Not invited, Disabled, Not enabled o Blocked.

Al seleccionar un usuario, la tarjeta User information de la derecha muestra cuántas llaves, aplicaciones y dispositivos tiene (Keys, Apps y Devices).

Listado de Directory > Users con la columna Protection

  1. En Directory > Users, haz clic en Add user. Se abre la ventana Add a new user.

  2. Escribe el nombre (Name), el apellido (Surname) y el correo (Email) del usuario, y elige su idioma en Preferred language (por defecto, English).

  3. Activa Send invitation si quieres que el usuario reciba ya el correo de alta. Necesita un Email válido.

    Ventana Add a new user con los datos del usuario y el interruptor Send invitation

  4. Haz clic en Add.

El correo externo (External email) y el resto de datos se completan después, en la pestaña Details del usuario: consulta Datos del usuario.

Si no activas Send invitation, el usuario se crea sin recibir ningún correo de Ironchip y en Protection aparece como no invitado. Es habitual cuando los usuarios llegan por sincronización. Para invitarlo después, usa Options > Send invitation.

Para completar el alta, el usuario tiene que verificarse: recibe en su correo un código QR que debe escanear para quedar registrado de forma segura en la plataforma.

Si tienes muchos usuarios, añádelos o actualízalos de forma automática con la sincronización de usuarios.

La columna Protection muestra un icono con el estado de cada usuario. Al pasar el ratón, la consola lo explica con un texto como los de la tabla.

Icono Texto Significado
Escudo verde is invited by Ironchip o is protected by Ironchip El usuario se ha verificado: la cuenta está activa y protegida por Ironchip.
Triángulo de aviso ámbar is invited by Ironchip, but has not added any devices yet Se le envió la invitación, pero aún no ha registrado ningún dispositivo.
Escudo rojo tachado is not invited to Ironchip La cuenta está habilitada, pero no se ha enviado la invitación.
Escudo gris tachado is disabled o is not enabled La cuenta está deshabilitada. Consulta cómo habilitarla.
Señal roja de prohibido is blocked El usuario está bloqueado, por ejemplo desde el ITDR. Consulta Desbloquear un usuario.

El recorrido habitual de un usuario es este:

Gris Cuenta no habilitada.
↓ Options > Enable Ironchip.
Rojo Habilitada, sin invitación.
↓ Options > Send invitation (o Send invitation al crearlo).
Ámbar Invitado: aún no ha registrado ningún dispositivo.
↓ El usuario escanea el código QR.
Verde Verificado: la cuenta está activa y protegida.

El botón Options de cada usuario ofrece acciones distintas según su estado:

Estado del usuario Acciones
No habilitado (gris) Enable Ironchip: habilita la cuenta. Consulta Habilitar una cuenta.
Habilitado sin invitación Send invitation: envía el correo de alta. Consume una licencia de la compañía.
Invitado, sin verificar Add a device: le envía otro correo para registrar un dispositivo.
Verificado (verde) Add a device, Register a passkey (passkeys) y Recover account. Consulta Dispositivos.
Bloqueado Además, Unblock user.

En todos los estados está Delete user, que borra el usuario con sus llaves y accesos después de que escribas su nombre para confirmar. No puedes borrarte a ti mismo.

Menú Options de un usuario verificado con Add a device, Register a passkey, Recover account y Delete user

Haz clic en el nombre de un usuario para abrir su página. En la cabecera ves desde cuándo es miembro (Member since), su identificador (User ID) y sus contadores, y debajo las pestañas Keys, Groups, Accesses, Invitations y Details. Keys y Accesses se explican en Dispositivos.

En Details editas los datos del usuario:

  • En General: Name, Surname, Email, External email, Phone number (solo si la compañía usa la autenticación por SMS) y Preferred language. Id no se puede cambiar.
  • En Attributes: los atributos del usuario. Para añadir uno, usa New Attributes, con Attribute name y Attribute value. Los atributos se pueden usar como etiquetas en el nombre de usuario de un acceso.

Haz clic en Save para guardar los cambios.

Pestaña Details de un usuario con los datos generales y los atributos

La pestaña Invitations lista los códigos de alta enviados al usuario, con sus usos restantes (Remaining uses), el tipo (Type), la fecha (Created at) y su estado (Status: available o consumed). Sirve para comprobar si una invitación ya se usó.

Un usuario bloqueado, por ejemplo con Block user desde el ITDR, aparece con la señal roja de prohibido. Para desbloquearlo:

  1. En Directory > Users, haz clic en Options en la fila del usuario y después en Unblock user.
  2. En la ventana Unblocking user, haz clic en Unblock.

Los administradores de la compañía son los miembros del grupo Ironchip Administrators, que tiene acceso completo a la consola. El usuario tiene que existir antes en la plataforma: si no, añádelo primero. Puedes hacerlo de dos formas:

  • Desde el grupo: ve a Directory > Groups, abre Ironchip Administrators (o usa la tarjeta Add a new Administrator de Get started) y, en la pestaña Direct users, añade al usuario como se explica en Añadir usuarios a un grupo.
  • Desde el usuario: abre su página, ve a la pestaña Groups y haz clic en Add group. En la ventana Select group, marca Ironchip Administrators y haz clic en Add.

Para dar a alguien acceso solo a una parte de la consola, ponlo en otro grupo y dale permisos a ese grupo.

  1. En Directory > Users, filtra la lista si solo quieres exportar una parte. Cada filtro necesita al menos 2 caracteres.

  2. Haz clic en Export CSV. La ventana Export search results muestra los filtros que se aplicarán; sin filtros, se exportan todos los miembros de la compañía.

  3. Haz clic en Export CSV en la ventana. Ironchip envía el archivo a tu correo cuando está listo y la campana de la consola avisa con User export completed. Close cierra la ventana sin exportar.

    Ventana Export search results con los filtros de la exportación

El CSV es útil para auditorías, revisiones periódicas del directorio o para cruzar los datos con otros sistemas (Active Directory, SCIM, etc.).

Los grupos organizan a los usuarios de forma jerárquica y agilizan la gestión: en lugar de dar accesos y permisos usuario a usuario, se los das a un grupo y todos sus miembros los heredan.

En Directory > Groups ves los grupos de la compañía con sus miembros (Members) y subgrupos (Subgroups). Al crear la compañía, Ironchip crea tres:

  • Ironchip users: todos los usuarios de la compañía. No se puede renombrar ni borrar, y sus miembros no se cambian a mano; solo se puede activar o desactivar su invitación automática.
  • Ironchip unverified users: los usuarios que aún no se han verificado. Lo mantiene Ironchip y no se puede editar ni borrar.
  • Ironchip Administrators: los administradores de la compañía. No se puede renombrar ni borrar, pero sí cambiar sus miembros. Se crea con la invitación automática activada.

Listado de grupos en Directory > Groups

El botón Options de cada grupo ofrece Manage group (abre su página), Enable autoinvite o Disable autoinvite y Delete group.

  1. En Directory > Groups, haz clic en Add group.

  2. En la ventana Add a new group, escribe el nombre en Group name (de 2 a 60 caracteres). Si activas Email invitation sending, los usuarios que añadas al grupo recibirán la invitación por correo.

    Ventana Add a new group con el campo Group name y el interruptor Email invitation sending

  3. Haz clic en Add.

Haz clic en el nombre del grupo, o en Options > Manage group, para abrir su página. Arriba ves sus contadores (Direct users, All users, Child groups y Parent groups) y debajo, cuatro pestañas:

  • Direct users: los usuarios que añadiste al grupo. Aquí se añaden y se quitan.
  • All users: todos sus miembros, también los de sus subgrupos. Solo lectura.
  • Child groups: sus subgrupos.
  • Parent groups: los grupos de los que es subgrupo. Solo lectura.

Página de un grupo con sus contadores y las pestañas Direct users, All users, Child groups y Parent groups

El icono del lápiz (Edit group name) abre una ventana para cambiar el nombre (Name) y activar o desactivar el envío de invitaciones (Email invitation sending). Guarda con Edit. Los grupos que crea Ironchip no tienen este icono.

  1. En Directory > Groups, haz clic en Options en la fila del grupo y después en Manage group.

    Grupo nuevo con 0 miembros y el menú Options con la opción Manage group

  2. En la pestaña Direct users, haz clic en Add.

  3. En la ventana Add a new user, marca los usuarios que quieres añadir.

    Ventana con la lista de usuarios y sus casillas para añadirlos al grupo

  4. Haz clic en Add. La consola confirma con Users added successfully.

    Mensaje Users added successfully

Para quitar usuarios del grupo, márcalos en Direct users y haz clic en Delete. También puedes sacar a un usuario de un grupo desde su página, pestaña Groups, con Delete from group: pierde los accesos que tenía por ese grupo.

Los subgrupos organizan los grupos de forma jerárquica, por ejemplo un departamento con un subgrupo por equipo. Los miembros de un subgrupo aparecen también en la pestaña All users del grupo del que cuelga.

Para añadir un subgrupo:

  1. En la página del grupo, abre la pestaña Child groups y haz clic en Add. Se abre la ventana Add a new group, con los grupos disponibles.

    Ventana con la lista de grupos que se pueden añadir como subgrupos

  2. Marca los grupos que quieres incorporar.

  3. Haz clic en Add para confirmar.

Para quitar un subgrupo, márcalo en la pestaña Child groups y haz clic en Delete.

Pestaña Child groups con un subgrupo seleccionado y el botón Delete

Usuarios genéricos y alias

Da de alta usuarios, configura cuentas compartidas con alias, gestiona cambios de rol, invitaciones que no llegan, recuperación de cuenta y recertificación.

Esta página reúne las tareas habituales de gestión de usuarios en la consola: dar de alta usuarios, configurar cuentas genéricas o compartidas con alias, recuperar una cuenta y revisar los accesos de forma periódica. Es para quien administra la consola.

Descarga el manual en PDF: Gestión de usuarios.

  1. Accede a la consola de administración como administrador.
  2. Ve a Directory > Users y haz clic en Add user.
  3. En la ventana Add a new user, introduce los datos del nuevo usuario: Name, Surname y Email, y elige su idioma en Preferred language.
  4. Activa Send invitation para que el usuario reciba el correo de alta de Ironchip. Necesita un Email válido.
  5. Haz clic en Add. El usuario queda registrado en la plataforma.

Para dar permisos de administración a un usuario o conocer el estado de su alta, consulta Usuarios y grupos.

Configurar usuarios genéricos o cuentas compartidas

Sección titulada «Configurar usuarios genéricos o cuentas compartidas»

Al dar acceso a una aplicación (ventana Add a new access), selecciona un grupo o un usuario y, en el paso Select usernames, define en Username composition el nombre de usuario con el que se autentica en esa aplicación, por ejemplo el de la cuenta genérica. Este nombre solo se aplica a ese acceso y no sustituye el nombre original del usuario en la plataforma.

Si además activas Set user alias, defines un alias del usuario para ese acceso. El alias es solo un identificador adicional: no cambia las credenciales, y el usuario sigue autenticándose con el nombre de Username composition. Para más información, consulta Dar acceso a usuarios y grupos.

Paso Select usernames de la ventana Add a new access, con la plantilla del nombre de usuario y el interruptor Set user alias activado

Hay tres aproximaciones recomendadas:

  • Token USB o NFC individual por persona, aunque usen la misma cuenta del sistema. Mantiene la trazabilidad individual aunque la cuenta sea compartida.
  • Un usuario por cuenta genérica: crea en Ironchip un usuario con el nombre de la cuenta genérica y vincúlalo al autenticador de la persona responsable. Este nombre no es el alias de Set user alias, que solo añade un identificador al acceso.
  • Magic Link temporal para usuarios ocasionales sin dispositivo emparejado.

La invitación automática envía de forma automática la invitación de alta a los usuarios que se añaden a un grupo de AD configurado con esta opción, sin intervención manual del administrador.

Requiere:

  • Un grupo de AD asociado al grupo de Ironchip con la invitación automática activa.
  • AD Connect sincronizando.
  • El atributo de correo electrónico correcto en AD.

Para configurarla, consulta Invitación automática y AD Connect.

Con SCIM o AD Connect activos, un cambio de grupo en AD se propaga automáticamente a Ironchip y actualiza los accesos del usuario. Sin sincronización automática, el administrador hace el cambio a mano en la consola.

Buena práctica: recertifica los accesos cada 6 meses para los accesos estándar y cada 12 meses para los roles funcionales.

Un usuario no recibe el correo de invitación o de activación

Sección titulada «Un usuario no recibe el correo de invitación o de activación»

Las causas más comunes y sus soluciones son:

  • El correo está en la carpeta de spam: añade ironchip.com a la lista de remitentes permitidos de tu servidor de correo.
  • El atributo de correo está vacío o es incorrecto en AD: corrige el atributo en el directorio.
  • Reenvío manual: en Directory > Users, el menú Options del usuario ofrece Send invitation si nunca se le invitó. Si ya estaba invitado pero no ha registrado ningún dispositivo (triángulo ámbar en Protection), usa Add a device, que le envía otro correo con las instrucciones.

Para comprobar si el usuario llegó a usar la invitación, abre su página y ve a la pestaña Invitations: muestra cada código de alta con sus usos restantes (Remaining uses) y su estado (Status: available o consumed).

Si un usuario pierde el acceso, el administrador inicia la recuperación desde la consola y el usuario completa el proceso con la app de Ironchip.

  1. El usuario contacta con el administrador del sistema para iniciar la recuperación de la cuenta.
  2. El administrador va a Directory > Users, hace clic en Options > Recover account del usuario, elige el dispositivo en el paso Select a device y confirma en Send recovery con Add. La opción solo aparece en los usuarios verificados. La consola envía al usuario un correo con un enlace de recuperación. Los detalles están en Recuperar un dispositivo.
  3. En el correo, el usuario hace clic en Recuperar mi acceso.
  4. Se abre una ventana con un código QR. El usuario concede los permisos necesarios, acepta los términos y condiciones y escanea el código QR con la app móvil de Ironchip.
  5. Tras escanear el código, la cuenta se recupera y el usuario puede volver a acceder.

Si el usuario recupera el acceso con la app de escritorio de Ironchip, el proceso correcto es este:

  1. Abre la app de escritorio de Ironchip en el PC.
  2. Selecciona Introducir código manualmente.
  3. Copia el código alfanumérico del correo de recuperación. No escanees el QR con la cámara del móvil.
  4. Pega el código en la app de escritorio y completa el reemparejamiento.

Para la vista del usuario, consulta Recuperación de la cuenta.

La recertificación es la revisión periódica de que cada usuario solo tiene acceso a lo que corresponde a su rol actual:

  • Cada 6 meses para los accesos estándar.
  • Cada 12 meses para los accesos asociados a roles funcionales.

Ironchip genera informes de auditoría exportables con todos los accesos activos por usuario, grupo y aplicación.

Invitación automática

Activa la invitación automática en un grupo de la consola para que sus usuarios reciban un correo y configuren su dispositivo con Ironchip.

La invitación automática (autoinvite) es una opción de los grupos de la consola de administración. Puedes activarla en un grupo que ya existe o al crear uno nuevo. Esta página es para quien administra la consola.

Cuando un usuario entra en un grupo con la invitación automática activada, si aún no estaba invitado, Ironchip le activa la cuenta y le envía un correo para configurar su dispositivo. Al activarla en un grupo que ya tiene miembros, también se invita a los que no lo estaban.

Cada invitación consume una licencia de la compañía: si se alcanza el límite de usuarios del plan, la consola no puede enviarlas.

El grupo Ironchip Administrators se crea con la invitación automática activada. Activarla o desactivarla es un cambio del grupo, así que hace falta permiso Update sobre el recurso Groups: consulta Roles y permisos.

  1. Ve a Directory > Groups.
  2. En el grupo que quieres modificar, haz clic en Options y después en Enable autoinvite.
  3. En la ventana Send auto-invite, haz clic en Send.

Cuando está activada, el menú Options muestra Disable autoinvite para desactivarla.

También puedes activarla o desactivarla en la página del grupo: haz clic en el icono del lápiz (Edit group name), cambia Email invitation sending y haz clic en Edit.

Al crear el grupo con Add group, activa Email invitation sending en la ventana Add a new group y haz clic en Add. Para más información sobre los grupos, consulta Crear un grupo.

Ventana Add a new group con el interruptor Email invitation sending

Ayuda de la opción Email invitation sending

Dispositivos

Da de alta, de baja y recupera los dispositivos de los usuarios, habilita cuentas y consulta sus móviles, equipos, USB, tarjetas RFID y passkeys.

Desde la consola de administración gestionas los dispositivos de cada usuario: puedes darlos de alta, de baja y recuperar una cuenta en otro dispositivo. Es especialmente útil si se pierde o se roba un dispositivo, porque permite quitarle el acceso y recuperar la cuenta en otro. Esta página es para quien administra la consola.

Hay dos formas de añadir un dispositivo y conviene distinguirlas:

  • Si quieres dar de alta un dispositivo nuevo o un usuario nuevo, sigue el proceso de dar de alta un dispositivo.
  • Si quieres recuperar una cuenta en un dispositivo que el usuario ya tenía registrado, sigue el proceso de recuperación. Un dispositivo ya registrado no se puede volver a dar de alta.

La opción aparece en los usuarios que ya están invitados.

  1. Ve a Directory > Users y busca al usuario.

  2. Haz clic en Options y después en Add a device.

    Menú Options de un usuario verificado con Add a device, Register a passkey, Recover account y Delete user

  3. En la ventana Add a new device, haz clic en Add. El usuario recibe un correo con las instrucciones para registrar el dispositivo, que podrá usar como llave de autenticación.

    Ventana Add a new device con el botón Add

Para que el usuario registre una passkey o una llave de seguridad, usa Options > Register a passkey: consulta Llave FIDO2.

  1. En Directory > Users, haz clic en el nombre del usuario para abrir su página.

  2. En la pestaña Keys ves sus llaves (dispositivos y zonas seguras), con las columnas Name, Platform, Created by, Access y Manage.

  3. Para dar de baja un dispositivo o borrar una zona segura, haz clic en Options y después en Delete key.

    Pestaña Keys de un usuario con la opción Delete key del menú Options

Al borrar un dispositivo también se cierran las sesiones abiertas desde él. En las zonas seguras personales, el mismo menú ofrece Make public o Make private: consulta Hacer pública una zona segura.

También puedes borrar un dispositivo desde su apartado de Directory > Devices: consulta Consultar todos los dispositivos.

Usa este proceso cuando un usuario ha perdido el acceso y quiere recuperar su cuenta en un dispositivo que ya tenía registrado. La opción aparece en los usuarios verificados.

  1. Ve a Directory > Users y busca al usuario.

  2. Haz clic en Options y después en Recover account.

  3. En el paso Select a device, elige el dispositivo en el que el usuario quiere recuperar el acceso. La lista solo muestra los dispositivos de ese usuario.

    Paso Select a device de la ventana Recover account con la lista de dispositivos del usuario

  4. En el paso Send recovery, revisa el usuario y el dispositivo seleccionados (Selected user:, Selected device:) y haz clic en Add.

    Paso Send recovery con el usuario y el dispositivo seleccionados y el botón Add

El usuario recibe un correo de recuperación y sigue el mismo proceso que al registrarse para recuperar el dispositivo. Si la aplicación ya tiene una sesión activa, el usuario puede borrarla eliminando los datos de la aplicación. La vista del usuario está en Recuperar el acceso.

Para habilitar una cuenta deshabilitada (escudo gris tachado en Protection):

  1. Localiza al usuario en Directory > Users.

  2. Haz clic en Options y selecciona Enable Ironchip.

    Opción Enable Ironchip en el menú Options de un usuario

  3. En la ventana Edit user protection enablement, confirma. Habilitar una cuenta consume una licencia de la compañía.

Después, el icono de Protection depende de lo que ya hubiera hecho el usuario: verde si ya estaba verificado, ámbar si estaba invitado pero sin dispositivos y rojo si nunca se le invitó. Consulta Estado de protección.

Al hacer clic en el nombre de un usuario en Directory > Users se abre su página. En la cabecera ves cuántas llaves, aplicaciones y dispositivos tiene (Keys, Apps y Devices) y, en el gráfico de autorizaciones del usuario, las correctas e incorrectas del mes que elijas. Debajo hay cinco pestañas: Keys, Groups, Accesses, Invitations y Details. Las de grupos, invitaciones y datos se explican en Datos del usuario.

En la pestaña Accesses ves las aplicaciones a las que tiene acceso el usuario (Application Name), el grupo por el que lo tiene (Group name) y su nombre de usuario en cada una (Username). El botón Authentication factors de cada acceso muestra las políticas que exige.

En Directory > Devices están los dispositivos de los usuarios de la compañía, repartidos en cinco apartados: Mobile, Desktop, USB, RFID y Passkeys. Las zonas seguras tienen su propio apartado, Directory > Safe zone: consulta Zonas seguras.

Mobile, Desktop y USB muestran cada dispositivo con las columnas Name, Platform, Used by (el usuario que lo usa) y Manage. Filtra por nombre, plataforma o usuario; el filtro Used by abre la ventana Select a user. El botón Delete borra el dispositivo después de pedir confirmación.

Apartado Directory > Devices > Mobile con la lista de dispositivos móviles

En RFID ves cada tarjeta con su plataforma y el usuario que la usa (Used by). Desde aquí puedes:

  • Borrar una tarjeta con Remove RFID.
  • Exportar la lista con Export CSV: la ventana Export search results muestra los filtros aplicados y, con Export, Ironchip te envía el archivo por correo.
  • Sincronizar tarjetas desde un CSV con Synchronize, que abre el asistente CSV synchronization (Template download, Template upload, Sync options y Summary).

Para dar de alta una tarjeta, consulta Tarjeta NFC / RFID.

Apartado RFID con los botones Export CSV y Synchronize

Passkeys lista las passkeys y llaves de seguridad registradas, con las columnas Name, Used by, Authenticator (el modelo, o Unknown si no se reconoce), Type (Synced si se sincroniza entre dispositivos, Device-bound si está ligada a uno), Transports, Credential y Manage. Si borras una passkey, el usuario ya no puede entrar con ella y necesita una invitación nueva para registrar otra. Consulta Llave FIDO2.

Apartado Directory > Devices > Passkeys con las columnas Authenticator, Type y Transports

Para agrupar dispositivos y exigirlos en los accesos, consulta Políticas de dispositivos.

Distribución de la aplicación

Cómo distribuir la app móvil de Ironchip y los plugins de escritorio (Windows, Linux, macOS y RFID): tiendas, MDM, GPO, app a medida y lista blanca de USB.

La app móvil de Ironchip se distribuye de forma pública, privada o a medida. Los plugins y agentes de escritorio se despliegan de forma masiva con GPO, MDM u otras herramientas de gestión. Esta página es para quien despliega Ironchip en los dispositivos de la compañía.

Descarga la app desde la tienda de tu dispositivo.

Google Play (Android):

  1. Abre la aplicación Play Store en tu dispositivo.
  2. Busca Ironchip.
  3. Descarga la app.

App Store (iOS):

  1. Abre la aplicación App Store en tu dispositivo.
  2. Busca Ironchip.
  3. Descarga la app.

Ironchip dispone de un repositorio privado de aplicaciones para las organizaciones que lo necesitan, como las que gestionan de forma centralizada sus dispositivos móviles corporativos. Hay dos modalidades:

  • MDM: distribución privada bajo demanda, integrada en la plataforma MDM corporativa (por ejemplo, Microsoft Intune, VMware Workspace ONE, JAMF para iOS o Kandji). Ironchip proporciona el paquete de la app para distribuirla de forma silenciosa.
  • Enlace privado: Ironchip proporciona un enlace privado para la descarga directa dentro de la organización, sin pasar por las tiendas públicas.

Ironchip ofrece una app personalizada con la apariencia de tu empresa: logotipo, colores y nombre de la aplicación. Se puede desplegar de forma pública (tiendas) o privada (MDM o enlace). Contacta con el equipo de Ironchip para incluir todos los requisitos.

Si solo quieres poner tu logotipo y tus colores en la app de Ironchip, sin publicar una app propia, hazlo tú desde la consola: consulta Aspecto.

  • Android 6.0 o superior. Las señales electromagnéticas están activas desde Android 8.0.
  • iOS 10.0 o superior.

Los instaladores de escritorio se descargan en la sección Plugins de la consola, agrupados así (consulta Plugins):

  • Logon: los plugins de inicio de sesión del equipo, Windows Logon, Linux Logon y MacOS Logon.
  • Authenticators: las apps autenticadoras de escritorio, Windows Authenticator, Linux Authenticator, Mac OS Authenticator y el agente RFID Authenticator.

Los plugins de inicio de sesión se configuran con la API key de una aplicación, no con una clave de la compañía. Créala en Applications > New application, sección Operating system security, con la tarjeta Windows Logon, MacOSX Logon o Linux Logon. La consola la muestra una sola vez, en el paso Overview: consulta Aplicaciones con API key.

El plugin Windows Logon añade Ironchip al inicio de sesión de Windows. Se distribuye con un instalador .msi para cada arquitectura: descárgalo en Plugins, tarjeta Windows Logon, con Download ARM o Download x64, o en GitHub (Ironchip-Windows-Logon). Hay tres métodos de despliegue.

Es el método recomendado para AD local.

  1. Descarga el instalador .msi de la arquitectura de tus equipos desde Plugins > Windows Logon.
  2. En el servidor de dominio, abre la Consola de administración de directivas de grupo (GPMC).
  3. Crea o edita un GPO y vincúlalo a la unidad organizativa (OU) que contiene los equipos de destino.
  4. Ve a Configuración del equipo > Directivas > Configuración de software > Instalación de software y añade el paquete .msi.
  5. El software se instala automáticamente en todos los equipos del dominio en el siguiente reinicio o al actualizar las directivas (gpupdate /force).

Puedes preconfigurar en el GPO la API key de la aplicación de Windows Logon para que la instalación sea totalmente silenciosa y sin interacción del usuario.

Es el método recomendado para entornos en la nube o híbridos.

  1. Sube el instalador .msi a Microsoft Intune (o a una herramienta MDM equivalente).
  2. Crea una política de implementación de aplicaciones asignada al grupo de dispositivos de destino.
  3. Configura los parámetros de instalación silenciosa (API key de la aplicación y entorno de producción).
  4. Intune despliega la app en los dispositivos asignados en el siguiente ciclo de sincronización.

Es compatible con Microsoft Intune, SCCM / Microsoft Endpoint Configuration Manager, Jamf (macOS), Kandji (macOS) y ManageEngine MDM.

Para pilotos o grupos pequeños: ejecuta el instalador .msi directamente en el equipo e introduce la API key de la aplicación en el asistente de instalación. No se recomienda para despliegues de más de 20 equipos.

Para más información sobre el plugin, consulta Inicio de sesión en Windows.

La tarjeta Linux Logon de Plugins enlaza con la página de versiones del plugin en GitHub, desde donde se descarga el módulo PAM de Ironchip para Linux (pam_ironchip_auth.so). Para desplegarlo en un parque de servidores Linux, usa Ansible, Puppet o Chef para automatizar la copia del módulo y la edición de los archivos de /etc/pam.d/ en todos los servidores de destino, con la API key de la aplicación de Linux Logon.

Ejemplo con Ansible:

Ventana de terminal
ansible-playbook ironchip_pam.yml -i inventario.ini

Para más información, consulta Inicio de sesión en Linux.

La tarjeta MacOS Logon de Plugins enlaza con la página de versiones del plugin en GitHub. El módulo PAM para macOS se distribuye con JAMF Pro o Kandji. El flujo es:

  1. Sube el .pkg del módulo PAM a JAMF.
  2. Crea una política de despliegue asignada a los Mac corporativos.
  3. Ejecuta un script posterior a la instalación que edita automáticamente el archivo de /etc/pam.d/ con la API key de la aplicación de MacOSX Logon.

Para más información, consulta Inicio de sesión en macOS.

Las apps autenticadoras de escritorio, con las que el usuario aprueba sus accesos desde el ordenador, están en la sección Authenticators de Plugins:

  • Windows Authenticator: instalador .msi. Consulta Instalación del autenticador en Windows.
  • Linux Authenticator: paquete .deb.
  • Mac OS Authenticator: paquete .pkg, con Download ARM y Download x86 según el procesador del Mac.

Para el uso de la app, consulta Aplicación de escritorio.

El agente RFID se descarga en Plugins, sección Authenticators, tarjeta RFID Authenticator. Su API key se genera al crear una política de dispositivos de tipo RFID en Authentication policies > Device policies: consulta Tarjeta NFC / RFID. Para desplegarlo en varios equipos con lectores RFID:

  1. Distribuye el agente con GPO o con una herramienta de despliegue de software.

  2. Configura la API key con un script de PowerShell que se ejecute como tarea de inicio de sesión o como script de GPO. El comando de configuración es:

    Ventana de terminal
    .\IronchipRFID.exe c --api_key <API_KEY>

Este proceso se puede automatizar por completo en los equipos del dominio, sin intervención del usuario.

Para permitir solo determinados dispositivos USB en los equipos del dominio:

  1. Abre el Administrador de dispositivos.
  2. Busca el dispositivo USB y abre sus propiedades.
  3. Ve a la pestaña Detalles y selecciona ID de hardware en el menú desplegable. Anota el ID de hardware.
  1. Abre el Editor de directivas de grupo (gpedit.msc).

  2. Ve a Configuración del equipo > Plantillas administrativas > Sistema > Instalación del dispositivo > Restricciones de instalación del dispositivo.

  3. Abre la directiva Permitir la instalación de dispositivos que coincidan con cualquiera de estos ID de dispositivo.

  4. Configúrala como Habilitada.

  5. Haz clic en Mostrar.

  6. Introduce el ID de hardware del dispositivo USB que anotaste.

    Directiva para permitir la instalación de dispositivos con ID concretos

  1. En el Editor de directivas de grupo, ve a Configuración del equipo > Plantillas administrativas > Sistema > Instalación del dispositivo > Restricciones de instalación del dispositivo.

  2. Abre la directiva Evitar la instalación de dispositivos no descritos por otras configuraciones de políticas.

  3. Configúrala como Habilitada.

    Directiva para impedir la instalación de dispositivos no aprobados

Sincronización de identidades

Sincronización de identidades

Trae usuarios y grupos a Ironchip desde Active Directory, Entra ID, LDAP, SCIM o un archivo CSV, y resuelve las dudas más habituales de la sincronización.

Mantén los usuarios y grupos de la consola de administración alineados con tu directorio. Esta página resume los métodos de sincronización disponibles, explica cómo sincronizar con SCIM o con un archivo CSV desde la consola y reúne las preguntas frecuentes.

Origen Mecanismo Guía
Active Directory local Agente Ironchip AD Connect, que lee el AD y lo envía por SCIM AD Connect
Microsoft Entra ID Aplicación empresarial con aprovisionamiento SCIM Entra ID
Directorio LDAP Comando sync-users del proxy LDAP de Ironchip Proxy LDAP
Otro directorio Credencial SCIM creada en la consola SCIM en la consola
Archivo CSV Plantilla que se carga desde la consola Sincronizar usuarios con un archivo CSV

En la consola, el menú Directory > Synchronization tiene dos opciones: CSV, para sincronizar con un archivo, y SCIM, para la sincronización automática.

SCIM (System for Cross-domain Identity Management) sincroniza de forma automática los usuarios y grupos de tu directorio con Ironchip. Cualquier alta, cambio o baja en el directorio llega a la consola sin gestionar los usuarios a mano. Para usarlo, crea una credencial SCIM en la consola y configúrala en el origen: AD Connect, Entra ID u otro sistema compatible con SCIM 2.0.

  1. Ve a Directory > Synchronization > SCIM. La página Synchronization with SCIM tiene dos pestañas: Get Started y Credentials.

  2. En Get Started, copia la Base URL: con el botón de copiar: https://api.ironchip.com/scim/v2. La pestaña resume también los pasos de la integración, las acciones admitidas (User Provisioning y Group Management) y el método de autenticación (Bearer).

    Pestaña Get Started de Synchronization with SCIM con la Base URL y los pasos de la integración

  3. Abre la pestaña Credentials y haz clic en Add credential. Confirma con Add en la ventana Add a new credential.

  4. La ventana SCIM credentials muestra la API KEY. Cópiala con el icono de copiar o descárgala con Download credentials (credentials.json). Por seguridad, la consola no vuelve a mostrarla.

    Ventana SCIM credentials con el campo API KEY y el botón Download credentials

  5. Configura el origen con la Base URL y la API KEY, que el origen envía como token Bearer. Los pasos de la pestaña Get Started llaman a la API KEY Authentication Token, y cada origen usa sus propios nombres:

    En Ironchip En Entra ID
    Base URL URL de inquilino (Tenant URL)
    API KEY Token secreto (Secret Token)

    En AD Connect, la API KEY se llama SCIM synchronization key.

La pestaña Credentials lista las credenciales con su pista (Hint) y su fecha (Date), y puedes buscar por pista. Para retirar una, haz clic en Delete en su fila y confirma. El origen que la use deja de poder sincronizar.

Ironchip expone los recursos /scim/v2/Users, /scim/v2/Groups y /scim/v2/Schemas. Con los usuarios hace esto:

  • name.givenName pasa al nombre y name.familyName, a los apellidos.
  • emails pasa al correo; si hay varios, se usa primero el principal. Si no llega ningún correo, se usa userName cuando es una dirección válida.
  • active activa o desactiva la protección de Ironchip del usuario. No borra al usuario.
  • title pasa al puesto.
  • Los atributos de la extensión empresarial, los de la extensión de Ironchip y el resto se guardan como atributos personalizados del usuario.

Para saber si un usuario ya existe, Ironchip lo busca por emails, userName, externalId e immutableId.

En la consola no hay una opción de sincronización con LDAP. Un Active Directory o un directorio LDAP se sincronizan con uno de estos plugins, que se descargan desde Plugins (consulta Plugins):

  • AD Connect: agente que se instala en tu red, lee los usuarios y grupos del AD por LDAP o LDAPS y los envía a Ironchip por SCIM, con la API KEY de una credencial SCIM de la consola. Consulta AD Connect.
  • LDAP: el proxy LDAP se sitúa delante del controlador de dominio para proteger la autenticación LDAP. Incluye el comando sync-users, que importa los usuarios del directorio en Ironchip cuando lo ejecutas.

Esta integración sincroniza de forma automática los usuarios de tu organización desde Microsoft Entra ID (antes Azure AD) hacia la consola de Ironchip. Con el protocolo SCIM, cualquier usuario o grupo que asignes a tu aplicación empresarial se aprovisiona en Ironchip sin gestión manual. También puedes mapear atributos de los usuarios de Entra ID con los campos de Ironchip.

El proceso se resume así:

  1. Configuración en Ironchip. Crea en la consola de administración una credencial SCIM y copia la Base URL y la API KEY. Consulta SCIM en la consola.
  2. Aprovisionamiento en Entra ID. En el portal de Microsoft Entra ID, añade la aplicación de Ironchip y escribe esos valores en URL de inquilino y Token secreto, en Aprovisionamiento.
  3. Mapeo de atributos. Define qué campos (nombre, correo, grupos) se sincronizan. Ironchip usa estos datos para crear y actualizar usuarios, y para activar o desactivar su protección.
  4. Sincronización continua. Los cambios en el directorio, como dar de baja a un empleado o cambiarlo de departamento, llegan a Ironchip en los ciclos de aprovisionamiento de Entra ID, cuya frecuencia gestiona Microsoft.

La guía completa está en Sincronizar usuarios con Entra ID.

La sincronización con CSV permite dar de alta el número de usuarios que quieras con un único archivo, en un grupo de la compañía.

  1. Ve a Directory > Synchronization > CSV y haz clic en Synchronize. Se abre la ventana CSV synchronization, con cuatro pasos: Template download, Template upload, Sync options y Summary.

    Página Synchronization with CSV con el listado de sincronizaciones y el botón Synchronize

  2. En el paso Template download, haz clic en Download template y después en Next. Si ya tienes una plantilla, puedes saltar este paso.

    Paso Template download con el botón Download template

  3. Rellena la plantilla synchronization_template.csv con los datos de los usuarios. Tiene las columnas ID, Name, Surname, Email, Lang, ImmutableID, ExternalEmail, MaxDevices y SelfInvite, más PhoneNumber si tu compañía tiene activada la autenticación por SMS y una columna por cada atributo personalizado de usuario. No cambies la extensión .csv ni los nombres de las columnas.

  4. En el paso Template upload, arrastra la plantilla rellena a la zona indicada, o haz clic en la zona para seleccionarla desde el explorador de archivos. Solo se admiten ficheros .csv.

    Paso Template upload con la zona para soltar el archivo CSV

  5. Cuando la plantilla se haya cargado correctamente, haz clic en Next. Con Back vuelves al paso anterior.

  6. En el paso Sync options, elige el grupo en la tabla Select group. Puedes buscarlo con Search by group name; solo aparecen los grupos de la compañía, no los grupos personales de cada usuario. El grupo elegido aparece en GROUP SELECTION, con el aviso de que se actualizará con los miembros del archivo; para cambiarlo, haz clic en la X roja.

  7. En SYNCHRONIZATION OPTIONS, elige qué pasa con los usuarios que ya están en el grupo pero no en el archivo, y si se invita a los nuevos:

    • Delete them from the selected group. Se quitan del grupo y pierden los accesos que les daba.
    • Also delete them from the platform. Además, se eliminan de la plataforma con todos sus datos, claves y accesos.
    • Enable invitation to Ironchip for the synchronized users. Los usuarios sincronizados reciben la invitación para usar la app de Ironchip y quedan protegidos por Ironchip. Si no la marcas, no quedan protegidos.

    Paso Sync options con la tabla Select group, el grupo seleccionado y las opciones de sincronización

  8. Haz clic en Next.

  9. En el paso Summary, revisa el resumen final de la sincronización:

    • La plantilla importada (Import template:).
    • El grupo al que se añaden los usuarios sincronizados.
    • Si los usuarios sincronizados quedan o no protegidos por Ironchip.
    • Qué pasa con un usuario del grupo que no está en los nuevos datos: se queda en él, sale del grupo o, además, se elimina de la plataforma, según lo que elegiste.

    Paso Summary con el resumen de la sincronización y la casilla de confirmación

  10. Marca I have read the synchronization summary and understand the implications. y haz clic en Add. Si tienes dudas, vuelve a las pantallas anteriores con Back.

Solo puede haber una importación en curso por compañía, y el nombre del archivo no puede repetir el de una sincronización anterior.

La página Synchronization with CSV lista las sincronizaciones con las columnas Updated group, File name, Date, Status, Users y Manage. La columna Users muestra los usuarios sincronizados sobre el total del archivo, y Status indica si la sincronización se completó, quedó incompleta o sigue en curso. Puedes buscar con Find report.

  • Al seleccionar una fila, el panel Synchronization details muestra la fecha, el grupo, el archivo y el resultado.
  • Options > View report abre la ventana Synchronization report, con la fecha (Synchronization date:), el grupo (Synchronized group:), el archivo (Synchronized file:), los usuarios sincronizados (Synchronized users:) y los errores de cada línea del archivo con el formato [line N]: correo: mensaje.

¿Qué métodos hay para integrar Ironchip con Active Directory?

Sección titulada «¿Qué métodos hay para integrar Ironchip con Active Directory?»

Hay cuatro:

  • Agente AD Connect: el método más común para AD local. Lee el AD y sincroniza usuarios y grupos de forma automática por SCIM.
  • Proxy LDAP: protege la autenticación LDAP de un grupo del directorio, y su comando sync-users importa los usuarios cuando lo ejecutas.
  • Entra ID mediante SCIM: para entornos en la nube o híbridos.
  • AD con Windows Logon: el agente añade Ironchip como proveedor de credenciales adicional sobre AD. Consulta Inicio de sesión en Windows.

¿Qué diferencia hay entre el proxy LDAP y AD Connect?

Sección titulada «¿Qué diferencia hay entre el proxy LDAP y AD Connect?»
  • AD Connect: instala un agente en la red que mantiene sincronizados los usuarios y grupos de forma automática. Es lo ideal para AD local y admite grupos y atributos.
  • Proxy LDAP: se pone delante del controlador de dominio para proteger con Ironchip la autenticación LDAP de los usuarios de un grupo. La sincronización no es automática: la lanzas tú con el comando sync-users.

La consola muestra menos usuarios que el Active Directory

Sección titulada «La consola muestra menos usuarios que el Active Directory»

Las causas más habituales son:

  • Grupos hijo sin sincronizar: el agente puede no sincronizar todos los miembros de los subgrupos anidados.
  • Configuración incorrecta del grupo con invitación automática (Autoinvite) en Ironchip. Consulta Invitación automática.

Para resolverlo, escribe a soporte indicando el nombre del grupo afectado, para que verifiquen la versión del agente y la configuración.

¿Cómo se gestionan los grupos anidados (grupos hijo) de Active Directory?

Sección titulada «¿Cómo se gestionan los grupos anidados (grupos hijo) de Active Directory?»

Al configurar la sincronización, indica de forma explícita si se sincronizan los miembros de los grupos hijo. El grupo hijo debe estar asociado al grupo de Ironchip correspondiente. Los grupos hijo que añadas después de la configuración inicial pueden requerir un ajuste manual.

¿Cómo se actualiza el agente de AD Connect?

Sección titulada «¿Cómo se actualiza el agente de AD Connect?»

La actualización requiere una sesión técnica conjunta entre Ironchip y tu equipo de IT. Ironchip valida la actualización antes de la sesión. Escribe a support@ironchip.com para coordinarla.

¿Se puede migrar la configuración de Ironchip entre entornos de AD?

Sección titulada «¿Se puede migrar la configuración de Ironchip entre entornos de AD?»

Sí, pero requiere coordinación previa con el equipo técnico de Ironchip. El proceso incluye:

  1. Exportar la configuración de origen.
  2. Validar la compatibilidad del nuevo AD.
  3. Configurar el conector.
  4. Verificar la sincronización.
  5. Mantener un periodo de coexistencia si la migración es gradual.

AD Connect

Instala y configura Ironchip AD Connect en Windows para sincronizar los usuarios y grupos de Active Directory con la consola de administración.

Ironchip AD Connect es una herramienta que sincroniza los usuarios y grupos de tu Active Directory con la consola de administración de Ironchip. Se instala como servicio de Windows y se configura desde un panel local.

  1. Descarga Ironchip AD Connect desde la sección Plugins de la consola de administración.

  2. Abre una terminal de PowerShell como administrador y ve a la carpeta donde está el ejecutable.

  3. Instala el servicio y arráncalo:

    Ventana de terminal
    .\ironchip-ad-connect.exe s install
    .\ironchip-ad-connect.exe s start

    Comandos de instalación e inicio del servicio en PowerShell

  4. Abre en un navegador http://localhost:10300. Es una dirección local donde se aloja el panel de sincronización de usuarios.

    Dirección localhost en la barra del navegador

Para parar o desinstalar el servicio, ejecuta:

Ventana de terminal
.\ironchip-ad-connect.exe s stop
.\ironchip-ad-connect.exe s uninstall

Para ver el resto de comandos disponibles, ejecuta:

Ventana de terminal
.\ironchip-ad-connect.exe h

El primer paso es establecer la conexión entre Ironchip y Active Directory. En el panel, rellena el apartado de configuración y haz clic en el botón verde Configure:

  • User: dominio y nombre de un usuario de Active Directory con permisos de administrador.
  • Password: contraseña de ese usuario.
  • SCIM synchronization key: la clave de sincronización SCIM de tu compañía, que se obtiene en la consola de Ironchip (consulta la sección siguiente).

Formulario Configure de AD Connect con el usuario, la contraseña y la clave de sincronización SCIM

La SCIM synchronization key es el secreto de una credencial SCIM de tu compañía. Para crearla, ve a Directory > Synchronization > SCIM, abre la pestaña Credentials y haz clic en Add credential. Los pasos, con capturas, están en SCIM en la consola.

Una vez configurado, elige qué usuarios y grupos sincronizar.

  1. En el apartado Groups, haz clic en el botón verde +.

    Botón + de la pestaña Groups de AD Connect

  2. En la nueva pestaña, selecciona las unidades o grupos que quieres sincronizar con la consola de Ironchip y haz clic en Add Groups.

    Árbol de grupos del directorio con el botón Add Groups

  3. Haz clic en Start para empezar la sincronización.

    Lista Synchronized Groups y botón Start para iniciar la sincronización

Sincronización con Entra ID

Sincroniza usuarios y grupos de Microsoft Entra ID con Ironchip mediante SCIM: aplicación empresarial, aprovisionamiento, atributos y asignación.

Sincroniza los usuarios y grupos de Microsoft Entra ID (antes Azure AD) con Ironchip mediante SCIM, usando una aplicación empresarial con aprovisionamiento automático.

  • Una única licencia P1 o P2 de Entra ID.
  • Un usuario con permisos en portal.azure.com.
  • La información de sincronización (SCIM) de tu compañía de Ironchip: la Base URL y la API KEY de una credencial SCIM, que en Entra ID se llaman URL de inquilino (Tenant URL) y Token secreto (Secret Token). Para obtenerlas, consulta SCIM en la consola.
  1. Entra en el portal de Azure con un usuario con permisos.

    Portal de Azure

  2. Busca y entra en Aplicaciones empresariales.

    Acceso a Aplicaciones empresariales

  3. Haz clic en Nueva aplicación.

    Botón Nueva aplicación

  4. Haz clic en Cree su propia aplicación.

    Botón Cree su propia aplicación

  5. Asígnale un nombre identificativo, selecciona la última de las tres opciones, Integrar cualquier otra aplicación que no se encuentre en la galería, y crea la aplicación.

    Nombre de la aplicación y opción seleccionada

  1. Dentro de la aplicación, en el menú lateral izquierdo, selecciona Aprovisionamiento.

    Menú Aprovisionamiento de la aplicación

  2. Vuelve a seleccionar Aprovisionamiento y establece el modo en Automático.

    Modo de aprovisionamiento automático

  3. Despliega Credenciales de administrador e introduce los datos de tu compañía de Ironchip: la Base URL (https://api.ironchip.com/scim/v2) en URL de inquilino y la API KEY de la credencial SCIM en Token secreto.

    Credenciales de administrador del aprovisionamiento

  4. Haz clic en Probar conexión. Si aparece una notificación que indica que la conexión es correcta, guarda la configuración.

  1. En el aprovisionamiento de la aplicación, entra en Editar asignaciones de atributos.

    Opción Editar asignaciones de atributos

  2. Despliega la sección Asignaciones y haz clic en Provision Microsoft Entra ID Users.

    Asignación Provision Microsoft Entra ID Users

  3. Establece solo los atributos obligatorios o también los recomendados.

    Atributos obligatorios:

    Atributos obligatorios de la asignación

    Atributos recomendados:

    Atributos recomendados de la asignación

Ironchip lee los atributos SCIM que envía Entra ID según tus asignaciones:

Atributo SCIM En Ironchip
name.givenName Nombre
name.familyName Apellidos
emails Correo. Si hay varios, se usa primero el principal.
userName Correo, solo si no llega ninguno en emails y es una dirección válida.
active Activa o desactiva la protección de Ironchip del usuario. No borra al usuario.
title Puesto
Extensión empresarial y extensión de Ironchip Atributos personalizados del usuario
Cualquier otro atributo Atributo personalizado del usuario

Para saber si un usuario ya existe, Ironchip lo busca por emails, userName, externalId e immutableId.

Se recomienda asignar también el atributo ID inmutable (immutableId). En algunos servicios es obligatorio. Para añadirlo:

  1. En el panel de asignación de atributos, marca Mostrar opciones avanzadas y entra en Editar lista de atributos.

    Opciones avanzadas y Editar lista de atributos

  2. Baja hasta el final de la lista y añade un atributo de tipo String con el nombre urn:ietf:params:scim:schemas:extension:2.0:User:immutableId. Guarda los cambios.

    Nuevo atributo immutableId de tipo String

  3. De vuelta en la pestaña de asignación de atributos, haz clic en Agregar nueva asignación.

    Botón para agregar una nueva asignación

  4. Deja Tipo de asignación en Directo, selecciona immutableId en Atributo de origen y urn:ietf:params:scim:schemas:extension:2.0:User:immutableId en Atributo de destino, y guarda.

    Valores de la asignación del ID inmutable

Para elegir qué usuarios se sincronizan:

  1. En la aplicación empresarial, entra en Usuarios y grupos.

    Menú Usuarios y grupos de la aplicación

  2. Haz clic en Agregar usuario o grupo y selecciona los usuarios y grupos que quieres sincronizar.

    Selección de usuarios y grupos a sincronizar

Con esto, la configuración básica está completa. Si hace falta, ajusta los parámetros a tu caso y reinicia o enciende la aplicación empresarial para que empiece a sincronizar.

Proxy LDAP

Instala y configura el proxy LDAP de Ironchip en Windows, sincroniza usuarios y grupos desde LDAP y protege grupos del directorio con Ironchip.

El proxy LDAP de Ironchip se sitúa delante del controlador de dominio LDAP para proteger con Ironchip la autenticación de los usuarios de un grupo concreto, y permite sincronizar usuarios entre LDAP e Ironchip. Esta página es para quien administra la plataforma e integra su directorio LDAP.

  • Una cuenta de administrador de la consola de administración de Ironchip.
  • La compañía creada en Ironchip. Para saber qué datos preparar, consulta Antes de empezar en Protocolos de integración.
  • Un controlador de dominio LDAP y un equipo Windows donde instalar el proxy.

El proxy se conecta a Ironchip con la API key de una aplicación de tipo API key.

  1. Ve a Applications y haz clic en New application. Se abre la ventana Add new application.
  2. En el paso Select service type, sección For developers, elige Custom code.
  3. En el paso Configure service, escribe el nombre de la aplicación en Name, en la pestaña General, y haz clic en Add.
  4. En el paso Overview, copia la API KEY o descárgala con Download credentials (credentials.json). La aplicación aparece en el listado de Applications.

Para más información, consulta Aplicaciones con API key.

  1. Ve a Applications y, en la columna Add access de la aplicación, haz clic en Add. Se abre la ventana Add a new access.
  2. En Select a group, marca el grupo o el usuario que se autentica a través del proxy y haz clic en Next. Cada acceso es para un solo grupo o usuario: crea un acceso por cada uno.
  3. En Select usernames, define en Username composition el formato del nombre de usuario. Debe ser el mismo con el que el usuario se autentica. Haz clic en Next.
  4. En Select authentication policies, elige las políticas de autenticación que se exigen y haz clic en Next.
  5. En Review, revisa el resumen y haz clic en Add.

El acceso queda creado con la configuración elegida y puedes cambiarlo en cualquier momento. Para más información, consulta Dar acceso a usuarios y grupos.

Descarga el proxy LDAP desde la consola de administración de Ironchip, en Plugins > Windows Integrations > LDAP, con el botón Download.

  1. Mueve el ejecutable descargado a una carpeta del sistema adecuada para ejecutar servicios.

  2. Ejecútalo con el parámetro configuration para generar el archivo de configuración predeterminado:

    Ventana de terminal
    ldap-windows.exe configuration
  3. Edita el archivo de configuración (consulta la sección siguiente) e instala el servicio:

    Ventana de terminal
    ldap-windows.exe service install
  4. Inicia el servicio:

    Ventana de terminal
    ldap-windows.exe service start

Puedes modificar el archivo de configuración en cualquier momento. Para que los cambios se apliquen, reinicia el servicio:

Ventana de terminal
ldap-windows.exe service restart

El archivo de configuración tiene estas propiedades:

  • Ruta: la ruta del archivo de configuración.
  • ldap:
    • server_address: el FQDN del controlador de dominio LDAP.
    • server_port: el puerto del controlador de dominio LDAP.
    • network: el esquema de comunicación que usa el cliente. Actualmente solo se admite tcp.
    • base_dn: el DN base al que se adjunta el proxy.
  • proxy:
    • server_address: la dirección en la que sirve el proxy.
    • server_port: el puerto en el que sirve el proxy.
    • protected_group: el nombre del grupo protegido con Ironchip.
    • network: el esquema de comunicación que usa el proxy. Actualmente solo se admite tcp.
  • ironchip:
    • ironchip_api_key: la API key generada para el servicio de Ironchip asociado.
    • ironchip_host: la dirección de tu entorno de Ironchip. Normalmente, https://api.ironchip.com.

Un archivo de configuración de ejemplo:

{
"ldap": {
"server_address": "localhost",
"server_port": 389,
"tls_enable": false,
"key_file": "",
"cert_file": "",
"time_out_seconds": 5,
"network": "tcp",
"base_dn": ""
},
"proxy": {
"server_address": "0.0.0.0",
"server_port": 4389,
"tls_enable": false,
"key_file": "",
"cert_file": "",
"protected_group": "",
"time_out_seconds": 5,
"network": "tcp"
},
"ironchip": {
"ironchip_api_key": "<API_KEY>",
"ironchip_host": "https://api.ironchip.com"
}
}

Los usuarios que pertenecen al grupo protegido quedan protegidos con Ironchip.

  1. En el controlador de dominio, haz clic derecho y selecciona Nuevo > Grupo.

    Menú Nuevo > Grupo en el controlador de dominio

  2. Crea el grupo con un nombre específico.

    Ventana de creación del grupo

  3. Para añadir un usuario al grupo, haz clic derecho en el usuario y selecciona Agregar a un grupo…

    Opción Agregar a un grupo en el menú del usuario

  4. Selecciona el grupo y haz clic en Aceptar.

    Selección del grupo al que añadir el usuario

El usuario queda protegido con Ironchip.

Con el servicio en marcha y el usuario en el grupo protegido, prueba la autenticación en la aplicación LDAP Admin:

  1. Inicia una conexión: haz clic en Start y después en Connect.
  2. Haz clic derecho en Custom y selecciona Properties.
  3. Define estas propiedades y haz clic en OK:
    • Host: el nombre o la dirección del equipo donde se ejecuta el proxy.
    • Port: el puerto en el que sirve el proxy (server_port de proxy).
    • Username: el nombre de usuario que usaste en la configuración del servicio.
  4. Haz clic de nuevo en OK para iniciar la autenticación.

El usuario recibe una notificación del servicio y autoriza el acceso. La autenticación tarda unos segundos. Cuando termina, ves que el usuario se ha autorizado correctamente.

Para sincronizar los usuarios entre LDAP e Ironchip, el proxy incluye una herramienta:

Ventana de terminal
ldap-windows.exe sync-users -ldap-user <user-used-for-bind> -ironchip-user <ironchip admin with access to the dashboard> -export-path <path for the exported users file creation>

Estos son los parámetros:

  • -ldap-user: el usuario que se usa para el bind con el LDAP.
  • -ironchip-user: un administrador de Ironchip con acceso a la consola.
  • -export-path: la ruta donde se crea el archivo con los usuarios exportados.

Cuando termina la importación, todos los usuarios están creados en Ironchip.

Para sincronizar solo los usuarios de un grupo, usa sync-users con un filtro de búsqueda:

Ventana de terminal
ldap-windows.exe sync-users -ldap-user <user-used-for-bind> -ironchip-user <ironchip admin with access to the dashboard> --ldap-search-filter "(&(objectClass=person)(memberOf=<group full DN>))"

Por ejemplo, si los usuarios pertenecen al grupo VPNAuthorized, con el DN CN=VPNAuthorized,DC=ironchip,DC=com, el comando es:

Ventana de terminal
ldap-windows.exe sync-users -ldap-user <user-used-for-bind> -ironchip-user <ironchip admin with access to the dashboard> --ldap-search-filter "(&(objectClass=person)(memberOf=CN=VPNAuthorized,DC=ironchip,DC=com))"

sync-users también admite el parámetro --ldap-search-dn. Por defecto vale el DN configurado en el archivo de configuración, pero puedes usarlo para sustituir el DN base de la búsqueda en esa ejecución.

El proxy registra sus eventos en el visor de eventos de Windows con el nombre Ironchip LDAP Proxy.

Para desinstalar el servicio, ejecuta:

Ventana de terminal
ldap-windows.exe service uninstall

El proxy LDAP es uno de los plugins que se descargan desde la sección Plugins de la consola de administración. La lista completa, organizada en las secciones Logon, Authenticators, Windows Integrations y Linux Integrations, está en Plugins.

Aplicaciones y permisos

Aplicaciones

Crea aplicaciones OIDC, SAML, con API key o servidores NPS en la consola, da acceso a usuarios y grupos con sus políticas y gestiona sus credenciales.

Una aplicación es cualquier servicio que protege Ironchip: un portal web por OIDC o SAML, el inicio de sesión de un equipo, una VPN o una red Wi-Fi por RADIUS, o una aplicación propia con API key. Esta página es para quien administra la consola: explica cómo crear una aplicación, cómo dar acceso a usuarios y grupos, cómo gestionarla después y dónde están sus credenciales. Las guías de cada protocolo e integración remiten aquí para los pasos comunes.

En Applications (página Your applications) ves las aplicaciones de la compañía con las columnas Name, Integration (APIKEY, OIDC, SAML o el nombre del servidor NPS), Manage y Add access. Al seleccionar una aplicación, la tarjeta Application information de la derecha muestra su número de accesos (Access number:) y su historial de autenticaciones (Authentication history).

Página Your applications con la lista de aplicaciones, el botón New application y la tarjeta Application information

  1. Ve a Applications y haz clic en New application. Se abre la ventana Add new application, con tres pasos: Select service type, Configure service y Overview.

  2. En Select service type, haz clic en la tarjeta del tipo de aplicación. El asistente pasa solo al paso siguiente.

    Paso Select service type con las secciones Operating system security, Remote access protocols, RADIUS NPS server configuration, Standard authentication protocols y For developers

  3. En Configure service, pestaña General, escribe el nombre de la aplicación en Name (3 caracteres como mínimo). En Icon puedes subir un icono en JPEG, JPG o PNG de hasta 1 MB.

    Paso Configure service, pestaña General, con los campos Name e Icon

  4. Completa las demás pestañas, que dependen del tipo de aplicación (las explican los apartados siguientes), y haz clic en Add.

  5. En Overview, copia o descarga las credenciales que muestra la consola y cierra la ventana con la X.

Si vuelves atrás con Back desde Configure service, el formulario se vacía; si cierras la ventana antes de terminar, se descarta lo que hayas rellenado.

Estas son las tarjetas de Select service type y lo que crea cada una:

Sección Tarjeta Qué crea
Operating system security Windows Logon, MacOSX Logon, Linux Logon Una aplicación con API key para el plugin de inicio de sesión del equipo
Remote access protocols SSH, Remote Desktop Protocol (RDP) Una aplicación con API key
RADIUS NPS server configuration New NPS server, y una tarjeta con el botón Assign policy por cada servidor NPS que ya existe Un servidor NPS y, con Assign policy, la aplicación de una directiva
Standard authentication protocols OIDC Una aplicación OIDC
SAML Una aplicación SAML
Passwordless RADIUS Una aplicación con API key para el Ironchip RADIUS server
For developers Custom code Una aplicación con API key para una aplicación propia

Ironchip actúa como proveedor OpenID Connect. Para los detalles del protocolo, consulta OIDC.

  1. En Select service type, haz clic en OIDC.

  2. En la pestaña General, escribe el nombre en Name.

  3. En la pestaña Redirect URIs, escribe en Redirect URL la dirección a la que se devuelve al usuario después de autenticarse, por ejemplo https://app.example.com/callback. Con el icono + añades más direcciones. Hace falta al menos una.

    Pestaña Redirect URIs con una dirección en el campo Redirect URL

  4. Haz clic en Add.

  5. En Overview, copia Client ID, Client Secret y Metadata URL, o descárgalos en un archivo credentials.json con Download credentials.

    Paso Overview de una aplicación OIDC con Client ID, Client Secret, Metadata URL y el botón Download credentials

Ironchip actúa como proveedor de identidad (IdP) SAML. Para los atributos que envía y los detalles del protocolo, consulta SAML.

Ten a mano los datos del proveedor de servicio (SP) antes de empezar: la consola no crea la aplicación sin un Entity ID y un Assertion Consumer Services con Binding y Location.

  1. En Select service type, haz clic en SAML.

  2. En la pestaña General, escribe el nombre en Name.

  3. En la pestaña Service Provider (SP), despliega Import Metadata y, en SP Metadata, elige cómo cargar la metadata del servicio:

    • URL: escribe la dirección de la metadata en URL of SP’s Metadata.
    • Text: pega el XML de la metadata.
    • File: sube el archivo .xml.

    Haz clic en Import para rellenar los campos con la metadata. Si el servicio no ofrece metadata, rellena a mano Entity ID y Assertion Consumer Services (Binding y Location).

    Pestaña Service Provider (SP) con la sección Import Metadata desplegada y las opciones URL, Text y File

  4. En la pestaña Identity Provider (IdP) están los datos de Ironchip que necesita el servicio: el identificador del IdP (IdP Entity ID or Issuer), la dirección de inicio de sesión único (Single Sign On Service) y los certificados, cada uno con su icono para copiarlo. Ya están disponibles antes de crear la aplicación.

    Pestaña Identity Provider (IdP) con los datos de Ironchip como proveedor de identidad

  5. Haz clic en Add. Overview muestra el nombre de la aplicación (Name:) y la dirección de la metadata del IdP (IDP Metadata URL:). Las aplicaciones SAML no tienen secretos que guardar.

Las tarjetas Windows Logon, MacOSX Logon, Linux Logon, SSH, Remote Desktop Protocol (RDP), Passwordless RADIUS y Custom code crean una aplicación que se autentica con una API key. Solo tienen la pestaña General.

  1. En Select service type, haz clic en la tarjeta.

  2. En la pestaña General, escribe el nombre en Name y haz clic en Add.

  3. En Overview, copia la API key del campo API KEY o descárgala en un archivo credentials.json con Download credentials. En las aplicaciones de Windows Logon, MacOSX Logon y Linux Logon, el botón View installation guide abre en GitHub las instrucciones de descarga e instalación del plugin, que te pedirá esta API key.

    Paso Overview de una aplicación Custom code con el campo API KEY y el botón Download credentials

Si necesitas otra API key para la misma aplicación, por ejemplo para cambiarla, créala en la pestaña Credentials de la aplicación: consulta Credenciales de una aplicación.

Guías que usan estas aplicaciones: Inicio de sesión en Windows, en macOS y en Linux, Ironchip RADIUS server y API HTTP.

Para proteger un Microsoft NPS (VPN, Wi-Fi o RDP por RADIUS) primero creas un servidor NPS, que tiene su propia API key, y después, con Assign policy, una aplicación por cada directiva de red que protege el plugin de NPS. Las integraciones HTTP-MFA de versiones anteriores de la consola (MFA integrations > Add MFA) se crean ahora así, como servidores NPS. La instalación del plugin está en Microsoft NPS.

Para crear el servidor:

  1. Ve a Applications y haz clic en New application.

  2. En la sección RADIUS NPS server configuration, haz clic en New NPS server.

  3. En la ventana Add RADIUS Server, escribe un nombre en Name (de 3 a 60 caracteres) y haz clic en Add. Elige un nombre reconocible: es el que aparece en la tarjeta del servidor y en la columna Integration de sus aplicaciones.

    Ventana Add RADIUS Server con el campo Name

  4. La ventana Credentials for your new RADIUS Servers muestra la API key del servidor. Cópiala o descárgala con Download credentials: solo aparece esta vez y la necesitas para instalar el plugin de NPS.

    Ventana Credentials for your new RADIUS Servers con la API key y el botón Download credentials

Para proteger una directiva de red con ese servidor:

  1. En Applications > New application, sección RADIUS NPS server configuration, haz clic en Assign policy en la tarjeta del servidor.

  2. En la pestaña General, escribe el nombre de la aplicación en Name.

  3. En la pestaña NPS, comprueba que NPS Server tiene seleccionado el servidor y escribe en Policy el nombre de la directiva de red de NPS que protege el plugin, por ejemplo IronchipProtected. El campo es obligatorio.

    Pestaña NPS con el servidor seleccionado en NPS Server y el nombre de la directiva en Policy

  4. Haz clic en Add. Overview confirma que la aplicación se ha creado. No muestra ninguna API key: la del servidor apareció al crearlo.

El icono ? junto al título RADIUS NPS server configuration abre la página RADIUS Servers, que no está en el menú: lista los servidores con su nombre y su pista (Name, Hint) y permite borrarlos con Delete RADIUS Server. También puedes borrar un servidor con el icono rojo de su tarjeta (Delete NPS Server). Un servidor borrado deja de servir para acceder a cualquier aplicación.

Un acceso une una aplicación con un grupo o un usuario, el nombre de usuario con el que entra y las políticas de autenticación que debe cumplir. Puedes crearlo desde dos sitios:

  • En Applications, con el botón Add de la columna Add access de la aplicación.
  • En la página de la aplicación, pestaña Accesses, con Add access.

Se abre la ventana Add a new access, con cuatro pasos.

En Select a group, busca con Search by name y marca la casilla Add del grupo o del usuario. Cada acceso es para un solo grupo o un solo usuario: si marcas otro, sustituye al anterior. El icono de cada fila distingue los grupos de los usuarios. Para dar acceso a varios grupos, crea un acceso por grupo. Haz clic en Next.

Paso Select a group de la ventana Add a new access con la lista de grupos y usuarios

En Select usernames, el apartado Username composition define la plantilla del nombre de usuario con el que se entra en la aplicación. Ese nombre solo se usa en este acceso: no sustituye al nombre del usuario en la plataforma.

  • La plantilla empieza con la etiqueta email. Haz clic en Enter a tag para añadir otras: name, name initial, surname, surname initial, email, username, domain, domain name, root domain, top-level domain, id y los atributos personalizados de la compañía.
  • Con etiquetas, cada usuario recibe un nombre distinto. El texto que escribes sin elegir una etiqueta queda como texto fijo, igual para todos los usuarios.
  • La plantilla admite hasta 150 caracteres.
  • El icono del engranaje de una etiqueta ofrece Trim to specified length, que la recorta a los caracteres que indiques. Confirma con Apply o descarta con Cancel.
  • Username example muestra el nombre que genera la plantilla con los datos de un usuario de ejemplo (Generated username:).

Si activas Set user alias, puedes definir además un alias del usuario para este acceso, con su propia plantilla (Generated user alias:). El alias es solo un identificador adicional: no cambia las credenciales, y el usuario sigue entrando con el nombre de la plantilla anterior. Haz clic en Next.

Paso Select usernames con la plantilla del nombre de usuario y el interruptor Set user alias activado

Paso 3: elige las políticas de autenticación

Sección titulada «Paso 3: elige las políticas de autenticación»

En Select authentication policies, apartado Configure authentication factors, eliges las políticas que debe cumplir el usuario para entrar. Las políticas se organizan en filas:

  • En cada fila, haz clic en + Select authentication policy y elige una o varias políticas. Las de una misma fila se unen con AND: el usuario tiene que cumplirlas todas.
  • El botón + añade otra fila. Las filas se unen con OR: basta con cumplir todas las políticas de una de ellas.
  • La x de una política la quita de su fila; la x roja de una fila la borra entera.

Por ejemplo, con una fila Any user devices AND Any user safezones y otra fila Any FIDO2 devices, el usuario entra con su dispositivo desde una de sus zonas seguras o con su passkey. Haz clic en Next.

Paso Select authentication policies con dos filas de políticas: dentro de cada fila se unen con AND y entre filas con OR

En Review ves el nombre de la aplicación (Application name:), el grupo o usuario (Selected group:), la plantilla del nombre de usuario (Username template:), la del alias (User alias template:, o No alias was set) y las políticas que exige el acceso (Authentication factors:). Haz clic en Add. La consola confirma con Access added.

Paso Review con el resumen del acceso

Haz clic en el nombre de la aplicación, o en Options > View service, para abrir su página. Arriba, el gráfico Authentications in nombre muestra las autenticaciones completadas e incompletas (Completed authentications, Incomplete authentications) del mes que elijas en Time period. Debajo hay dos pestañas:

  • Accesses: los accesos de la aplicación, con las columnas Group, Username template y Manage, el buscador Search by access name y el botón Add access.
  • Credentials: las credenciales de la aplicación. Las aplicaciones SAML no tienen esta pestaña. Consulta Credenciales de una aplicación.

Página de una aplicación con el gráfico de autenticaciones y la pestaña Accesses

En la pestaña Accesses, el botón Options de cada acceso ofrece:

  • Authentication factors: abre Authentication factors for grupo, con las políticas que exige el acceso.
  • Configure access: abre la ventana Edit access, con los pasos Select usernames, Select authentication policies y Review. Termina con Save changes. El grupo o usuario no se puede cambiar: para eso, borra el acceso y crea otro.
  • Configure attributes: solo en aplicaciones SAML cuya metadata pide atributos (Requested Attributes). Abre Attributes for grupo, donde das a esos atributos valores propios de este acceso. Si dejas un valor vacío, se usa el de la aplicación. Los cambios solo afectan a este acceso, no a la configuración SAML.
  • Delete access: borra el acceso después de pedir confirmación.

Menú Options de un acceso con Authentication factors, Configure access y Delete access

La pestaña Credentials de la página de la aplicación lista sus credenciales con las columnas Hint, Date y Manage. Hint es el prefijo de la credencial: sirve para reconocerla sin verla entera, y es el que muestra la columna Integration de la lista de aplicaciones al pasar el ratón (Credential hint:).

En las aplicaciones con API key, Add credential crea una API key nueva: confirma con Add en la ventana Add a new credential y copia o descarga la clave con Download credentials, porque no se vuelve a mostrar. Así puedes cambiar la API key de una integración sin cortar el servicio:

  1. Crea una credencial nueva con Add credential y guárdala.
  2. Configura la nueva API key en la integración (el plugin, el servidor RADIUS o tu código).
  3. Borra la credencial antigua con Delete, en la columna Manage.

En Applications, haz clic en Options > Edit application. La ventana Edit application tiene la pestaña General (nombre e icono) y, según el tipo, OIDC Settings (direcciones de redirección), Service Provider (SP) e Identity Provider (IdP) en SAML, o MFA Settings en las aplicaciones de un servidor NPS, donde el servidor y la directiva no se pueden cambiar. Guarda con Edit.

Ventana Edit application con la pestaña General

En Applications, haz clic en Options > Delete application, escribe el nombre de la aplicación para confirmar y haz clic en Delete.

Security > Credentials reúne en una lista todas las credenciales de la compañía: las API keys de las aplicaciones, las credenciales de las aplicaciones OIDC, las de los servidores NPS, las de las políticas de dispositivos RFID y la de la sincronización SCIM. Solo ves las de las aplicaciones y políticas sobre las que tienes permiso.

La lista tiene las columnas Application (el nombre de la aplicación, del servidor NPS o de la política, o SCIM), Hint (el prefijo de la credencial), Date y Manage. Busca por prefijo con Search by hint.

Para borrar una credencial, haz clic en Delete en su fila, escribe el prefijo que te pide la ventana Delete credential y confirma. Lo que use esa credencial deja de autenticarse, así que bórrala solo cuando ya no la use ninguna integración. Las credenciales OIDC y las de aplicaciones que ya no existen (Application not found) no tienen el botón Delete.

Roles y permisos (RBAC)

Controla qué grupos de administradores acceden a qué recursos de la consola y con qué operaciones, filtra por grupo y conoce los roles de usuario de Ironchip.

Ironchip incluye un sistema de control de acceso basado en roles (RBAC, Role-Based Access Control). Permite definir qué grupos de administradores tienen acceso a qué recursos de la consola y con qué operaciones, y garantiza el principio de mínimo privilegio dentro del propio equipo de IT. Esta página es para quien administra la consola.

Asignar permisos a grupos y subgrupos simplifica la administración, porque concedes o revocas acceso a muchas personas a la vez.

Descargar la documentación de políticas y seguridad (RBAC) en PDF (en español)

Cada permiso combina tres elementos:

  • Grupo: el grupo al que se aplica el permiso (por ejemplo, Ironchip Administrators, Presales, Mobility o Administration).
  • Recurso: la parte de la consola sobre la que se ejerce el permiso (por ejemplo, Users, Groups, Keys, Applications o Permissions). Algunos recursos se pueden limitar a un grupo: consulta Filtrar por grupo.
  • Operación: lo que se permite (Allow) o se deniega (Deny) sobre ese recurso: All, Read, Write, Update o Delete.

Cada grupo puede tener varios permisos sobre distintos recursos, lo que permite configurar perfiles de administración a medida. Los miembros de Ironchip Administrators tienen acceso completo a todos los recursos.

En Security > Permissions la consola muestra una tabla con las columnas Group, Resource, Operation y Manage para ver y gestionar todos los permisos configurados.

Sección Security > Permissions con la tabla de permisos

Operación Descripción
All Acceso completo al recurso: incluye todas las operaciones (Read, Write, Update y Delete). Equivale a permisos de superadministrador sobre ese recurso.
Read Solo lectura. El grupo puede consultar el recurso, pero no modificarlo ni eliminarlo.
Write Puede crear registros nuevos en el recurso. No puede modificar ni eliminar los existentes.
Update Puede modificar registros existentes. No puede crear nuevos ni eliminar.
Delete Puede eliminar registros del recurso. No puede crear ni modificar.

Estos son los recursos del desplegable Select resource type, en el orden en que aparecen:

Recurso Qué controla
All Todos los recursos a la vez. Equivale a administrador global.
Application Accesses Los accesos de las aplicaciones. Se puede filtrar por grupo.
Applications Las aplicaciones.
Authentication policies Las políticas de autenticación.
Billing El plan contratado y los datos de facturación.
Company Los datos de la compañía y su aspecto: Read para ver Look & feel y Update para cambiarlo.
Events Los registros de actividad.
Groups Los grupos de usuarios. Se puede filtrar por grupo.
Groups Auto-invite Las invitaciones de alta de los usuarios.
IP Allowlist Management La lista blanca de IP.
ITDR El ITDR: Read para el feed, los informes, la exportación y las reglas; Update para guardar las reglas.
Keys Las llaves de los usuarios: dispositivos y zonas seguras. Se puede filtrar por grupo.
Metrics Las métricas de Monitoring > Metrics.
Metrics Timeline La línea temporal de autenticaciones de Monitoring > Metrics.
Permissions El propio sistema de permisos.
RADIUS Servers Los servidores NPS (RADIUS).
Synchronization La sincronización de usuarios.
Users Los usuarios. Se puede filtrar por grupo.
Users Export La exportación de usuarios en CSV.

En Groups, Application Accesses, Keys y Users puedes elegir entre Do not filter y Filter by group. Con Filter by group eliges un grupo y el permiso se limita a ese grupo: según la consola, afecta a los recursos creados por el grupo o, si el recurso es Users, a sus miembros.

La columna Resource muestra el recurso con su filtro entre paréntesis: Users (All) es el recurso Users sin filtro y Keys (Mobility) es Keys filtrado por el grupo Mobility.

  1. Entra en la consola: https://app.ironchip.com.

  2. Ve a Security > Permissions.

  3. Haz clic en Add permission. Se abre la ventana Add a new permission.

  4. En Group selection, elige el grupo al que quieres asignar el permiso y haz clic en Next.

    Paso Group selection con la lista de grupos de la compañía

  5. En Resource selection, elige el recurso en Select resource type. Si el recurso lo permite, elige Do not filter o Filter by group y, en ese caso, el grupo. Haz clic en Next. Si no eliges ningún recurso, el permiso se aplica a todos.

    Paso Resource selection con el recurso Users y la opción Filter by group con un grupo elegido

  6. En Operation selection, marca para cada operación (Write, Read, Update, Delete o All) Allow para permitirla o Deny para denegarla. Haz clic en Next.

    Paso Operation selection con las operaciones Write, Read, Update, Delete y All

  7. En Permission review, revisa el resumen, marca I understand the new permission implications and want to continue. y haz clic en Add. El permiso queda activo de forma inmediata.

    Paso Permission review con el resumen del permiso nuevo

En Security > Permissions aparecen todos los permisos. Al seleccionar uno, el panel Permission details de la derecha lo resume en una frase. Para gestionarlo, usa el botón Options:

  • Edit permission: abre el mismo asistente con los datos del permiso. Termina con Edit. Si alguna operación no se puede cambiar, la ventana Permission edition indica cuál y por qué.
  • Delete permission: borra el permiso.

Esta tabla muestra los permisos de una configuración de ejemplo en Security > Permissions:

Grupo Recurso Operaciones
Ironchip Administrators All (All) All: acceso total a la consola
Administration Users (All) Read, Write, Update y Delete sobre todos los usuarios
Mobility Keys (Mobility) All sobre las llaves del grupo Mobility
Presales Applications (All) Read, Write y Delete
Presales Application Accesses (Presales) All sobre los accesos del grupo Presales
Presales Permissions (All) Read

Independientemente del RBAC de la consola, cada usuario de Ironchip tiene uno de estos tres roles:

Rol Descripción
Administrador Tiene acceso a la consola de administración. Puede gestionar usuarios, aplicaciones, accesos y configuración según los permisos de su grupo.
Usuario Usuario verificado y activo en Ironchip. No tiene acceso a la consola de administración: solo puede autenticarse en las aplicaciones a las que tiene acceso.
Invitado Usuario creado en la plataforma que aún no ha completado la verificación. En la columna Protection aparece con un triángulo ámbar (invitado, sin dispositivos) o con un escudo rojo tachado (sin invitación).

Para dar el rol de administrador, consulta Asignar un administrador.

Lista blanca de IP

Limita desde qué direcciones IP o rangos CIDR se puede usar la consola de administración de Ironchip y añade, edita o borra las entradas de la lista.

La lista blanca de IP (Security > IP allowlist) limita desde qué direcciones se puede usar la consola de administración de tu compañía. Esta página es para quien la administra: explica cómo funciona la lista y cómo añadir, editar y borrar sus entradas sin quedarte fuera.

  • Mientras la lista está vacía, no hay ninguna restricción: se puede entrar en la consola desde cualquier dirección.
  • En cuanto tiene una entrada, la consola solo admite conexiones desde las direcciones y rangos de la lista, y la API rechaza las peticiones con sesión iniciada que llegan desde cualquier otra.

Quien intenta entrar desde una dirección que no está en la lista ve la página Access Denied (Your IP address is not allowed, en la ruta /error_net), con la dirección desde la que se conecta y el botón Try again.

Cada entrada es una dirección IP (192.0.2.10) o un rango en notación CIDR (192.0.2.0/24).

  • Necesitas permiso sobre el recurso IP Allowlist Management: Read para ver la lista, Write para añadir, Update para editar y Delete para borrar. Consulta Roles y permisos.
  • Ten a mano las direcciones públicas desde las que se administra la consola: la de tu oficina, la de la VPN corporativa o la tuya.
  1. Ve a Security > IP allowlist y haz clic en Add IP.

    Página IP allowlist con las columnas IP Address, Description y Actions y el botón Add IP

  2. En la ventana Add a new IP address, escribe la dirección o el rango en IP Address, por ejemplo 192.0.2.10 o 192.0.2.0/24. Para usar la dirección pública desde la que te conectas, haz clic en Add current IP address.

  3. Si quieres, escribe en Description para qué es la entrada, por ejemplo Oficina central.

    Ventana Add a new IP address con los campos IP Address y Description y el botón Add current IP address

  4. Haz clic en Add.

  5. En la ventana Add IP address, escribe la dirección para confirmar y haz clic en Add. La consola confirma con IP Address Added.

En Security > IP allowlist, busca la entrada con Search by IP address or description y usa los botones de la columna Actions:

  • Edit IP: abre la ventana Edit IP address para cambiar la dirección o la descripción. Guarda con Edit.
  • Delete IP: abre la ventana Delete IP address. Escribe la dirección para confirmar y haz clic en Delete.

Si borras la última entrada, la lista queda vacía y la consola vuelve a admitir conexiones desde cualquier dirección.

Si la consola te muestra Access Denied, la dirección desde la que te conectas no está en la lista. Conéctate desde una dirección permitida, por ejemplo desde la oficina o la VPN corporativa, o pide a otro administrador que entre desde una de ellas y añada la tuya. Si nadie de la compañía puede entrar, escribe al soporte de Ironchip.

Multicuenta

Configura varios perfiles en la app autenticadora de Ironchip: envía la invitación, cierra la sesión actual y enrola una nueva identidad.

La app autenticadora de Ironchip admite varios perfiles (identidades) en el mismo dispositivo. Para añadir un perfil nuevo, un administrador envía antes una invitación a la cuenta que quieres añadir; el resto de pasos se hacen en la app.

  1. Envía la invitación desde la consola de administración: ve a Directory > Users, abre el menú Options del usuario cuya cuenta quieres añadir, haz clic en Add a device y confirma con Add. La opción aparece en los usuarios que ya están invitados. Para más información, consulta Dar de alta un dispositivo.

    Opción Add a device en el menú Options de un usuario de la consola

  2. Abre la aplicación del autenticador.

  3. Pulsa el menú de las tres líneas, en la esquina superior derecha, y selecciona Log out.

    Botón del menú de tres líneas en la app autenticadora

    Opción Log out del menú de la app

  4. Tras cerrar sesión, la app muestra el perfil que ya está configurado. En la parte inferior, pulsa Añadir un perfil para iniciar el enrolamiento con una nueva identidad.

    Pantalla Selecciona tu perfil con el botón Añadir un perfil

  5. Abre el correo electrónico donde recibiste la invitación, haz clic en Confirm my device y sigue los pasos indicados para completar el enrolamiento de la nueva identidad en el autenticador.

    Correo de invitación con el enlace para confirmar el nuevo dispositivo

Cómo añadir un segundo perfil al autenticador de IronchipReproducir el vídeo

Autoridad de certificación

Crea o importa una autoridad de certificación (CA) en Ironchip y emite certificados de servidor y de cliente para HTTPS, SSH, SSL y VPN IPsec.

Ironchip puede actuar como autoridad de certificación (CA) para emitir y gestionar certificados de servidor (HTTPS y SSH) y de cliente (HTTPS, SSL y VPN IPsec). Esta página explica cómo crear o importar la CA, emitir certificados y gestionar su ciclo de vida.

  • Acceso a la consola de Ironchip con rol de administrador.
  • Conocer el uso previsto de los certificados (HTTPS, SSH, SSL o VPN IPsec).
  • Para actuar como CA intermedia: el certificado y la clave privada de la CA superior, o un CSR firmado por ella.

El primer paso es crear la CA en la consola de Ironchip. Ironchip puede funcionar de dos formas:

  • CA final (raíz): Ironchip firma directamente los certificados. Es la opción más sencilla para entornos cerrados.
  • CA intermedia: Ironchip firma los certificados con una CA subordinada, cuya firma procede de la CA corporativa. Es la opción recomendada cuando ya existe una PKI.
  1. Ve a Certificates y haz clic en New CA.
  2. Selecciona el tipo de CA (Root CA o Intermediate CA) y completa estos campos:
    • Name: nombre identificativo de la CA.
    • Common Name: nombre que aparece en el campo CN del certificado de la CA.
    • Key algorithm: RSA 4096 o ECDSA P-384. Se recomienda ECDSA P-384 para nuevas implantaciones.
    • Validity: periodo de validez de la CA. En una CA intermedia, no puede superar el de la CA superior.
    • Path length: número máximo de CA subordinadas que pueden depender de esta CA. Si la CA solo emite certificados finales, indica 0.
  3. Si has seleccionado Intermediate CA, haz clic en Generate CSR, descarga el archivo y fírmalo con tu CA superior. Después, vuelve a esta pantalla y haz clic en Upload signed certificate para cargar el certificado firmado junto con la cadena completa.
  4. Haz clic en Create CA.

La clave privada se genera y se almacena cifrada en Ironchip, y no se puede exportar.

Si ya tienes una CA y quieres que Ironchip la use para emitir certificados:

  1. Ve a Certificates y haz clic en Import CA.
  2. Carga estos archivos:
    • El certificado de la CA en formato PEM.
    • La clave privada de la CA en formato PEM, con o sin contraseña.
    • La cadena de certificados hasta la raíz, si existe.

Antes de importar, comprueba que la clave privada corresponde al certificado. Ejecuta estos comandos y verifica que las dos huellas coinciden:

Ventana de terminal
openssl x509 -in ca.crt -noout -pubkey | openssl sha256
openssl pkey -in ca.key -pubout | openssl sha256

Emitir certificados de servidor (HTTPS y SSH)

Sección titulada «Emitir certificados de servidor (HTTPS y SSH)»

Para emitir un certificado de servidor, ve a Certificates, selecciona la CA y haz clic en New certificate. Elige el perfil que corresponda.

Genera un certificado con el uso de clave Server Authentication. Indica el Common Name y los Subject Alternative Names (DNS o IP) del servicio. Puedes pegar un CSR propio o dejar que Ironchip genere el par de claves.

Si prefieres generar la clave en el propio servidor, crea el CSR con este comando y pega su contenido en la consola:

Ventana de terminal
openssl req -new -newkey rsa:4096 -nodes -keyout servidor.key -out servidor.csr -subj "/CN=intranet.empresa.com" -addext "subjectAltName=DNS:intranet.empresa.com"

Genera un certificado de host SSH firmado por la CA, de modo que los clientes confíen en el servidor sin tener que aceptar su huella a mano. Pega la clave pública del servidor (por ejemplo, el contenido de /etc/ssh/ssh_host_ed25519_key.pub) e indica los hostnames válidos.

  1. Descarga el certificado emitido y cópialo en el servidor.

  2. Añade esta línea a /etc/ssh/sshd_config:

    /etc/ssh/sshd_config
    HostCertificate /etc/ssh/ssh_host_ed25519_key-cert.pub
  3. En los clientes, añade la CA como autoridad de confianza en ~/.ssh/known_hosts:

    ~/.ssh/known_hosts
    @cert-authority *.empresa.com <clave pública de la CA SSH>
  4. Reinicia el servicio SSH para aplicar los cambios:

    Ventana de terminal
    sudo systemctl restart sshd

Emitir certificados de cliente (HTTPS, SSL y VPN IPsec)

Sección titulada «Emitir certificados de cliente (HTTPS, SSL y VPN IPsec)»

Los certificados de cliente permiten autenticar el dispositivo o al usuario frente a un servicio. Ve a Certificates, selecciona la CA y haz clic en New certificate con uno de estos perfiles:

  • Client HTTPS/SSL: certificado con el uso de clave Client Authentication, para mTLS en aplicaciones web y servicios SSL.
  • VPN IPsec: certificado con los usos de clave Client Authentication e IPsec end system, para túneles IKEv2 con certificados.

Para cada certificado de cliente, indica:

  • Subject: usuario o dispositivo al que se asocia el certificado. Si seleccionas un usuario de Ironchip, el certificado queda vinculado a su identidad.
  • Validity: periodo de validez. Se recomienda un máximo de 12 meses para los certificados de dispositivo.
  • Export format: PEM o PKCS#12 (.p12). Con PKCS#12, define una contraseña de exportación.

Descarga el certificado e instálalo en el dispositivo. Este es un ejemplo de configuración de un cliente IKEv2 con strongSwan:

ipsec.conf
conn ironchip-vpn
keyexchange=ikev2
left=%any
leftcert=cliente.crt
leftid=%fromcert
right=vpn.empresa.com
rightid=@vpn.empresa.com
rightsubnet=0.0.0.0/0
auto=start

El servidor VPN debe tener instalado el certificado de la CA de Ironchip como autoridad de confianza, para validar los certificados de los clientes.

Gestionar el ciclo de vida de los certificados

Sección titulada «Gestionar el ciclo de vida de los certificados»

En Certificates puedes consultar todos los certificados emitidos, filtrarlos por CA, perfil, usuario o estado, y ejecutar estas acciones:

  • Renew: emite un nuevo certificado con los mismos datos y mantiene el anterior hasta que caduque.
  • Revoke: revoca el certificado e indica el motivo. La revocación se publica de inmediato en la CRL y en el servicio OCSP.
  • Download: descarga el certificado o la cadena completa.
  • Export audit log: descarga el historial de emisiones, renovaciones y revocaciones.

Para que los servicios consulten el estado de revocación, configura en ellos estas URL, sustituyendo <id-ca> por el identificador de tu CA:

CRL: https://pki.ironchip.com/crl/<id-ca>.crl
OCSP: https://pki.ironchip.com/ocsp/<id-ca>

En el apartado Alerts, define con cuántos días de antelación quieres recibir un aviso por correo de los certificados que están a punto de caducar.

Seguridad y auditoría

ITDR y registro de actividad

Sigue las amenazas de identidad con el ITDR: feed en tiempo real, análisis de amenazas, informe de cada evento, niveles de riesgo, filtros y bloqueo de usuario.

El ITDR (Identity Threat Detection and Response) de Ironchip analiza cada intento de autenticación de tu compañía, le da una puntuación de riesgo de 0 a 100 y guarda un informe con lo que ha detectado. Esta página explica a quien administra la consola cómo seguir esos informes, investigarlos y bloquear a un usuario. Qué cuenta como amenaza y qué hace el ITDR cuando la encuentra lo decides en Reglas del ITDR.

Descarga el manual en PDF: ITDR.

  • El ITDR tiene que estar activado en tu compañía. Si no lo está, al entrar en el ITDR la consola muestra la ventana ITDR is not enabled, con el botón Back to home, o el aviso ITDR Not Enabled, y te pide que contactes con tu company manager para activarlo.
  • Tu cuenta necesita permisos sobre el recurso ITDR (consulta Roles y permisos): Read para ver el feed, los informes y las reglas, y para exportar; Update para guardar cambios en las reglas. Sin ellos, la consola muestra Insufficient Permissions.
Entrada Qué muestra
Realtime feed Todos los informes del periodo elegido, a medida que se generan.
Threat analysis > Confirmed Solo los informes de nivel Fraud.
Threat analysis > Suspected Solo los informes de nivel High.
Ruleset (BETA) Las reglas que deciden el riesgo de cada intento. Consulta Reglas del ITDR.
  1. Ve a ITDR > Realtime feed. La página ITDR - Real-time feed muestra los informes del periodo elegido, 25 por página, con las columnas Risk level, Date, User Id, Blocked y Manage.

  2. Haz clic en una fila para seleccionarla. El panel Transaction details de la derecha resume el evento:

    • el identificador del usuario;
    • Location, con la ciudad (City), la región (Region) y el país (Country);
    • Device, con el modelo del dispositivo y si está rooteado (Rooted), emulado (Emulated) o depurado (Debugged);
    • Network analysis, con el país de la conexión y si pasa por VPN, TOR, Proxy o Hosting;
    • Report case(s), con los casos detectados, o No fraud cases detected si no hay ninguno.

    Realtime feed con un evento seleccionado y el panel Transaction details a la derecha

  3. Para abrir el informe completo, haz clic en la etiqueta de nivel de la columna Risk level o en Options > View report.

Encima de la tabla tienes Refresh table, que recarga la lista, y Export CSV, que pide la exportación de los informes filtrados (consulta Exportación de eventos del ITDR).

Threat analysis separa los informes que más atención necesitan:

  • Confirmed (página ITDR - Threat analysis confirmed): los de nivel Fraud, con una puntuación de 70 o más.
  • Suspected (página ITDR - Threat analysis suspected): los de nivel High, con una puntuación de 50 a 69.

Las dos páginas tienen las mismas columnas, el mismo panel Transaction details y el mismo menú Options que Realtime feed, y el botón Refresh table. Filtra por periodo y por Email: el nivel ya lo fija la página. Export CSV solo está en Realtime feed.

Si un evento indica que una cuenta está comprometida, bloquea al usuario desde Realtime feed o desde Threat analysis:

  1. En la fila del evento, haz clic en Options.

    Menú Options de un evento con las opciones View report y Block user

  2. Haz clic en Block user.

  3. Confirma con Block. El usuario pierde el acceso a todos los servicios hasta que lo desbloquees, y la columna Blocked lo indica.

Para desbloquearlo, abre Options en uno de sus eventos, haz clic en Unblock user y confirma con Unblock. También puedes desbloquearlo desde Directory > Users. Si el informe no tiene identificador de usuario, Options solo ofrece View report.

Una regla con la acción Lock the user bloquea al usuario de la misma forma, sin que intervengas. Consulta Reglas del ITDR.

El informe (página ITDR - Report detail) reúne todo lo que el ITDR sabe del evento. Back to reports te devuelve a Realtime feed.

Informe de un evento con los bloques Event briefing, Detected fraud info, Location details, Device details y Threat intelligence

El bloque Event briefing, con el identificador de la transacción, tiene tres partes:

  • Risk assessment: el nivel de riesgo, con un indicador de tres segmentos y una etiqueta por cada caso detectado.
  • Operation details: Transaction ID, Account ID, Event time y Device.
  • Event type: el tipo de operación y la explicación escrita de lo que se ha detectado. En las transacciones muestra también el concepto (Concept) y el importe (Amount).

Muestra el nivel de riesgo general (Overall) y el de cada fuente y categoría: Block list, Shared intel, Account takeover, New account fraud y Tampering.

  • Location sensors: las coordenadas (Current coordinates) y de dónde salen (Sensor source).
  • Network analysis: la IP (IP Address); si la conexión pasa por VPN, TOR, Proxy o Hosting; el país de origen y el actual de la SIM (SIM native, SIM current), y si había una llamada en curso (On call).
  • Location behavior: ciudad, región, estado y país.
  • Un mapa con la ubicación estimada (Predicted location) y las posiciones por IP o red, por GPS y por señales electromagnéticas.
  • Device integrity: si el dispositivo tiene root o jailbreak (Root/Jailbreak), un depurador (Debugged) o es un emulador (Emulator).
  • Device reputation: el modelo (Device), Device ID, el sistema operativo (OS) y el idioma (Language).
  • Detected malware: las aplicaciones maliciosas encontradas, o No malware detected.
  • Applied rules: las reglas del ITDR que se han cumplido, con su nombre, su número y su descripción, o No rules triggered.
  • Shared intelligence: el nivel y los avisos compartidos, o No reports.
  • Tampering details: el nivel y las manipulaciones detectadas, o No tampering entries.

En Realtime feed, en Threat analysis y en el informe, la consola calcula el nivel a partir de la puntuación con estos cortes fijos:

Nivel en tablas y filtros Nivel en el informe Puntuación Significado
Clear Clear Menos de 10 Sin riesgo.
Low Low risk De 10 a 49 Riesgo bajo.
High High risk De 50 a 69 Riesgo alto. Aparece en Threat analysis > Suspected.
Fraud Fraud 70 o más Fraude. Aparece en Threat analysis > Confirmed.
Unknown Unknown Sin puntuación El ITDR no tiene datos suficientes para evaluar el evento.

Estos cortes no dependen de los umbrales de ITDR > Ruleset > Settings.

El listado muestra por defecto los informes de las últimas 24 horas. Para cambiar el periodo:

  1. Haz clic en el selector de periodo, a la izquierda de los filtros (Last 24 hours).

  2. Elige un periodo en Presets, de Last 5 minutes a Last 90 days, o marca el inicio y el fin en el calendario y ajusta Start time y End time.

  3. Haz clic en Apply. Cancel cierra el selector sin cambios.

    Selector de periodo abierto con la lista Presets, el calendario y los campos Start time y End time

Para filtrar por usuario o por nivel:

  1. Haz clic en Select a search filter y elige Email o Risk level.

  2. Escribe el correo del usuario, o elige el nivel: Clear, Low, High o Fraud.

  3. El filtro aparece como una etiqueta en la barra. Para quitarlo, haz clic en la X de la etiqueta.

    Barra de filtros con el menú Select a search filter abierto y las opciones Email y Risk level

Puedes combinar el periodo y los dos filtros. Por ejemplo, para investigar a un usuario, filtra por su correo y elige Last 30 days.

Las acciones de los administradores en la consola y los eventos de autenticación de los usuarios quedan en Monitoring > Logs. Consulta Actividad y métricas.

Reglas del ITDR

Decide en el Ruleset del ITDR qué es una amenaza, cuánto riesgo suma, si deniega el acceso o bloquea al usuario y a quién avisa, y pruébalo antes de guardar.

En ITDR > Ruleset decides qué cuenta como amenaza para tu compañía, cuánto pesa y qué hace el ITDR cuando la encuentra. Esta página es para quien administra la consola: explica cómo funcionan las reglas, cómo añadirlas y editarlas, los ajustes del conjunto y cómo probarlo antes de guardarlo.

  • El ITDR tiene que estar activado en tu compañía. Con el plan Basic, la página muestra Your license doesn’t provide ITDR y el botón Go to billing.
  • Para ver las reglas necesitas el permiso Read sobre el recurso ITDR, y para guardar cambios, Update. Consulta Roles y permisos.

Cada regla tiene unas condiciones, un riesgo de 0 a 100 y, si quieres, una o dos acciones:

  • Deny the access: deniega el acceso que se está intentando en ese momento.
  • Lock the user: bloquea la cuenta del usuario, que pierde el acceso a todos los servicios hasta que un administrador lo desbloquee. Consulta Bloquear o desbloquear a un usuario.

En cada intento de autenticación, el ITDR comprueba todas las reglas activas:

  • Cada regla que se cumple queda escrita en el informe del intento (Applied rules), aunque su riesgo sea 0 y no tenga acciones. Las reglas de riesgo 0 sirven para dar contexto, por ejemplo que el dispositivo es conocido.
  • El intento toma el riesgo más alto de las reglas que se cumplen, nunca la suma. Ese riesgo decide el nivel: Clear, Low, High o Fraud.
  • Si alguna de las reglas que se cumplen pide Deny the access, se deniega el acceso. Si alguna pide Lock the user, se bloquea al usuario.

Las reglas son de toda la compañía (Company-wide): no se asignan a grupos ni a aplicaciones.

Ve a ITDR > Ruleset. La página ITDR - Ruleset tiene:

  • Arriba, el número de reglas activas (por ejemplo, 9 of 9 rules active), la etiqueta Company-wide y, si hay cambios sin guardar, Unsaved changes.
  • Los botones Settings (ajustes del conjunto), Test ruleset (probar), Discard (descartar los cambios) y Save changes (guardar). Discard y Save changes solo se activan cuando hay cambios.
  • La tabla de reglas, con el buscador Search rules, el botón Add detection y las columnas:
    • Status: activa o en pausa.
    • Rule: el nombre. Las reglas que aún no has guardado llevan la etiqueta new.
    • Detects: las condiciones, escritas como una frase.
    • Risk: el nivel y el riesgo de la regla, por ejemplo High 50.
    • Action: un icono si la regla deniega el acceso (Denies the access) o bloquea al usuario (Locks the user), o — si no hace ninguna de las dos cosas.
    • Manage: el menú Options, con Activate / pause, Duplicate y Delete rule.
  • A la derecha, el editor de la regla que selecciones.

Página ITDR - Ruleset con la tabla de reglas y una regla seleccionada en el editor de la derecha

Duplicate crea una copia en pausa con el nombre <nombre> (copy). Delete rule quita la regla al guardar; hasta entonces puedes recuperarla con Discard.

Una compañía que nunca ha configurado sus reglas empieza con este conjunto:

Regla Condición Riesgo Acción
Malware on the phone No known malware installed is false High 50 —
Tor network Tor exit node is true Fraud 100 Deny the access
IPs in different countries Both IPs in the same country is false High 50 Deny the access
VPN network VPN, proxy, relay or hosting is true Low 10 Deny the access
Tampered device Rooted or jailbroken is true Fraud 100 —
Known device First time on this device is false Clear 0 —
Habitual location The attempt uses the phone app is true y Transactions from this location is at least 10 Clear 0 —
On a phone call On a phone call is true High 50 —
Location tampering: gps spoofed GPS spoofed is true Fraud 100 Deny the access

Ninguna de estas reglas bloquea al usuario. El conjunto por defecto empieza también con los umbrales 10, 30 y 70, el aviso por correo activado solo para Fraud y dirigido al grupo Ironchip Administrators, y sin zona horaria (UTC). Puedes cambiar, pausar o borrar cualquiera de estas reglas.

La consola no tiene un botón para crear una regla en blanco: las reglas nuevas salen del catálogo de detecciones o de duplicar una regla. Para crear una regla a tu medida, añade la detección más parecida y cambia sus condiciones en el editor.

  1. Haz clic en Add detection. Se abre Add a detection.

  2. Busca en Search detections o filtra por grupo: All, Time, Network & IP, Device, Location & GPS, User history o SIM & carrier. Cada tarjeta muestra qué detecta, su riesgo (Risk 50) y si deniega el acceso (Risk 100 · denies the access).

  3. Si la tarjeta tiene un control deslizante, ajusta el valor, por ejemplo la distancia.

  4. Haz clic en Add. La consola confirma con Detection added y la regla aparece arriba de la tabla, activa y con la etiqueta new.

    Ventana Add a detection con los filtros por grupo y las tarjetas de detección

  5. Revisa la regla en el editor y haz clic en Save changes.

Estas son las detecciones del catálogo:

Detección Grupo Condición Riesgo Acción
Impossible travel Network & IP Distance between IPs is greater than 500 km (de 50 a 5000 km) 70 —
Phone far from the session Location & GPS Distance browser / phone is greater than 100 km (de 10 a 2000 km) 50 —
Shared phone Device Users on this device is greater than 1 (de 1 a 20) 30 —
New identities on one phone Device New users on this device recently is at least 2 (de 1 a 20) 70 —
Malware on the phone Device No known malware installed is false 100 Deny the access
SIM roaming abroad SIM & carrier SIM roaming is true 30 —
New SIM for this user SIM & carrier First time with this SIM is true 30 —
Outdated location Location & GPS GPS fix age is greater than 300 s (de 30 a 3600 s) 10 —
Imprecise location Location & GPS GPS accuracy is greater than 1000 m (de 100 a 10000 m) 10 —
First time from this place Location & GPS First time from this location is true 10 —
Far from the usual place Location & GPS Distance to the usual location is greater than 200 km (de 10 a 5000 km) 30 —
Many users at one place Location & GPS Users at this location is greater than 5 (de 1 a 100) 30 —
Connection from a datacenter Network & IP App IP is a hosting provider is true 50 —
New operator for this user Network & IP First time on this ISP is true 10 —
Brand new user User history New user is true 10 —

Para detectar accesos fuera del horario de la compañía, consulta Horario laboral y zona horaria.

Haz clic en una regla de la tabla para abrirla en el editor de la derecha:

  • El interruptor de estado (Active o Paused) y Delete.
  • Name: el nombre de la regla. Es obligatorio.
  • DETECTS WHEN: la frase que resume la regla y, debajo, sus condiciones (consulta Condiciones).
  • THEN, lo que pasa cuando se cumple:
    • Risk it adds: el riesgo, de 0 a 100 en pasos de 5. A 0, la regla aparece en el informe pero no sube la puntuación.
    • Deny the access: deniega el acceso en curso.
    • Lock the user: bloquea la cuenta del usuario hasta que alguien la revise y la desbloquee.
  • REPORT, cómo aparece en el informe:
    • Category: Tampering, Account takeover, Money laundering, New account fraud o Shared intelligence.
    • Label in the report: el nombre corto del caso en el informe, por ejemplo impossible travel. Si lo dejas vacío, se usa el nombre de la regla.
    • What the analyst reads: la explicación que aparece en el informe cuando la regla se cumple.

Mientras una regla está en pausa, solo puedes cambiar su estado, su nombre o borrarla. Los cambios no se aplican hasta que haces clic en Save changes (consulta Guardar los cambios).

Las condiciones de una regla se combinan con Match all of the following (se tienen que cumplir todas) o Match any of the following (basta con una). Las filas empiezan por when y después por and o por or, según lo que hayas elegido.

  1. En DETECTS WHEN, elige all o any.
  2. Haz clic en + Condition y elige el campo, el operador y el valor. La consola muestra la unidad del campo (km, s, m) y, en el icono de información, qué mide.
  3. Para mezclar las dos formas de combinar, haz clic en + Group. Un grupo nuevo empieza con la combinación contraria a la de su grupo padre: dentro de una regla all, un grupo any, y al revés. Puedes anidar hasta dos niveles de grupos.
  4. Para quitar una condición, haz clic en su X (Remove condition).

Editor de una regla con dos condiciones y un grupo anidado de tipo any

Por ejemplo, para detectar un dispositivo nuevo que se conecta por Tor o por una VPN:

  • Match all of the following
    • when First time on this device is true
    • and un grupo Match any of the following:
      • when Tor exit node is true
      • or VPN, proxy, relay or hosting is true

Un grupo sin condiciones muestra No conditions — this rule never matches.: una regla así no salta nunca.

Tipo de campo Operadores
Sí o no is true, is false
Número is greater than, is at least, is less than, is at most, is, is not
Texto (países, sistema operativo) is, is not
Working hours, Valid between is within

En los campos de texto, escribe el valor tal como lo recoge el ITDR: los países con su código ISO en mayúsculas (ES, FR) y el sistema operativo en minúsculas (android, ios).

El selector de campos los agrupa por tipo de señal.

Time

Campo Qué indica
Working hours Si el intento cae dentro de unos días y unas horas (consulta Horario laboral).
Day of the month El día del mes. Útil en fechas de nómina o de cierre de mes.
Valid between Si el intento cae dentro de una ventana de fechas (From y To). Necesita las dos fechas.
Day of the week El día de la semana como número: 1 es lunes y 7, domingo.
Time of day La hora del intento en minutos desde medianoche: 480 son las 08:00.
Moment of the attempt El momento del intento en segundos Unix.

Network & IP

Campo Qué indica
Tor exit node La IP del navegador o la del teléfono es de la red Tor.
VPN, proxy, relay or hosting Alguna de las dos IP es una VPN, un proxy, un relay o un proveedor de hosting.
Both IPs in the same country Las IP del navegador y del teléfono están en el mismo país.
Distance between IPs La distancia en km entre las ubicaciones de las dos IP. Vale -1 si alguna no se puede ubicar.
App IP is a VPN La IP del teléfono es una VPN.
Browser IP is a VPN La IP del navegador es una VPN.
App IP is a hosting provider La IP del teléfono es de un centro de datos y no de una red doméstica o móvil.
The phone connects through a proxy La IP del teléfono es un proxy.
App IP country El país de la IP del teléfono (código ISO).
Browser IP country El país de la IP del navegador (código ISO).
App IP operator (ASN name) El nombre del operador (sistema autónomo) de la IP del teléfono.
First time on this ISP El usuario nunca se había conectado con este operador.

Device

Campo Qué indica
Rooted or jailbroken El teléfono tiene root o jailbreak. El ITDR también lo marca si la app corre en un emulador o tiene un depurador.
Running on an emulator La app se ejecuta en un emulador y no en un teléfono real.
Debugger attached La app tiene un depurador conectado.
On a phone call El usuario está en una llamada mientras autoriza.
Operating system El sistema operativo del teléfono.
First time on this device El usuario no había usado este dispositivo antes.
Users on this device Cuántos usuarios distintos se han autenticado desde este dispositivo.
New users on this device recently Cuántas identidades se han visto por primera vez en este dispositivo en los últimos tiempos.
Transactions from this device Cuántos intentos ha hecho este usuario desde este dispositivo.
No known malware installed Ninguna app instalada coincide con la base de datos de malware.

Location & GPS

Campo Qué indica
GPS spoofed Alguno de los detectores de falsificación del GPS (el de wifi o el electromagnético) ha saltado.
GPS contradicted by wifi Solo el detector de wifi.
GPS contradicted by EM consensus Solo el detector electromagnético.
GPS fix age La antigüedad en segundos de la lectura GPS. Vale -1 si no se conoce.
GPS accuracy La precisión horizontal en metros que declara el teléfono. Exactamente 100 es un valor por defecto, no una medida.
Distance browser / phone La distancia en km entre el navegador y el teléfono que autoriza. Vale -1 si alguno no tiene ubicación.
Transactions from this location Cuántos intentos ha hecho el usuario desde este lugar.
First time from this location El usuario nunca había operado desde este lugar.
Distance to the usual location La distancia en km a donde el usuario suele operar.
Users at this location Cuántas identidades operan desde este lugar.
Location country El país de la ubicación (código ISO).
Anonymised connection La ubicación solo se ha podido resolver a través de una conexión anonimizada.

User history

Campo Qué indica
New user Es el primer intento de esta identidad.
Transactions by this user Cuántos intentos ha hecho la identidad.
The attempt uses the phone app El intento se hace con la app del teléfono.
The attempt uses a browser El intento se hace desde un navegador.

SIM & carrier

Campo Qué indica
SIM roaming La SIM está fuera de su país.
SIM home country El país al que pertenece la SIM (código ISO).
SIM current country El país en el que está conectada la SIM (código ISO).
First time with this SIM El usuario nunca se había autenticado con esta SIM.

Las condiciones de tiempo (Working hours, Day of the month, Day of the week y Time of day) se calculan en la zona horaria de la compañía, que eliges en Settings > Company time zone. Si no la eliges, se usa UTC y una regla de horario saltará a horas equivocadas.

Una condición Working hours lleva los días (de Mon a Sun) y una hora de inicio y otra de fin; al añadirla, la consola propone de lunes a viernes, de 08:00 a 20:00. Ten en cuenta que:

  • La hora de inicio cuenta y la de fin no: de 08:00 a 20:00 cubre hasta las 19:59.
  • Tienes que marcar al menos un día.
  • Un horario que cruza la medianoche, por ejemplo de 22:00 a 06:00, no se cumple nunca. Para un turno de noche, usa dos condiciones bajo Match any of the following: una de 22:00 a 23:59 y otra de 00:00 a 06:00.

Para detectar accesos fuera de un horario de lunes a viernes de 08:00 a 20:00, crea una regla con Match any of the following y tres condiciones Working hours is within:

  • de Mon a Fri, de 00:00 a 08:00;
  • de Mon a Fri, de 20:00 a 23:59;
  • Sat y Sun, de 00:00 a 23:59.

Como la hora de fin no cuenta, el minuto de las 23:59 queda fuera de estas condiciones.

Haz clic en Settings para abrir Ruleset settings. Los cambios de esta ventana pasan al borrador, como los de las reglas: guárdalos con Save changes.

Ventana Ruleset settings con Risk thresholds, Enforcement, Company time zone y Notifications

Risk thresholds reparte la escala de 0 a 100 entre los cuatro niveles con tres marcadores, en pasos de 5. La leyenda indica dónde empieza cada nivel (Clear below 10, Low from 10, High from 30, Fraud from 70 con los valores por defecto). Si guardas los tres a 0, se restauran los valores por defecto: 10, 30 y 70.

Las vistas Realtime feed, Threat analysis y el informe usan sus propios cortes fijos para mostrar el nivel. Consulta Niveles de riesgo.

Son los interruptores generales de las acciones:

  • Block authorization: activa las reglas que piden Deny the access. Debajo, la consola indica cuántas hay (Rules asking to deny the access: N).
  • Block user: activa las reglas que piden Lock the user (Rules asking to lock the account: N).

Mientras un interruptor está apagado, las reglas que piden esa acción no la aplican, aunque siguen sumando riesgo y apareciendo en el informe. El editor de cada regla lo avisa con Blocking is turned off for the whole ruleset. o Locking is turned off for the whole ruleset.

La zona horaria en la que se leen las condiciones de tiempo. Elígela de la lista, por ejemplo Europe/Madrid. Si la dejas vacía, la consola avisa de que las horas se leen en UTC. Es el único ajuste de zona horaria de la compañía en la consola: el resto de fechas de la consola se muestran en la zona horaria de tu navegador.

Decide quién recibe un correo cuando el ITDR marca un intento:

  • Email a security contact: activa o desactiva el aviso. Viene activado.
  • Send it for: desde qué nivel se avisa: Only fraud (por defecto), High risk and above, Low risk and above o Anything, even when nothing is flagged, que envía un correo por cada intento evaluado.
  • Groups: busca y añade grupos de la compañía.
  • People: busca y añade usuarios por su correo.
  • Other addresses: buzones que no son usuarios de la plataforma, como seguridad@example.com. Escribe la dirección y pulsa Intro; lo que no es una dirección válida se descarta.

Si no eliges a nadie, el aviso va al grupo Ironchip Administrators. A cada usuario de los grupos y personas elegidos le llega a su correo y, si lo tiene, a su correo externo, sin duplicados. El correo se envía en el idioma de la compañía.

Antes de guardar, comprueba qué veredicto da tu conjunto de reglas a un intento concreto:

  1. Haz clic en Test ruleset. Se abre Test your ruleset.

  2. En Transaction, describe el intento. La ventana muestra un campo por cada dato que leen las reglas activas: un interruptor, un número, un texto, un día y una hora, o una fecha.

  3. Revisa el resultado:

    • la puntuación sobre 100 y el nivel;
    • Authorization blocked o Authorization allowed, y User blocked si se bloquearía al usuario;
    • Matching rules: las reglas que se cumplen, con su riesgo o clear, y block si piden bloquear;
    • Report cases: los casos que irían al informe.

    Ventana Test your ruleset con un intento descrito y las reglas que se cumplen

  4. Para volver a los valores iniciales, haz clic en Reset.

Si ninguna regla se cumple, la ventana muestra Nothing matches — the transaction goes through unflagged. La prueba usa el borrador, con los cambios sin guardar, y no crea informes ni afecta a ningún usuario.

Todo lo que cambias en la página (reglas y ajustes) es un borrador hasta que haces clic en Save changes. Mientras tanto, la página muestra Unsaved changes. Si cambias de página dentro de la consola, el borrador sigue ahí al volver.

  • Save changes guarda el conjunto completo y muestra Ruleset updated. El motor de detección aplica los cambios en menos de un minuto y solo a los intentos nuevos: no hay que desplegar nada y los intentos en curso no se vuelven a evaluar.
  • Discard descarta el borrador después de confirmar en Discard changes.
  • Si otro administrador ha guardado mientras editabas, la consola muestra Someone else changed the ruleset. Haz clic en Reload para cargar sus reglas y vuelve a aplicar tus cambios.
  • Si alguna regla no es válida, la consola muestra el motivo y no guarda nada, ni siquiera las reglas correctas.
  • Hasta 200 reglas por compañía.
  • Cada regla necesita un nombre, un riesgo de 0 a 100 y al menos una condición.
  • Una regla no puede desplegarse en más de 64 combinaciones de condiciones (cada grupo any dentro de un grupo all multiplica las combinaciones). Si la regla no se guarda por eso, divídela en dos.
  • Working hours necesita al menos un día, y Working hours y Valid between necesitan las dos horas o fechas.
  • La zona horaria tiene que ser un nombre válido, como Europe/Madrid.
  • En Notifications, hasta 100 grupos, 100 personas y 100 direcciones.

Exportación de eventos del ITDR

Filtra los informes del ITDR por periodo, usuario y nivel de riesgo y pide su exportación: la consola te envía por correo un archivo con los informes filtrados.

Desde ITDR > Realtime feed puedes exportar los informes del ITDR que cumplen tus filtros: la consola prepara un archivo y te lo envía por correo. Esta página es para quien administra la consola.

  • Necesitas el permiso Read sobre el recurso ITDR. Consulta Roles y permisos.
  • La exportación solo está en Realtime feed: Threat analysis > Confirmed y Threat analysis > Suspected no tienen Export CSV.
  • El archivo llega solo al correo de la cuenta con la que pides la exportación.

La exportación incluye los informes que muestran los filtros del feed. Puedes combinarlos, por ejemplo para exportar los informes de nivel High de un usuario en los últimos 7 días.

Por defecto, el feed muestra las últimas 24 horas (Last 24 hours). Para cambiarlo, haz clic en el selector de periodo, elige un periodo en Presets o marca el inicio y el fin en el calendario con Start time y End time, y haz clic en Apply.

Selector de periodo abierto con la lista Presets, el calendario y los campos Start time y End time

Haz clic en Select a search filter y elige:

  • Email: los informes de un usuario. Escribe su correo.
  • Risk level: los informes de un nivel: Clear, Low, High o Fraud.

Cada filtro aparece como una etiqueta en la barra. Para quitarlo, haz clic en la X de la etiqueta.

Barra de filtros con el menú Select a search filter abierto y las opciones Email y Risk level

  1. Ve a ITDR > Realtime feed y aplica los filtros que necesites.

  2. Haz clic en Export CSV, encima de la tabla.

  3. En la ventana Export ITDR reports, revisa los filtros de la exportación: Since, Until, Email y Risk level. Debajo, la ventana indica el correo al que llegará el archivo.

    Ventana Export ITDR reports con los filtros Since, Until, Email y Risk level

  4. Haz clic en Export CSV. La consola confirma la solicitud con ITDR export requested. Para cerrar sin exportar, haz clic en Close.

  5. Cuando el archivo está listo, la campana de notificaciones de la consola muestra ITDR report export completed y recibes un correo con el archivo adjunto.

    Correo de Ironchip con los filtros de la exportación y el archivo de informes adjunto

La solicitud y el final de cada exportación quedan en Monitoring > Logs (consulta Actividad y métricas).

  • La consola muestra Error exporting ITDR reports. Si acabas de pedir otras exportaciones, puede que hayas llegado al límite de solicitudes seguidas. Espera un momento y vuelve a pedirla.
  • No encuentro Export CSV. Comprueba que estás en Realtime feed y no en Threat analysis.

Integración con un SIEM

Recibe los eventos de Ironchip en tu SIEM: Ironchip los envía por HTTPS en JSON y rsyslog los recibe y los reenvía por syslog a QRadar, Splunk, Sentinel u otro.

Esta página explica cómo llevar los eventos de tu compañía en Ironchip a tu SIEM: cómo los envía Ironchip y cómo recibirlos con rsyslog para reenviarlos por syslog. Es para quien administra la plataforma y el SIEM.

  1. Ironchip envía cada evento de tu compañía como un objeto JSON en una petición POST por HTTPS a una dirección tuya.
  2. En tu red, un rsyslog recibe esas peticiones con su módulo de entrada HTTP (imhttp).
  3. rsyslog reenvía cada evento por syslog a tu SIEM, que lo trata como cualquier otra fuente.

Si tu SIEM tiene su propio colector HTTP, puede recibir los eventos directamente, sin rsyslog.

La integración está disponible en las capas Enterprise y Premium. En Premium, además de los eventos de autenticación, el SIEM recibe las alertas del ITDR. Consulta Enterprise y Premium.

La activa el equipo de Ironchip para tu compañía. Pídela en Monitoring > SIEM integration o a tu contacto de Ironchip, con estos datos:

Dato Ejemplo Para qué
Dirección de recepción https://siem-relay.example.com:8443/ironchip Dónde envía Ironchip los eventos. Tiene que ser accesible desde internet.
Cabeceras Authorization: ApiKey <TOKEN> Con qué se identifica Ironchip ante tu receptor.
Eventos Autenticaciones y alertas del ITDR Qué eventos quieres recibir.

Usa un certificado TLS válido en la dirección de recepción y un token largo y aleatorio solo para esta integración.

Esta configuración de referencia recibe los eventos por HTTPS, comprueba el token y los reenvía por syslog a tu SIEM. Se ha probado con rsyslog 8.2610 (la imagen oficial rsyslog/rsyslog) detrás de nginx. Adáptala a tu entorno.

  • rsyslog necesita el módulo de entrada HTTP imhttp. Escucha solo en local, sin TLS.
  • Un proxy inverso (nginx en el ejemplo, o el balanceador que ya uses) termina HTTPS con tu certificado y pasa las peticiones a rsyslog.
  1. Guarda el token que acordaste con Ironchip en /etc/rsyslog/imhttp-apikeys, con permisos 600.

  2. Crea /etc/rsyslog.d/ironchip.conf:

    /etc/rsyslog.d/ironchip.conf
    # Recepción HTTP solo en local: el proxy inverso termina HTTPS delante
    module(load="imhttp" ports="127.0.0.1:8080")
    input(type="imhttp" endpoint="/ironchip" name="ironchip"
    ruleset="ironchip" apiKeyFile="/etc/rsyslog/imhttp-apikeys")
    # Syslog RFC 5424 con "ironchip" como aplicación; el mensaje es el JSON del evento
    template(name="IronchipRFC5424" type="string"
    string="<%PRI%>1 %TIMESTAMP:::date-rfc3339% %$myhostname% ironchip - - - %msg%\n")
    ruleset(name="ironchip") {
    action(type="omfwd" target="siem.example.com" port="514" protocol="tcp"
    template="IronchipRFC5424")
    }
  3. Publica la dirección por HTTPS en el proxy inverso. Con nginx:

    /etc/nginx/conf.d/ironchip-siem.conf
    server {
    listen 8443 ssl;
    server_name siem-relay.example.com;
    ssl_certificate /etc/nginx/tls/siem-relay.crt;
    ssl_certificate_key /etc/nginx/tls/siem-relay.key;
    location = /ironchip {
    proxy_pass http://127.0.0.1:8080;
    }
    }
  4. Reinicia los dos servicios:

    Ventana de terminal
    sudo systemctl restart rsyslog nginx
  5. Comprueba que recibe y reenvía, con un evento de prueba:

    Ventana de terminal
    curl -H 'Authorization: ApiKey <TOKEN>' \
    -d '{"type":"test","message":"prueba de Ironchip"}' \
    https://siem-relay.example.com:8443/ironchip

    La respuesta es 200 y a tu SIEM llega una línea como esta:

    <13>1 2026-10-29T17:56:04.134194+00:00 siem-relay ironchip - - - {"type":"test","message":"prueba de Ironchip"}

imhttp separa los mensajes por saltos de línea, y cada evento de Ironchip llega en una sola línea de JSON, así que cada evento es un mensaje. Sin el token correcto, rsyslog responde 401 y no reenvía nada.

  • Crea una fuente de syslog para el rsyslog receptor e identifica los eventos de Ironchip por la aplicación ironchip.
  • El contenido es JSON: usa el analizador JSON de tu SIEM para extraer sus campos (tipo de evento, usuario, aplicación, resultado, dirección IP…).
  • Algunos SIEM, como IBM QRadar, identifican la fuente por la dirección desde la que llega el syslog, no por su cabecera: en ese caso, todos los eventos de Ironchip llegan desde el rsyslog receptor.
Síntoma Qué hacer
La prueba con curl devuelve 401 El token de la cabecera no coincide con el de imhttp-apikeys.
La prueba con curl devuelve 502 rsyslog no escucha en 127.0.0.1:8080: revisa que cargue imhttp (journalctl -u rsyslog).
La prueba funciona pero no llega nada de Ironchip Comprueba que la dirección es accesible desde internet y que su certificado es válido.
Los eventos llegan pero el SIEM no los separa en campos Activa el análisis JSON del mensaje en la fuente de Ironchip.

Actividad y métricas

Revisa en la consola los registros de actividad, las métricas de autenticación de la compañía, de cada usuario y de cada aplicación, y tu plan y facturación.

La consola reúne en el grupo Monitoring los registros de actividad (Logs) y las métricas de autenticación (Metrics); el plan y los datos de facturación están en Account settings > Billing. Esta página es para quien administra la consola. Monitoring incluye también SIEM integration, que se explica en Integración con un SIEM.

En los registros de actividad ves quién ha hecho qué en la compañía:

  • los cambios de configuración que hacen los administradores: aplicaciones, accesos, usuarios, grupos, políticas de autenticación, permisos, restricciones de IP y datos de facturación;
  • las autenticaciones de los usuarios: solicitudes enviadas, factores aportados y autorizaciones completadas o canceladas, y las sesiones que abren y cierran;
  • los bloqueos y desbloqueos de usuarios;
  • las sincronizaciones y las exportaciones de usuarios, de llaves y de informes del ITDR.

Para consultarlos:

  1. Ve a Monitoring > Logs. La página Monitoring lista los eventos con las columnas Event type, Date y Description. Al bajar por la lista se cargan más eventos.
  2. Haz clic en un evento. El panel Log details de la derecha muestra el tipo de evento, el usuario que lo hizo, hace cuánto ocurrió y la descripción.
  3. Para ver los eventos nuevos, haz clic en Refresh table.

Página Monitoring con la lista de eventos y el panel Log details del evento seleccionado

La lista no tiene buscador, filtros ni exportación. Para seguir las amenazas detectadas en cada intento, usa el ITDR.

Ve a Monitoring > Metrics. La página tiene tres bloques:

  • Overview: cuántas aplicaciones (Apps:), usuarios protegidos (Users protected:), dispositivos (Devices:) y zonas seguras (Safezones:) tiene la compañía.
  • Authentications: las autenticaciones del mes que elijas en Time period. Un gráfico circular compara las correctas (Correct) y las incorrectas (Wrong), y un gráfico de líneas las muestra día a día (Correct auths, Wrong auths).
  • Timeline: las autenticaciones a medida que se producen. De cada una ves:
    • la aplicación y su identificador (UID), que puedes copiar con el icono de al lado;
    • el usuario;
    • las llaves que aportó (Keys provided:): el dispositivo, la zona segura o el correo. Si el usuario estaba fuera de la zona segura, la línea indica que la zona no es válida;
    • el resultado: Correct authentication, Wrong authentication o Pending authentication.

Página Metrics con Overview, el gráfico de autenticaciones del mes y el Timeline

  1. Ve a Directory > Users y haz clic en un usuario. El panel de la derecha muestra sus llaves (Keys), aplicaciones (Apps) y dispositivos (Devices), sus dispositivos por plataforma (Devices by platform) y su historial de autenticaciones (Authentication history).
  2. Para ver más detalle, abre la página del usuario. Arriba están los mismos contadores Keys, Apps y Devices, y el gráfico <nombre>’s Authorizations con las autenticaciones completadas (Completed authentications) e incompletas (Incomplete authentications) del mes que elijas en Time period.

Debajo, las pestañas Keys, Groups, Accesses, Invitations y Details muestran sus llaves, grupos, accesos, invitaciones y atributos. Consulta Usuarios y grupos.

  1. Ve a Applications y haz clic en una aplicación. El panel de la derecha muestra Application information, con el número de accesos (Access number:), y su historial de autenticaciones (Authentication history).
  2. Para ver más detalle, abre la aplicación. La página Application Details muestra el gráfico Authentications in <nombre> del mes que elijas en Time period, y las pestañas Accesses y Credentials (las aplicaciones SAML no tienen Credentials).

Consulta Aplicaciones.

Tu plan limita, entre otras cosas, cuántos usuarios y cuántas zonas seguras públicas puedes usar. En Account settings > Billing consultas el plan contratado:

  • Plan details: el plan actual (Current plan) y su fecha de caducidad, el intervalo de facturación (Billing interval), el correo de facturación (Billing email), la dirección (Billing Address) y el número de IVA (VAT/GST number). Desde aquí tienes los botones Change plan y Update billing details.
  • Next payment: el próximo pago previsto.
  • Resource usage: los usuarios activos (Active users) y las zonas públicas (Public zones) en uso frente a las contratadas, con el porcentaje consumido.
  • Invoices: las facturas disponibles.

Página Billing con el plan actual, los datos de facturación y el uso de usuarios y zonas públicas

  1. En Account settings > Billing, haz clic en Update billing details.
  2. En Edit billing details, cambia Billing interval, Billing email, Billing address o VAT/GST number.
  3. Haz clic en Edit.

El cambio queda en Monitoring > Logs.

El cambio de plan no es automático: lo gestiona el equipo comercial de Ironchip.

  1. En Account settings > Billing, haz clic en Change plan. Se abre el formulario Contact our sales team.
  2. Escribe tu correo de contacto (Email) y, si quieres, tu teléfono (Phone number).
  3. En Choose your plan, elige Premium o Enterprise.
  4. Indica cuántos usuarios quieres proteger (Estimated number of users you wish to protect), cómo prefieres que te contacten (Phone o eMail) y el número de empleados.
  5. Haz clic en Upgrade my plan.

Formulario Contact our sales team con el correo, el teléfono, el plan que quieres y el número de usuarios

Si la licencia de la compañía caduca, la consola desactiva todas las entradas del menú salvo Account settings > Billing y el enlace externo Phishing Shield, y si abres otra página por su dirección te lleva a Billing. Look & feel también queda bloqueada. Para recuperar el acceso, renueva la licencia con el equipo comercial de Ironchip.

Aspecto (Look & feel)

Pon los logotipos y colores de tu compañía en las páginas web de Ironchip y en la app móvil desde Look & feel, en Account settings, con vista previa.

En Account settings > Look & feel pones los logotipos y los colores de tu compañía en lo que ven tus usuarios: las páginas web de Ironchip en las que se autentican y la app móvil. Esta página es para quien administra la consola.

  • Necesitas permiso sobre el recurso Company: Read para ver la página y Update para guardar los cambios. Sin él, la consola muestra Unable to access look and feel page. Consulta Roles y permisos.
  • Prepara los logotipos en .png, .jpg, .jpeg o .svg, de 1 MB como máximo cada uno.

La página tiene dos pestañas, que se guardan por separado:

Pestaña Dónde se ve Logotipos (Assets) Colores (Colors)
Web Las páginas web de Ironchip en las que se autentican tus usuarios, como Sign in with Ironchip y Verify it’s you. Header logo y Main logo Primary color, Secondary color y Background color
Mobile La app móvil de Ironchip, por ejemplo la solicitud de autorización (Authorization required). Logo Primary color y Secondary color
  1. Ve a Account settings > Look & feel y elige la pestaña Web o Mobile.

    Página Look & feel, pestaña Web, con los logotipos, los colores y la vista previa

  2. En Assets, para cada logotipo elige File y sube la imagen, o URL y escribe su dirección. Si la imagen no carga desde su dirección, normalmente porque la web que la aloja no permite usarla desde otros sitios, descárgala y súbela como archivo.

  3. En Colors, elige cada color.

  4. Comprueba el resultado en la vista previa (Preview), que cambia a medida que editas.

  5. Haz clic en Save. La consola confirma con Skin updated successfully.

Los usuarios ven el aspecto nuevo cuando cierran y vuelven a abrir la aplicación. Si quieres descartar los cambios que aún no has guardado, haz clic en Reset: la pestaña vuelve a lo último que guardaste.

Para publicar una app con el nombre y la apariencia de tu empresa en las tiendas o por MDM, consulta App a medida.

Guía de usuario

Guía de usuario

Qué es Ironchip Location Identity Platform para el usuario final, cómo es la aplicación de autenticación y qué es una zona segura.

Esta guía explica cómo usar Ironchip en el día a día: instalar la aplicación de autenticación, darte de alta, autenticarte en tus servicios y resolver los problemas más habituales.

Nuestro producto, Location Identity Platform

Sección titulada «Nuestro producto, Location Identity Platform»

Location Identity Platform tiene como objetivo proporcionar a las compañías el máximo nivel de seguridad y garantizar el control de todos los accesos corporativos. La plataforma se integra con más de 5.000 servicios o aplicaciones y puede monitorizar todos los accesos y configurar reglas o factores de identidad según las políticas de seguridad. Así determina la identidad de los usuarios y autoriza el acceso a las distintas aplicaciones de la corporación.

La solución de identidad de Ironchip se compone de varios elementos que permiten autenticarse en los servicios de diferentes modos y con distintos sistemas.

Una plataforma de autenticación es cualquier sistema que se utiliza para identificar al usuario o empleado de la compañía y verificar su identidad. Por ejemplo, puede ser una aplicación móvil, un USB o una aplicación de escritorio que permite comprobar los factores de identidad necesarios para conceder el acceso.

La aplicación de autenticación de Ironchip es tu método de autenticación para entrar en los distintos servicios de tu compañía. Tiene tres pestañas principales:

  • Pestaña principal: muestra los servicios de tu compañía a los que tienes acceso.

    Pestaña principal de la aplicación, con la lista de servicios a los que tiene acceso el usuario

  • Pestaña de OTP: sirve para configurar tus servicios de autenticación OTP. Si ya tienes servicios OTP configurados, también aparecen aquí. Usa el botón + para añadir uno nuevo.

    Pestaña de OTP de la aplicación, con un servicio OTP configurado y el botón +

  • Pestaña de zonas seguras: muestra las zonas habituales desde las que sueles acceder a los servicios, además de las que hayas creado de forma manual.

    Pestaña de zonas seguras de la aplicación, con las zonas habituales y las creadas manualmente

Una zona segura es una zona desde la que el usuario suele operar. Una operación fraudulenta tiende a realizarse desde un lugar alejado de las zonas seguras.

Además, una zona segura es una localización geográfica única e insuplantable. Un administrador puede obligar a que los usuarios solo se autentiquen desde la zona segura que haya establecido.

El concepto de zona segura se complementa con el sistema de reconocimiento de dispositivos de Ironchip. Para más detalle, consulta Zonas seguras.

Alta en la aplicación

Descarga el autenticador de Ironchip y da de alta tu dispositivo por móvil, escritorio o USB para usar los servicios de tu compañía con Ironchip.

Esta guía explica cómo descargar la aplicación de autenticación y cómo dar de alta tu dispositivo en Ironchip, para que puedas usar los servicios de tu compañía que utilicen Ironchip como método de autenticación.

La descarga de la aplicación de autenticación depende de la plataforma en la que quieras instalarla.

  1. Abre la aplicación Play Store, que reconocerás por este icono.

    Icono de la aplicación Play Store en el móvil

  2. En la barra de búsqueda superior, escribe Ironchip.

    Barra de búsqueda de Play Store con el texto Ironchip

  3. Pulsa la lupa de la esquina inferior izquierda para buscar. Selecciona la aplicación Ironchip Authenticator y pulsa Instalar.

    Ficha de Ironchip Authenticator en Play Store con el botón Instalar

  4. Espera a que termine la descarga y la instalación.

    Progreso de la descarga e instalación de la aplicación

  5. Cuando termine, el botón Instalar habrá cambiado a Abrir y la aplicación estará entre las que ya tienes instaladas.

    Ficha de la aplicación con el botón Abrir una vez instalada

    Aplicación de Ironchip entre las aplicaciones instaladas del móvil

  1. Abre la aplicación App Store, que reconocerás por este icono. Pulsa la lupa de la esquina inferior izquierda para buscar, selecciona Ironchip Authenticator y pulsa Instalar.

    Ficha de Ironchip Authenticator en la App Store con el botón Instalar

  2. Cuando termine la instalación, el botón Instalar habrá cambiado a Abrir y la aplicación estará entre las que ya tienes instaladas.

    Ficha de la aplicación con el botón Abrir una vez instalada

    Aplicación de Ironchip entre las aplicaciones instaladas del iPhone

Comprobar la versión de la aplicación móvil

Sección titulada «Comprobar la versión de la aplicación móvil»
  1. Abre la aplicación Ironchip Authenticator.

  2. En la parte superior derecha, pulsa el icono de los tres puntos. Se despliega un panel con tres opciones: Account information, App Information y OTP.

  3. Pulsa App Information. Aparece un mensaje con la versión instalada en tu dispositivo.

    Mensaje de App Information con la versión de la aplicación instalada

El instalador de la aplicación de escritorio para Windows te lo tiene que facilitar un administrador técnico de tu compañía. Cuando lo tengas, ejecútalo con doble clic en su icono.

Icono del instalador de la aplicación de escritorio de Ironchip

  1. Lee la licencia de Ironchip, marca I accept the terms in the License Agreement y pulsa Next.

    Pantalla de licencia del instalador con la casilla de aceptación de los términos

  2. Selecciona Ironchip Windows Logon y elige Entire feature will be unavailable para no instalar el producto Windows Logon.

    Selección de características del instalador con Ironchip Windows Logon desactivado

  3. Pulsa Next. En la pantalla siguiente, mantén el valor por defecto https://api.ironchip.com.

    Pantalla del instalador con la dirección del servidor https://api.ironchip.com

  4. Pulsa Next. En la pantalla siguiente, introduce la API key que te ha facilitado tu administrador. Si no la tienes, pídesela.

    Pantalla Ironchip logon API Key del instalador con el campo Ironchip API Key

  5. Pulsa Next y, en la pantalla siguiente, Install.

Pulsa Finish para cerrar el instalador.

Pantalla final del asistente de instalación con el botón Finish

Hay cuatro formas de dar de alta tu dispositivo. Elige la que corresponda al método que usa tu compañía.

Antes de empezar, un administrador tiene que haberte dado de alta en la plataforma desde la consola de administración. En ese momento recibes un correo electrónico de verificación en tu correo de empresa. Si no lo has recibido, contacta con el administrador de tu compañía.

  1. Abre el correo que has recibido desde un PC o portátil y pulsa Verificar mi correo.

    Correo de verificación con el botón Verificar mi correo

  2. Se abre una pestaña nueva que te pide descargar la aplicación de Ironchip. No la cierres.

    Pestaña que pide descargar la aplicación de Ironchip

  3. En tu teléfono, descarga Ironchip Authenticator desde Google Play Store o App Store, como se explica en Descargar la aplicación.

    Aplicación Ironchip Authenticator en la tienda de aplicaciones

  4. Abre la aplicación. Te pide una serie de permisos:

    • Cámara, para escanear el código QR.
    • Ubicación, para recopilar datos de las redes wifi cercanas.
    • Llamadas telefónicas, para recopilar datos sobre las redes móviles cercanas.

    Pantalla de permisos de la aplicación

  5. Si tienes un dispositivo Xiaomi, la aplicación te pide dos permisos más: mostrar en la pantalla de bloqueo y abrir ventanas en segundo plano, para recibir correctamente las notificaciones de la app.

    Permisos adicionales que solicita la aplicación en dispositivos Xiaomi

  6. Acepta los términos y condiciones. Al pulsar Continue, la aplicación te pide escanear un QR.

    Pantalla de la aplicación que pide escanear el QR, con la casilla de los términos y condiciones y el botón Continue

  7. Obtén ese QR pulsando Continuar en la pestaña donde se te pidió descargar la aplicación y escanéalo con la aplicación.

    Pestaña Comencemos con el botón Continuar resaltado

    Página Escanea el código QR con el código que hay que escanear con la aplicación

  8. Opcionalmente, la aplicación te deja elegir si quieres usar biometría. La biometría identifica y verifica al usuario mediante características físicas o de comportamiento únicas, y mejora la seguridad y la comodidad de uso.

    Pantalla de la aplicación para elegir si se usa biometría

  9. El proceso termina cuando en el ordenador aparece la pantalla de confirmación y en el móvil se abre la aplicación.

Alta en la aplicación móvil escaneando el QRReproducir el vídeo

Con la aplicación móvil y el enlace directo

Sección titulada «Con la aplicación móvil y el enlace directo»
  1. Abre el correo que has recibido desde tu teléfono móvil y pulsa Verificar mi correo.

    Correo de verificación abierto en el móvil con el botón Verificar mi correo

  2. Se abre una pestaña nueva que te pide descargar la aplicación de Ironchip. No la cierres.

    Pestaña que pide descargar la aplicación de Ironchip

  3. Descarga Ironchip Authenticator desde Google Play Store o App Store.

    Aplicación Ironchip Authenticator en la tienda de aplicaciones

  4. Abre la aplicación. Te pide una serie de permisos:

    • Cámara, para escanear el código QR. En este caso no es necesario.
    • Ubicación, para recopilar datos de las redes wifi cercanas.
    • Llamadas telefónicas, para recopilar datos sobre las redes móviles cercanas.

    Pantalla de permisos de la aplicación

  5. Si tienes un dispositivo Xiaomi, la aplicación te pide dos permisos más: mostrar en la pantalla de bloqueo y abrir ventanas en segundo plano, para recibir correctamente las notificaciones de la app.

    Permisos adicionales que solicita la aplicación en dispositivos Xiaomi

  6. Cuando aparezca la pantalla de escaneo del código QR, vuelve a la pestaña de Ironchip donde se te pidió descargar la aplicación y pulsa Continuar.

    Pantalla de la aplicación que pide escanear el QR

    Pestaña Comencemos con el botón Continuar resaltado

  7. Pulsa Inscribirse. El proceso se completa de forma automática.

    Página Escanea el código QR con los botones Copiar e Inscribirse

Alta en la aplicación móvil con enlace directoReproducir el vídeo
  1. Abre el correo que has recibido desde un PC o portátil y pulsa Verificar mi correo.

    Correo de verificación con el botón Verificar mi correo

  2. Se abre una pestaña nueva que te pide descargar la aplicación de Ironchip. No la cierres.

    Pestaña que pide descargar la aplicación de Ironchip

  3. Pide al administrador que te proporcione el autenticador de escritorio de Ironchip. Cuando lo tengas instalado en tu equipo, ábrelo. Verás una ventana como esta.

    Ventana inicial del autenticador de escritorio de Ironchip

  4. Acepta los términos y condiciones. En el recuadro que aparece, pega el código de alta. Lo obtienes pulsando Continuar en la pestaña donde se te pidió descargar la aplicación.

    Pestaña Comencemos con el botón Continuar resaltado

  5. En esa pestaña nueva, pulsa el botón de copiar y pega el código en el recuadro del autenticador de escritorio.

    Página Escanea el código QR con el botón Copiar para copiar el código de seguridad

El alta termina cuando en el ordenador aparece la pantalla de confirmación y la aplicación se abre.

Pantalla de confirmación del alta en la aplicación de escritorio

Esta opción te permite llevar tus credenciales de identificación contigo. Cuando te has dado de alta con un dispositivo de memoria externo, puedes usarlo como mecanismo de autenticación en cualquier equipo compatible con Ironchip que tenga instalados los servicios de escritorio de Ironchip.

  1. Abre el correo que has recibido desde un PC o portátil y pulsa Verificar mi correo.

    Correo de verificación con el botón Verificar mi correo

  2. Se abre una pestaña nueva que te pide descargar la aplicación de Ironchip. No la cierres.

    Pestaña que pide descargar la aplicación de Ironchip

  3. Pide al administrador que te proporcione el autenticador de escritorio de Ironchip. Cuando lo tengas instalado en tu equipo, ábrelo. Verás una ventana como esta.

    Ventana inicial del autenticador de escritorio de Ironchip

  4. Inserta tu dispositivo externo de almacenamiento y pulsa el botón de refrescar para que se escanee.

  5. Pulsa el recuadro con el nombre de tu equipo, a la izquierda del botón de refrescar, y elige el dispositivo externo en la lista desplegable (por ejemplo, la unidad D:\). Si no aparece, comprueba que el USB está bien conectado y pulsa la rueda de recarga.

    Selección del dispositivo USB en la lista desplegable de la aplicación

  6. Acepta los términos y condiciones. En el recuadro que aparece, pega el código de alta. Lo obtienes pulsando Continuar en la pestaña donde se te pidió descargar la aplicación.

    Pestaña Comencemos con el botón Continuar resaltado

  7. En esa pestaña nueva, pulsa el botón de copiar y pega el código en el recuadro del autenticador de escritorio.

    Página Escanea el código QR con el botón Copiar para copiar el código de seguridad

Alta con un USBReproducir el vídeo

En la pestaña de servicios aparecen todos los servicios a los que tienes acceso. Si tu compañía lo ha decidido, también aparece el servicio Panel de gestión Ironchip, que es exclusivo de los administradores seleccionados, encargados de gestionar las autenticaciones y los accesos a los servicios.

En estos servicios aparece una cuenta atrás cuando se ha solicitado autenticación en el servicio. Para ver cómo autenticarte, consulta Autenticarse con Ironchip.

Apps y métodos

Aplicación móvil

Usa la aplicación móvil de Ironchip para Android e iOS: descarga, alta, servicios, zonas seguras, autenticación con notificación push y versión.

Ironchip proporciona una aplicación móvil, que se distribuye por lo general a través de las tiendas oficiales. Está disponible para Android e iOS y su uso es igual en ambos sistemas.

  • Un teléfono con Android o iOS y acceso a la tienda oficial (Google Play o App Store).
  • Que tu administrador te haya registrado en la consola de administración. Recibes un correo electrónico de verificación.
  • Aceptar los permisos que pide la aplicación durante el alta: Cámara (para escanear el código QR), Ubicación (para recopilar datos de las redes wifi cercanas) y Llamadas telefónicas (para recopilar datos sobre las redes móviles cercanas). En Alta en la aplicación tienes los detalles, incluidos los permisos adicionales en dispositivos Xiaomi.

La descarga de la aplicación se hace por lo general desde las tiendas oficiales: Google Play o App Store.

Insignias de descarga de Google Play y App Store

Para ver los pasos detallados, consulta Alta en la aplicación.

Para darte de alta, un administrador tiene que haberte registrado antes en la consola de administración. En ese momento recibes un correo electrónico de verificación. Sigue estos pasos:

  1. En el correo, pulsa el botón Verify my account.

    Correo de verificación con el botón Verify my account

  2. Si ya has descargado la aplicación, pulsa Continue. Si no, puedes descargarla pulsando la imagen correspondiente.

  3. Se abre la aplicación. Acepta los permisos que te pide.

    Pantalla de permisos de la aplicación

  4. Elige si quieres usar biometría en la aplicación.

    Pantalla de la aplicación para elegir si se usa biometría

  5. Escanea con la aplicación de Ironchip el código QR que aparece en la pantalla del ordenador.

    Código QR en la pantalla del ordenador que hay que escanear con la aplicación

El alta termina cuando en el ordenador aparece la siguiente imagen y en el móvil se abre la aplicación.

Pantalla de confirmación del alta en el ordenador

En la pestaña de servicios están todos los servicios a los que tienes acceso. Si tu compañía lo ha decidido, también aparece el servicio Panel de gestión Ironchip, que es exclusivo de los administradores seleccionados, encargados de gestionar las autenticaciones y los accesos a los servicios.

En estos servicios aparece una cuenta atrás si se ha solicitado autenticación en el servicio.

Pestaña de servicios de la aplicación móvil con la cuenta atrás de un servicio

En la pestaña de llaves están todas las llaves a las que tienes acceso: las que has creado tú y las que han compartido contigo otros miembros de la compañía.

Para crear una zona segura nueva:

  1. Pulsa el icono +.

    Pestaña de llaves con el icono + para crear una zona segura

  2. Escribe un nombre para la zona segura.

  3. Pulsa Add Safe Zone.

    Formulario para poner nombre a la zona segura, con el botón para añadirla

  4. Cuando la rueda de progreso llegue a su fin, la llave estará creada.

Cuando las zonas seguras están creadas y vinculadas a los servicios correspondientes, puedes autenticarte de dos maneras.

Es la forma más habitual.

  1. Introduce tus credenciales en el servicio al que quieres acceder. Te llega una notificación push al móvil a través de la aplicación de Ironchip.

    Notificación push de Ironchip en el móvil

  2. Pulsa la notificación push. Se abre la aplicación de Ironchip, donde tienes que introducir la biometría elegida si se ha establecido como requisito.

    Aplicación de Ironchip pidiendo la biometría

  3. Pulsa Authorize. Se abre la pantalla de escaneo de señales, que verifica si estás en el lugar autorizado para acceder al servicio. Si estás en el lugar correcto, accedes al servicio.

    Pantalla de escaneo de señales que verifica la ubicación

  1. Introduce tus credenciales en el servicio al que quieres acceder. Te llega una notificación push al móvil.

  2. En lugar de pulsar la notificación, abre directamente la aplicación y ve a Servicios. En el servicio en el que has introducido las credenciales aparece una cuenta atrás con los segundos que quedan para hacer el escaneo de señales y verificar tu identidad. Pulsa la tarjeta del servicio.

    Tarjeta del servicio con la cuenta atrás

  3. Pulsa Authorize. Se abre la pantalla de escaneo de señales, que verifica si estás en el lugar autorizado. Si estás en el lugar correcto, accedes al servicio.

Para ver la versión de la aplicación móvil:

  1. Abre la aplicación y pulsa los tres puntos de la barra superior.

    Barra superior de la aplicación con el icono de los tres puntos

  2. En el menú desplegable, pulsa App information (Información de la aplicación).

    Menú desplegable con las opciones Account information, App information y OTP

  3. Se abre una ventana con la versión de la aplicación.

Si has perdido el acceso a tu cuenta, contacta con tu administrador para que inicie la recuperación. Después sigue los pasos de Recuperar el acceso: abres el correo de recuperación y escaneas un código QR con la aplicación.

Aplicación de escritorio

Instala y usa la aplicación de escritorio de Ironchip en Windows, Linux y macOS: alta, identidad en USB, zonas seguras y autenticación.

Ironchip puede proporcionar la aplicación de escritorio a los clientes que la necesiten. Tiene exactamente el mismo funcionamiento que la aplicación móvil y está disponible para Windows, Linux y macOS. Las instrucciones de instalación cambian según el sistema operativo, pero el uso es igual en todos.

ComponenteVersiónPublicada
Ironchip Windows Authenticatorv1.10.221 oct 2026
Ironchip Authenticator para macOS1.1.020 ene 2026
Ironchip Authenticator para Linux1.3.119 may 2026

Descarga la aplicación desde el GitHub oficial de Ironchip: github.com/Ironchip-Security.

Entra en la sección del instalador que corresponde a tu sistema operativo. El autenticador de escritorio está disponible para Windows, Linux y macOS. Asegúrate de descargar la última versión disponible.

Haz doble clic en el archivo .msi que has descargado y sigue estos pasos:

  1. Pulsa Next.

    Pantalla de bienvenida del instalador de Windows con el botón Next

  2. Marca I accept the terms in the License Agreement y pulsa Next.

    Pantalla de licencia del instalador con la casilla de aceptación

  3. Selecciona los componentes que quieras y pulsa Next.

    Pantalla de selección de componentes del instalador

  4. Pulsa Next.

  5. Pulsa Finish para terminar la instalación.

Para desinstalar la aplicación de escritorio, haz clic derecho sobre el archivo y pulsa Uninstall.

Para instalar el autenticador de Ironchip en tu equipo, ejecuta este comando con permisos de administrador:

Ventana de terminal
sudo dpkg -i <ruta al archivo .deb>

Por seguridad, el sistema te pide tu contraseña. Con ella autorizas la operación y la instalación continúa.

Cuando termine la instalación, solo te falta registrar el dispositivo y ya puedes usarlo.

Para desinstalar la aplicación, ejecuta este comando con permisos de administrador. El sistema te pide tu contraseña de administrador.

Ventana de terminal
sudo dpkg -r ironchip-authenticator

Escribe este comando en la terminal y pulsa Enter. El sistema te pide tu contraseña de administrador.

Ventana de terminal
sudo ironchip-service configure --restrict-usb=true

Con el proxy automático, la aplicación usa el proxy configurado en el sistema. Para activarlo, escribe este comando en la terminal y pulsa Enter:

Ventana de terminal
sudo ironchip-service configure --proxy-enable=true

Con el proxy manual, la aplicación toma los datos del proxy del archivo config.json:

Ventana de terminal
sudo ironchip-service configure --proxy-manual=true --proxy-manual-uri 127.0.0.1:8080

Antes de darte de alta, un administrador tiene que haberte registrado en la consola de administración. En ese momento recibes un correo electrónico de verificación. Sigue estos pasos:

  1. En el correo, pulsa el botón Verify my account.

    Correo de verificación con el botón Verify my account

  2. La aplicación de escritorio ya está descargada, así que pulsa Continue.

  3. Copia el código de seguridad que aparece en la pantalla del ordenador y pégalo en la aplicación de escritorio de Ironchip.

    Código de seguridad copiado e introducido en la aplicación de escritorio

El alta termina cuando en el ordenador aparece la siguiente imagen y la aplicación se abre.

Pantalla de confirmación del alta en la aplicación de escritorio

Para las otras formas de dar de alta el dispositivo (app móvil o USB), consulta Alta en la aplicación.

Lleva tu identidad en un dispositivo externo

Sección titulada «Lleva tu identidad en un dispositivo externo»

Esta opción te permite llevar contigo tus credenciales de identificación. Cuando te has dado de alta con un dispositivo de memoria externo, puedes usarlo como mecanismo de autenticación en cualquier equipo compatible con Ironchip que tenga instalados los servicios de escritorio de Ironchip.

Para dar de alta un dispositivo nuevo como proveedor de identidad para ti, tienes que seleccionar el dispositivo en el que se hará la instalación durante el proceso de alta, al ejecutar la aplicación de escritorio de Ironchip:

  1. Conecta tu dispositivo externo de almacenamiento.

  2. Pulsa el botón de refrescar para que se escanee tu dispositivo externo.

  3. Haz clic en el nombre del dispositivo, a la izquierda del botón de refrescar, y elige el dispositivo externo en la lista desplegable.

    Selección del dispositivo externo en la lista desplegable de la aplicación

Para guardar una identidad en un USB, primero hay que generar una invitación.

  1. Accede a la consola de administración.

  2. Selecciona la identidad que quieres guardar en el USB.

  3. Envía la invitación al usuario. En la lista de usuarios, la opción es Options > Add a device.

    Lista de usuarios de la consola con el menú Options abierto y la opción Add a device

El usuario recibe un correo electrónico con un enlace de alta.

  1. Abre el correo y haz clic en el enlace.

    Correo Confirma el nuevo dispositivo con el enlace para confirmar el dispositivo

  2. Se abre la pantalla de alta, con un código QR y, debajo, un botón Enrol o Inscribirse.

    Pantalla de alta con el código QR y, debajo, el botón Inscribirse

  3. Haz clic en ese botón para iniciar el alta con el autenticador de escritorio.

Al pulsar el botón:

  1. El sistema pregunta si quieres abrir el Autenticador de Ironchip. Selecciona Sí.

  2. Se muestra una ventana como esta.

    Ventana del autenticador de escritorio para elegir el USB

  3. En esta ventana, elige el USB en el que se guardará la identidad.

En la pestaña de servicios están todos los servicios a los que tienes acceso. Si tu compañía lo ha decidido, también aparece el servicio Panel de gestión Ironchip, que es exclusivo de los administradores seleccionados, encargados de gestionar las autenticaciones y los accesos a los servicios.

En estos servicios aparece una cuenta atrás si se ha solicitado autenticación en el servicio.

Pestaña de servicios de la aplicación de escritorio con la cuenta atrás de un servicio

Para ver la versión de la aplicación de escritorio:

  1. Abre la aplicación y pulsa los tres puntos de la barra superior.

    Barra superior de la aplicación con el icono de los tres puntos

  2. En el menú desplegable, pulsa App information (Información de la aplicación).

    Menú desplegable con las opciones Account information, App information y OTP

  3. Se abre una ventana con la versión de la aplicación.

    Ventana con la versión de la aplicación de escritorio

En la pestaña de llaves están todas las llaves a las que tienes acceso: las que has creado tú y las que han compartido contigo otros miembros de la compañía.

Para crear una zona segura nueva:

  1. Pulsa el icono +.

    Pestaña de llaves con el icono + para crear una zona segura

  2. Escribe un nombre para la zona segura.

  3. Pulsa Add Safe Zone.

    Formulario para poner nombre a la zona segura, con el botón para añadirla

  4. Cuando la rueda de progreso llegue a su fin, la llave estará creada.

Cuando las zonas seguras están creadas y vinculadas a los servicios correspondientes, puedes autenticarte de dos maneras.

Es la forma más habitual.

  1. Introduce tus credenciales en el servicio al que quieres acceder. Te llega una notificación al dispositivo a través de la aplicación de Ironchip.

  2. Pulsa la notificación. Se abre la aplicación de Ironchip.

  3. Pulsa Authorize. Se abre la pantalla de escaneo de señales, que verifica si estás en el lugar autorizado para acceder al servicio. Si estás en el lugar correcto, accedes al servicio.

    Pantalla de escaneo de señales que verifica la ubicación

  1. Introduce tus credenciales en el servicio al que quieres acceder. Te llega una notificación al dispositivo.

  2. En lugar de pulsar la notificación, abre directamente la aplicación y ve a Servicios. En el servicio en el que has introducido las credenciales aparece una cuenta atrás con los segundos que quedan para hacer el escaneo de señales y verificar tu identidad. Pulsa la tarjeta del servicio.

    Tarjeta del servicio con la cuenta atrás

  3. Pulsa Authorize. Se abre la pantalla de escaneo de señales, que verifica si estás en el lugar autorizado. Si estás en el lugar correcto, accedes al servicio.

Uso de la aplicación de escritorio de IronchipReproducir el vídeo

Instalación del autenticador en Windows

Descarga e instala el autenticador de escritorio de Ironchip en Windows desde la consola de administración o GitHub, y da de alta al usuario.

Esta guía explica cómo instalar el autenticador de escritorio de Ironchip en su versión para Windows. Tiene tres partes: descargar el instalador, instalarlo y dar de alta al usuario.

  • Windows de 64 bits. En versiones anteriores a Windows 10 hace falta además Microsoft Visual C++ Redistributable x64.
  • Permisos de administrador en el equipo.
  • Conectividad con la API de Ironchip (https://api.ironchip.com por defecto).

Tienes dos alternativas para descargar el instalador del autenticador.

  1. Entra en la consola de administración de Ironchip, app.ironchip.com, e inicia sesión con tu cuenta de administrador.
  2. Ve a la sección Plugins, busca en Authenticators la tarjeta Windows Authenticator y pulsa Download.
  1. Entra en el repositorio oficial de Ironchip, github.com/Ironchip-Security, donde están todos los descargables, y abre Ironchip-Windows-Authenticator.
  2. Entra en github.com/Ironchip-Security/Ironchip-Windows-Authenticator/releases, que muestra todas las versiones disponibles, y descarga IronchipWindowsAuthenticator.msi de la última.

Cuando tengas el instalador en el equipo, ejecútalo como administrador y sigue estos pasos:

  1. Comprueba que es la versión que quieres y pulsa Next.

    Pantalla inicial del instalador con la versión del autenticador

  2. Acepta los términos de uso.

    Pantalla de aceptación de los términos de uso

  3. Selecciona las características que quieres instalar. En este caso solo hace falta Ironchip Authenticator y, si lo necesitas, USB support, que sirve para guardar tu identidad en un USB y no se instala por defecto.

    Pantalla de selección de características del instalador

  4. En Ironchip Host, deja la URL de la API como está (https://api.ironchip.com) salvo que tu compañía esté en otro entorno. Después selecciona una de las tres opciones de proxy según tengas un proxy automático (Automatic), un proxy manual (Manual, con su host y su puerto) o ningún proxy (None).

    Pantalla de configuración del proxy del instalador

  5. Pulsa Install. Hacen falta permisos de administrador. Al terminar, puedes marcar Launch Ironchip Authenticator para abrir la aplicación.

    Pantalla final del instalador con el botón Install

Para instalar el autenticador de forma silenciosa, por ejemplo en un despliegue masivo, usa msiexec.exe desde una consola con permisos de administrador:

Ventana de terminal
msiexec.exe /i "C:\Ruta\Al\Archivo\IronchipWindowsAuthenticator.msi" IRONCHIP_HOST="https://api.ironchip.com" ADDLOCAL="AuthenticatorFeature,USBFeature" /q

Todas las propiedades son opcionales:

Propiedad Valor por defecto Descripción
IRONCHIP_HOST https://api.ironchip.com URL de la API de Ironchip. Cámbiala solo si tu compañía está en otro entorno.
ADDLOCAL Autenticador sin USB Características que se instalan: AuthenticatorFeature (el autenticador) y USBFeature (soporte USB). Sepáralas con comas.
IRONCHIP_PROXY_SELECTED none Modo de proxy: none, automatic o manual.
IRONCHIP_PROXY_MANUAL_HOST Vacío Host del proxy. Solo hace falta con IRONCHIP_PROXY_SELECTED="manual".
IRONCHIP_PROXY_MANUAL_PORT Vacío Puerto del proxy. Solo hace falta con IRONCHIP_PROXY_SELECTED="manual".

Por ejemplo, para instalar el autenticador sin soporte USB y con un proxy manual:

Ventana de terminal
msiexec.exe /i "C:\Ruta\Al\Archivo\IronchipWindowsAuthenticator.msi" IRONCHIP_HOST="https://api.ironchip.com" ADDLOCAL="AuthenticatorFeature" IRONCHIP_PROXY_SELECTED="manual" IRONCHIP_PROXY_MANUAL_HOST="proxy.example.com" IRONCHIP_PROXY_MANUAL_PORT="8080" /q

Para saber cómo dar de alta a los usuarios, consulta Alta en la aplicación.

Llave FIDO2

Registra una llave de seguridad FIDO2 o una passkey para un usuario desde la consola de administración de Ironchip y prueba el acceso sin contraseña.

FIDO2 es un estándar de autenticación sin contraseña basado en criptografía de clave pública. La clave privada se guarda en el autenticador, por ejemplo una llave de seguridad física, y nunca se comparte con el servicio. Así se protege frente a ataques de phishing y filtraciones de credenciales.

Para registrar una llave FIDO2 desde la consola de administración, sigue estos pasos:

  1. Accede a la consola de administración de Ironchip: app.ironchip.com.

  2. En el menú lateral izquierdo, ve a Directory > Users.

    Menú lateral de la consola con la opción Directory y Users

  3. Localiza el usuario al que quieres asignar la llave FIDO2, pulsa Options y selecciona Register a passkey.

    Menú Options de un usuario con la opción Register a passkey

  4. El usuario recibe un correo electrónico para registrar su clave de acceso. En el correo, pulsa el botón Registrar clave de acceso.

    Correo con el botón Registrar clave de acceso

  5. Escribe un nombre para identificar la clave.

    Campo para escribir el nombre de la clave

  6. Pulsa Registrar passkey.

    Página Registrar una passkey con el nombre de la clave y el botón Registrar passkey

  7. Aparece una ventana que solicita el PIN del autenticador. Introdúcelo y pulsa Siguiente.

    Ventana que solicita el PIN del autenticador

  8. Si todo ha ido bien, la clave FIDO2 queda registrada.

    Mensaje de confirmación del registro de la clave FIDO2

Puedes ver todas las llaves creadas en la consola de administración, en Directory > Devices > Passkeys:

Menú lateral de la consola con Directory, Devices y Passkeys resaltados

Ahí aparece el listado de todas las llaves creadas.

Listado de las llaves FIDO2 creadas

Para la prueba, configura Any FIDO2 devices como método de autenticación del acceso. En la ventana Add a new access, en el paso Select authentication policies, añádelo en Configure authentication factors.

Ventana Add a new access con Any FIDO2 devices como factor de autenticación

El vídeo muestra cómo es la autenticación con FIDO2.

Autenticación con una llave FIDO2Reproducir el vídeo

Token USB con cifrado por huella

Usa un USB con cifrado por huella dactilar: sistemas compatibles, registro de huellas, particiones y cómo guardar en él la identidad de Ironchip.

El USB con cifrado por huella dactilar utiliza un chip de cifrado de seguridad financiera. Los datos se guardan cifrados y el usuario accede a ellos con su huella dactilar. Esta guía explica cómo usarlo y cómo guardar en él una identidad de Ironchip.

El dispositivo es compatible con estos sistemas operativos:

  • Windows XP
  • Windows 7
  • Windows 10
  • Windows 11
  • Linux

El sistema admite el registro de hasta 10 huellas dactilares.

Cuando insertas el USB en el ordenador, aparecen tres letras de unidad:

  • Disco óptico (CD): contiene el software de gestión.
  • Disco público: unidad de almacenamiento de acceso libre.
  • Disco extraíble (disco cifrado, privado): unidad de acceso protegido.

Al insertar el dispositivo en el PC, la interfaz de la herramienta de gestión de disco aparece automáticamente. Si no se abre sola por la configuración del PC o por el antivirus, haz doble clic en el archivo UserTool.exe.

El sistema también ofrece un modo de inicio de sesión con contraseña (Password Verification Mode), que parte de una contraseña inicial de fábrica.

Herramienta de gestión del USB en el modo de verificación por huella (Fingerprint Verification Mode)

Herramienta de gestión del USB en el modo de verificación por contraseña, con el campo de la contraseña

La primera vez que abres el software, accedes directamente a la interfaz de registro de la huella dactilar del administrador.

Añadir o eliminar huellas requiere los permisos adecuados, que se obtienen con la autenticación por huella dactilar del administrador. Si no hay ningún administrador registrado, el sistema solicita registrar su huella.

Para registrar una huella:

  1. Al añadir una huella, introduce el nombre del usuario que la va a registrar.
  2. Autentícate como administrador.
  3. Cuando termine la autenticación, empieza el registro normal.
  4. Presiona el dedo sobre el sensor seis veces, hasta que aparezca el mensaje de registro correcto.
  5. Tras el registro, puedes volver a la interfaz de gestión de usuarios para consultar la información de la huella registrada.

Para eliminar una huella, ve a la interfaz de gestión de huellas y selecciona el nombre de la huella que quieres eliminar.

Puedes redimensionar el disco ordinario y el disco cifrado según tus necesidades. Para repartir el espacio hay que autenticarse con la huella dactilar del administrador.

Pestaña Storage Partition de la herramienta de gestión, con el tamaño privado y público del disco

Para acceder al disco cifrado en el uso habitual, coloca directamente el dedo registrado sobre el sensor de huella. Cuando se verifique, accedes al disco cifrado con normalidad.

Para guardar la identidad de un usuario en el almacenamiento privado del USB, necesitas tener instalada en tu equipo la aplicación autenticadora de escritorio. Después, envía una invitación al usuario para añadir un dispositivo nuevo.

Cuando tengas la invitación, desbloquea la unidad privada con la huella y usa la invitación para dar de alta en ella la identidad del usuario.

Autenticador de escritorio en la pantalla Almacene su identidad, con la unidad privada del USB seleccionada

Uso del USB con cifrado por huella dactilar con IronchipReproducir el vídeo

Tarjeta NFC / RFID

Configura la autenticación con tarjetas RFID en Ironchip: instala el agente, genera la API key, crea los accesos, registra tarjetas y vincula el lector.

La autenticación RFID permite usar una tarjeta de acceso como método de autenticación con un lector conectado al equipo. Esta guía explica cómo preparar la consola, instalar el agente y vincular el lector.

  • Acceso de administrador a la consola de administración de Ironchip.
  • Permisos de administrador en el sistema.
  • Lectores y tarjetas compatibles.
  1. Accede a la consola de administración de Ironchip con tus credenciales.

  2. En el menú lateral izquierdo, selecciona la sección Plugins.

    Menú lateral de la consola con la sección Plugins

  3. Localiza el paquete RFID Authenticator y descárgalo. Guarda el archivo en una ubicación accesible, porque lo necesitarás en pasos posteriores.

    Paquete RFID Authenticator en la sección Plugins

El agente necesita una API key para funcionar. Para generarla:

  1. En la consola de administración, ve a Authentication Policies > Device Policies.

    Menú Authentication Policies con la opción Device Policies

  2. Haz clic en Add device policy para crear una entrada nueva.

    Botón Add device policy en la lista de políticas de dispositivo

  3. Asigna un nombre descriptivo a la política.

  4. Activa la opción Use RFID protocol.

  5. Pulsa Add para confirmar. El sistema genera automáticamente una API key.

    Formulario de la política con la opción Use RFID protocol activada

Para generar un acceso RFID, tienes que tener creada antes una aplicación de inicio de sesión. Cuando la tengas:

  1. Haz clic en Add access para añadir un acceso nuevo.

    Botón Add access de la aplicación de inicio de sesión

  2. Selecciona el usuario autenticador, es decir, quien va a hacer la autenticación.

    Selección del usuario autenticador

  3. Indica el usuario a proteger con el formato correcto según el tipo de cuenta:

    • Usuario de dominio: DOMINIO\usuario
    • Usuario local: NOMBRE_DE_EQUIPO\usuario
  4. Pulsa Next.

    Campo del usuario a proteger y botón Next

  5. En el campo del método de autenticación, selecciona la política RFID que creaste antes.

    Selección de la política RFID como método de autenticación

  6. Haz clic en Add para terminar. El acceso queda generado y activo.

    Acceso RFID generado y activo

Para registrar tarjetas RFID en la plataforma, ve a Directory > Devices > RFID y sigue estos pasos:

Sección Directory > Devices > RFID de la consola

  1. Haz clic en Synchronize para acceder al proceso de importación.

    Botón Synchronize en la sección RFID

  2. Descarga la plantilla (template) que ofrece el sistema.

    Botón para descargar la plantilla de importación

  3. Rellena la plantilla con estos datos de cada tarjeta:

    Campo Descripción
    UserID ID del usuario en Ironchip, disponible en la ficha del usuario
    Email Correo electrónico del usuario
    Name Nombre identificativo de la tarjeta
    UUID Identificador único de la tarjeta RFID

    Plantilla de importación rellena con los datos de las tarjetas

  4. Sube la plantilla completada a Ironchip y pulsa Next.

    Pantalla para subir la plantilla completada

  5. En la pantalla siguiente, selecciona la política RFID que creaste antes.

    Selección de la política RFID para las tarjetas

  6. Confirma la operación pulsando Add. Las tarjetas quedan registradas en el sistema.

    Tarjetas RFID registradas en el sistema

Con el agente descargado y la API key disponible, abre una ventana de PowerShell como administrador y ve al directorio donde está el archivo del agente.

  1. Vincula la API key al agente. Sustituye <API_KEY> por la clave que generaste antes:

    Ventana de terminal
    .\IronchipRFID.exe c --api_key <API_KEY>

    Comando que aplica la API key al agente en PowerShell

  2. Comprueba que la configuración se ha aplicado. Este comando muestra los parámetros activos del agente:

    Ventana de terminal
    .\IronchipRFID.exe c show

    Parámetros activos del agente mostrados en PowerShell

  3. Instala el agente como servicio del sistema:

    Ventana de terminal
    .\IronchipRFID.exe s install

    Comando de instalación del servicio del agente

  4. Inicia el servicio del agente para que empiece a funcionar:

    Ventana de terminal
    .\IronchipRFID.exe s start

    Comando que inicia el servicio del agente

Para desinstalar el agente, antes tienes que detenerlo. Sigue estos dos pasos en orden:

  1. Detén el servicio:

    Ventana de terminal
    .\IronchipRFID.exe s stop

    Comando que detiene el servicio del agente

  2. Cuando esté detenido, desinstala el agente del sistema:

    Ventana de terminal
    .\IronchipRFID.exe s uninstall

    Comando que desinstala el servicio del agente

Cuando el servicio del agente está instalado y en marcha, el último paso es vincular el lector RFID para que el sistema pueda capturar las lecturas de las tarjetas.

Si tu lector se identifica como un dispositivo de interfaz humana (HID), usa este comando para abrir el menú de selección interactivo:

Ventana de terminal
.\IronchipRFID.exe hid

Se muestra una lista con los dispositivos HID que detecta el sistema. Introduce el número del lector que quieres usar para completar la vinculación.

Lista de dispositivos HID detectados por el agente

Si el lector se conecta por un puerto serie o un emulador de puerto COM, usa el comando específico para dispositivos serie. Con él defines el puerto COM y los parámetros de comunicación que necesita el agente para comunicarse con el hardware:

Ventana de terminal
.\IronchipRFID.exe srl

Autenticarse con Ironchip

Cómo autenticarte con Ironchip en servicios web, Windows y Linux: notificación push, USB, código sin conexión y cambio de contraseña.

Esta guía explica cómo te autenticas con Ironchip según el servicio al que accedes: con la aplicación y una notificación push, en el inicio de sesión de Windows y Linux, o en servicios web por SAML u OIDC.

Puedes autenticarte de dos maneras.

  1. Introduce tus credenciales en el servicio al que quieres acceder. Te llega una notificación push al móvil a través de la aplicación de Ironchip.

    Notificación push de Ironchip en el móvil

  2. Pulsa la notificación push. Se abre la aplicación de Ironchip, donde tienes que introducir la biometría elegida si se ha establecido como requisito.

    Aplicación de Ironchip pidiendo la biometría tras abrir la notificación

  3. Pulsa Authorize. Se abre la pantalla de escaneo de señales, que verifica si estás en el lugar autorizado para acceder al servicio. Si estás en el lugar correcto, accedes al servicio.

    Pantalla de escaneo de señales que verifica la ubicación

  1. Introduce tus credenciales en el servicio al que quieres acceder. Te llega una notificación push al móvil.

  2. En lugar de pulsar la notificación, abre directamente la aplicación y ve a Servicios. En el servicio en el que has introducido las credenciales aparece una cuenta atrás con los segundos que quedan para hacer el escaneo de señales y verificar tu identidad. Pulsa la tarjeta del servicio.

    Tarjeta del servicio con la cuenta atrás en la pestaña de servicios

  3. Pulsa Authorize. Se abre la pantalla de escaneo de señales, que verifica si estás en el lugar autorizado. Si estás en el lugar correcto, accedes al servicio.

Con Windows Logon accedes de forma segura a tus servicios Windows con factores de seguridad adicionales a tu contraseña habitual. Si eres administrador y tienes que instalarlo, consulta Instalación del autenticador en Windows. Hay tres opciones:

  • Notificación push: te llega una notificación al móvil para que autorices el inicio de sesión.
  • Offline: accedes al equipo sin conexión a internet con un código que te facilita la aplicación.
  • USB: accedes sin autorizar nada, porque el propio USB autoriza el acceso.

Pantalla de inicio de sesión de Windows con el logotipo de Ironchip

Si tienes más de un usuario, el primer desplegable te permite elegir con cuál iniciar sesión en el equipo. Rellena los campos necesarios, como usuario y contraseña.

Pantalla Ironchip Login de Windows con el desplegable de usuario y los campos de usuario y contraseña

Cuando hayas introducido tus datos de inicio de sesión, te llega al móvil una notificación que te pide autorizarlo.

Pantalla Windows Logon de la aplicación móvil con los botones Cancel y Authorize

Para acceder con este mecanismo, tienes que haberte dado de alta antes con un USB. Consulta Alta en la aplicación.

Rellena los campos necesarios, como usuario y contraseña. Como tienes el USB insertado en el equipo, no hace falta autorizar nada: el USB lo hace de forma automática.

Puedes autenticarte en servicios sin conexión a internet con la función Offline, que usa un código offline para verificar tu identidad en lugar de la autorización desde el móvil.

  1. Accede a la aplicación de autenticador offline, que te proporciona un enlace. Con ese enlace puedes crear una de tus llaves offline: escribe tu usuario de Windows en Windows Username y pulsa Generate. Si no recuerdas con claridad el usuario con el que accedes, pídele ayuda a tu administrador.

    Pantalla Generate offline key con el campo Windows Username y el botón Generate

  2. Cuando se genera la llave offline, aparece un código QR para añadirla en la aplicación móvil y un código de texto para copiarlo y pegarlo en la aplicación de escritorio.

    Llave offline generada, con el código QR y el botón Copy text code to clipboard

  3. En la aplicación móvil, ve a la segunda pestaña de la parte inferior derecha, la del icono de candado. Pulsa el botón verde redondo + de la esquina inferior derecha y elige Scan a QR code.

    Pestaña del candado en la aplicación móvil con el botón + y la opción Scan a QR code

  4. Escanea el código QR generado o introduce a mano la clave de configuración (Setup KEY). Si todo ha ido bien, aparece una nueva entrada con tu código OTP, que se regenera cada 30 segundos.

    Nueva entrada en la aplicación con el código OTP y el contador de 30 segundos

  5. Pulsa la tarjeta que ha aparecido para ver el código OTP. El código se oculta cada 30 segundos.

  6. En la pantalla de inicio de sesión de Windows, introduce en el campo OTP code el código que te muestra la aplicación.

    Pantalla Ironchip Login de Windows sin conexión, con el campo OTP code

Si aparece el error de que la función offline (OTP) no está instalada (Offline functionality is not installed), tienes dos opciones:

Pantalla de inicio de sesión de Windows con el aviso de que la función offline no está instalada

  • Conéctate a internet e inicia sesión con notificación push o con USB.
  • Si no tienes internet, contacta con tu administrador.

Para cambiar tu contraseña, contacta con tu administrador. Después, al iniciar sesión te aparece esta ventana. También la verás si tu contraseña ha caducado.

Ventana de cambio de contraseña en el inicio de sesión de Windows

  1. Rellena el segundo campo con el usuario con el que quieres acceder.

  2. Rellena el tercer campo con la contraseña anterior.

  3. Rellena los campos cuarto y quinto con la nueva contraseña.

    Ventana de cambio de contraseña con los campos rellenos

Cuando la contraseña se ha cambiado, aparece este mensaje:

Mensaje de confirmación del cambio de contraseña

Con Linux Logon accedes de forma segura a tus servicios Linux. Según los requisitos de tu administrador, el sistema puede pedirte autorización al iniciar sesión, al escalar privilegios en Linux (sudo) o al usar el servicio ssh.

Pantalla de inicio de sesión de Linux protegida con Ironchip

Cuando el administrador haya instalado Linux Logon en tu equipo, inicia sesión. Te llega una notificación push al móvil para que autorices el acceso.

Pantalla de autorización de Linux PAM en la aplicación móvil, con los botones Cancel y Authorize

La plataforma de Ironchip permite acceder a los servicios de la compañía desde el navegador. Hay dos formas de acceso, SAML u OIDC.

Verás una pestaña como la siguiente. Accede pulsando Login with Ironchip.

Página de un servicio web con el botón Login with Ironchip

  1. Pulsa el botón rojo, escribe tu correo electrónico habitual y pulsa Send notification. Te llega una notificación push de la aplicación de Ironchip.

    Pantalla para introducir el correo electrónico y enviar la notificación

    Pantalla de autorización de la aplicación de Ironchip, con los botones Cancel y Authorize

  2. Acepta la notificación en la aplicación pulsando Authorize y accederás a la plataforma.

La segunda forma de inicio de sesión web es parecida a la siguiente pantalla.

Página de un servicio web con el botón Ironchip Authentication

  1. Pulsa el botón rectangular gris de la parte inferior, Ironchip Authentication. Este botón también puede aparecer como Sign in with OIDC. Al pulsarlo se abre una pestaña adicional.

  2. En la pestaña nueva, escribe tu correo habitual y pulsa Send notification para recibir la notificación push.

    Pestaña de Ironchip para introducir el correo y enviar la notificación

  3. Acepta la notificación que te llega al móvil para acceder a la plataforma.

    Pantalla de autorización del acceso en la aplicación de Ironchip, con los botones Cancel y Authorize

Crear una zona segura

Crea tu propia zona segura desde la aplicación de Ironchip: pulsa el icono +, ponle un nombre y espera a que termine el indicador de progreso.

Las zonas seguras son los lugares desde los que sueles acceder a tus servicios. Esta guía explica cómo crear una nueva desde la aplicación. Para saber qué es una zona segura, consulta Zonas seguras.

En la pestaña de zonas seguras están todas las llaves con las que puedes operar, si así lo decide tu administrador. Entre ellas, las llaves que has creado tú y las que se han compartido contigo.

  1. Pulsa el icono +.

    Pestaña de zonas seguras de la aplicación con la lista de zonas y el botón + para crear una nueva

  2. Escribe un nombre para tu zona segura.

  3. Pulsa Add Safe Zone.

    Pantalla Go to your Safezone con el campo del nombre y el botón para añadir la zona segura

  4. Espera a que termine el indicador de progreso. Cuando acaba, tu zona segura está creada.

Recuperar el acceso

Recupera el acceso a tu cuenta de Ironchip: pide la recuperación a tu administrador, abre el correo y escanea el código QR con la app.

Si has perdido el acceso a tu cuenta, un administrador puede iniciar su recuperación. Esta guía explica los pasos que tienes que seguir tú.

  1. Contacta con tu administrador. Cuando haya iniciado la recuperación, recibirás un correo de recuperación de la cuenta.

  2. En el correo, haz clic en Recuperar mi acceso.

    Correo de recuperación de la cuenta con el botón Recuperar mi acceso

  3. Se abre una ventana con un código QR. Escanéalo con tu teléfono móvil.

    Ventana de recuperación con el código QR que hay que escanear con el móvil

  4. Concede todos los permisos que pide la aplicación, acepta los términos y condiciones y escanea el código QR que se te proporciona.

    Aplicación de Ironchip escaneando el código QR de recuperación

Cuando termines, tendrás de nuevo acceso a tu cuenta.

Problemas frecuentes

Respuestas a las preguntas habituales de los usuarios de Ironchip y solución a los errores comunes, como el nombre de dispositivo en iOS.

Esta página reúne las preguntas más habituales de los usuarios y los errores comunes que puedes encontrar al usar la aplicación de Ironchip.

¿Cómo me pongo en contacto con el soporte de Ironchip?

Sección titulada «¿Cómo me pongo en contacto con el soporte de Ironchip?»

Puedes encontrarnos en varios sitios:

  • En la sección de contacto de nuestro sitio web.
  • En el chat de la web.
  • Por correo electrónico, en info@ironchip.com.
  • Por teléfono, en el 946 03 94 99.

¿Por qué no guardamos la firma de los lugares seguros?

Sección titulada «¿Por qué no guardamos la firma de los lugares seguros?»

Porque da más seguridad y no es necesario. En Ironchip creemos que no guardarla evitará el robo de credenciales a gran escala que podríamos sufrir en el futuro. Además, las soluciones biométricas, aunque son cómodas, no son un buen enfoque de seguridad: si se las roban, ningún usuario puede cambiarlas.

Por eso solo mantenemos un modelo matemático, que es la solución para aprender el conjunto de señales. Una vez aprendidas, las señales se borran.

Ironchip utiliza los estándares de seguridad más extendidos, como SAML u OIDC (OpenID Connect), para integrarse con tus sistemas, ya sea en entornos Windows (Microsoft Active Directory) o mediante la plataforma de gestión que te proporcionamos. Consulta los protocolos SAML y OIDC.

Por parte del usuario, puedes usar un SDK para integrar Ironchip en tus aplicaciones o, si no, la aplicación oficial de Ironchip Location-Based Authentication.

Si tienes un dispositivo iOS y has visto este error (Enroll error con el texto error bad request in fields: DeviceName):

Mensaje Enroll error de la aplicación en iOS con el texto error bad request in fields: DeviceName

El nombre del dispositivo en iOS no puede contener acentos, ni los caracteres -, /, $, %, @, &, ., _ ni otros similares. Para corregir el error, cambia el nombre del dispositivo.

Si has visto este error (Login error con un mensaje PlatformException que indica que la clave maestra android-keystore://default1_authenticated_master_key existe pero no se puede usar):

Mensaje Login error de la aplicación con el detalle PlatformException sobre la clave maestra del almacén de claves de Android

Si te aparece, contacta con tu administrador o con el soporte de Ironchip por los canales de ¿Cómo me pongo en contacto con el soporte de Ironchip?.

Protocolos

Protocolos de integración

Cómo elegir entre OIDC, SAML, RADIUS, TACACS+ y la API HTTP para proteger una aplicación con Ironchip, y los pasos que comparten todas las integraciones.

Ironchip protege cualquier servicio mediante protocolos estándar. La elección depende de dónde se autentica el usuario y de qué admite el servicio.

Protocolo Para qué Ejemplos
OIDC Aplicaciones web y móviles modernas. Ironchip actúa como proveedor de identidad y emite tokens. Nextcloud, HashiCorp Vault y Boundary, aplicaciones propias
SAML Federación con suites y SaaS corporativos. Microsoft 365, Google Workspace, Salesforce, Palo Alto
RADIUS VPN, wifi corporativo, cortafuegos y electrónica de red. Fortinet, Check Point, Stormshield, OpenVPN
TACACS+ Administración de dispositivos de red con perfiles de autorización por comando. Switches, routers y cortafuegos compatibles con TACACS+
API HTTP Añadir la verificación de Ironchip a aplicaciones de desarrollo propio, con una API key. Portales internos, aplicaciones a medida

Para proteger conexiones de Escritorio remoto, consulta la guía de RDP. Para proteger la autenticación LDAP, consulta el proxy LDAP.

Además, puedes usar contraseñas de un solo uso (OTP) como segundo factor y centralizar la validación de certificados, LDAP, RADIUS y OTP/MFA. Las guías de integraciones aplican estos protocolos a productos concretos.

Ironchip admite de forma nativa estos protocolos y accesos:

  • SAML y OIDC / OAuth 2.0.
  • RADIUS NPS y RADIUS passwordless.
  • LDAP.
  • Windows Logon, RDP e hipervisores.
  • Linux PAM, SSH, sudo y su.

Consola de Ironchip con la configuración de servidores RADIUS NPS y los protocolos estándar OIDC, SAML y Passwordless RADIUS

Puedes descargar el documento de aplicaciones y accesos (PDF).

Prepara las direcciones de correo electrónico y los nombres de los usuarios que vas a agregar. La persona que se agrega se registra primero. Esto se hace en una reunión.

  1. Da de alta la aplicación en la consola: ve a Applications > New application y elige su tipo en el paso Select service type. Escribe el nombre en el paso Configure service y haz clic en Add. Consulta Crear una aplicación.
  2. Guarda las credenciales que muestra el paso Overview, porque la consola no vuelve a mostrarlas:
    • OIDC: el Client ID, el Client Secret y la Metadata URL.
    • Tipos con API key (Passwordless RADIUS, Custom code y los de inicio de sesión y acceso remoto): la API KEY.
    • SAML: no hay secreto. El paso muestra la IDP Metadata URL:, y los datos del proveedor de identidad están en la pestaña Identity Provider (IdP) de la aplicación.
    • Servidor NPS: la API key se muestra al crear el servidor NPS, no al crear la aplicación.
  3. Da acceso a usuarios y grupos desde la ventana Add a new access, un grupo o un usuario por acceso. Cada usuario individual se trata como un grupo con su propio nombre.
  4. Elige el formato del nombre de usuario que recibirá la aplicación, en Username composition (paso Select usernames): el correo por defecto, o una combinación de etiquetas como name, surname o domain.
  5. Asigna las políticas de autenticación que decidirán qué se exige a ese grupo en esa aplicación, como el dispositivo o la zona segura del usuario. Las políticas de una misma fila se unen con AND y las filas, con OR. Consulta Cómo se combinan las políticas en un acceso.

Los pasos detallados están en Aplicaciones. Los atributos que Ironchip envía en SAML están en la página de SAML.

En el paso Select service type, las tarjetas se agrupan en estas secciones:

Sección Tarjetas Para qué
Operating system security Windows Logon, MacOSX Logon, Linux Logon El inicio de sesión en los equipos, con una API key
Remote access protocols SSH, Remote Desktop Protocol (RDP) Los accesos remotos, con una API key
RADIUS NPS server configuration New NPS server y una tarjeta por cada servidor NPS, con Assign policy RADIUS a través del NPS de Windows con el plugin de Ironchip
Standard authentication protocols OIDC, SAML, Passwordless RADIUS OIDC, SAML y RADIUS con el Ironchip RADIUS server
For developers Custom code Aplicaciones propias, con una API key

RADIUS se integra de dos formas: con Passwordless RADIUS, que usa el Ironchip RADIUS server, o con un servidor NPS de Windows y el plugin de Ironchip. Consulta RADIUS y NPS.

En SAML, la consola no crea la aplicación hasta que tienes los datos del proveedor de servicio (SP). Consulta SAML.

¿Cómo se integran aplicaciones propias o de desarrollo interno?

Sección titulada «¿Cómo se integran aplicaciones propias o de desarrollo interno?»

La aplicación ejecuta una única llamada HTTPS GET a un endpoint de Ironchip. Cuando el usuario completa su autenticación, el endpoint devuelve la identidad validada para que la aplicación conceda o deniegue el acceso.

  • No requiere SDK complejos y es compatible con cualquier lenguaje.
  • No modifica la lógica de autenticación existente.

¿Se puede integrar una aplicación propia sin SAML ni OIDC?

Sección titulada «¿Se puede integrar una aplicación propia sin SAML ni OIDC?»

Sí. Una única llamada HTTPS GET al endpoint de Ironchip es suficiente:

  1. El usuario intenta acceder a la aplicación propia.
  2. La aplicación llama al endpoint de Ironchip con el identificador del usuario.
  3. Ironchip muestra el flujo de autenticación habitual (push, USB, NFC, etc.).
  4. Cuando el usuario termina, el endpoint devuelve la identidad validada.
  5. La aplicación usa esa respuesta para conceder o denegar el acceso.

Consulta la guía de API HTTP.

¿Se puede proteger el acceso a un ERP (Navision, SAP, Oracle PeopleSoft)?

Sección titulada «¿Se puede proteger el acceso a un ERP (Navision, SAP, Oracle PeopleSoft)?»

Sí, de varias formas según el ERP:

  • Windows Logon: protege el sistema operativo que ejecuta el ERP.
  • SAML u OIDC: si el ERP lo admite (SAP, Dynamics 365, Workday).
  • API directa: para ERP con desarrollo propio.
  • RADIUS: para acceder a los ERP a través de una VPN corporativa.

¿Ironchip requiere infraestructura local o es SaaS?

Sección titulada «¿Ironchip requiere infraestructura local o es SaaS?»

Es SaaS puro: no requiere despliegues pesados en la infraestructura del cliente. El cliente solo instala agentes ligeros (aplicación de escritorio, conector RADIUS y agente AD Connect). Existe una modalidad on-premise bajo acuerdo específico para organizaciones con requisitos de soberanía de datos o redes air-gapped.

¿Ironchip puede proveer entornos de contingencia o failover?

Sección titulada «¿Ironchip puede proveer entornos de contingencia o failover?»

Sí. Ironchip puede proveer entornos de contingencia sin coste adicional en las licencias, que funcionan como espejo de producción para garantizar la continuidad del servicio de autenticación.

¿Cómo integro Ironchip con el servidor NPS?

Sección titulada «¿Cómo integro Ironchip con el servidor NPS?»

Se instala el plugin MFA para NPS en el servidor NPS. El proceso tiene tres partes:

  1. En la consola de Ironchip, crea un servidor NPS en Applications > New application > New NPS server y guarda su API key, que se muestra una sola vez en la ventana Credentials for your new RADIUS Servers. Después, crea la aplicación con Assign policy en la tarjeta del servidor. Consulta Servidores NPS (RADIUS).
  2. En Network Policy Server, crea la política de red que quieres proteger, con sus condiciones y sus parámetros.
  3. Descarga el plugin de Ironchip desde Plugins > Windows Integrations > Windows NPS, ejecuta el instalador e indica el host de Ironchip, la API key del servidor NPS y el nombre de la política de red. Después, comprueba los registros del plugin en el Visor de eventos.

Los pasos detallados, con capturas, están en la guía de NPS.

Se instala el plugin de Ironchip MFA en el servidor ADFS:

  1. En la consola de Ironchip, crea una aplicación Custom code (sección For developers) y guarda su API key.
  2. Descarga el plugin desde Plugins > Windows Integrations > ADFS y ejecuta el instalador en el servidor ADFS, indicando el host y la API key.
  3. En ADFS, activa el adaptador Ironchip MFA como método de autenticación multifactor y protege las aplicaciones que quieras.
  4. Comprueba en el Visor de eventos que el plugin está instalado.

Los pasos detallados están en la guía de ADFS.

Descargar la documentación de NPS y ADFS (PDF)

OIDC

Proteger una aplicación con OpenID Connect: dar de alta la aplicación en Ironchip, guardar el Client ID y el Client Secret y dar acceso a grupos de usuarios.

OpenID Connect (OIDC) es el protocolo de identidad sobre OAuth 2.0 que usan las aplicaciones web y móviles modernas. Ironchip actúa como proveedor de identidad: la aplicación redirige al usuario a Ironchip, que lo autentica con su método y su zona segura, y devuelve un token con su identidad.

  • Una cuenta de administrador en la consola de Ironchip.
  • Un servicio que admita OIDC y del que conozcas la Redirect URI (la dirección a la que Ironchip devolverá al usuario tras autenticarse).
  • Los usuarios dados de alta en Ironchip, o la sincronización de identidades configurada.
  • La compañía creada en Ironchip. Consulta Protocolos de integración para los datos previos.

En la sección Applications ves todos los servicios protegidos que se han añadido a Ironchip y su tipo de integración. El procedimiento general está en Aplicaciones OIDC.

  1. Haz clic en New application. Se abre la ventana Add new application.

    Página Your applications con el botón New application

  2. En el paso Select service type, sección Standard authentication protocols, elige OIDC.

  3. En el paso Configure service, pestaña General, escribe el nombre de la aplicación en Name, de 3 caracteres como mínimo. Si quieres, añade un icono en Icon (JPEG o PNG de hasta 1 MB).

  4. Abre la pestaña Redirect URIs y escribe en Redirect URL la Redirect URI del servicio. Para obtenerla, busca su ruta en el servicio que quieres integrar. Si el servicio tiene varias, añade cada una con el icono +. Hace falta al menos una.

    Pestaña Redirect URIs con el campo Redirect URL relleno y el icono + para añadir otra

  5. Haz clic en Add. El paso Overview muestra el Client ID, el Client Secret y la Metadata URL de la aplicación, cada uno con su icono de copiar. Con Download credentials los descargas en el fichero credentials.json.

    Paso Overview de una aplicación OIDC con el Client ID, el Client Secret, la Metadata URL y el botón Download credentials

No cierres la ventana ni vuelvas atrás con Back antes de hacer clic en Add: la consola descarta los datos del formulario.

Para cambiar las Redirect URI más adelante, abre Options > Edit application en la aplicación, ve a la pestaña OIDC Settings y guarda con Edit. Consulta Gestionar una aplicación.

En la página de la aplicación (haz clic en su nombre en Applications) ves el recuento de autenticaciones completadas (Completed authentications) e incompletas (Incomplete authentications) y, en la pestaña Accesses, los accesos ya configurados.

Para dar un acceso nuevo, sigue Dar acceso a usuarios y grupos. En resumen:

  1. En Applications, haz clic en Add, en la columna Add access de la aplicación, o en Add access en la pestaña Accesses de su página. Se abre la ventana Add a new access.

  2. En Select a group, elige el grupo o el usuario al que das acceso. Cada acceso es para un solo grupo o usuario.

  3. En Select usernames, define en Username composition el nombre de usuario que recibirá la aplicación. Por defecto es la etiqueta email, pero puedes construir otro formato con etiquetas (name, surname, domain, etc.) en el cuadro Enter a tag. Username example muestra el nombre que se generaría para un usuario de ejemplo. Este nombre solo se usa en este acceso: no sustituye al nombre del usuario en la plataforma.

  4. En Select authentication policies, elige las políticas de autenticación que se exigen. Las políticas de una fila se unen con AND y las filas, con OR.

    Paso Select authentication policies con dos filas de políticas unidas con AND y las filas unidas con OR

  5. En Review, revisa el resumen (Username template: y Authentication factors:, entre otros) y haz clic en Add.

El acceso aparece en la pestaña Accesses de la aplicación. Desde su menú Options puedes cambiar sus factores (Authentication factors), su configuración (Configure access) o eliminarlo (Delete access).

SAML

Proteger una aplicación con SAML 2.0: atributos que envía Ironchip, alta de la aplicación con su metadata y acceso de usuarios y grupos con sus políticas.

SAML 2.0 es el protocolo de federación que usan las suites y los SaaS corporativos (Microsoft 365, Google Workspace, Salesforce). Ironchip actúa como proveedor de identidad (IdP) y emite la aserción con los atributos del usuario.

  • Una cuenta de administrador en la consola de Ironchip.
  • Un servicio que admita SAML 2.0 y del que conozcas la ACS URL y el Entity ID, o su metadata de proveedor de servicio (SP) en una URL, en XML o en un fichero.
  • Los usuarios dados de alta en Ironchip, o la sincronización de identidades configurada.
  • La compañía creada en Ironchip. Consulta Protocolos de integración para los datos previos.

Ironchip admite actualmente estos campos:

Descripción Friendly name SAML name
Nombre de usuario uid urn:oid:0.9.2342.19200300.100.1.1
Correo mail urn:oid:0.9.2342.19200300.100.1.3
Nombre givenName urn:oid:2.5.4.42
Nombre completo cn urn:oid:2.5.4.3

En la sección Applications ves todos los servicios protegidos que se han añadido a Ironchip y su tipo de integración. El procedimiento general está en Aplicaciones SAML.

  1. Haz clic en New application. Se abre la ventana Add new application.

    Página Your applications con el botón New application

  2. En el paso Select service type, sección Standard authentication protocols, elige SAML.

  3. En el paso Configure service, pestaña General, escribe el nombre de la aplicación en Name, de 3 caracteres como mínimo. Si quieres, añade un icono en Icon.

  4. Abre la pestaña Service Provider (SP) y carga los datos del servicio de una de estas formas:

    • Importando su metadata: despliega Import Metadata y, en SP Metadata, elige URL (la dirección de la metadata del SP), Text (pega el XML) o File (sube el fichero .xml). Haz clic en Import.
    • A mano: escribe el Entity ID del servicio y, en Assertion Consumer Services, la Location (la ACS URL) con su Binding (por defecto, HTTP-POST). En NameID Formats, elige el formato que espera el servicio, por ejemplo emailAddress.

    Protocol Support Enumeration y NameID Formats vienen rellenos. En la misma pestaña puedes ajustar, si el servicio lo pide, Auth Requests Signed, Want Assertions Signed, Single Logout, los certificados del SP (Signing Certificate y Encryption Certificate), Attribute Consuming Services, Organization Information y Contact Information.

    Pestaña Service Provider (SP) con la sección Import Metadata desplegada y las opciones URL, Text y File

  5. Abre la pestaña Identity Provider (IdP). Tiene los datos de Ironchip que debes configurar en el servicio, cada uno con su icono de copiar:

    • URL Metadata: la dirección de la metadata del IdP de Ironchip. Ábrela para descargar el XML si el servicio pide un fichero.
    • IdP Entity ID or Issuer.
    • Single Sign On Service: el binding y la dirección del inicio de sesión único.
    • Signing X.509 Certificate y Encryption X.509 Certificate.
    • Name ID Format y Protocol Support Enumeration.

    En Certificates IDP puedes cargar tu propia clave (Key) y tu certificado (X.509 Certificate) con Edit. En Alias puedes escribir un alias, que se añade al final de la URL Metadata.

    Pestaña Identity Provider (IdP) con la URL Metadata, el Entity ID, el Single Sign On Service y los certificados de Ironchip

  6. Haz clic en Add. El paso Overview muestra el nombre de la aplicación (Name:) y la IDP Metadata URL:. Las aplicaciones SAML no tienen secreto.

Para cambiar los datos más adelante, abre Options > Edit application en la aplicación. La ventana tiene las pestañas General, Service Provider (SP) e Identity Provider (IdP); guarda con Edit. Consulta Gestionar una aplicación.

Sigue Dar acceso a usuarios y grupos. En resumen:

  1. En Applications, haz clic en Add, en la columna Add access del servicio. Se abre la ventana Add a new access.

  2. En Select a group, busca por nombre con Search by name y elige el grupo o el usuario que tendrá acceso. Cada acceso es para un solo grupo o usuario. Haz clic en Next.

  3. En Select usernames, comprueba el formato del nombre de usuario en Username composition, por defecto el correo, y haz clic en Next.

  4. En Select authentication policies, elige las políticas de autenticación que se exigirán para acceder, por ejemplo Any user devices AND Any user safezones, y haz clic en Next.

  5. En Review, revisa el resumen y haz clic en Add.

El acceso queda creado con la configuración seleccionada. Puedes cambiarla en cualquier momento desde el menú Options del acceso, en la pestaña Accesses de la aplicación. Si el servicio pide atributos en Attribute Consuming Services, ese menú tiene además la opción Configure attributes.

RADIUS

Proteger VPN, wifi y equipos de red con RADIUS: crear la aplicación Passwordless RADIUS, instalar el Ironchip RADIUS server y probar el acceso.

RADIUS (Remote Authentication Dial-In User Service) es el protocolo de autenticación que usan las VPN, el wifi corporativo, los cortafuegos y la electrónica de red. Ironchip responde a las peticiones RADIUS del equipo y pide al usuario la aprobación en su dispositivo.

  • Una cuenta de administrador en la consola de Ironchip.
  • Un equipo que admita RADIUS y acceso a su configuración de servidores de autenticación.
  • Los usuarios dados de alta en Ironchip, o la sincronización de identidades configurada.

El primer paso es crear una aplicación Passwordless RADIUS en la consola de Ironchip, que te da una API key. El procedimiento general está en Aplicaciones con API key.

  1. Ve a Applications y haz clic en New application. Se abre la ventana Add new application.
  2. En el paso Select service type, sección Standard authentication protocols, elige Passwordless RADIUS.
  3. En el paso Configure service, pestaña General, escribe un nombre identificativo en Name (mínimo 3 caracteres) y haz clic en Add.
  4. En el paso Overview, copia la API KEY o haz clic en Download credentials para descargarla en el fichero credentials.json. La consola no vuelve a mostrarla.

Da acceso a la aplicación Passwordless RADIUS a los grupos o usuarios que se autenticarán por RADIUS, siguiendo Dar acceso a usuarios y grupos:

  1. En Applications, haz clic en Add, en la columna Add access de la aplicación.
  2. En Select a group, elige el grupo o el usuario. Cada acceso es para un solo grupo o usuario.
  3. En Select usernames, define en Username composition el nombre de usuario. Debe coincidir con el que el usuario escribe en el equipo protegido, por ejemplo en el cliente VPN.
  4. En Select authentication policies, elige las políticas de autenticación que se exigen.
  5. En Review, revisa el resumen y haz clic en Add.

Ironchip responde a las peticiones RADIUS con el Ironchip RADIUS server, un servicio para Windows y Linux que escucha por defecto en el puerto UDP 1812. En la consola lo tienes en Plugins, con la tarjeta Passwordless RADIUS de las secciones Windows Integrations y Linux Integrations. Su guía explica cómo:

  • descargar el ejecutable de la última versión;
  • crear el fichero de configuración ironchip_lbauth_radius_server.json con la API key (ironchip_api_secret) y el secreto compartido (radius_key);
  • instalarlo e iniciarlo como servicio con service install y service start;
  • añadir atributos a la respuesta RADIUS, por ejemplo los grupos del usuario.

Después, configura el equipo que quieres proteger (VPN, wifi, cortafuegos) para que use ese servidor: su dirección, el puerto 1812 y el mismo secreto compartido. Tienes ejemplos para productos concretos en las guías de integraciones, como WatchGuard.

El siguiente vídeo muestra el acceso a una VPN de WatchGuard con el Ironchip RADIUS server en funcionamiento.

En el vídeo se escribe una contraseña porque WatchGuard no permite dejar el campo vacío. El texto de ese campo puede ser aleatorio, como en los dos ejemplos del vídeo.

Acceso a una VPN de WatchGuard con el servidor RADIUS de IronchipReproducir el vídeo

TACACS+

Proteger la administración de switches, routers y cortafuegos con TACACS+: crear la aplicación, definir perfiles de autorización y configurar el dispositivo.

TACACS+ permite autenticar y autorizar a los administradores de dispositivos de red con Ironchip, y registrar sus sesiones y comandos. Ironchip actúa como servidor TACACS+.

  • Acceso a la consola de Ironchip con rol de administrador.
  • Un dispositivo de red compatible con TACACS+ (switches, routers, cortafuegos).
  • Conectividad desde el dispositivo hasta Ironchip por el puerto TCP 49.
  1. Ve a Applications y haz clic en New Application.
  2. En el primer cuadro, con el título Custom application, haz clic en Create application.
  3. Ponle un nombre identificativo, selecciona el tipo TACACS+ y haz clic en Add service.
  4. Completa estos campos:
    • Shared secret: el secreto compartido entre el dispositivo de red e Ironchip. Elige el que quieras, pero debe ser el mismo en el dispositivo y en la consola. Se recomienda un mínimo de 24 caracteres.
    • Devices: direcciones IP o rangos CIDR de los dispositivos autorizados a consultar al servidor TACACS+. Las peticiones de otros orígenes se rechazan.
    • Authentication method: método con el que se valida al administrador. Puedes elegir Ironchip (modelo passwordless), LDAP, RADIUS o certificado, según lo configurado en la validación centralizada.
    • Second factor: OTP o MFA de Ironchip, opcional u obligatorio.
  5. Haz clic en Save. Ironchip empieza a escuchar peticiones TACACS+ en el puerto TCP 49.

Los perfiles definen qué puede hacer cada administrador una vez autenticado.

  1. Ve a la aplicación creada, abre la pestaña Authorization y haz clic en New profile.
  2. Completa estos campos:
    • Name: nombre del perfil, por ejemplo network-admin o read-only.
    • Privilege level: nivel de privilegio, de 0 a 15, que se entrega al dispositivo.
    • Allowed commands: lista de comandos permitidos, con soporte de expresiones regulares.
    • Denied commands: lista de comandos denegados. Tiene prioridad sobre la lista de permitidos.
  3. Asigna cada perfil a un usuario o a un grupo de Ironchip.

Un usuario que pertenece a varios grupos recibe el perfil de mayor privilegio, salvo que definas otro orden de prioridad en Priority.

Todas las sesiones y los comandos ejecutados quedan registrados (accounting). Puedes consultarlos en el apartado Events de la consola o exportarlos mediante la exportación de eventos.

Configura el dispositivo para que use Ironchip como servidor TACACS+. Este es un ejemplo para un dispositivo con Cisco IOS:

Cisco IOS
aaa new-model
tacacs server ironchip
address ipv4 <IP de Ironchip>
port 49
key <secreto compartido>
aaa group server tacacs+ ironchip-group
server name ironchip
aaa authentication login default group ironchip-group local
aaa authorization exec default group ironchip-group local
aaa authorization commands 15 default group ironchip-group local
aaa accounting exec default start-stop group ironchip-group
aaa accounting commands 15 default start-stop group ironchip-group

Para comprobar la conectividad, ejecuta en el dispositivo:

test aaa group ironchip-group <usuario> <código OTP> legacy

Al conectar por SSH al dispositivo, el administrador introduce su usuario y, en el campo de contraseña, el segundo factor (por ejemplo, el código de un OTP). Si el método de autenticación es Ironchip, el dispositivo envía la petición al servidor TACACS+ de Ironchip, que valida al administrador, comprueba la localización y los factores configurados y devuelve el perfil de autorización correspondiente.

Algunos dispositivos no permiten dejar vacío el campo de contraseña. Cuando el método de autenticación es Ironchip, el texto de ese campo puede ser aleatorio.

API HTTP

Añadir la verificación de Ironchip a una aplicación de desarrollo propio con la API key de un servidor NPS: alta del servidor, aplicación y accesos.

La autenticación HTTP permite añadir la verificación de Ironchip a una aplicación de desarrollo propio: el backend llama a la API con una API key e Ironchip pide al usuario la aprobación en su dispositivo. Es una forma de soportar autenticaciones mediante llamadas HTTP estándar, sin SDK y desde cualquier lenguaje.

  1. El usuario intenta acceder a la aplicación propia.
  2. La aplicación hace una llamada HTTPS GET al endpoint de Ironchip con el identificador del usuario.
  3. Ironchip muestra al usuario el flujo de autenticación habitual (push, USB, NFC, etc.).
  4. Cuando el usuario termina, el endpoint devuelve la identidad validada.
  5. La aplicación usa esa respuesta para conceder o denegar el acceso.

La integración no modifica la lógica de autenticación que ya tiene la aplicación.

  • Una cuenta de administrador en la consola de Ironchip.
  • Acceso al código del backend de la aplicación que quieres proteger.
  • Los usuarios dados de alta en Ironchip, o la sincronización de identidades configurada.
  • La compañía creada en Ironchip. Consulta Protocolos de integración para los datos previos.

En la consola, este tipo de integración se crea como un servidor NPS: el servidor te da la API key y cada aplicación que cuelga de él tiene su propio identificador. El procedimiento general está en Servidores NPS (RADIUS).

  1. Ve a Applications y haz clic en New application. Se abre la ventana Add new application.

    Página Your applications con el botón New application

  2. En el paso Select service type, sección RADIUS NPS server configuration, haz clic en la tarjeta New NPS server.

  3. En la ventana Add RADIUS Server, escribe en Name un nombre reconocible para el servidor, de 3 a 60 caracteres, y haz clic en Add.

    Ventana Add RADIUS Server con el campo Name

  4. La ventana Credentials for your new RADIUS Servers muestra la API key del servidor. Cópiala o descárgala con Download credentials: por seguridad, no podrás volver a consultarla desde la consola. Es la API key que usará tu aplicación.

    Ventana Credentials for your new RADIUS Servers con la API key y el botón Download credentials

El servidor aparece como una tarjeta más en la sección RADIUS NPS server configuration.

  1. En el paso Select service type, haz clic en Assign policy en la tarjeta del servidor que acabas de crear.

  2. En el paso Configure service, pestaña General, escribe el nombre de la aplicación en Name.

  3. Abre la pestaña NPS. En NPS Server ya está elegido tu servidor. En Policy, escribe el identificador de la aplicación: tu aplicación lo envía en el parámetro service de sus llamadas, junto con la API key del servidor.

    Pestaña NPS con el servidor elegido en NPS Server y el campo Policy

  4. Haz clic en Add. El paso Overview no muestra ninguna clave: la aplicación usa la API key del servidor. La aplicación aparece en la sección Applications.

Sigue Dar acceso a usuarios y grupos. En resumen:

  1. En Applications, haz clic en Add, en la columna Add access de la aplicación. Se abre la ventana Add a new access.

  2. En Select a group, busca por nombre con Search by name, elige el grupo o el usuario que tendrá acceso y haz clic en Next. Cada acceso es para un solo grupo o usuario.

  3. En Select usernames, comprueba el formato del nombre de usuario en Username composition, por defecto el correo, y haz clic en Next.

  4. En Select authentication policies, elige las políticas de autenticación que se exigirán para acceder, por ejemplo Any user devices AND Any user safezones, y haz clic en Next.

  5. En Review, revisa el resumen y haz clic en Add.

El acceso queda creado con la configuración seleccionada. Puedes cambiarla en cualquier momento desde el menú Options del acceso, en la pestaña Accesses de la aplicación.

Contraseñas de un solo uso (OTP)

Crear, usar, proteger y eliminar OTP de Ironchip como segundo factor: códigos TOTP RFC 6238, protección con hardware seguro y control del ITDR.

Los OTP (contraseñas de un solo uso) de Ironchip generan códigos TOTP conformes al RFC 6238. Sirven como segundo factor en cualquier servicio protegido por Ironchip, y son compatibles con la aplicación Ironchip y con cualquier aplicación autenticadora que implemente ese estándar.

  • Acceso a la consola de Ironchip con rol de administrador.
  • La aplicación Ironchip (móvil o de escritorio) instalada en el dispositivo del usuario, o cualquier aplicación autenticadora compatible con RFC 6238.
  • Para la protección de la semilla: un dispositivo con TPM (Windows), Android Keystore, o Secure Enclave y Keychain en iOS.
  1. Abre la aplicación móvil de Ironchip y ve al apartado de la barra inferior con el icono de un candado con una flecha.

  2. Pulsa el botón + y selecciona una de estas opciones:

    • Scan a QR code: escanea con la cámara del teléfono el código QR del OTP.
    • Enter URL: introduce la URL de configuración del OTP.
    • Enter setup key: introduce manualmente la clave de configuración del OTP.

Una vez añadido, el OTP queda creado y la aplicación empieza a mostrar sus códigos.

La ventana de validez temporal del OTP se configura al generarlo y queda asociada a él. Para modificarla, elimina el OTP y crea uno nuevo con la ventana que quieras.

Una vez dado de alta, el usuario usa el OTP como segundo factor en cualquier servicio protegido por Ironchip, como el acceso a dispositivos de red mediante TACACS+, una VPN o una aplicación web.

Cuando el servicio pide el segundo factor, el usuario abre la aplicación, lee el código vigente y lo introduce. Ironchip lo calcula de nuevo a partir de la clave del OTP y lo valida, aceptando los periodos incluidos en la ventana de validez configurada al crearlo.

En el acceso por SSH a un dispositivo con TACACS+, el código se introduce en el campo de contraseña. Para comprobarlo desde el propio dispositivo, ejecuta:

test aaa group ironchip-group <usuario> <código OTP> legacy

La validación se rechaza en estos casos:

  • Código caducado: ha pasado su periodo y queda fuera de la ventana de validez, o el reloj del dispositivo está desfasado. Espera al siguiente código y comprueba que la hora del dispositivo es automática.
  • Código ya utilizado: cada código solo puede validarse una vez. Espera al siguiente código.
  • OTP eliminado: el OTP se ha eliminado de la aplicación. Da de alta un OTP nuevo.
  • Contexto sospechoso: el ITDR bloquea el intento por la localización, el dispositivo o el horario, aunque el código sea correcto.

Todas las validaciones, correctas o rechazadas, quedan registradas en Monitoring > Logs de la consola y pueden exportarse mediante la exportación de eventos.

Los OTP de Ironchip están protegidos frente a la clonación de tokens, el phishing y la reutilización de credenciales.

La generación de los códigos se apoya en el hardware seguro de cada plataforma. La clave del OTP nunca se almacena en claro y queda protegida por ese hardware, de modo que no puede copiarse a otro dispositivo:

  • Windows (aplicación de escritorio): TPM (Trusted Platform Module). La clave se cifra con una clave generada y protegida por el TPM, ligada al equipo, y no puede descifrarse fuera de él.
  • Android: Android Keystore, con StrongBox o TEE según el dispositivo. Es el equivalente al TPM en el teléfono: la clave que protege el OTP se genera dentro del hardware seguro y no es exportable.
  • iOS: Secure Enclave y Keychain. Es el equivalente al TPM en el iPhone: la clave que protege el OTP se genera en el Secure Enclave y el OTP se guarda en el Keychain, accesible solo en ese dispositivo y con el dispositivo desbloqueado.

Al estar ligado al dispositivo, el OTP no se transfiere con una copia de seguridad ni con la migración a otro teléfono. En ese caso, da de alta un OTP nuevo.

Además, el ITDR de Ironchip controla el uso de los OTP:

  • Anti-reutilización: un código ya utilizado dentro de su ventana de validez se rechaza y el intento queda registrado.
  • Anti-phishing: el ITDR evalúa la localización, el dispositivo, el horario y los patrones de uso de cada autenticación, y, según las reglas de ITDR > Ruleset, puede denegar el acceso o bloquear al usuario si el comportamiento es anómalo, aunque el código introducido sea correcto.
  • Anti-clonado: si el mismo OTP se usa desde contextos incompatibles, por ejemplo localizaciones distantes en un intervalo corto, el ITDR lo detecta y lo deja registrado en sus informes.

Puedes exportar estos eventos a tu SIEM mediante la exportación de eventos del ITDR.

  1. Abre la aplicación móvil de Ironchip y ve al apartado de la barra inferior con el icono de un candado con una flecha.
  2. Desliza el OTP hacia la izquierda y pulsa la papelera roja.

Una vez eliminado, la aplicación deja de mostrar los códigos de ese OTP.

Para reasignarlo a otro dispositivo, o para crear uno con otra ventana de validez, elimina el OTP anterior y da de alta uno nuevo en el dispositivo de destino siguiendo los pasos de Crear un OTP.

Validación centralizada

Validar certificados, LDAP, RADIUS y OTP/MFA desde un único punto: modos integrado y passthrough, configuración de cada servicio y política de autenticación.

Ironchip actúa como punto único de validación de certificados, LDAP, RADIUS y OTP/MFA. Esta página explica cómo configurar cada servicio y cómo combinarlos en una política de autenticación.

  • Acceso a la consola de Ironchip con rol de administrador.
  • Para el modo passthrough: conectividad desde Ironchip hasta los servidores LDAP, RADIUS u OTP existentes.
  • Para la validación de certificados: al menos una CA configurada en Ironchip o importada como CA de confianza.

Para cada servicio puedes elegir entre dos modos:

Servicio Modo integrado Modo passthrough
Certificados Validación con las CA de Ironchip, CRL y OCSP Validación contra CA externas de confianza y su CRL u OCSP
LDAP Directorio de usuarios y grupos de Ironchip Proxy LDAP hacia el directorio existente (Active Directory, OpenLDAP)
RADIUS Servidor RADIUS de Ironchip Reenvío de la petición a un servidor RADIUS externo
OTP/MFA Factores de Ironchip (aplicación móvil, llave FIDO2, OTP) Validación del código en un servidor OTP externo

Puedes combinar ambos modos. Por ejemplo, puedes validar el certificado del dispositivo con la CA integrada, el usuario contra tu Active Directory mediante passthrough y el segundo factor con Ironchip.

Ve a Settings, apartado Certificate validation, y configura:

  • Trusted CAs: CA integradas y CA externas que se consideran de confianza. Para añadir una CA externa, haz clic en Add trusted CA y carga su certificado.
  • Revocation check: OCSP, CRL o ambos. Se recomienda OCSP con CRL como respaldo.
  • On failure: qué hacer si no se puede consultar el estado de revocación. Selecciona Deny (recomendado) o Allow.
  • Mapping: campo del certificado que identifica al usuario o al dispositivo (CN, SAN o número de serie).

Desde ese momento, cualquier servicio que use la validación de certificados de Ironchip, como TACACS+, RADIUS con EAP-TLS o mTLS, comprueba la cadena, la vigencia y la revocación del certificado.

  1. Ve a Settings, apartado Directory, y haz clic en Add directory.
  2. Elige el modo:
    • Integrated: usa el directorio de usuarios y grupos de Ironchip, sincronizado con Entra ID o con Ironchip AD Connect.
    • Passthrough: usa el proxy LDAP para validar las credenciales directamente contra tu servidor LDAP, sin copiar los usuarios a Ironchip. Completa estos campos:
      • Server: dirección y puerto del servidor LDAP, por ejemplo ldaps://dc01.empresa.local:636.
      • Bind DN: cuenta de servicio con permisos de lectura.
      • Base DN: rama del directorio donde se buscan los usuarios.
      • User filter: filtro de búsqueda, por ejemplo (sAMAccountName={username}).
  3. Haz clic en Test connection para verificar el acceso y, después, en Save.

Ve a Settings, apartado RADIUS, y selecciona el modo:

  • Integrated: Ironchip actúa como servidor RADIUS mediante el servidor RADIUS de Ironchip, con soporte de PAP y EAP-TLS. Registra los dispositivos cliente en Clients con su dirección IP y su secreto compartido.
  • Passthrough: Ironchip recibe la petición y la reenvía a un servidor RADIUS externo, y mantiene el control de la política y del segundo factor. Completa estos campos:
    • Upstream server: dirección y puerto del servidor RADIUS externo.
    • Shared secret: secreto compartido con el servidor externo.
    • Timeout y retries: tiempo de espera y número de reintentos antes de considerar el servidor no disponible.

Ve a Settings, apartado MFA, y define qué factores están disponibles:

  • Ironchip: aplicación móvil, aplicación de escritorio, llave FIDO2 y OTP de Ironchip.
  • External OTP (passthrough): Ironchip pide el código al usuario y lo valida contra un servidor OTP externo mediante RADIUS. Indica la dirección del servidor y el secreto compartido.

En Enforcement, selecciona si el segundo factor es obligatorio, opcional o se exige solo cuando la localización o el contexto de la conexión sean de riesgo.

Cuando hayas configurado los servicios, define en qué orden se validan.

  1. Ve a Policies y haz clic en New policy.
  2. Selecciona la aplicación a la que se aplica, por ejemplo la aplicación TACACS+ o una VPN.

Una política habitual para el acceso de administradores es esta:

  1. Certificado de dispositivo válido, emitido por la CA de Ironchip.
  2. Usuario y grupo validados contra LDAP mediante passthrough.
  3. Segundo factor de Ironchip, obligatorio.

Si falla cualquiera de los pasos, la autenticación se rechaza y el motivo queda registrado en Events. Puedes exportar estos eventos a tu SIEM mediante la exportación de eventos del ITDR.

Integraciones

Integraciones

Guías paso a paso para integrar Ironchip con Windows, macOS, Linux, Entra ID, Microsoft 365, Google Workspace, Fortinet, Palo Alto y más de 30 productos.

Cualquier servicio compatible con OIDC, SAML o RADIUS puede protegerse con Ironchip. Estas guías recogen la configuración concreta de los productos más habituales entre nuestros clientes, agrupados por dónde se autentica el usuario.

Si el servicio admite OIDC, SAML o RADIUS, sigue la guía del protocolo correspondiente. Si no, la API HTTP permite añadir la verificación de Ironchip a cualquier aplicación.

Inicio de sesión en el equipo

Inicio de sesión en Windows

Protege el inicio de sesión de Windows, local y por RDP, con Ironchip: crea la aplicación, instala el plugin, despliégalo con GPO y personaliza la pantalla.

Ironchip Windows Logon añade un segundo factor al inicio de sesión de Windows, tanto local como remoto por RDP. Usa esta página para crear la aplicación en Ironchip, instalar el plugin en los equipos y desplegarlo de forma masiva.

  • Acceso a la consola de administración de Ironchip, con permisos en la compañía para crear aplicaciones y dar accesos.
  • Equipos con Windows 8 o posterior de 64 bits (x64 o ARM64).
  • Permisos de administrador en cada equipo donde instales el plugin.
  • Conectividad HTTPS con api.ironchip.com (o con el host de tu entorno).
  • El certificado raíz ISRG Root X1 de Let’s Encrypt entre las entidades de certificación de confianza del equipo. Consulta Certificado de Let’s Encrypt.

Crea una aplicación con API key de tipo Windows Logon.

  1. Ve a Applications > New application y elige la integración Windows Logon, en la sección Operating system security.

    Página Your applications con el botón New application

    Paso Select service type con la tarjeta Windows Logon en la sección Operating system security

  2. En la pestaña General, escribe un nombre descriptivo en Name y haz clic en Add. Este nombre aparece en el autenticador, así que te ayudará a identificar la aplicación.

    Nombre de la aplicación tal como aparece en el autenticador

    Pestaña General con el nombre de la aplicación

  3. En Overview, guarda la API key del campo API KEY, o descárgala con Download credentials. Solo se muestra en ese momento y la necesitarás al instalar el plugin. View installation guide abre las instrucciones de instalación del plugin.

    Paso Overview con la API key generada para la aplicación

Los accesos determinan qué grupo de usuarios puede autorizar el inicio de sesión y con qué políticas de autenticación. El procedimiento completo está en Dar acceso a usuarios y grupos.

  1. En Applications, haz clic en el nombre de la aplicación recién creada y, en la pestaña Accesses, haz clic en Add access.

    Lista de aplicaciones con la aplicación recién creada

    Página de la aplicación con la pestaña Accesses y el botón Add access

  2. En Select a group, selecciona el grupo que va a utilizar el servicio y haz clic en Next. Si aún no existe, créalo antes en Directory > Groups.

  3. En Select usernames, crea en Username composition la plantilla del nombre de usuario. Ironchip Logon trabaja por defecto con el formato SAM, así que la plantilla debe coincidir con equipo\usuario o con dominio\usuario. Por ejemplo:

    • Usuarios locales: nombre-del-equipo\usuario, como PC-prueba\prueba.
    • Usuarios del dominio: dominio\usuario, como SERVER0\prueba.

    Haz clic en Next.

    Paso Select usernames con la plantilla del nombre de usuario en Username composition

  4. En Select authentication policies, haz clic en + Select authentication policy y elige cómo tendrá que autorizar el usuario el inicio de sesión. Por ejemplo, con una notificación al móvil, un magic link o una tarjeta RFID. Haz clic en Next.

    Paso Select authentication policies con las políticas del acceso

  5. Revisa el resumen en Review y haz clic en Add. El resultado debe ser similar a este:

    Paso Review con el grupo, la plantilla del nombre de usuario y los factores de autenticación

  1. Descarga el plugin de Windows Logon desde la sección Plugins de la consola de administración de Ironchip. En la sección Logon, busca la tarjeta Windows Logon y haz clic en Download x64 o Download ARM, según la arquitectura del equipo. Los instaladores se llaman IronchipWindowsLogon_x64.msi e IronchipWindowsLogon_arm64.msi.

    Página Plugins con la tarjeta Windows Logon y los botones Download ARM y Download x64 en la sección Logon

  2. Ejecuta el instalador .msi en el equipo cuyo inicio de sesión quieres proteger.

  3. Haz clic en Next, acepta los términos de uso y vuelve a hacer clic en Next.

    Pantalla de bienvenida y términos de uso del instalador

  4. Elige los componentes a instalar:

    • Ironchip Logon instala el proveedor de credenciales de Ironchip y su filtro.
    • Offline instala el servicio OTP (Ironchip Offline Service) para el inicio de sesión sin conexión. Genera un código OTP que permite iniciar sesión cuando el equipo no tiene conexión a internet.

    Puedes cambiar las opciones de instalación con el desplegable que hay a la izquierda del nombre de cada componente. Haz clic en Reset para volver a los valores por defecto y, cuando estés conforme, en Next.

    Selección de componentes del instalador

  5. Rellena los dos campos. Ninguno puede quedar vacío.

    • Ironchip target host: la URL de la API. Déjala como está para producción (https://api.ironchip.com) y cámbiala solo si tu compañía está en otro entorno.
    • Ironchip application APIKEY: la API key que generaste al crear la aplicación.

    Haz clic en Validate para comprobar la configuración. Necesita conexión a internet, así que puedes omitirlo si instalas sin conexión.

    Pantalla de entorno y API key

  6. En Advanced configuration, indica con Enable remember user password during login si quieres recordar las credenciales de los usuarios que inicien sesión con el agente. Viene activada por defecto. Si la dejas activada, al iniciar sesión el usuario verá un botón para recordar sus credenciales y no volver a escribirlas.

    Opción de recordar las credenciales de los usuarios

  7. En Ironchip Logon scenarios, elige para cada escenario cómo protege el agente el equipo. Puedes activarlo en estos escenarios:

    • Logon (inicio de sesión): al iniciar sesión en el equipo.
    • Unlock (desbloqueo de sesión): al iniciar sesión en un equipo que se había bloqueado.
    • CredUI (escalada de privilegios): cuando Windows pide credenciales para elevar privilegios, por ejemplo con Ejecutar como administrador.
    • Password Change (cambio de contraseña): al cambiar la contraseña.

    Cada escenario tiene un desplegable con estas opciones:

    • None: deshabilita Ironchip en ese escenario.
    • Local and Remote, Only Remote u Only Local: aplica Ironchip en accesos locales y remotos por RDP, solo remotos o solo locales.
    • Las mismas tres opciones con (Exclude other providers): además, ocultan los demás proveedores de credenciales de Windows en ese escenario.

    Por defecto, los cuatro escenarios usan Local and Remote.

    Para que Ironchip sea el único método de inicio de sesión, consulta Usar Ironchip como único método de inicio de sesión.

    Escenarios de inicio de sesión que protege el agente

  8. Con todos los parámetros correctos, haz clic en Install.

    Pantalla de confirmación para iniciar la instalación

  9. Cuando termine la instalación, haz clic en Finish.

    Pantalla final de la instalación completada

Pantalla del instalador con la opción Change

Puedes instalar Ironchip Windows Logon de forma automatizada con msiexec.exe. Es lo más útil para despliegues masivos y configuraciones remotas.

  1. Pulsa Win + R, escribe cmd y pulsa Ctrl + Shift + Enter para abrir la consola como administrador. El instalador necesita permisos de administrador.

  2. Localiza la ruta completa del instalador de Ironchip, por ejemplo en la carpeta de descargas o en una unidad de red.

  3. Ejecuta el comando de instalación. El parámetro /i indica instalación y /q la hace en modo silencioso, sin interfaz gráfica.

    Ventana de terminal
    msiexec.exe /i "C:\Ruta\Al\Archivo\IronchipWindowsLogon_x64.msi" IRONCHIP_SECRET="<API_KEY>" IRONCHIP_REMEMBER_CREDENTIALS="1" CPUS_LOGON="0d" CPUS_UNLOCK="0d" CPUS_CREDUI="0d" CPUS_CHANGE_PASSWORD="0d" /q

La instalación puede tardar unos segundos. Como has usado /q, el terminal devuelve el control cuando termina.

La única propiedad obligatoria es IRONCHIP_SECRET. Las demás son opcionales y solo hace falta pasarlas para cambiar el valor por defecto. Si el equipo ya tenía Ironchip Logon instalado, las propiedades que no pases conservan el valor que tenían.

Propiedad Valor por defecto Descripción
IRONCHIP_SECRET Ninguno API key de la aplicación.
IRONCHIP_URL https://api.ironchip.com URL de la API. Cámbiala solo si tu compañía está en otro entorno.
IRONCHIP_REMEMBER_CREDENTIALS 1 1 permite recordar las credenciales al iniciar sesión; 0 lo desactiva.
CPUS_LOGON 0d Escenario de inicio de sesión. Valores en la tabla siguiente.
CPUS_UNLOCK 0d Escenario de desbloqueo de sesión.
CPUS_CREDUI 0d Escenario de elevación de privilegios (CredUI).
CPUS_CHANGE_PASSWORD 0d Escenario de cambio de contraseña.
IRONCHIP_TIMEOUT 5 Segundos de espera al comprobar la conexión con Ironchip.
IRONCHIP_TIMEOUTCP 60 Segundos que espera el agente a que el usuario autorice el acceso.
IRONCHIP_CACHE 1 1 guarda los usuarios que inician sesión para mostrarlos como mosaicos; 0 lo desactiva.
IRONCHIP_COMPANY_NAME Vacío Nombre de la empresa que se muestra en la pantalla de inicio de sesión.
IRONCHIP_COMPANY_LOGO_PATH Vacío Ruta del logotipo que se muestra en la pantalla de inicio de sesión.
IRONCHIP_LOG_LEVEL info Nivel de registro: error, warning, info o debug. Consulta Registros.

Los parámetros CPUS_* combinan un número (0 a 3) y una letra (e o d):

Valor Efecto
0 Aplica Ironchip en el acceso local y en el remoto (RDP).
1 Aplica Ironchip solo en los accesos remotos (RDP).
2 Aplica Ironchip solo en los accesos locales.
3 Deshabilita por completo el proveedor de credenciales de Ironchip.
e Permite solo Ironchip y deshabilita cualquier otro método de entrada.
d Permite que el usuario elija otros proveedores de credenciales.

Por ejemplo, CPUS_LOGON="0d" aplica Ironchip en accesos locales y remotos y permite otros proveedores.

En el instalador con asistente, estos valores corresponden a las opciones del desplegable de cada escenario: 3d es None, 0d es Local and Remote, 1d es Only Remote, 2d es Only Local, y 0e, 1e y 2e son las mismas opciones con (Exclude other providers).

Para usar el agente sin conexión, instala el componente Offline y configura el OTP de cada usuario. Inicia sesión en el equipo con ese usuario y abre el acceso directo Ironchip Offline Setup, que está en el escritorio y en la carpeta Ironchip del menú Inicio, o entra en localhost:10000 desde un navegador.

  1. Haz clic en Continuar y después en Generar mi clave.

    Pantalla inicial de la configuración sin conexión

  2. En Generar clave sin conexión, haz clic en Generar.

    Pantalla Generar clave sin conexión

    Botón Generar de la clave sin conexión

  3. Se muestra un código QR y la opción de introducir el código manualmente.

    Código QR y código manual para el OTP sin conexión

Para añadir el OTP al autenticador de Ironchip del móvil, elige una de estas dos opciones.

  1. Abre el autenticador de Ironchip en el móvil.

    Autenticador de Ironchip en el móvil

  2. Ve al apartado OTPs, abajo a la derecha.

    Apartado OTPs del autenticador

  3. Pulsa el botón +, elige Scan a QR code y escanea el QR. El OTP ya está disponible.

    Menú del botón más con la opción Scan a QR code

  1. En la pantalla del equipo, haz clic en Copiar código de texto en portapapeles.

    Botón para copiar el código de texto al portapapeles

  2. En el autenticador de Ironchip, ve a OTPs, pulsa + y elige Enter URL.

  3. Pega el código que copiaste.

    Campo Enter URL del autenticador con el código pegado

Una vez añadido el código, ya tienes disponible el inicio de sesión sin conexión con OTP. Guarda el QR o el código de texto: es la forma de iniciar sesión cuando el equipo no tiene internet.

OTP sin conexión disponible en el autenticador

Para iniciar sesión en Windows, escribe tu usuario y contraseña como siempre. Según las políticas del acceso, el usuario autoriza el inicio de sesión con una notificación en el móvil, un código recibido por SMS o un código OTP. El proceso tarda unos segundos y, al terminar, el usuario queda autorizado.

Inicio de sesión en Windows con Ironchip Windows LogonReproducir el vídeo

Para desplegar Windows Logon con una directiva de grupo (GPO) necesitas una herramienta que edite el MSI. Esta guía usa Orca, incluida en los componentes de Windows para desarrolladores de instaladores.

El fichero .mst contiene la configuración que se aplicará al instalar el MSI mediante la GPO.

  1. Descarga el instalador .msi que quieres transformar (IronchipWindowsLogon_x64.msi o IronchipWindowsLogon_arm64.msi), haz clic derecho en el archivo y elige Edit with Orca.

    Instalador MSI abierto en Orca

  2. En Orca, haz clic en Transform > New transform.

    Menú Transform de Orca con New transform

  3. Ve a Property y pon en las propiedades CPUS_ los valores que quieras aplicar en la instalación. Las opciones son las mismas que en la tabla de escenarios. Si una propiedad no aparece en la tabla, añádela como fila nueva, como se explica en el paso siguiente.

    Si trabajas en un entorno distinto de producción, edita también IRONCHIP_URL e indica la URL de la API del entorno correcto.

    Tabla Property de Orca con las propiedades CPUS

  4. Añade la API key: haz clic derecho y añade una fila nueva.

    Menú contextual de Orca para añadir una fila

  5. Llama a la propiedad IRONCHIP_SECRET y pon la API key en Value.

    Fila IRONCHIP_SECRET con la API key como valor

  6. Configura IRONCHIP_REMEMBER_CREDENTIALS, que activa la opción de recordar las credenciales tras el inicio de sesión: 1 para activarla o 0 para desactivarla. Si no aparece en la tabla, añádela como fila nueva.

    Propiedad IRONCHIP_REMEMBER_CREDENTIALS en Orca

  7. Haz clic en Transform > Generate Transform para guardar la configuración.

    Opción Generate Transform de Orca

Crea una carpeta compartida, guarda en ella el instalador y el .mst y compártela con todos con permisos de lectura.

Carpeta compartida con el instalador y el fichero de configuración

  1. En el servidor, abre Administración de directivas de grupo. Expande el nodo de tu dominio y, en la carpeta Dominios, elige Crear un GPO en este dominio y vincularlo aquí. Dale un nombre que describa lo que hace, haz clic en Aceptar y edítala con clic derecho en Editar.

    Creación de la GPO en la administración de directivas de grupo

  2. Ve a Computer Configuration > Policies > Software Settings > Software installation, haz clic derecho en Software installation y selecciona New > Package. Elige el .msi de la carpeta compartida que creaste al principio y haz clic en Open.

    Software installation en el editor de directivas

    Selección del instalador desde la carpeta compartida

  3. En la ventana siguiente, selecciona Avanzado y haz clic en OK.

    Ventana de método de implementación con la opción Avanzado

  4. En las propiedades de la política, selecciona Asignados (aunque ya aparezca marcada). Así se habilita Instalar esta aplicación al inicio de sesión, que también debes marcar.

    Propiedades de la política con Asignados marcado

  5. Ve a la pestaña Modificaciones y haz clic en Agregar.

    Pestaña Modificaciones de la política

  6. Elige el fichero .mst que generaste, desde la misma carpeta compartida en la que está el .msi, y haz clic en Open.

    Selección del fichero mst en la carpeta compartida

  7. Comprueba la ruta del fichero seleccionado y haz clic en OK.

    Ruta del fichero mst añadida a la política

  8. Vuelve a la configuración de la GPO e indica en qué equipos quieres que se instale Windows Logon.

    Filtrado de seguridad de la GPO

    Equipos seleccionados para la instalación

  9. Cierra Group Policy Management, abre una consola de comandos de Windows y ejecuta gpupdate /force.

  10. El servidor avisará de que no puede aplicar la política de instalación sin reiniciar y te ofrecerá hacerlo. Escribe Y y pulsa Enter: el sistema se reiniciará un minuto después. También puedes reiniciar el servidor desde el menú Inicio.

Después, Windows Logon aparecerá instalado en todos los equipos incluidos en la GPO.

Puedes eximir a una lista de usuarios de la autorización de Ironchip, por ejemplo cuentas de servicio, al distribuir Windows Logon con una GPO.

  1. En el servidor, abre Administración de directivas de grupo.

  2. Crea una GPO nueva con Crear un GPO en este dominio y vincularlo aquí. También puedes reutilizar la GPO con la que distribuyes la aplicación a un grupo de usuarios, como se explica en Crear la GPO.

  3. Edita la GPO. Ve a Configuración del equipo > Preferencias > Configuración de Windows > Registro, haz clic derecho y elige Nuevo > Elemento de registro.

  4. En la ventana que se abre, rellena estos valores en la pestaña General:

    • Acción: Actualizar
    • Subárbol: HKEY_LOCAL_MACHINE
    • Ruta de la clave: SOFTWARE\Classes\CLSID\{D2CBBFE7-22CC-4FF0-A7C4-8FCDCFB141B7}
    • Nombre de valor: ironchipExcludedUsers
    • Tipo de valor: REG_MULTI_SZ
    • Información del valor: un usuario por línea, con el formato DOMINIO\usuario o EQUIPO\usuario.

    Ironchip compara cada línea con el usuario que inicia sesión sin distinguir mayúsculas de minúsculas. La coincidencia es exacta: no admite comodines ni expresiones regulares. Si escribes un usuario sin dominio, se interpreta como un usuario local del equipo.

  5. Haz clic en Aplicar y en Aceptar.

Usar Ironchip como único método de inicio de sesión

Sección titulada «Usar Ironchip como único método de inicio de sesión»

Puedes excluir el proveedor de credenciales de contraseña de Windows para que los usuarios solo puedan autenticarse con Ironchip Windows Logon. La forma más sencilla es hacerlo al instalar el plugin, con el valor e de los escenarios CPUS_* o con una opción (Exclude other providers) del instalador: el filtro de credenciales de Ironchip oculta entonces los demás proveedores en ese escenario. Si no puedes volver a configurar el plugin, usa una directiva de grupo como se explica a continuación. Consulta Despliegue de agentes de inicio de sesión.

Si has configurado el inicio de sesión automático con Autologon de Sysinternals y no excluyes los demás proveedores, Windows muestra su proveedor predeterminado. Para que Ironchip sea el proveedor predeterminado:

  1. Pulsa Win + R, escribe gpedit.msc y pulsa Enter.
  2. Ve a Local Computer Policy > Computer Configuration > Administrative Templates > System > Logon y abre Assign a default credential provider.
  3. Habilita la directiva y escribe el GUID del proveedor de Ironchip: {D2CBBFE7-22CC-4FF0-A7C4-8FCDCFB141B7}.

Configurarlo en una política local o existente

Sección titulada «Configurarlo en una política local o existente»
  1. Ve a Editar directiva de grupo.
  2. Selecciona la carpeta Plantillas administrativas y después Sistema.
  3. Abre la carpeta Inicio de sesión y elige Excluir proveedores de credenciales.
  4. Cambia la opción de No configurada a Habilitada.
  5. En el campo Excluir los siguientes proveedores de credenciales, escribe el GUID del proveedor PasswordProvider.
  6. Haz clic en Aplicar y en Aceptar. La autenticación queda habilitada solo con Ironchip Windows Logon.
  1. En el servidor, abre Administración de directivas de grupo.
  2. Expande el nodo de tu dominio y, en la carpeta Dominios, elige Crear un GPO en este dominio y vincularlo aquí.
  3. Dale a la directiva un nombre que describa lo que hace y haz clic en Aceptar.
  4. Haz clic derecho en el nombre de la directiva y elige Editar.
  5. Ve a Directivas > Plantillas administrativas > Sistema > Inicio de sesión y elige Excluir proveedores de credenciales.
  6. Cambia la opción de No configurada a Habilitada.
  7. En el campo Excluir los siguientes proveedores de credenciales, escribe el GUID del proveedor PasswordProvider.
  8. Haz clic en Aplicar y en Aceptar. La autenticación queda habilitada solo con Ironchip Windows Logon.
  9. Cierra Administración de directivas de grupo, abre una consola de comandos de Windows y ejecuta gpupdate /force. Cuando el servidor ofrezca reiniciar, escribe Y y pulsa Enter, o reinicia el servidor desde el menú Inicio.

Tras el reinicio, la directiva se aplica a todos los equipos incluidos en la GPO.

Con el registro de Windows puedes personalizar la pantalla de inicio de sesión y ajustar el comportamiento del agente. Abre el editor del registro y ve a la clave Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Classes\CLSID\{D2CBBFE7-22CC-4FF0-A7C4-8FCDCFB141B7}. Solo los administradores y el sistema pueden leerla y modificarla.

Clave del registro de Ironchip Windows Logon en el editor

Valor Tipo Descripción
ironchipServers REG_SZ URL de la API de Ironchip.
ironchipSharedSecret REG_SZ API key de la aplicación. No la compartas.
ironchipServerTimeout REG_DWORD Segundos de espera al comprobar la conexión con Ironchip. Por defecto, 5.
ironchipTimeout REG_DWORD Segundos que espera el agente a que el usuario autorice el acceso. Por defecto, 60.
ironchipRememberCredentialsEnabled REG_DWORD 1 permite recordar las credenciales; 0 lo desactiva.
ironchipCacheEnabled REG_DWORD 1 guarda los usuarios que inician sesión para mostrarlos como mosaicos.
ironchipCachedUsers REG_MULTI_SZ Usuarios guardados.
ironchipExcludedUsers REG_MULTI_SZ Usuarios exentos de la autorización de Ironchip.
cpus_logon, cpus_unlock, cpus_credui, cpus_password REG_SZ Escenarios, con los valores de los escenarios.
companyName, companyLogoPath REG_SZ Nombre y logotipo de la empresa en la pantalla de inicio de sesión.
logLevel REG_SZ Nivel de registro. Por defecto, info.

companyLogoPath personaliza el logotipo que se muestra en la pantalla de inicio de sesión. Edita estos dos campos:

  • Nombre de valor: déjalo como está.
  • Información del valor: escribe la ubicación del logotipo de la empresa.

El logotipo debe cumplir estos requisitos:

  • Dimensiones de 512x512 px.
  • Extensión .bmp.
  • Menos de 1 MB.
  • 24 bits.

Valor companyLogoPath con la ruta del logotipo

companyName personaliza el nombre de la empresa que se muestra en la pantalla de inicio de sesión.

Valor companyName con el nombre de la empresa

Con los dos parámetros configurados, la pantalla de inicio de sesión muestra el logotipo y el nombre de tu empresa:

Pantalla de inicio de sesión de Windows con el logotipo y el nombre de la empresa

ironchipCachedUsers almacena los nombres de usuario para facilitar accesos futuros. Se activa con ironchipCacheEnabled.

Valor ironchipCachedUsers en el registro

ironchipExcludedUsers define una lista de usuarios exentos de autorización. Los usuarios incluidos aquí no necesitan una validación adicional al iniciar sesión en el equipo. Escribe un usuario por línea con el formato DOMINIO\usuario o EQUIPO\usuario. Para distribuirlo con una GPO, consulta Excluir usuarios de Ironchip con una GPO.

Sigue este procedimiento para cambiar claves del registro en varios equipos con directivas de grupo. El ejemplo cambia el nombre de la empresa.

  1. Abre el Administrador de directivas de grupo en el servidor y crea una GPO nueva en la unidad organizativa (OU) correspondiente.

    Creación de la GPO en la unidad organizativa

  2. En Filtrado de seguridad, añade los equipos o grupos a los que quieres aplicar la directiva.

    Filtrado de seguridad con los equipos o grupos añadidos

  3. Edita la GPO y ve a Configuración del equipo > Preferencias > Configuración de Windows > Registro.

    Ruta Preferencias, Configuración de Windows y Registro en el editor de la GPO

  4. Haz clic derecho en el panel derecho y selecciona Nuevo elemento de registro.

    Menú contextual con Nuevo elemento de registro

  5. Rellena el elemento:

    • Subárbol: HKEY_LOCAL_MACHINE
    • Ruta de la clave: SOFTWARE\Classes\CLSID\{D2CBBFE7-22CC-4FF0-A7C4-8FCDCFB141B7}
    • Nombre de valor: el valor a modificar, por ejemplo companyName.
    • Tipo de valor: REG_SZ
    • Información del valor: el nombre de la empresa tal como debe aparecer en pantalla.

    Propiedades del nuevo elemento de registro rellenadas

  6. En el equipo cliente, abre un símbolo del sistema o PowerShell con privilegios de administrador y ejecuta gpupdate /force.

  7. Haz clic en Aplicar y accede a uno de los equipos asignados para comprobar el resultado. El nombre de la empresa debería aparecer en la pantalla de inicio de sesión.

    Pantalla de inicio de sesión con el nombre de la empresa aplicado

  1. Crea una carpeta compartida en el servidor y guarda en ella la imagen corporativa. Concede permisos de lectura a los usuarios o grupos de equipos a los que se aplicará la directiva.

    Carpeta compartida con la imagen corporativa

  2. En la GPO correspondiente, ve a la sección Registro y crea un elemento nuevo con estos parámetros:

    • Subárbol: HKEY_LOCAL_MACHINE
    • Ruta de la clave: SOFTWARE\Classes\CLSID\{D2CBBFE7-22CC-4FF0-A7C4-8FCDCFB141B7}
    • Nombre de valor: companyLogoPath
    • Tipo de valor: REG_SZ
    • Información del valor: la dirección de red de la carpeta compartida con la imagen.

    Elemento de registro companyLogoPath con la dirección de red

  3. En el equipo cliente, abre un símbolo del sistema o PowerShell con privilegios de administrador y ejecuta gpupdate /force.

  4. Bloquea el equipo (Win + L) o cierra la sesión. La imagen corporativa debería aparecer en la pantalla de inicio de sesión de todos los equipos a los que se ha aplicado la directiva.

    Pantalla de inicio de sesión con la imagen corporativa

El proveedor de credenciales escribe sus registros en el Visor de eventos de Windows.

  1. Abre el Visor de eventos (eventvwr.msc).
  2. Ve a Registros de Windows > Aplicación.
  3. Busca los eventos del origen Ironchip Logon.

Para cambiar el nivel de detalle, modifica el valor logLevel de la clave del registro de Ironchip:

Valor Qué registra
error Solo errores.
warning Advertencias y errores.
info Información general de funcionamiento, advertencias y errores. Es el valor por defecto.
debug Información detallada de diagnóstico. No lo uses de forma habitual: genera muchos eventos.

La herramienta Ironchip Logon Diagnostic Tool comprueba si un equipo cumple los requisitos para Ironchip Windows Logon. Descarga IronchipLogonDiagnoseTool.exe de las versiones publicadas en GitHub y ejecútalo en el equipo. Muestra la versión de Windows, el usuario y el dominio, las dependencias de DLL, la versión de OpenSSL, si el certificado ISRG Root X1 está instalado y si el equipo se conecta con los servidores de Ironchip. Si Windows Logon está instalado, también usa su configuración para consultar las condiciones de acceso del usuario actual y enviarle una solicitud de autorización de prueba. Al terminar puedes guardar el informe en la carpeta Documentos.

Desde la versión 2.2.0, Windows Logon usa OpenSSL en lugar de Schannel para las comunicaciones. Esto mejora la compatibilidad con versiones antiguas de Windows (sobre todo Windows 8) y permite usar TLS 1.3.

Los servidores de Ironchip usan un certificado firmado por Let’s Encrypt, así que el equipo debe tener su certificado raíz ISRG Root X1 entre las entidades de certificación de confianza. Si falta, descárgalo de la documentación de Let’s Encrypt e instálalo en el almacén de entidades de certificación raíz de confianza del equipo.

Inicio de sesión en macOS

Protege con Ironchip el inicio de sesión, sudo y SSH en macOS mediante el módulo PAM: crea la aplicación MacOSX Logon y configura los archivos de /etc/pam.d.

Esta guía explica cómo instalar el servicio Mac Logon de Ironchip en un equipo macOS. Se basa en un módulo PAM que añade el segundo factor al inicio de sesión, a sudo o a SSH.

  • Acceso a la consola de administración de Ironchip.
  • Permisos de administrador sobre el dispositivo.
  • El archivo PAM de Ironchip, que te proporciona el equipo de Ironchip.

Crea una aplicación con API key de tipo MacOSX Logon y da acceso al usuario del Mac.

  1. En la consola de administración de Ironchip, ve a Applications y haz clic en New application.

  2. En Select service type, sección Operating system security, haz clic en MacOSX Logon.

    Paso Select service type con las tarjetas de Operating system security, entre ellas MacOSX Logon

  3. En la pestaña General, escribe el nombre de la aplicación en Name y haz clic en Add.

  4. En Overview, guarda en un lugar seguro la API key del campo API KEY, o descárgala con Download credentials: no se vuelve a mostrar. View installation guide abre las instrucciones de instalación.

    Ejemplo del paso Overview de una aplicación con API key, con el campo API KEY y el botón Download credentials

  5. Añade un acceso con el nombre de usuario de tu dispositivo Mac: en el paso Select usernames, escríbelo como texto fijo en Username composition. Consulta Dar acceso a usuarios y grupos.

    Paso Select usernames de la ventana Add a new access con la plantilla del nombre de usuario en Username composition

  6. Para conocer el nombre de usuario exacto, abre un terminal en el Mac y ejecuta whoami.

    Terminal con el resultado del comando whoami

  1. Descarga el archivo PAM en el equipo y cópialo en /opt/local/lib/pam.

    Ventana de terminal
    cp <ruta del archivo PAM> /opt/local/lib/pam

    Si la carpeta no existe, créala antes.

    Ventana de terminal
    mkdir /opt/local/lib/pam
  2. Ve a /etc/pam.d. Según lo que necesites proteger, añade una línea al principio de uno de estos archivos:

    Archivo Protege
    sudo La autenticación al ejecutar acciones de administrador, como sudo su o similares.
    authorization y screensaver La autenticación al iniciar la sesión del usuario.
    sshd La autenticación al establecer una conexión SSH.

    Archivos de la carpeta /etc/pam.d

  3. Edita uno de esos archivos y añade al principio la siguiente línea, con la API key de tu aplicación de Ironchip.

    auth required /opt/local/lib/pam/pam_ironchip_auth.so host=https://api.ironchip.com api_key=<API_KEY>
  4. Ejecuta este comando para deshabilitar la protección de software de desarrolladores no identificados solo para este archivo. Si no lo haces, macOS no permitirá ejecutar el archivo PAM.

    Ventana de terminal
    xattr -dr com.apple.quarantine <ruta del archivo PAM>

Para ver en directo los registros del módulo PAM de Ironchip, ejecuta en un terminal:

Ventana de terminal
log stream --predicate 'sender == "pam_ironchip_auth.so"' --level debug

Inicio de sesión en Linux

Añade Ironchip como segundo factor en Linux con el módulo PAM: crea la aplicación, instala pam_ironchip_auth.so y protege sudo, SSH o el inicio de sesión local.

Ironchip se integra en Linux mediante PAM (Pluggable Authentication Modules) y añade el segundo factor a servicios como sudo, SSH o el inicio de sesión local. Usa esta página para crear la aplicación, instalar el módulo y configurar PAM.

  • Acceso a la consola de administración de Ironchip.
  • Un usuario con permisos de administrador (root o sudo) en el equipo Linux.
  • Conectividad desde el equipo con la API de Ironchip (https://api.ironchip.com).
  • Un sistema Linux con PAM. Para macOS, consulta Inicio de sesión en macOS.

Crea una aplicación con API key de tipo Linux Logon.

  1. Ve a Applications y haz clic en New application.

    Página Your applications con el botón New application

  2. En Select service type, sección Operating system security, haz clic en Linux Logon.

    Paso Select service type con las tarjetas de Operating system security, entre ellas Linux Logon

  3. En la pestaña General, escribe un nombre descriptivo para la aplicación en Name y haz clic en Add.

    Nombre de la aplicación y botón Add

  4. En Overview, guarda la API key del campo API KEY, o descárgala con Download credentials: la necesitarás más tarde y no se vuelve a mostrar. View installation guide abre las instrucciones de instalación del plugin.

    Paso Overview con la API key de la aplicación

Crea un acceso para los usuarios que van a utilizar el servicio. El procedimiento completo está en Dar acceso a usuarios y grupos.

  1. En Applications, haz clic en Add, en la columna Add access de la aplicación. Se abre la ventana Add a new access.

  2. En Select a group, marca el grupo o el usuario que va a utilizar el servicio y haz clic en Next.

    Paso Select a group de la ventana Add a new access

  3. En Select usernames, define en Username composition un nombre de usuario que coincida con el del sistema Linux y haz clic en Next.

    Paso Select usernames con la plantilla del nombre de usuario en Username composition

  4. En Select authentication policies, haz clic en + Select authentication policy y elige las políticas que tiene que cumplir el usuario para acceder al equipo. Haz clic en Next.

    Paso Select authentication policies con las políticas del acceso

  5. En Review, revisa el resumen y haz clic en Add.

    Paso Review con el resumen del acceso

  1. Opcional: instala estas dependencias, que solo hacen falta en algunos casos.

    Ventana de terminal
    # Debian y Ubuntu
    sudo apt-get install libcurl4-openssl-dev libpam-dev uuid-dev
    # RHEL, AlmaLinux y CentOS
    sudo yum install curl-devel pam-devel libuuid libuuid-devel
  2. Crea una carpeta en una ubicación segura.

    Ventana de terminal
    mkdir /usr/local/lib/security
  3. Guarda en ella el archivo pam_ironchip_auth.so, que descargas en el apartado Plugins de la consola de Ironchip: sección Logon, tarjeta Linux Logon, botón Download.

    Ventana de terminal
    mv pam_ironchip_auth.so /usr/local/lib/security/

    Archivo pam_ironchip_auth.so copiado en la carpeta segura

Ve a /etc/pam.d y abre con un editor de texto uno de estos archivos, según las necesidades de la compañía. Los nombres pueden cambiar según la arquitectura del sistema.

Archivo Protege
sudo La autenticación en el comando sudo.
sshd La autenticación en el servicio SSH.
gdm-password El inicio de sesión en el equipo.
common-auth Todos los servicios anteriores.

gdm-password gestiona el inicio de sesión gráfico (GNOME Display Manager). common-auth centraliza la autenticación que importan servicios como sudo, login o sshd con la línea @include common-auth.

Añade esta línea con tus datos:

auth required <ruta absoluta de pam_ironchip_auth.so> host=https://api.ironchip.com api_key=<API_KEY>

La API key es la que guardaste al crear la aplicación.

Parámetro Obligatorio Descripción
host Sí URL del servidor de identidad de Ironchip, por ejemplo https://api.ironchip.com.
api_key Sí API key de la aplicación, usada en la autenticación.
offline_skip No Con offline_skip=true, si no hay conectividad con Ironchip el módulo se omite y PAM lo da por válido.
whitelisted_users No Usuarios separados por ; que omiten el módulo, por ejemplo whitelisted_users=root;ubuntu.

Exigir el segundo factor o aceptarlo como suficiente

Sección titulada «Exigir el segundo factor o aceptarlo como suficiente»

El verbo que uses en la línea auth decide cómo se combina Ironchip con el resto de módulos PAM:

  • required: el usuario debe superar este módulo como mínimo. Es la opción para que el segundo factor sea obligatorio.
  • sufficient: si el módulo se supera, PAM termina la autenticación con éxito de inmediato e ignora el resto de módulos.
auth required pam_ironchip_auth.so <opciones>
auth sufficient pam_ironchip_auth.so <opciones>

Esta configuración exige a la vez la clave pública y Ironchip como autenticación interactiva (keyboard-interactive).

  1. Abre el archivo de configuración principal de SSH con privilegios de administrador.

    Ventana de terminal
    sudo nano /etc/ssh/sshd_config
  2. Localiza y ajusta estos parámetros, o añádelos al final del archivo.

    /etc/ssh/sshd_config
    # Habilitar llaves y desactivar contraseñas simples
    PubkeyAuthentication yes
    PasswordAuthentication no
    # Forzar AMBOS: llave pública + Ironchip (keyboard-interactive)
    AuthenticationMethods publickey,keyboard-interactive
    # Configuración necesaria para que PAM (Ironchip) funcione
    UsePAM yes
    KbdInteractiveAuthentication yes # Ubuntu/Debian modernos
  3. Si tu sistema Linux no es Ubuntu o Debian, añade además esta línea.

    ChallengeResponseAuthentication yes

Para que el servidor SSH reconozca a Ironchip como método de autenticación interactiva, modifica la configuración de PAM. Así el sistema valida la identidad con Ironchip sin pedir además la contraseña tradicional de Linux.

  1. Abre el archivo que gestiona la autenticación del servicio SSH.

    Ventana de terminal
    sudo nano /etc/pam.d/sshd
  2. Añade esta línea al principio del archivo, para que sea el primer método que se evalúa en la fase interactiva.

    /etc/pam.d/sshd
    auth sufficient pam_ironchip_auth.so host=https://api.ironchip.com api_key=<API_KEY>

El servidor debe hacer peticiones salientes a api.ironchip.com para validar la identidad. En sistemas con SELinux habilitado, como RHEL, AlmaLinux o CentOS, el servicio SSH tiene restringido el acceso a la red por defecto, y eso bloquearía la comunicación con Ironchip.

Importa el módulo de política que permite al proceso de SSH establecer conexiones de red.

Ventana de terminal
semodule -i mi-sshdsession.pp

Guarda los archivos y reinicia el servicio SSH.

Ventana de terminal
# Sistemas con systemd (Ubuntu, Debian, RHEL 7+)
sudo systemctl restart sshd
# Verificar el estado del servicio
sudo systemctl status sshd

Con sufficient, el cliente SSH sigue mostrando el aviso de contraseña. El usuario puede escribir cualquier valor: no se valida si Ironchip ya ha aceptado la autenticación. Para que no se pregunte, añade PermitEmptyPasswords yes en /etc/ssh/sshd_config y reinicia sshd. Hazlo solo si usas el módulo como método sufficient. Si esperas un segundo factor (MFA), no cambies este parámetro.

  1. Mantén abierta una sesión de root y abre otra terminal.
  2. Ejecuta un comando que pase por PAM, por ejemplo sudo -k && sudo ls.
  3. Autoriza el acceso en Ironchip cuando te lo pida.
  4. Si protegiste SSH, abre una conexión nueva con el usuario configurado en Ironchip y autoriza el acceso.

Si algo falla, restaura la línea de PAM desde la sesión de root, que sigue abierta.

Protección del inicio de sesión en Linux con IronchipReproducir el vídeo

El módulo escribe sus registros en syslog. Consúltalos así:

Ventana de terminal
tail -f /var/log/auth.log

Para filtrar el inicio de sesión gráfico:

Ventana de terminal
tail -f /var/log/syslog | grep gdm-password

SSH sigue pidiendo la contraseña de Linux. Comprueba que UsePAM yes está en /etc/ssh/sshd_config y reinicia el servicio. Si quieres evitar el aviso con el método sufficient, consulta Aplicar los cambios.

En RHEL, AlmaLinux o CentOS, SSH no valida con Ironchip. Importa el módulo de política de SELinux de la sección Permitir la conexión con SELinux.

Despliegue de agentes de inicio de sesión

Despliega y mantén los agentes de inicio de sesión de Ironchip en Windows y Linux: GPO, MDM o instalación manual, proveedor único, actualizaciones y RDP.

Respuestas a las dudas habituales sobre cómo desplegar, configurar y actualizar los agentes de inicio de sesión de Ironchip en parques amplios de equipos Windows y Linux. Para la instalación paso a paso de cada agente, consulta Inicio de sesión en Windows, Inicio de sesión en Linux e Inicio de sesión en macOS.

Desplegar el agente de Windows Logon en muchos equipos

Sección titulada «Desplegar el agente de Windows Logon en muchos equipos»

Elige el método según tu entorno:

  • GPO (recomendado): distribuye el MSI mediante Group Policy a todos los equipos del dominio. El despliegue es silencioso, sin interacción del usuario.
  • MDM (Intune, SCCM): para entornos con herramientas de gestión de dispositivos.
  • Manual: para pilotos o grupos pequeños. No se recomienda para despliegues masivos.

El instalador MSI oficial está en las versiones publicadas en GitHub. Hay un instalador para equipos x64 (IronchipWindowsLogon_x64.msi) y otro para equipos ARM64 (IronchipWindowsLogon_arm64.msi). Las propiedades que admite el instalador están en Inicio de sesión en Windows.

Página de versiones del instalador de Windows Logon en GitHub

Hacer que Ironchip sea el único proveedor de credenciales

Sección titulada «Hacer que Ironchip sea el único proveedor de credenciales»

En el instalador, que también puedes configurar con un fichero .mst desplegado mediante GPO, elige una opción (Exclude other providers) en cada escenario (valor e en las propiedades CPUS_*). Con ella:

  • Ironchip pasa a ser el único credential provider de Windows en ese escenario.
  • El segundo factor es obligatorio en cualquier inicio de sesión.
  • Desaparece el riesgo de saltarse el segundo factor usando el credential provider nativo de Windows.

Ironchip publica las nuevas versiones en las versiones de GitHub. Distribuye el nuevo MSI mediante GPO o MDM. Al instalar el MSI nuevo sobre el existente, el agente se actualiza y conserva su configuración y los usuarios guardados. No se puede instalar una versión anterior sobre una más reciente. Antes de desplegarlo en producción, espera a que Ironchip confirme que la versión está validada.

Compatibilidad con software de gestión de credential providers

Sección titulada «Compatibilidad con software de gestión de credential providers»

Puede haber incompatibilidades. Se ha documentado un caso en el que la configuración de un software de terceros interfería con el credential provider de Ironchip y permitía saltarse el segundo factor. Ironchip lo corrigió en la versión 2.3.2 de Windows Logon.

Si detectas una incompatibilidad con software de terceros, repórtala al soporte de Ironchip con capturas o un vídeo del comportamiento.

Hay dos opciones:

  • Windows Logon en el equipo de destino: protege la sesión RDP directamente. Elige Local and Remote u Only Remote en el escenario Logon del instalador (valores 0 y 1 de CPUS_LOGON).
  • RD Gateway con RADIUS: Ironchip actúa como segundo factor en el Gateway y protege todas las conexiones RDP que pasan por él. Consulta Escritorio remoto de Windows (RDP).

Hay clientes que usan Ironchip tanto con RDP directo como con una VPN de Citrix combinada con RDP.

En Linux, Ironchip se integra mediante PAM (Pluggable Authentication Modules). Añade el segundo factor de Ironchip a cualquier servicio de Linux que use PAM, como SSH, sudo, su o el inicio de sesión local. Es especialmente útil en servidores de producción, bastiones y entornos de desarrollo. Los pasos están en Inicio de sesión en Linux.

Escritorio remoto y servidores

Escritorio remoto de Windows (RDP)

Protege el Escritorio remoto de Windows con Ironchip: configura RD Gateway, las políticas RD CAP y RD RAP, el plugin NPS y limita RDP al acceso por Gateway.

RDP (Remote Desktop Protocol) es el protocolo que permite la comunicación entre un terminal y un servidor Windows para ejecutar aplicaciones de forma remota. Esta guía protege RDP con Ironchip mediante RD Gateway y un servidor NPS protegido por Ironchip.

  • Un Directorio Activo funcional.
  • Servicios DHCP y DNS activos.
  • RDP instalado en el servidor.
  • NPS protegido por Ironchip. Consulta Microsoft NPS.
  • El servidor NPS de Ironchip cuya API key usa el plugin, creado al proteger NPS. Consulta Servidores NPS (RADIUS).

Si ya tienes un dominio de Active Directory con DHCP y DNS, y RDP habilitado en el servidor y en los clientes, salta a Configuración en Ironchip. Si no, prepara el entorno así.

  1. En Administrador del servidor, abre Agregar roles y características y añade estos roles:

    • Servicios de dominio de Active Directory.
    • Servidor DHCP.
    • Servidor DNS.
  2. Haz clic en Siguiente hasta el final. Aparece una barra de progreso.

  3. De vuelta en la página principal del Administrador del servidor, comprueba que los tres roles aparecen en el menú de la izquierda. En el menú superior aparecen también dos alertas.

  4. Haz clic en la primera alerta, Promover este servidor a controlador de dominio.

  5. Selecciona Agregar un nuevo bosque y escribe el nombre de dominio que quieras.

  6. Sigue los pasos hasta el final y haz clic en Instalar. Al terminar aparece otra alerta sobre el DNS, que resolverás más adelante.

  1. Haz clic en la segunda alerta para aplicar la configuración por defecto y en Siguiente hasta el final.
  2. Abre DHCP desde las herramientas administrativas.
  3. Haz clic derecho en IPv4, selecciona Ámbito nuevo… y escribe un rango de IP, por ejemplo de 192.168.11.50 a 192.168.11.100. Deja el resto de opciones por defecto y haz clic en Finalizar.
  4. Haz clic derecho en el nombre del servidor, dentro de DHCP, y en Autorizar. Al actualizar la página, el icono de IPv4 pasa de rojo a verde.

Añade un reenviador:

  1. Abre DNS desde las herramientas administrativas.
  2. Haz clic derecho en el servidor y selecciona Propiedades.
  3. En la pestaña Reenviadores, añade los servidores DNS externos que necesites, como 8.8.8.8 y 8.8.4.4.

Habilita RDP en el servidor y en el equipo cliente:

  • Equipo cliente: desde Inicio, abre la configuración para desarrolladores y permite las conexiones remotas.
  • Servidor, si lo anterior no funciona: en el Administrador del servidor, abre Servidor local. Entre las propiedades verás Escritorio remoto. Haz clic en Deshabilitado, selecciona Permitir las conexiones remotas con este equipo y haz clic en Aplicar. Después haz clic en Seleccionar usuarios… y elige los usuarios que podrán acceder al servidor.

Después, une el equipo cliente al dominio:

  1. Haz clic derecho en Este equipo y, en Configuración de nombre, dominio y grupo de trabajo, haz clic en Cambiar configuración.
  2. Escribe el nombre del equipo y el dominio al que pertenece.
  3. Cuando aparezca el inicio de sesión de Active Directory, escribe el usuario y la contraseña del Directorio Activo.
  4. Reinicia el equipo e inicia sesión con Otro usuario, con el mismo usuario y contraseña que escribiste en Active Directory.
  5. Abre una conexión RDP con Conexión a Escritorio remoto. Te pedirá las credenciales del administrador.

Crea una aplicación del servidor NPS para la política RD CAP y da acceso a los usuarios. Los detalles están en Servidores NPS (RADIUS).

  1. Ve a Applications y haz clic en New application. En la sección RADIUS NPS server configuration, haz clic en Assign policy en la tarjeta del servidor NPS.

  2. En la pestaña General, escribe el nombre de la aplicación en Name.

  3. En la pestaña NPS, comprueba que NPS Server tiene seleccionado el servidor y escribe en Policy el nombre de la política RD CAP que crearás en Windows (en esta guía, IronchipCAP). Haz clic en Add.

    Pestaña NPS con el servidor seleccionado en NPS Server e IronchipCAP en Policy

  4. Da acceso a la aplicación a los usuarios o grupos que se conectan por RDP. En Username composition, define la plantilla para que el nombre de usuario tenga el formato Dominio\Usuario. Consulta Dar acceso a usuarios y grupos.

Crear la aplicación en Ironchip y añadir usuarios para RDPReproducir el vídeo
  1. En el Administrador del servidor, ve a Servicios de Escritorio remoto.

    Servicios de Escritorio remoto en el Administrador del servidor

  2. Haz clic en el botón Puerta de enlace de Escritorio remoto.

    Botón Puerta de enlace de Escritorio remoto

  3. Selecciona el servidor en el que instalarás el servicio. En la pantalla siguiente, escribe el nombre de dominio completo.

    Selección del servidor y nombre de dominio completo

  4. Haz clic en Siguiente y después en Agregar.

  5. Cuando termine el proceso, Windows te pide configurar un certificado. Este ejemplo usa un certificado autofirmado.

    Configuración del certificado de RD Gateway

  6. Si no tienes un certificado, haz clic en Crear nuevo certificado.

    Opción para crear un certificado nuevo

  7. Escribe el nombre de dominio completo, una contraseña y una ruta para guardar el certificado, y marca la casilla del final. Haz clic en Aceptar y después en Aplicar.

    Formulario de creación del certificado

  8. Añade el mismo certificado a todos los servicios de la lista seleccionándolo.

Crear o cambiar el certificado de RD Gateway

Sección titulada «Crear o cambiar el certificado de RD Gateway»

Si ya tienes RD Gateway instalado, o quieres crear el certificado más tarde, hazlo desde el administrador:

  1. En Herramientas, ve a Servicio de Escritorio remoto y selecciona Administración de la Puerta de enlace de Escritorio remoto.

    Menú de herramientas con la administración de la Puerta de enlace de Escritorio remoto

  2. Haz clic derecho en el servidor, abre Propiedades y ve a la pestaña SSL Certificate.

    Pestaña SSL Certificate de las propiedades del servidor

  3. Selecciona Crear un certificado autofirmado y haz clic en Crear e importar certificado… y en Aceptar. El certificado se guarda en la carpeta Documentos del equipo.

    Opción para crear un certificado autofirmado

Copia el certificado a todas las máquinas, el propio servidor y los clientes, e instálalo en cada una con el mismo proceso:

  1. Haz clic derecho en el certificado.
  2. Selecciona Instalar certificado.
  3. Selecciona Máquina local y haz clic en Siguiente.
  4. Selecciona Colocar todos los certificados en el siguiente almacén y haz clic en Examinar….
  5. En la ventana que se abre, selecciona la carpeta Autoridades de certificación raíz de confianza y haz clic en Aceptar.
  6. Haz clic en Siguiente y en Finalizar.
  1. En el administrador de la puerta de enlace de Escritorio remoto, selecciona tu servidor y crea una directiva nueva con clic derecho en Directivas.

    Menú contextual para crear una directiva nueva

  2. Selecciona Crear una CAP de RD y una RAP de RD.

    Asistente con la opción de crear RD CAP y RD RAP

  3. Ponle un nombre identificativo. El nombre de la política RD CAP (aquí, IronchipCAP) debe ser el mismo que escribiste en Policy al crear la aplicación en la consola de Ironchip.

    Nombre de la política RD CAP

  4. Añade los grupos de usuarios del dominio a los que se aplicará la directiva: haz clic en Agregar grupo…, después en Opciones avanzadas… y en Buscar ahora para ver todos los grupos que puedes seleccionar.

    Grupos de usuarios de la directiva RD CAP

  5. En la pestaña siguiente, selecciona la primera opción y marca la casilla del final, Permitir solamente conexiones de cliente a servidores host de sesión de Escritorio remoto que apliquen la redirección de dispositivos de Puerta de enlace de Escritorio remoto. Las demás opciones no son necesarias: haz clic en Siguiente hasta llegar a la directiva de autorización de recursos.

    Opciones de la directiva RD CAP

  6. Ponle un nombre identificativo a la directiva de autorización de recursos.

    Nombre de la directiva de autorización de recursos

  7. Añade los grupos de usuarios del dominio a los que se aplicará, con el mismo procedimiento.

    Grupos de usuarios de la directiva RD RAP

  8. Selecciona la última opción, Permitir que los usuarios se conecten a cualquier recurso de red. La opción siguiente no es necesaria: haz clic en Siguiente hasta finalizar.

    Opción para permitir la conexión a cualquier recurso de red

  1. Abre Administración de directivas de grupo, haz clic derecho en tu servidor y selecciona Crear un GPO en este dominio y vincularlo aquí.

    Menú contextual para crear un GPO y vincularlo

  2. Escribe un nombre, por ejemplo Ironchip.

  3. Haz clic derecho en el GPO creado y selecciona Editar.

  4. En el Editor de administración de directivas de grupo, ve a Configuración de usuario > Directivas > Plantillas administrativas > Componentes de Windows > Servicio de Escritorio remoto > Puerta de enlace de Escritorio remoto.

    Ruta hasta la Puerta de enlace de Escritorio remoto en el editor del GPO

  5. Selecciona Método de autenticación de RD Gateway, actívalo con Habilitado y elige Solicitar credenciales, usar protocolo de negociación. En un Windows en inglés, como el de la captura, la directiva es Set RD Gateway authentication method y la opción, Ask for credentials, use Negotiate protocol.

    Método de autenticación de RD Gateway habilitado

  6. Selecciona Habilitar conexión a través de RD Gateway y actívalo con Habilitado.

  7. Selecciona Establecer dirección del servidor de puerta de enlace de RD, actívalo con Habilitado e introduce la dirección de tu servidor, por ejemplo 10.0.0.2.

  8. Ejecuta gpupdate en PowerShell en todas las máquinas relacionadas.

Si todavía no has instalado el plugin NPS, sigue Instalar el plugin NPS. Después, añade al plugin las políticas que has creado:

  1. Ejecuta de nuevo el instalador del plugin y haz clic en Change.

  2. En NPS Policies, añade la política de red protegida por Ironchip y la RD CAP, separadas por comas.

    Instalador del plugin NPS con varias políticas en el campo NPS Policies

  3. Reinicia los servicios NPS y RDP.

Necesitas un equipo cliente conectado al dominio. Sigue los pasos del vídeo.

Comprobar el acceso por RDP protegido con IronchipReproducir el vídeo Tutorial completo de RDP con IronchipReproducir el vídeo

Configura el firewall del servidor para que solo acepte conexiones RDP a través de la puerta de enlace.

  1. Abre Windows Defender Firewall con seguridad avanzada.

    Menú de inicio con Windows Defender Firewall con seguridad avanzada

  2. Ve a Reglas de entrada y busca Escritorio remoto - Modo usuario (TCP de entrada) y Escritorio remoto - Modo usuario (UDP de entrada).

    Reglas de entrada de Escritorio remoto en modo usuario

  3. Abre la regla TCP. Las dos configuraciones son iguales:

    1. En la pestaña General, activa Bloquear la conexión.
    2. En la pestaña Ámbito, añade la IP de tu servidor en Dirección IP local.
    3. Aplica los cambios.

    Pestaña General de la regla con Bloquear la conexión

    Pestaña Ámbito de la regla con la IP local del servidor

  4. Repite los pasos anteriores con la regla UDP.

Escritorios virtuales (VDI)

Usa una misma identidad de Ironchip Authenticator en varios equipos del dominio con una carpeta compartida: instalación por terminal, enrolamiento y pruebas.

En entornos de escritorios virtuales (VDI), Ironchip Authenticator puede guardar la identidad en una carpeta compartida para que el mismo usuario la use desde distintos equipos del dominio sin volver a enrolarse. Esta página explica cómo preparar la carpeta, instalar el autenticador y probarlo.

  • Equipos unidos al dominio.
  • Una carpeta compartida accesible mediante una ruta UNC.
  • El usuario debe tener permisos de lectura y escritura sobre la carpeta compartida.
  • Conectividad con el servidor donde se encuentra el recurso compartido.
  1. Crea en el servidor la carpeta que se usará como recurso compartido.
  2. Compártela con los usuarios que vayan a utilizar la identidad de Ironchip y comprueba que tienen permisos de lectura y escritura.

La ruta de acceso al recurso tiene este formato:

\\<servidor>\<recurso>

Carpeta compartida en el servidor con la ruta UNC

Descarga IronchipWindowsAuthenticator.msi como se explica en Instalación del autenticador en Windows e instálalo desde un terminal con este comando:

Ventana de terminal
msiexec.exe /i IronchipWindowsAuthenticator.msi IRONCHIP_HOST="https://<host-api>" ADDLOCAL="AuthenticatorFeature" IRONCHIP_REMOTE_PATH="\\<servidor>\<recurso>" /qb
Parámetro Descripción
IRONCHIP_HOST URL de la API de Ironchip (https://api.ironchip.com por defecto).
ADDLOCAL Componente a instalar (AuthenticatorFeature, sin soporte USB).
IRONCHIP_REMOTE_PATH Ruta UNC de la carpeta compartida.
/qb Ejecuta la instalación mostrando solo la interfaz básica del instalador.

Usa dos equipos para comprobar que la identidad se puede utilizar desde diferentes equipos del dominio.

  1. Instala y configura Ironchip Authenticator en el Equipo 1.
  2. Enrola el Authenticator con el usuario correspondiente.
  3. Cuando termine el enrolamiento, se genera la identidad en la carpeta compartida.
  4. Configura el Equipo 2 con la misma configuración y mantenlo unido al dominio.
  5. Inicia sesión en el Equipo 2 con el mismo usuario que usaste en el primer enrolamiento.
  6. Abre Ironchip Authenticator.

Desde el Equipo 1, enrola Ironchip Authenticator.

Enrolamiento de Ironchip Authenticator en el Equipo 1

Al terminar, abre la carpeta compartida: contiene una carpeta nueva con la identidad que acabas de crear.

Carpeta compartida con la carpeta de la identidad creada

Con la identidad creada, puedes usarla desde el Equipo 2 sin enrolarte de nuevo. El Equipo 2 debe:

  • Estar unido al mismo dominio.
  • Tener instalado y configurado Ironchip Authenticator.
  • Usar el mismo usuario con el que se hizo el primer enrolamiento.
  • Tener acceso a la carpeta compartida.

Al abrir Ironchip Authenticator en el Equipo 2, la aplicación accede a la identidad almacenada en el recurso compartido y muestra la misma identidad que se enroló en el Equipo 1.

Ironchip Authenticator en el Equipo 2 mostrando la identidad enrolada

Así, la identidad queda disponible para el mismo usuario en distintos equipos del dominio, sin enrolarse de nuevo en cada uno.

HashiCorp Boundary

Integra Ironchip con HashiCorp Boundary por OIDC para iniciar sesión sin contraseña: crea el método de autenticación, la aplicación OIDC y prueba el acceso.

Esta guía integra Ironchip con Boundary para añadirle una capa de seguridad con el inicio de sesión sin contraseña de Ironchip, mediante OIDC.

  • Un Boundary desplegado.
  • Acceso a la consola de administración de Ironchip.
  1. Ve a Auth Methods.

    Menú de métodos de autenticación de Boundary

  2. Haz clic en New y elige OIDC para crear un método de autenticación nuevo.

    Creación de un método de autenticación OIDC

  3. Ponle un nombre identificativo. En Client ID y Client Secret escribe cualquier valor para que te deje guardar: los modificarás más adelante.

    Nombre del método y valores provisionales de Client ID y Client Secret

  4. En API URL Prefix, escribe la dirección de acceso a Boundary. Al guardar, Boundary te devuelve una URL que usarás en Ironchip.

    Campo API URL Prefix con la dirección de Boundary

Crea una aplicación OIDC con la URL que obtuviste en Boundary.

  1. En la consola de Ironchip, ve a Applications y haz clic en New application.

  2. En Select service type, sección Standard authentication protocols, haz clic en OIDC.

  3. En la pestaña General, escribe el nombre de la aplicación en Name.

  4. En la pestaña Redirect URIs, escribe en Redirect URL la URL que te devolvió Boundary.

    Pestaña Redirect URIs con el campo Redirect URL

  5. Haz clic en Add.

  6. En Overview, copia Client ID, Client Secret y Metadata URL, o descárgalos con Download credentials. No se vuelven a mostrar.

    Paso Overview de la aplicación OIDC con Client ID, Client Secret, Metadata URL y el botón Download credentials

  7. Da acceso a la aplicación a los usuarios que quieras. Consulta Dar acceso a usuarios y grupos.

  1. De vuelta en el método de autenticación de Boundary, introduce los datos de Ironchip en los campos correspondientes:

    • Issuer: la Metadata URL sin /.well-known/openid-configuration al final, por ejemplo https://idp.ironchip.com/oidc.
    • Client ID y Client Secret: los de la aplicación de Ironchip.

    Campos Issuer, Client ID y Client Secret del método OIDC en Boundary

  2. Añade los campos restantes en su lugar correspondiente:

    • Signing Algorithms: RS256.
    • Claims Scopes: email, groups y profile.
    • Account Claim Maps: email a email y external_username a name.

    Signing Algorithms, Claims Scopes y Account Claim Maps del método OIDC en Boundary

  1. Cierra sesión en Boundary y vuelve a iniciarla con la opción de Ironchip.

  2. Escribe las credenciales del usuario que añadiste a la aplicación de Ironchip.

  3. Autoriza el acceso con la notificación de la app móvil o de escritorio.

    Inicio de sesión en Boundary con la opción de Ironchip

    Notificación de autorización de Ironchip

Si quieres que ese usuario tenga permisos en Boundary, añade sus credenciales al administrador de Boundary.

Integración de Ironchip con BoundaryReproducir el vídeo

La máquina Docker no resuelve el dominio ironchip.com. Añade el dominio al archivo /etc/hosts de la máquina que resuelve el dominio.

Al comprobar el issuer aparece https://idp.ironchip.com/oidc/ y da un error. Elimina la / del final.

HashiCorp Vault

Integra Ironchip con HashiCorp Vault mediante OIDC: crea la aplicación en Ironchip, habilita el método de autenticación oidc y define las políticas y los roles.

Esta guía configura HashiCorp Vault para que los usuarios inicien sesión con Ironchip mediante OIDC. Incluye la aplicación en Ironchip, el método de autenticación en Vault y las políticas y roles de usuario y de administrador.

  • Acceso a la consola de administración de Ironchip.
  • Un usuario con permisos para realizar la configuración en Vault.

Crea una aplicación OIDC con las URIs de redirección de Vault.

  1. En la consola de Ironchip, ve a Applications y haz clic en New application. Se abre la ventana Add new application.

  2. En Select service type, sección Standard authentication protocols, haz clic en OIDC.

  3. En la pestaña General, escribe el nombre de la aplicación en Name.

  4. En la pestaña Redirect URIs, escribe la primera URI en Redirect URL y añade la segunda con el icono +:

    • http://<host-de-tu-servicio>:8250/oidc/callback
    • http://<host-de-tu-servicio>:8200/ui/vault/auth/oidc/oidc/callback

    Pestaña Redirect URIs con el campo Redirect URL y el icono + para añadir otra dirección

  5. Haz clic en Add.

  6. En Overview, copia Client ID y Client Secret, o descárgalos con Download credentials. La Metadata URL también aparece aquí.

    Paso Overview de la aplicación OIDC con Client ID, Client Secret, Metadata URL y el botón Download credentials

  7. Da acceso a la aplicación a los usuarios que iniciarán sesión en Vault. Consulta Dar acceso a usuarios y grupos.

  1. En la pestaña de acceso (Access), crea un nuevo método de autenticación oidc.

    Pestaña Access de Vault con la opción de crear un método de autenticación

  2. Introduce la ruta oidc, habilita List method when unauthenticated y haz clic en el botón para habilitar el método.

    Habilitación del método oidc con la ruta oidc

  3. En la configuración de OIDC, rellena estos parámetros:

    • OIDC discovery url: https://idp.ironchip.com/oidc
    • Default role: demo
    • OIDC response mode: query

    Parámetros de discovery url, default role y response mode

  4. Rellena también estos dos campos con los datos que devolvió Ironchip al crear la aplicación:

    • OIDC client ID: el ID de cliente.
    • OIDC client secret: el secreto del cliente.

    Campos OIDC client ID y OIDC client secret

  5. Haz clic en guardar. El nuevo método de autenticación oidc queda creado.

En la pestaña de políticas, si no hay ninguna política default definida, créala con este contenido. Es la política de los usuarios ordinarios, que no tendrán acceso a la pestaña de políticas.

Política default
# Allow tokens to look up their own properties
path "auth/token/lookup-self" {
capabilities = ["read"]
}
# Allow tokens to renew themselves
path "auth/token/renew-self" {
capabilities = ["update"]
}
# Allow tokens to revoke themselves
path "auth/token/revoke-self" {
capabilities = ["update"]
}
# Allow a token to look up its own capabilities on a path
path "sys/capabilities-self" {
capabilities = ["update"]
}
# Allow a token to look up its own entity by id or name
path "identity/entity/id/{{identity.entity.id}}" {
capabilities = ["read"]
}
path "identity/entity/name/{{identity.entity.name}}" {
capabilities = ["read"]
}
# Allow a token to look up its resultant ACL from all policies. This is useful
# for UIs. It is an internal path because the format may change at any time
# based on how the internal ACL features and capabilities change.
path "sys/internal/ui/resultant-acl" {
capabilities = ["read"]
}
# Allow a token to renew a lease via lease_id in the request body; old path for
# old clients, new path for newer
path "sys/renew" {
capabilities = ["update"]
}
path "sys/leases/renew" {
capabilities = ["update"]
}
# Allow looking up lease properties. This requires knowing the lease ID ahead
# of time and does not divulge any sensitive information.
path "sys/leases/lookup" {
capabilities = ["update"]
}
# Allow a token to manage its own cubbyhole
path "cubbyhole/*" {
capabilities = ["create", "read", "update", "delete", "list"]
}
# Allow a token to wrap arbitrary values in a response-wrapping token
path "sys/wrapping/wrap" {
capabilities = ["update"]
}
# Allow a token to look up the creation time and TTL of a given
# response-wrapping token
path "sys/wrapping/lookup" {
capabilities = ["update"]
}
# Allow a token to unwrap a response-wrapping token. This is a convenience to
# avoid client token swapping since this is also part of the response wrapping
# policy.
path "sys/wrapping/unwrap" {
capabilities = ["update"]
}
# Allow general purpose tools
path "sys/tools/hash" {
capabilities = ["update"]
}
path "sys/tools/hash/*" {
capabilities = ["update"]
}
# Allow checking the status of a Control Group request if the user has the
# accessor
path "sys/control-group/request" {
capabilities = ["update"]
}
# Allow a token to make requests to the Authorization Endpoint for OIDC providers.
path "identity/oidc/provider/+/authorize" {
capabilities = ["read", "update"]
}

Pestaña de políticas de Vault con la política default

Si quieres configurar un usuario administrador, crea una política admin con este contenido:

Política admin
path "sys/health"
{
capabilities = ["read", "sudo"]
}
path "sys/policies/acl"
{
capabilities = ["list"]
}
path "sys/policies/acl/*"
{
capabilities = ["create", "read", "update", "delete", "list", "sudo"]
}
path "auth/*"
{
capabilities = ["create", "read", "update", "delete", "list", "sudo"]
}
path "sys/auth/*"
{
capabilities = ["create", "update", "delete", "sudo"]
}
path "sys/auth"
{
capabilities = ["read"]
}
path "secret/*"
{
capabilities = ["create", "read", "update", "delete", "list", "sudo"]
}
path "sys/mounts/*"
{
capabilities = ["create", "read", "update", "delete", "list", "sudo"]
}
path "sys/mounts"
{
capabilities = ["read"]
}

Con las políticas definidas, crea un rol para cada una. Se hace desde el terminal que ofrece la aplicación Vault. Sustituye CLIENT_ID por el client ID de la aplicación de Ironchip.

Para el usuario común, crea el rol demo:

Ventana de terminal
vault write auth/oidc/role/demo \
bound_audiences="CLIENT_ID" \
allowed_redirect_uris="http://<host-de-tu-servicio>:8200/ui/vault/auth/oidc/oidc/callback" \
allowed_redirect_uris="http://<host-de-tu-servicio>:8250/oidc/callback" \
user_claim="sub" \
policies="default" \
verbose_oidc_logging="true"

Para el administrador, crea el rol admin:

Ventana de terminal
vault write auth/oidc/role/admin \
bound_audiences="CLIENT_ID" \
allowed_redirect_uris="http://<host-de-tu-servicio>:8200/ui/vault/auth/oidc/oidc/callback" \
allowed_redirect_uris="http://<host-de-tu-servicio>:8250/oidc/callback" \
user_claim="sub" \
policies="admin" \
verbose_oidc_logging="true"

Antes de probar, comprueba que el usuario tiene acceso a la aplicación de Ironchip.

  1. Abre la página de inicio de sesión de Vault y selecciona el método OIDC.
  2. Si eres un usuario común, deja el Role vacío: Vault usa el rol por defecto demo. Para entrar como administrador, escribe admin.
  3. Haz clic en Sign in with OIDC Provider. Vault te redirige a Ironchip.
  4. Autoriza el acceso con Ironchip. Vuelves a Vault con la sesión iniciada y las políticas del rol.

UDS Enterprise (Virtual Cable)

Integra Ironchip con UDS Enterprise 3.5 mediante un autenticador SAML: crea la aplicación, configura el autenticador, define los atributos y los grupos.

Esta guía integra un autenticador SAML de UDS Enterprise 3.5 para validar usuarios en Ironchip, de modo que los usuarios de Ironchip puedan acceder al servicio de UDS.

  • Acceso a la consola de administración de Ironchip con un usuario con permisos de administración.
  • Una cuenta con permisos para realizar la configuración en UDS Enterprise.
  • Usuarios dados de alta en ambas plataformas.

Empieza a crear una aplicación SAML. La terminarás cuando tengas la metadata de UDS Enterprise como proveedor de servicio.

  1. En la consola de administración de Ironchip, ve a Applications y haz clic en New application.

    Página Your applications con el botón New application

  2. En Select service type, sección Standard authentication protocols, haz clic en SAML.

  3. En la pestaña General, escribe en Name un nombre para identificar la aplicación.

  4. En la pestaña Identity Provider (IdP), copia la URL Metadata, ábrela y guarda en un fichero el XML de la metadata de Ironchip. Lo necesitarás en UDS Enterprise.

    Pestaña Identity Provider (IdP) con la metadata de Ironchip como proveedor de identidad

  1. En la administración de UDS Enterprise, ve a Autenticadores, selecciona Nuevo y elige SAML Authenticator.

    Menú para crear un autenticador SAML en UDS Enterprise

  2. En la pestaña Main, indica un nombre para el autenticador (no puede contener espacios), la prioridad y un Label.

    Pestaña Main del autenticador

  3. En la pestaña Certificates, indica un certificado válido y su clave. Tienen que estar en formato PEM.

    Pestaña Certificates del autenticador

Si no tienes certificados, puedes generar uno con OpenSSL. El servidor de UDS tiene OpenSSL instalado, así que puedes usar esa máquina.

  1. Genera el certificado y la clave.

    Ventana de terminal
    openssl req -new -newkey rsa:2048 -days 3650 -x509 -nodes -keyout server.key -out server.crt

    Ejemplo de generación del certificado

  2. Completa los datos que te pide para generar el certificado.

    Datos solicitados para generar el certificado

  3. Convierte la clave a formato RSA.

    Ventana de terminal
    openssl rsa -in server.key -out server_rsa.key

    Conversión de la clave a RSA

  4. Copia el contenido del certificado y de la clave RSA en UDS.

    Contenido del certificado y de la clave RSA

  5. Pega la clave en Private Key y el certificado en Certificate.

    Campos Private Key y Certificate rellenados

  1. En la pestaña Metadata, rellena IDP Metadata con el metadata de Ironchip que guardaste al empezar a crear la aplicación SAML. Copia el contenido completo del fichero. Ábrelo con un editor adecuado y nunca con un navegador, porque oculta partes del código.

    Pestaña Metadata con el IDP Metadata pegado

  2. Deja Entity ID vacío: se rellena automáticamente al guardar el autenticador, a partir de la URL que uses para conectar con el portal de UDS Enterprise.

  3. Guarda el autenticador. Para que te deje guardar, indica cualquier dato en la pestaña Attributes; volverás a este apartado más adelante para aplicar la configuración definitiva.

  4. Vuelve a editar el autenticador. Ahí obtienes los datos de Entity ID y la URL de la metadata que necesitas para terminar de configurar la aplicación SAML en la consola de Ironchip.

    Datos de Entity ID y metadata del autenticador guardado

  1. Vuelve a la ventana Add new application de Ironchip y abre la pestaña Service Provider (SP). Despliega Import Metadata, elige URL en SP Metadata, escribe en URL of SP’s Metadata la URL de la metadata que generó UDS Enterprise al guardar y volver a editar el autenticador, y haz clic en Import. Ironchip descarga esa URL desde sus servidores: si UDS Enterprise no es accesible desde internet, abre la URL, copia el XML y usa Text en lugar de URL.

    Pestaña Service Provider (SP) con la sección Import Metadata

  2. Comprueba que se han rellenado Entity ID y Assertion Consumer Services y haz clic en Add.

  3. Da acceso a tus usuarios a la aplicación creada. Cada acceso es para un grupo o un usuario: crea uno por cada grupo o usuario. Consulta Dar acceso a usuarios y grupos.

    Paso Select a group de la ventana Add a new access

    Paso Select authentication policies con las políticas del acceso

    Pestaña Accesses de la aplicación con el acceso añadido

Definir los atributos y los grupos en UDS Enterprise

Sección titulada «Definir los atributos y los grupos en UDS Enterprise»
  1. En la administración de UDS Enterprise, selecciona el autenticador SAML que creaste y edítalo.

    Edición del autenticador SAML

  2. En Attributes, indica los atributos correctos. Están definidos y visibles en la documentación de Ironchip. Por defecto son:

    Description Friendly Name SAML Name
    User Name uid urn:oid:0.9.2342.19200300.100.1.1
    User Email mail urn:oid:0.9.2342.19200300.100.1.3
    User given Name givenName urn:oid:2.5.4.42
    User common Name cn urn:oid:2.5.4.3
    User Groups eduPersonAffiliation urn:oid:1.3.6.1.4.1.5923.1.1.1.1

    Pestaña Attributes con los atributos definidos

  3. Guarda y accede al autenticador creado en UDS Enterprise.

  4. Ve al apartado Groups y añade los grupos necesarios. Tienes que añadirlos manualmente, porque la búsqueda automática no se aplica a este tipo de autenticador.

    Apartado Groups del autenticador

  5. Añade todos los grupos necesarios. En este ejemplo se añaden los departamentos a los que pertenecen los usuarios, porque el atributo de pertenencia a departamentos que usa Ironchip es Groups.

    Grupos añadidos al autenticador

  1. Accede al portal de UDS Enterprise a través del autenticador SAML que acabas de crear.

    Portal de UDS Enterprise con el autenticador SAML

  2. Al seleccionar el autenticador SAML, UDS Enterprise te redirige a la página del proveedor. En este caso, el sistema te pide el correo electrónico del usuario al que se enviará una notificación push.

    Página de inicio de sesión de Ironchip pidiendo el correo

    Notificación push enviada al usuario

  3. Tras iniciar sesión en Ironchip, se te redirige de vuelta a la página de servicios de UDS Enterprise.

    Página de servicios de UDS Enterprise tras iniciar sesión

    Si el grupo al que pertenece el usuario tiene servicios asignados, se le muestran y puede acceder a ellos.

  4. Para comprobar a qué grupos pertenece un usuario, accede al autenticador y edita el usuario.

    Edición del usuario en el autenticador

En este ejemplo, el usuario pertenece al grupo UDS Enterprise y, como ese grupo está dado de alta en el autenticador, puede acceder.

Directorio y SaaS

Entra ID

Integrar Microsoft Entra ID con Ironchip por LDAP seguro con Entra Domain Services: requisitos de Azure, política de contraseña LDAP en Ironchip y acceso.

Microsoft Entra ID (antes Azure AD) es un servicio de gestión de identidades y accesos en la nube. Ayuda a tus empleados a acceder a recursos externos, como Microsoft 365, el portal de Azure y miles de aplicaciones SaaS. Se integra con Ironchip mediante el protocolo LDAP, a través de Microsoft Entra Domain Services (antes Azure AD DS).

Cada tenant nuevo viene con un nombre de dominio inicial, .onmicrosoft.com, que no puedes cambiar ni eliminar. Sí puedes añadir los nombres de dominio de tu organización, lo que ayuda a crear nombres de usuario que resulten familiares a tus usuarios. Más información en la documentación de Microsoft.

  • Acceso a la consola de administración de Ironchip.
  • Un usuario con permisos para realizar la configuración en Azure.
  • Una suscripción activa de Azure y un tenant de Microsoft Entra ID asociado a la suscripción.
  • Microsoft Entra Domain Services habilitado y configurado en el tenant.

Microsoft Entra Domain Services debe cumplir estos requisitos para integrarse con Ironchip:

  • LDAP seguro habilitado:
    • Crea los certificados necesarios.
    • Permite el acceso a LDAP seguro a través de internet. Puedes usar una regla de grupo de seguridad de red de Azure para limitar ese acceso.
    • Configura los grupos que quieres sincronizar.
    • Crea un subdominio que apunte a la dirección IP externa de LDAP seguro. Es necesario si quieres conectar con TLS en modo seguro, porque el certificado del cliente tiene que coincidir con el host.
  • Configuración de usuarios:
    • Usuarios federados: no se admiten.
    • Usuarios sincronizados desde on-premises: en entornos híbridos, asegúrate de que la sincronización del hash de la contraseña está habilitada. Si ya lo está, ejecuta el cmdlet indicado en la guía de Microsoft para aplicarla.
    • Usuarios de la nube: aunque el usuario ya esté creado en la nube, tiene que iniciar sesión y cambiar su contraseña.

Para más información, consulta el tutorial oficial de Microsoft para configurar LDAPS.

Cuando termines la configuración de Azure, crea en Ironchip una política de contraseña con el protocolo LDAP que apunte a Microsoft Entra Domain Services. Tienes el detalle en Políticas de contraseña.

  1. Ve a Authentication policies > Password policies y haz clic en Add password policy.

  2. En la ventana Add a new password policy, escribe el nombre (LDAP name) y el servidor (Server host). Si quieres habilitar TLS seguro (Enable TLS), añade también el certificado. Haz clic en Add.

    Ventana Add a new password policy con el nombre LDAP, el servidor, el cifrado TLS y el certificado

  3. Ironchip comprueba que la conexión funciona: en la ventana Test con el nombre de la política, escribe un usuario (UPN or email) y una contraseña (LDAP password) de ejemplo, que no se almacenan, y haz clic en Test. La política solo se crea si la prueba es correcta.

Puedes modificar cualquier campo más adelante con Configure password policy: cada vez que lo hagas, Ironchip vuelve a comprobar la conexión. Una vez creada la política, también puedes probarla con distintos usuarios con Test password policy, en sus opciones.

Con la política de contraseña creada, añádela al acceso de la aplicación que quieres proteger, en el paso Select authentication policies. Consulta Dar acceso a usuarios y grupos.

  1. Inicia la autenticación en la aplicación como en cualquier otra, con el nombre de usuario que configuraste antes.
  2. Si el acceso exige la política de contraseña LDAP, aparece un aviso para que introduzcas la contraseña de tu correo.
  3. Si configuraste el acceso con otro tipo de política, como tu dispositivo, abre la app de Ironchip para terminar el proceso y entrar en la aplicación.

Entra ID como MFA

Usar Ironchip como método de autenticación multifactor externo en Microsoft Entra ID mediante OIDC y exigirlo con una política de acceso condicional.

Esta guía explica cómo integrar Ironchip como método de autenticación multifactor (MFA) externo en Microsoft Entra ID (antes Azure AD). La conexión entre Microsoft e Ironchip se hace con el protocolo OIDC.

  • Una cuenta con licencia P1 o P2 y permisos en Azure Cloud.
  • Acceso a la consola de administración de Ironchip.
  1. En Entra ID, ve a Aplicaciones empresariales y añade una nueva aplicación empresarial.

    Lista de aplicaciones empresariales en Entra ID con el botón de nueva aplicación

  2. Selecciona Crear su propia aplicación, elige un nombre para la aplicación y selecciona Integrar cualquier otra aplicación que no se encuentre en la galería.

    Ventana Crear su propia aplicación con el nombre de la aplicación

    Opción para integrar cualquier otra aplicación que no se encuentre en la galería

  1. Ve a Administrar > Propiedades y haz clic en el registro de la aplicación.

    Propiedades de la aplicación empresarial con el enlace al registro de la aplicación

  2. En Información general, copia el ID de la aplicación. Lo necesitarás más adelante para configurar Ironchip como MFA en Azure.

  3. En Puntos de conexión, copia el Punto de conexión de autorización de OAuth 2.0 (v2). Es uno de los dos URI de redirección que necesitas.

  4. El otro URI de redirección es el que lleva al IdP de Ironchip: https://idp.ironchip.com/oidc/auth.

  5. Ve a Autenticación, selecciona Agregar una plataforma y elige Web.

    Menú Autenticación con la opción Agregar una plataforma

    Selección de la plataforma Web

  6. Añade primero el URI de redirección de Ironchip y después el de Azure.

Ve a Configuración de tokens y añade las notificaciones opcionales que se muestran en la captura:

  • login_hint, en los tipos de token Id. y Acceso.
  • preferred_username, en el tipo de token Id..

Configuración de token con las notificaciones opcionales login_hint (Id. y Acceso) y preferred_username (Id.)

Ve a Permisos de API, añade estos permisos delegados de Microsoft Graph y concede el consentimiento de administrador:

  • openid
  • profile
  • User.Read

Permisos delegados de Microsoft Graph openid, profile y User.Read con el consentimiento concedido

Crea en la consola de Ironchip una aplicación OIDC para conectar Microsoft con Ironchip.

  1. En la consola de Ironchip, ve a Applications y haz clic en New application.

    Página Your applications con el botón New application

  2. En Select service type, sección Standard authentication protocols, haz clic en OIDC.

  3. En la pestaña General, escribe el nombre de la aplicación en Name.

  4. En la pestaña Redirect URIs, escribe en Redirect URL https://login.microsoftonline.com/common/federation/externalauthprovider. Este URI devuelve al usuario a Microsoft cuando termina la autenticación.

    Pestaña Redirect URIs con el campo Redirect URL

  5. Haz clic en Add.

  6. En Overview, Ironchip muestra las credenciales de la aplicación: Client ID, Client Secret y Metadata URL. Las necesitas para configurar Entra ID y no podrás volver a verlas: cópialas o descárgalas con Download credentials antes de cerrar la ventana.

    Paso Overview de la aplicación OIDC con Client ID, Client Secret, Metadata URL y el botón Download credentials

Añadir Ironchip como método de autenticación externo

Sección titulada «Añadir Ironchip como método de autenticación externo»
  1. En Microsoft Entra ID, ve a Administrar > Seguridad > Métodos de autenticación.

  2. Selecciona Agregar método externo.

    Métodos de autenticación con la opción Agregar método externo

  3. En la pestaña Configurar, rellena las propiedades del método:

    • Nombre: el nombre del MFA que vas a añadir.
    • Id. de cliente: el Client ID que mostró Ironchip al crear la aplicación OIDC.
    • Punto de conexión de detección: la Metadata URL que mostró Ironchip, https://idp.ironchip.com/oidc/.well-known/openid-configuration.
    • Id. de aplicación: el ID de la aplicación que copiaste en las propiedades de la aplicación empresarial.

    Propiedades del método externo con el nombre, el id. de cliente, el punto de conexión de detección y el id. de aplicación

  4. En la pestaña Habilitar y establecer como destino, en Incluir, haz clic en Agregar un destino y añade los usuarios o grupos que podrán usar este MFA. En el ejemplo se usa un grupo llamado TestUser.

    Pestaña Incluir del método externo con el grupo TestUser como destino

Para elegir qué usuarios usan este método de autenticación, configura una política de acceso condicional.

  1. En Seguridad, ve a Proteger > Acceso condicional y crea una nueva política.

    Sección Acceso condicional con el botón de nueva política

  2. Configura los usuarios, los recursos a los que tendrán acceso y el método de autenticación.

    Configuración de usuarios y recursos de la política de acceso condicional

  3. En Control de acceso, ve a Conceder y activa Requerir autenticación multifactor.

    Opción Requerir autenticación multifactor en Conceder

Con el acceso condicional configurado, la autenticación queda habilitada para los usuarios que has seleccionado.

Microsoft 365

Federar Microsoft 365 con AD FS e Ironchip MFA: instalar Microsoft Entra Connect, configurar los sufijos UPN, federar el dominio y probar el acceso con push.

Esta guía explica cómo federar Microsoft 365 con tu servidor AD FS integrado con Ironchip, para exigir Ironchip MFA a los usuarios de los grupos protegidos.

  • El Windows Server debe tener un dominio asignado y un FQDN asociado accesible desde internet.
  • Para integrar AD FS en un servidor local, necesitas un certificado asociado a ese dominio, emitido por una entidad certificadora válida. AD FS debe tener acceso a la clave privada y necesita el certificado en formato PFX.
  • El dominio asignado a la máquina en Azure debe estar validado. Para ello, inserta en el DNS el registro que Azure requiere para verificar que eres el propietario del dominio.

El primer paso es configurar AD FS y el plugin de AD FS de Ironchip. Sigue la guía de ADFS.

Cuando AD FS esté configurado correctamente, continúa con la federación de Microsoft 365.

  1. Descarga Microsoft Entra Connect (antes Azure AD Connect).

  2. Cuando termine la descarga, ejecuta el instalador en el Windows Server donde configuraste AD FS integrado con Ironchip.

  3. Cuando el instalador lo pregunte, selecciona la configuración Express.

  4. En el paso Connect to Azure AD, introduce las credenciales de un administrador global de Microsoft Entra ID (antes Azure AD).

  5. En el paso Connect to AD DS, introduce las credenciales de un administrador de Active Directory del Windows Server.

  6. En el paso Azure AD sign-in, comprueba que el dominio que aparece en la columna Azure AD Domain está en estado Verified. Si el dominio que quieres federar no está verificado, sigue esta guía de Microsoft para verificarlo.

    Paso Azure AD sign-in del instalador con el dominio y su estado

  7. Si el instalador no te deja continuar, puedes marcar la casilla Continue without matching all UPN suffixes to verified domains. Los sufijos UPN se crean después, si hace falta.

  8. Haz clic en Next. La instalación empieza en el paso Configure.

Omite este apartado si el instalador no te pidió marcar la casilla Continue without matching all UPN suffixes to verified domains.

  1. En el Windows Server, abre Active Directory Domains and Trusts.

  2. Haz clic derecho en el primer elemento de la lista y selecciona Propiedades.

    Propiedades de Active Directory Domains and Trusts para añadir el sufijo UPN

  3. Escribe el dominio tal como aparece en Azure y haz clic en Add para habilitar el sufijo UPN.

  4. Cierra la herramienta. El sufijo queda configurado.

  1. Abre Microsoft Entra Connect en el Windows Server y haz clic en Configure.

  2. En la lista de tareas, selecciona Manage federation y después Federate Azure AD domain.

  3. En el paso Connect to Azure AD, introduce las credenciales de un administrador global de Entra ID.

  4. En el paso Connect to AD FS, introduce las credenciales de un administrador de Active Directory del servidor local.

  5. En el paso Azure AD domain, selecciona en DOMAIN un dominio federable de Entra ID. Para que el dominio esté disponible, debe estar ya validado. El instalador avisa de que el dominio pasará de administrado a federado y de que el inicio de sesión de los usuarios se interrumpirá durante el proceso.

    Paso Azure AD domain de Microsoft Entra Connect con el desplegable para elegir el dominio que se federa

  6. Lee las indicaciones del paso Azure AD trust y haz clic en Next. Empieza el proceso de federación.

La sincronización de AD FS puede tardar bastante. Mientras dura, es posible que los usuarios sigan entrando al servicio como hasta ahora, sin que se les pida la autenticación multifactor.

  1. Intenta entrar en tu cuenta de Microsoft 365. El inicio de sesión debe haber cambiado y redirigirte a tu Windows Server para una experiencia de SSO unificada.

    Página de inicio de sesión del servidor AD FS a la que redirige Microsoft 365

  2. Si el plugin de Ironchip está bien configurado y el usuario pertenece a un grupo protegido con Ironchip MFA, se le pide que permita el acceso con una notificación push en su autenticador.

    Página de AD FS que pide autenticarse en Ironchip con el botón Send Push Notification

Pedir las credenciales al iniciar las aplicaciones locales de Windows

Sección titulada «Pedir las credenciales al iniciar las aplicaciones locales de Windows»

Para que las aplicaciones locales de Windows pidan las credenciales cada vez que el usuario se conecta, establece una GPO con estos parámetros:

  1. Elimina todos los archivos de esta carpeta cuando el usuario cierre sesión:

    %LOCALAPPDATA%\Packages\Microsoft.AAD.BrokerPlugin_cw5n1h2txyewy\AC\TokenBroker\Accounts
  2. Añade esta entrada al registro:

    HKLM\SOFTWARE\Policies\Microsoft\Windows\WorkplaceJoin
    DWORD: BlockAADWorkplaceJoin
    VALUE: 1
  3. Establece este valor en la GPO:

    Computer Configuration > Policies > Windows Settings > Security Settings > Local Policies > Security Options
    Valor: Users can't add Microsoft accounts

ADFS

Añadir Ironchip MFA a Active Directory Federation Services: instalar el plugin de ADFS con una API key y proteger las aplicaciones de confianza.

Ironchip se integra con ADFS (Active Directory Federation Services) mediante un plugin de autenticación multifactor. Esta guía recorre desde la preparación del servidor hasta la prueba de acceso con Claims X-Ray.

  • Un servidor Windows con los roles de dominio y federación de Active Directory.
  • Acceso a la consola de administración de Ironchip.
  • Un usuario con permisos para configurar el servidor.

Crea una aplicación Custom code, que se autentica con una API key. Necesitarás esa API key al instalar el plugin. El procedimiento general está en Aplicaciones con API key.

  1. En la consola de Ironchip, ve a Applications y haz clic en New application.

    Página Your applications con el botón New application

  2. En Select service type, sección For developers, haz clic en Custom code.

  3. En la pestaña General, escribe el nombre que quieras en Name y haz clic en Add.

  4. En Overview, copia la API key del campo API KEY o descárgala con Download credentials. Guárdala para el paso de instalación del plugin.

    Paso Overview de la aplicación Custom code con el campo API KEY y el botón Download credentials

  1. En el Administrador del servidor, abre Agregar roles y características.

  2. Añade los roles Servicios de dominio de Active Directory y Servicios de federación de Active Directory.

  3. Haz clic en Siguiente hasta el final del asistente y espera a que termine la instalación. Al volver al Administrador del servidor, los dos roles aparecen en el menú de la izquierda y hay una alerta en el menú superior.

  4. Haz clic en la alerta Promocionar este servidor a un controlador de dominio.

  5. Selecciona Agregar un nuevo bosque y escribe el nombre de dominio que quieras.

  6. Sigue los pasos hasta el final y haz clic en Instalar. Al terminar recibirás una alerta de DNS que resolverás en el apartado siguiente.

    Asistente de configuración de Active Directory para promocionar el servidor a controlador de dominio

  1. Desde las herramientas administrativas, abre el programa de configuración de DNS.

  2. Haz clic derecho en el nombre de tu servidor y abre Propiedades.

    Menú contextual del servidor en el administrador de DNS con la opción Propiedades

  3. Ve a la pestaña Reenviadores y añade los servidores DNS externos que necesites, como 4.2.2.1, 4.2.2.2, 8.8.8.8 y 8.8.4.4.

    Pestaña Reenviadores con los servidores DNS externos añadidos

Después de esto, la máquina se reinicia automáticamente.

  1. Crea un certificado autofirmado con este comando de PowerShell:

    Ventana de terminal
    New-SelfSignedCertificate -DnsName server.ironchip.local
  2. Se abre el programa certlm.msc. El certificado creado está en la carpeta Personal.

  3. Haz clic derecho en el certificado y selecciona Abrir. En la pestaña Detalles, haz clic en Copiar a archivo.

  4. En el asistente de exportación, selecciona Sí, exportar la clave privada. Deja el resto de opciones por defecto y guarda el fichero, por ejemplo en el escritorio.

  5. Ejecuta el fichero exportado para importarlo. En la ventana que se abre, selecciona Máquina local.

  6. Cuando llegues al punto de elegir dónde guardarlo, selecciona Colocar todos los certificados en el siguiente almacén, haz clic en Examinar y elige la carpeta Autoridades de certificación raíz de confianza.

  1. En el Administrador del servidor, abre la alerta y selecciona Configurar el servicio de federación en el servidor.

    Alerta del Administrador del servidor para configurar el servicio de federación

    Se abre el Asistente de configuración del servicio de federación de Active Directory.

  2. En Bienvenida, selecciona Crear el primer servidor de federación en una granja de servidores de federación y haz clic en Siguiente.

  3. En Conectarse a AD DS, indica una cuenta con derechos de administrador de dominio para el dominio de Active Directory al que está unido el equipo (en este ejemplo, ironchip.local) y haz clic en Siguiente.

  4. En Especificar propiedades del servicio, haz lo siguiente y haz clic en Siguiente:

    • Selecciona en el desplegable el certificado SSL que creaste antes. Es el certificado de autenticación del servicio.
    • En el nombre del servicio de federación, escribe adfs.ironchip.local. Debe coincidir con el valor que usaste al inscribir el certificado SSL en los Servicios de certificados de Active Directory (AD CS).
    • En el nombre para mostrar, escribe Ironchip Corporation.
  5. En Especificar cuenta de servicio, selecciona Usar una cuenta de usuario de dominio existente o una cuenta de servicio administrada de grupo. Para ello necesitas crear antes un usuario específico para este servicio, por ejemplo service-adfs. Después vuelve al asistente y selecciónalo.

  6. En Especificar base de datos de configuración, selecciona Crear una base de datos en este servidor mediante la base de datos interna de Windows y haz clic en Siguiente.

  7. En Opciones de revisión, comprueba la configuración y haz clic en Siguiente.

  8. En Comprobaciones de requisitos previos, verifica que todas se han completado correctamente y haz clic en Configurar.

  9. En Resultados, revisa que la configuración se haya completado. Aparecerán 4 advertencias, que puedes ignorar por ahora.

    Página de resultados del asistente de configuración de AD FS

  1. En la consola de Ironchip, ve a Plugins y, en la sección Windows Integrations, haz clic en Download en la tarjeta ADFS.

  2. Ejecuta el instalador.

  3. Rellena solo estos campos: Ironchip Host (déjalo con el valor por defecto si tienes dudas) e Ironchip API Key, con la API key que obtuviste al crear la aplicación Custom code.

    Instalador del plugin de ADFS con los campos Ironchip Host e Ironchip API Key

  4. Si la configuración es correcta, el instalador añade el plugin a AD FS y reinicia el servicio de AD FS para aplicar los cambios.

    Instalador del plugin de ADFS al terminar la instalación

La interfaz del administrador de ADFS cambia entre las versiones 3.0 y 4.0. Sigue las instrucciones de la tuya. En los ejemplos, el servicio protegido es Claims X-Ray (consulta Configurar Claims X-Ray como aplicación de prueba).

  1. Ve a Políticas de autenticación y haz clic en Editar MFA global.
  2. Selecciona Adaptador Ironchip MFA como método de autenticación multifactor.
  3. Ve a Confianza por parte de confianza (Per Relying Party Trust) y haz clic derecho en el servicio que quieras proteger.
  4. Haz clic en Editar autenticación multifactor personalizada.
  5. Activa MFA para intranet, extranet o ambas.

El servicio queda protegido con Ironchip MFA.

  1. Ve a Servicio > Métodos de autenticación. En el menú de la derecha, haz clic en Editar métodos de autenticación multifactor.
  2. En la pestaña Multifactor, selecciona Adaptador Ironchip MFA.
  3. Haz clic en Aplicar y Aceptar.
  4. Ve a Relaciones de confianza de la parte que confía (Relying Party Trusts) y selecciona el servicio, por ejemplo ClaimsXray.
  5. En el menú de la derecha, haz clic en Editar política de control de acceso.
  6. En la parte inferior de la ventana, haz clic en Usar política de control de acceso.
  7. Selecciona Permitir a todos y requerir MFA. Si quieres, puedes aplicarlo solo a un grupo de usuarios concreto.
  8. Haz clic en Aplicar y Aceptar.

El servicio queda protegido con Ironchip MFA.

  1. Abre el Visor de eventos para ver los registros del plugin de Ironchip.

    Visor de eventos de Windows

  2. Si todo es correcto, verás ADFS Ironchip Plugin en la lista de Registros de aplicaciones y servicios. Ábrelo.

  3. Si el plugin está instalado, verás en los registros el mensaje Ironchip license key loaded without errors.

    Registro ADFS Ironchip Plugin del Visor de eventos con el mensaje Ironchip license key loaded without errors

Configurar Claims X-Ray como aplicación de prueba

Sección titulada «Configurar Claims X-Ray como aplicación de prueba»

Claims X-Ray es una herramienta de Microsoft que sirve como aplicación de prueba para ADFS.

  1. Ve a https://adfshelp.microsoft.com/ClaimsXray/TokenRequest y sigue las instrucciones.

  2. Abre PowerShell como administrador y ejecuta lo siguiente. Esto añade Claims X-Ray como relying party trust:

    Ventana de terminal
    $authzRules = "=>issue(Type = `"http://schemas.microsoft.com/authorization/claims/permit`", Value = `"true`"); "
    $issuanceRules = "@RuleName = `"Issue all claims`"`nx:[]=>issue(claim = x); "
    $redirectUrl = "https://adfshelp.microsoft.com/ClaimsXray/TokenResponse"
    $samlEndpoint = New-AdfsSamlEndpoint -Binding POST -Protocol SAMLAssertionConsumer -Uri $redirectUrl
    Add-ADFSRelyingPartyTrust -Name "ClaimsXray" -Identifier "urn:microsoft:adfs:claimsxray" -IssuanceAuthorizationRules $authzRules -IssuanceTransformRules $issuanceRules -WSFedEndpoint $redirectUrl -SamlEndpoint $samlEndpoint
  3. Si quieres añadir también la integración OIDC, ejecuta:

    Ventana de terminal
    Add-AdfsClient -Name "ClaimsXrayClient" -ClientId "claimsxrayclient" -RedirectUri https://adfshelp.microsoft.com/ClaimsXray/TokenResponse
    if ([System.Environment]::OSVersion.Version.major -gt 6) { Grant-AdfsApplicationPermission -ServerRoleIdentifier urn:microsoft:adfs:claimsxray -AllowAllRegisteredClients -ScopeNames "openid","profile" }
  4. Comprueba que Claims X-Ray aparece en Relying Party Trusts.

  5. Si la política de control de acceso no tiene ningún parámetro, haz clic derecho en el servicio, selecciona Editar política de control de acceso, elimina todo lo que haya y elige la tercera opción, Permitir a todos y MFA para un grupo específico. En la parte inferior, selecciona el grupo protegido.

  6. En Métodos de autenticación > Métodos de autenticación multifactor, comprueba que aparece IronchipMFAAdapter. Si no aparece, edita la lista y añádelo.

Activar la página de inicio de sesión iniciada por el IdP

Sección titulada «Activar la página de inicio de sesión iniciada por el IdP»
  1. Consulta los endpoints de tu ADFS desde PowerShell:

    Ventana de terminal
    Get-AdfsEndpoint | select FullUrl
  2. Abre en el navegador la URL de tu ADFS añadiendo al final /idpinitiatedsignon.aspx. Verás un error, porque esta página está desactivada por defecto.

  3. Actívala desde PowerShell:

    Ventana de terminal
    Set-AdfsProperties -EnableIdPInitiatedSignonPage $true
  4. Vuelve a abrir la página y autentícate con tu usuario.

  5. Si aparece el aviso de seguridad de Windows, puedes desactivarlo en la Consola de administración de ADFS: expande Servicios, haz clic en Métodos de autenticación, haz clic en Editar en Métodos de autenticación primarios y desmarca la opción de solicitud de Windows. Haz clic en Aplicar y Aceptar.

Ahora verás un formulario de inicio de sesión.

Probar el servicio protegido con Claims X-Ray

Sección titulada «Probar el servicio protegido con Claims X-Ray»
  1. Abre la herramienta Claims X-Ray y configúrala para tu ADFS.
  2. Haz clic en Probar autenticación. Te redirige a tu ADFS.
  3. Introduce tu usuario y contraseña.
  4. Se te solicita la autenticación MFA. Haz clic en Enviar.
  5. Recibes una notificación push en la aplicación de Ironchip. Ábrela y autentícate.

Si todo es correcto, se te redirige a la página final de Claims X-Ray.

Google Workspace

Integrar Google Workspace con Ironchip por SAML: crear la aplicación, configurar el perfil de SSO en la consola de Google y activarlo para usuarios y grupos.

Google Workspace se integra con Ironchip mediante el protocolo SAML. Los usuarios que asignes se autenticarán con el segundo factor de Ironchip.

  • Acceso a la consola de administración de Ironchip.
  • Un usuario con permisos para realizar la configuración en Google Workspace.

Empieza a crear una aplicación SAML. La terminarás cuando tengas los datos de Google como proveedor de servicio, que aparecen al añadir el perfil de SAML.

  1. En la consola de Ironchip, ve a Applications y haz clic en New application.

    Página Your applications con el botón New application

  2. En Select service type, sección Standard authentication protocols, haz clic en SAML.

  3. En la pestaña General, escribe un nombre identificativo en Name y, si quieres, sube un icono en Icon.

  4. Abre la pestaña Identity Provider (IdP). Tiene los datos de Ironchip que pide Google: IdP Entity ID or Issuer, la dirección del Single Sign On Service, el Signing X.509 Certificate y la URL Metadata.

    Pestaña Identity Provider (IdP) con los datos de Ironchip como proveedor de identidad

  1. Entra en la consola de administración de Google y ve a Seguridad > Autenticación > SSO con IdP de terceros. En Perfiles de SSO de terceros, haz clic en Agregar perfil de SAML.

    Perfiles de SSO de terceros en la consola de administración de Google con el botón Agregar perfil de SAML

  2. Rellena los campos de Detalles del IDP con los datos de la pestaña Identity Provider (IdP) de Ironchip:

    • ID de entidad del IDP: IdP Entity ID or Issuer.
    • URL de la página de acceso: la dirección del Single Sign On Service.
    • URL de la página de salida: abre la URL Metadata y copia la propiedad Location de la etiqueta XML SingleLogoutService.
    • Certificado de verificación: pega el Signing X.509 Certificate en el primer campo de esta herramienta y guarda el resultado en un fichero nuevo con extensión .crt. La herramienta añade las cabeceras necesarias para que Google detecte el certificado como válido. Sube el fichero con Subir certificado.
  3. Deja el resto de campos por defecto y guarda los cambios.

    Detalles del IDP del perfil de SAML con el ID de entidad, las URL de acceso y de salida y el botón Subir certificado

  1. En el perfil de SAML de Google, copia el ID de entidad y la URL de ACS que aparecen en Detalles del SP.

    Detalles del SP de Google con el ID de entidad y la URL de ACS

  2. Vuelve a la ventana de Ironchip, abre la pestaña Service Provider (SP) y rellena estos campos:

    • Entity ID: el ID de entidad de Google.
    • Assertion Consumer Services: en Location, la URL de ACS, con la forma https://www.google.com/a/<YOUR_DOMAIN>/acs. Deja Binding en urn:oasis:names:tc:SAML:2.0:bindings:HTTP-POST.
    • NameID Format: deja solo urn:oasis:names:tc:SAML:1.1:nameid-format:emailAddress.

    Pestaña Service Provider (SP) con los campos Entity ID, NameID Format y Assertion Consumer Services

  3. Haz clic en Add para crear la aplicación.

  1. En la consola de administración de Google, vuelve a Seguridad > Autenticación > SSO con IdP de terceros.
  2. Haz clic en Gestionar asignaciones de perfil de SSO.
  3. En la parte izquierda, configura los grupos o las personas que se autenticarán con el segundo factor de Ironchip.
  4. Da acceso a esos mismos usuarios o grupos en la aplicación SAML de Ironchip. Consulta Dar acceso a usuarios y grupos.
  1. Pide a un usuario o grupo que hayas asignado que inicie sesión en un servicio de Google Workspace.
  2. Google lo redirige a Ironchip para autenticarse con el segundo factor.
  3. Cuando el usuario completa la autenticación, vuelve a Google con la sesión iniciada.
Integración de Google Workspace con Ironchip mediante SAMLReproducir el vídeo

Airtable

Configurar el inicio de sesión único (SSO) de Airtable con Ironchip por SAML 2.0: crear la aplicación, añadir el proveedor de identidad y exigir SSO.

Ironchip actúa como proveedor de identidad SAML 2.0 de Airtable. Esta guía explica cómo registrar Ironchip como proveedor de identidad de SSO en el panel de administración de Airtable.

  • Acceso a la consola de administración de Ironchip.
  • Una cuenta Enterprise de Airtable con acceso al panel Admin.

Airtable necesita dos datos de Ironchip: la URL de inicio de sesión y el certificado X.509. Los encuentras en la pestaña Identity Provider (IdP) de una aplicación SAML.

  1. En la consola de Ironchip, ve a Applications y haz clic en New application.

    Página Your applications con el botón New application

  2. En Select service type, sección Standard authentication protocols, haz clic en SAML.

  3. En la pestaña General, escribe el nombre de la aplicación en Name.

  4. En la pestaña Identity Provider (IdP), copia estos valores, que pegarás en Airtable:

    • La dirección del Single Sign On Service: es la URL de inicio de sesión.
    • Signing X.509 Certificate: es el certificado.

    Pestaña Identity Provider (IdP) con los datos de Ironchip que pide Airtable

  5. En la pestaña Service Provider (SP), carga los datos de Airtable: despliega Import Metadata e importa su metadata (URL, Text o File), o escribe su Entity ID y, en Assertion Consumer Services, su URL de ACS en Location.

  6. Haz clic en Add.

  7. Da acceso a la aplicación a los usuarios que se autenticarán en Airtable. Consulta Dar acceso a usuarios y grupos.

  1. Inicia sesión en Airtable.

  2. Haz clic en tu icono de usuario y selecciona Admin.

  3. En la barra lateral izquierda, ve a Configuración y abre la pestaña SSO y autenticación (Seguridad y autenticación).

  4. En la sección de configuración de SSO, haz clic en Agregar proveedor de identidad de SSO. Se abre una ventana de configuración.

  5. Elige el dominio al que se aplicará esta configuración de SSO. El desplegable muestra todos los dominios asociados a tu cuenta Enterprise.

  6. Rellena los campos con los metadatos de Ironchip:

    • URL de inicio de sesión: la dirección del Single Sign On Service que copiaste de Ironchip.
    • Certificado x.509: pega el Signing X.509 Certificate que copiaste de Ironchip.
    • Versión de los metadatos: selecciona v2. Las integraciones de socios usan la opción predeterminada V2.
  7. Haz clic en Guardar. Se abre una ventana emergente que pide confirmación. Haz clic en Guardar de nuevo.

Los cambios pueden tardar unos minutos en aparecer. Después de guardar, la página Configuración se vuelve a cargar. Desde esa pestaña también puedes hacer clic en Editar metadatos si necesitas cambiarlos en el futuro o eliminar la configuración por completo.

Antes de exigir SSO para tu propio dominio de correo, comprueba que los metadatos que has proporcionado son correctos:

  1. Cierra sesión en Airtable y vuelve a iniciarla con SSO.
  2. Si el acceso funciona, vuelve a la pestaña SSO y autenticación.
  3. Cambia el interruptor a SSO opcional/requerido para cerrar la sesión de todos los usuarios del dominio configurado y hacer cumplir el SSO.

Atlassian

Usar Ironchip como proveedor de identidad SAML en Atlassian Guard: crear la aplicación, configurar el SSO en admin.atlassian.com y aplicarlo a los usuarios.

Ironchip actúa como proveedor de identidad SAML de tu organización de Atlassian (Atlassian Guard). Esta guía explica cómo configurar el inicio de sesión único (SSO) y aplicarlo a los usuarios.

  • Ser administrador de una organización de Atlassian.
  • Suscribirte a Atlassian Guard Standard desde tu organización y familiarizarte con su funcionamiento.
  • Verificar uno o más dominios en tu organización. Consulta cómo verificar un dominio.
  • Asegurarte de que tanto tu producto de Atlassian como tu proveedor de identidad usan HTTPS para comunicarse, y de que la URL base configurada del producto es una URL HTTPS.
  • Tener en cuenta que solo podrán usar SSO las cuentas de correo de los dominios asociados a la política.

Empieza a crear una aplicación SAML. La terminarás cuando tengas los datos de Atlassian como proveedor de servicio.

  1. En la consola de Ironchip, ve a Applications y haz clic en New application.

    Página Your applications con el botón New application

  2. En Select service type, sección Standard authentication protocols, haz clic en SAML.

  3. En la pestaña General, escribe el nombre de la aplicación en Name.

  4. Abre la pestaña Identity Provider (IdP). Tiene los datos de Ironchip que pide Atlassian: IdP Entity ID or Issuer, la dirección del Single Sign On Service y el Signing X.509 Certificate.

    Pestaña Identity Provider (IdP) con los datos de Ironchip como proveedor de identidad

  1. Ve a admin.atlassian.com y selecciona tu organización si tienes más de una.

  2. Selecciona Seguridad > Proveedores de identidades.

    Menú Seguridad > Proveedores de identidades en Atlassian Admin

  3. Elige como proveedor de identidades Otro proveedor.

    Selección de Otro proveedor como proveedor de identidades

  4. Haz clic en Configurar inicio de sesión único de SAML.

    Botón para configurar el inicio de sesión único de SAML

  5. Añade los detalles de SAML con los datos de la pestaña Identity Provider (IdP) de Ironchip: IdP Entity ID or Issuer, la dirección del Single Sign On Service y el Signing X.509 Certificate.

    Formulario de detalles de SAML en Atlassian

  6. Atlassian muestra la URL de la entidad del proveedor de servicios y la URL del Assertion Consumer Service del proveedor de servicios.

    Valores de entidad y Assertion Consumer Service del proveedor de servicios en Atlassian

  7. Vuelve a la ventana de Ironchip, abre la pestaña Service Provider (SP) y rellena estos campos:

    • Entity ID: la URL de la entidad del proveedor de servicios.
    • Assertion Consumer Services: en Location, la URL del Assertion Consumer Service del proveedor de servicios. Deja Binding en urn:oasis:names:tc:SAML:2.0:bindings:HTTP-POST.
    • NameID Format: deja solo urn:oasis:names:tc:SAML:1.1:nameid-format:emailAddress.

    Haz clic en Add para crear la aplicación.

    Pestaña Service Provider (SP) con los campos Entity ID, NameID Format y Assertion Consumer Services

  8. En Atlassian, selecciona tu dominio.

    Selección del dominio en Atlassian

  9. Guarda la configuración.

Para que Ironchip sea el método de autenticación de los usuarios:

  1. Ve a Seguridad > Políticas de autenticación.

  2. Busca la política de Ironchip que has creado y haz clic en Editar.

    Lista de políticas de autenticación con la opción Editar

  3. En Configuración, marca la casilla Aplicar inicio de sesión único.

    Casilla Aplicar inicio de sesión único en la política

  4. En Miembros, haz clic en Añadir miembros, elige uno de los dos métodos (individual o masivo) y añade las cuentas que quieres que usen Ironchip como método de autenticación.

    Añadir miembros a la política de autenticación

Antes de probar, da acceso a la aplicación de Ironchip al usuario con el que vas a iniciar sesión, con su correo de Atlassian como nombre de usuario. Los pasos están en Dar acceso a usuarios y grupos.

  1. Abre una ventana privada e inicia sesión en tu producto de Atlassian con una cuenta de correo de un dominio asociado a la política.
  2. Atlassian te redirige a Ironchip para autenticarte.
  3. Completa la autenticación en tu dispositivo. Ironchip te devuelve a Atlassian con la sesión iniciada.
Problema Causa probable Solución
Atlassian no redirige a Ironchip La cuenta no está en la política o su dominio no está verificado Añade la cuenta en Miembros de la política y comprueba que el dominio está verificado
La consola de Ironchip no deja crear la aplicación Falta el Entity ID o la Location de Assertion Consumer Services en la pestaña Service Provider (SP) Escribe los dos valores que muestra Atlassian en la configuración de SAML
Atlassian no reconoce al usuario La aplicación usa el NameID Format emailAddress y el nombre de usuario del acceso en Ironchip no es el correo de la cuenta Edita el acceso con Options > Configure access, en la pestaña Accesses de la aplicación, y usa como nombre de usuario su correo de Atlassian

HubSpot

Proteger el acceso a HubSpot con la autenticación de dos factores mediante OTP generado por la aplicación Ironchip: activar el 2FA y escanear el QR.

HubSpot admite autenticación de dos factores con una aplicación de autenticación. Esta guía explica cómo añadir Ironchip a HubSpot como generador de códigos OTP. Para saber más sobre los OTP de Ironchip, consulta Contraseñas de un solo uso (OTP).

  • Acceso a la consola de administración de Ironchip.
  • La aplicación de Ironchip instalada en tu dispositivo.
  • Un usuario con permisos para realizar la configuración en HubSpot.
  1. Inicia sesión en tu cuenta de HubSpot y ve a Configuración > Seguridad > Autenticación de dos factores.

    Ajustes de seguridad de HubSpot con la autenticación de dos factores

  2. Selecciona Aplicación de autenticación.

    Selección de Aplicación de autenticación en HubSpot

  3. HubSpot muestra un código QR.

    Código QR que muestra HubSpot

Configuración en la aplicación de Ironchip

Sección titulada «Configuración en la aplicación de Ironchip»
  1. Escanea el código QR de HubSpot con la aplicación de Ironchip. En la aplicación, abre el menú de tres puntos y ve a OTP > + > Escanear un código QR.

    Escaneo del código QR de HubSpot desde la aplicación de Ironchip
  2. HubSpot te pide un código para hacer la verificación. Introduce el que muestra la aplicación.

  3. Guarda los códigos de respaldo en un lugar seguro.

    Códigos de respaldo de HubSpot tras verificar el código

Añadir Ironchip a HubSpot mediante OTPReproducir el vídeo

Keeper Security

Integrar Keeper Security con Ironchip por SAML (SSO Connect): configurar el método de autenticación en Keeper, la aplicación en Ironchip y resolver errores.

Esta guía describe cómo integrar Keeper Security con Ironchip mediante SAML. Ironchip actúa como proveedor de identidad y Keeper Security, con SSO Connect Cloud, como proveedor de servicios.

  • Acceso a la consola de administración de Ironchip.
  • Un usuario con permisos para realizar la configuración en Keeper Security.
  1. Inicia sesión en la consola de administración de Keeper Security.

  2. Abre la pestaña Administración.

  3. En Nodo, selecciona el nodo al que quieres aplicar la configuración de Ironchip.

  4. Ve a la pestaña Suministro.

  5. Haz clic en Añadir método y crea un método de inicio de sesión único con SSO Connect Cloud.

  6. Abre el menú de tres puntos de la derecha del método y visualízalo.

    Pestaña Suministro de la consola de Keeper con el nodo, el botón Añadir método y el menú de tres puntos del método SSO Connect Cloud

  7. Haz clic en Exportar metadatos para descargar los metadatos de Keeper Security. Guarda el archivo: lo importarás en Ironchip.

    Vista del método SSO Connect Cloud con el botón Exportar metadatos

  8. Antes de continuar en Ironchip, edita el método desde el menú de tres puntos. En Asignaciones de atributos del proveedor de identidades, escribe uid en Correo electrónico. Ironchip solo necesita el correo: deja vacíos los demás campos.

    Asignaciones de atributos del proveedor de identidades con uid en el campo Correo electrónico

Crea una aplicación SAML con los metadatos de Keeper Security.

  1. En la consola de Ironchip, ve a Applications y haz clic en New application.

    Página Your applications con el botón New application

  2. En Select service type, sección Standard authentication protocols, haz clic en SAML.

  3. En la pestaña General, escribe el nombre de la aplicación en Name.

  4. En la pestaña Service Provider (SP), despliega Import Metadata, elige File en SP Metadata, sube el archivo de metadatos que exportaste de Keeper Security y haz clic en Import.

    Pestaña Service Provider (SP) con la sección Import Metadata y los campos que rellena la importación

  5. En la pestaña Identity Provider (IdP), copia la URL Metadata, ábrela en el navegador y guarda el XML como archivo. Es el archivo de metadatos de Ironchip que subirás a Keeper Security.

    Pestaña Identity Provider (IdP) con los datos de Ironchip como proveedor de identidad

  6. Haz clic en Add para terminar la configuración en Ironchip.

  7. De vuelta en Keeper Security, edita otra vez el método SSO Connect Cloud. En Proveedor de identidades, selecciona Generic en Tipo de IDP y sube en Metadatos SAML el archivo de metadatos de Ironchip.

    Sección Proveedor de identidades con el tipo de IDP Generic y el campo Metadatos SAML

Antes de probar, da acceso a la aplicación de Ironchip al usuario con el que vas a iniciar sesión. Los pasos están en Dar acceso a usuarios y grupos.

  1. Abre la página de inicio de sesión de Keeper Security e inicia sesión con SSO usando un correo de un dominio asociado a tu organización.
  2. Keeper Security te redirige a Ironchip para autenticarte.
  3. Completa la autenticación en tu dispositivo. Ironchip te devuelve a Keeper Security con la sesión iniciada.

Keeper muestra este error cuando el usuario no pertenece al nodo en el que está configurado SSO Connect:

For security reasons, any user who logs in with SSO must be provisioned to the SSO-enabled node in the Keeper Admin Console.

Mueve al usuario al nodo en el que configuraste SSO Connect.

Mensaje de error de SSO Connect por usuario fuera del nodo configurado

Keeper muestra este error cuando el dominio del correo no está asociado a tu organización:

Just-in-time provisioning is only allowed on reserved domains, and the domain (example.com) is not associated to your enterprise.

Keeper Security solo acepta los dominios asociados a tu organización. Asocia el dominio en Keeper o usa otra dirección de correo.

Mensaje de error de SSO Connect por dominio de correo no asociado

Nextcloud

Integrar Nextcloud con Ironchip por OIDC: instalar la app OpenID Connect user backend, crear la aplicación en Ironchip, dar accesos y vincular el proveedor.

Ironchip actúa como proveedor OIDC de Nextcloud. Los usuarios inician sesión en Nextcloud desde un botón que los redirige a Ironchip para autenticarse.

  • Acceso de administrador a la consola de Ironchip.
  • Privilegios de administrador en la instancia de Nextcloud.
  • Acceso al sistema de archivos del servidor de Nextcloud.
  1. Accede a tu instancia de Nextcloud.

  2. Haz clic en el icono de tu perfil (esquina superior derecha) y selecciona Aplicaciones.

    Menú de perfil de Nextcloud con la opción Aplicaciones

  3. En el menú lateral izquierdo, selecciona la categoría Integración.

    Categoría Integración en la lista de aplicaciones de Nextcloud

  4. Usa el buscador (icono de lupa) para localizar la aplicación OpenID Connect user backend.

  5. Haz clic en Descargar y activar.

    Aplicación OpenID Connect user backend con el botón Descargar y activar

Antes de seguir con la interfaz web, ajusta la configuración de seguridad y red de Nextcloud:

  1. Localiza y edita el archivo config/config.php en tu servidor.

  2. Añade o modifica estas líneas dentro del array de configuración:

    config/config.php
    'allow_local_remote_servers' => true,
    'debug' => true,

Crea una aplicación OIDC con la URL de retorno de Nextcloud.

  1. Inicia sesión en la consola de Ironchip, ve a Applications y haz clic en New application.

    Página Your applications con el botón New application

  2. En Select service type, sección Standard authentication protocols, haz clic en OIDC.

    Paso Select service type con la tarjeta OIDC seleccionada

  3. En la pestaña General, escribe un nombre identificativo en Name (por ejemplo, Acceso Nextcloud).

    Pestaña General de la configuración del servicio OIDC con el campo Name

  4. En la pestaña Redirect URIs, escribe en Redirect URL la URL de retorno de tu servidor:

    http://<IP_O_DOMINIO_DE_TU_SERVIDOR>/apps/user_oidc/code

    Por ejemplo: http://mi-dominio/apps/user_oidc/code.

    Pestaña Redirect URIs con el campo Redirect URL

  5. Haz clic en Add.

  6. En Overview, guarda en un lugar seguro el Client ID y el Client Secret que se generan; también puedes descargarlos con Download credentials. No se vuelven a mostrar.

    Resumen Service created successfully con el Client ID, el Client Secret y la Metadata URL

Autoriza qué usuarios podrán usar este método de acceso. El procedimiento completo está en Dar acceso a usuarios y grupos.

  1. En Applications, haz clic en el nombre de la aplicación que acabas de crear.

    Aplicación recién creada en la lista de aplicaciones

  2. En la pestaña Accesses, haz clic en Add access.

    Pestaña Accesses de la aplicación con el botón Add access

  3. En Select a group, busca y selecciona el usuario que se va a autenticar. Haz clic en Next.

    Paso Select a group con el usuario del acceso marcado

  4. En Select usernames, indica en Username composition cómo se compone el nombre de usuario del acceso. En este ejemplo, con la etiqueta email, es decir, el correo del usuario. Haz clic en Next.

    Paso Select usernames con la etiqueta email en Username composition

  5. En Select authentication policies, haz clic en + Select authentication policy y elige la política con la que se autenticará el usuario. En este ejemplo, Any user devices (cualquier dispositivo del usuario). Haz clic en Next.

    Paso Select authentication policies con filas de políticas, entre ellas Any user devices

  6. En Review, comprueba la configuración y haz clic en Add. El acceso del usuario queda creado.

    Paso Review con la plantilla %email% en Username template y las políticas en Authentication factors

  1. Vuelve a Nextcloud, abre tu perfil y selecciona Configuración de administración.

    Menú de perfil con Configuración de administración

  2. En el menú izquierdo, abre la sección OpenID Connect.

    Sección OpenID Connect en la configuración de administración

  3. En Proveedores Registrados, haz clic en + para crear un registro nuevo. El diálogo Registrar a un nuevo proveedor muestra la URL de retorno de tu servidor, que debe coincidir con la que pusiste en Redirect URIs en Ironchip.

    Apartado Proveedores Registrados con el botón + para crear un registro nuevo

  4. Completa los campos:

    • Identificador: un nombre para mostrar (por ejemplo, Ironchip Login).
    • ID de cliente: pega el Client ID que proporcionó Ironchip.
    • Secreto de cliente: pega el Client Secret que proporcionó Ironchip.
    • Endpoint para descubrimiento: https://idp.ironchip.com/oidc/.well-known/openid-configuration.

    Formulario del proveedor con el identificador, el ID y el secreto del cliente y el endpoint de descubrimiento

  5. Haz clic en Enviar. Ironchip queda integrado en Nextcloud.

  1. Cierra la sesión actual en Nextcloud.

  2. En la pantalla de inicio de sesión aparece un botón nuevo: Login with seguido del identificador que elegiste (por ejemplo, Login with Ironchip Login).

    Pantalla de inicio de sesión de Nextcloud con el botón de Ironchip

  3. Haz clic en el botón. Nextcloud te redirige a la pasarela de Ironchip para autenticarte.

    Pasarela de autenticación de Ironchip

  4. Completa el proceso en tu dispositivo. Nextcloud te redirige automáticamente a su panel principal.

    Panel principal de Nextcloud tras iniciar sesión

Salesforce

Configurar Ironchip como proveedor de identidad SAML de Salesforce: activar el SSO, intercambiar metadatos y exigir Ironchip como único método de acceso.

Ironchip actúa como proveedor de identidad (IdP) de Salesforce mediante SAML. Esta guía explica cómo activar el inicio de sesión único y, opcionalmente, cómo obligar a usuarios o grupos a entrar solo con Ironchip.

  • Acceso a la consola de administración de Ironchip.
  • Un usuario con los permisos necesarios para realizar la configuración en Salesforce.
  1. Inicia sesión como administrador en Salesforce y ve a Configuración.

    Menú de configuración de Salesforce

  2. Ve a Identidad y después a Configuración de inicio de sesión único.

    Configuración de inicio de sesión único en Salesforce

  3. Haz clic en Modificar, activa la opción SAML activado y haz clic en Nuevo a partir del archivo de metadatos.

    Pasos para modificar la configuración, activar SAML y crear a partir del archivo de metadatos

  4. En la consola de Ironchip, ve a Applications y haz clic en New application. Vas a crear una aplicación SAML.

    Página Your applications con el botón New application

  5. En Select service type, sección Standard authentication protocols, haz clic en SAML. En la pestaña General, escribe el nombre de la aplicación en Name.

  6. En la pestaña Identity Provider (IdP), copia la URL Metadata, ábrela en el navegador y guarda el XML como archivo. Es el archivo de metadatos de Ironchip. No cierres la ventana de Ironchip: si la cierras antes de hacer clic en Add, se pierde lo que hayas rellenado.

    Pestaña Identity Provider (IdP) con los datos de Ironchip y la URL Metadata

  7. Sube el archivo de metadatos de Ironchip a Salesforce y haz clic en Crear.

    Subida del archivo de metadatos de Ironchip en Salesforce

  8. Guarda los cambios (cambia el nombre si quieres) y descarga los metadatos de Salesforce con Descargar metadatos.

    Configuración de inicio de sesión único guardada con el botón Descargar metadatos

  9. Vuelve a la ventana de Ironchip. En la pestaña Service Provider (SP), despliega Import Metadata, elige File en SP Metadata, sube el archivo de metadatos de Salesforce y haz clic en Import.

    Pestaña Service Provider (SP) con la sección Import Metadata

  10. Haz clic en Add para crear la aplicación.

  11. Da acceso a la aplicación a los usuarios de Salesforce. El nombre de usuario del acceso (Username composition) debe ser igual al de Salesforce. Consulta Dar acceso a usuarios y grupos.

Crear los usuarios de Salesforce en IronchipReproducir el vídeo

Activar Ironchip como método de autenticación

Sección titulada «Activar Ironchip como método de autenticación»
  1. En Salesforce, busca Mi dominio con el buscador.

    Búsqueda de Mi dominio en Salesforce

  2. En Configuración de autenticación, haz clic en Modificar.

    Botón Modificar en Configuración de autenticación

  3. En Servicio de autenticación, marca el método de autenticación nuevo y haz clic en Guardar.

    Configuración de autenticación de Mi dominio con el método nuevo marcado en Servicio de autenticación

La integración queda configurada.

  1. Ve a la página de inicio de sesión de Salesforce y selecciona la opción de iniciar sesión con Ironchip que aparece debajo.

    Página de inicio de sesión de Salesforce con la opción de Ironchip

  2. Escribe el nombre de usuario.

    Campo de nombre de usuario

  3. Autoriza la conexión desde la app de Ironchip.

    Solicitud de autorización en la app de Ironchip

Esta parte explica cómo configurar Salesforce para que los usuarios o grupos que elijas solo puedan autenticarse con Ironchip.

  • Tener Salesforce protegido por Ironchip.
  • Tener dados de alta en Ironchip los usuarios que vayas a configurar.
  1. Ve a Configuración de inicio de sesión único y activa la opción Desactivar el inicio de sesión con credenciales de Salesforce.

    Opción para desactivar el inicio de sesión con credenciales de Salesforce

  2. Ve a Conjuntos de permisos y haz clic en Nuevo.

    Lista de conjuntos de permisos con el botón Nuevo

  3. Cuando hayas creado el conjunto, escribe Inicio de sesión único en la barra de búsqueda y haz clic en la única opción que aparece.

    Búsqueda de Inicio de sesión único en el conjunto de permisos

  4. Haz clic en Modificar, activa la opción marcada y guarda los cambios.

    Opción de inicio de sesión único activada en el conjunto de permisos

  5. Ve al panel de Usuarios o de Grupos, según lo que quieras modificar, y haz clic en el nombre del usuario o del grupo.

    Lista de usuarios con el nombre del usuario a modificar

  6. Baja hasta Asignación de conjuntos de permisos y haz clic en Modificar.

    Apartado Asignación de conjuntos de permisos del usuario

  7. Agrega el conjunto que creaste al principio y guarda los cambios.

    Conjunto de permisos añadido a las asignaciones del usuario

Intenta iniciar sesión con las credenciales de un usuario configurado con esta regla. Con usuario y contraseña de Salesforce no te deja entrar. Con Ironchip, sí.

SolarWinds

Integrar Ironchip en SolarWinds mediante SAML: crear la aplicación, configurar el proveedor de identidad en SolarWinds y crear el usuario SAML.

Ironchip actúa como proveedor de identidad SAML de SolarWinds. Esta guía explica cómo configurar el proveedor de identidad en SolarWinds y crear los usuarios que se autenticarán con Ironchip.

  • Acceso a la consola de administración de Ironchip.
  • Un usuario con permisos para realizar la configuración en SolarWinds.

Empieza a crear una aplicación SAML. La terminarás cuando tengas los datos de SolarWinds como proveedor de servicio.

  1. En la consola de Ironchip, ve a Applications y haz clic en New application.

    Página Your applications con el botón New application

  2. En Select service type, sección Standard authentication protocols, haz clic en SAML.

  3. En la pestaña General, escribe el nombre de la aplicación en Name.

  4. En la pestaña Identity Provider (IdP), copia estos valores, que necesitarás en SolarWinds: la dirección del Single Sign On Service, IdP Entity ID or Issuer y Signing X.509 Certificate.

    Pestaña Identity Provider (IdP) con los datos de Ironchip como proveedor de identidad

  1. Ve a Settings y después a All Settings.

    Menú Settings de SolarWinds

  2. En USER ACCOUNTS, haz clic en SAML Configuration.

    Sección SAML Configuration dentro de USER ACCOUNTS

  3. Añade un nuevo proveedor de identidad (Identity Provider).

    Botón para añadir un nuevo Identity Provider

  4. En la primera página, comprueba que la URL es correcta y haz clic en Next.

    Primera página del asistente con la URL de SolarWinds

  5. En la página siguiente aparecen dos valores: el Audience URI y el SSO Service URL. Anótalos.

    Página con el Audience URI y el SSO Service URL de SolarWinds

  1. Vuelve a la ventana de Ironchip, abre la pestaña Service Provider (SP) y rellena estos campos con los valores que anotaste en SolarWinds:

    • Entity ID: el Audience URI.
    • Assertion Consumer Services: en Location, el SSO Service URL. Deja Binding en urn:oasis:names:tc:SAML:2.0:bindings:HTTP-POST.
    • NameID Format: deja solo urn:oasis:names:tc:SAML:1.1:nameid-format:emailAddress.

    Pestaña Service Provider (SP) con los campos Entity ID, NameID Format y Assertion Consumer Services

  2. Haz clic en Add para crear la aplicación.

Completar los datos del proveedor de identidad

Sección titulada «Completar los datos del proveedor de identidad»

Configura los campos con estos datos:

Formulario del proveedor de identidad en SolarWinds

  • Identity Provider Name: el nombre que quieras para el nuevo método de autenticación.
  • SSO Target URL: la dirección del Single Sign On Service que copiaste de Ironchip.
  • Issuer URI: el IdP Entity ID or Issuer de Ironchip.
  • X.509 Signing Certificate: el Signing X.509 Certificate de Ironchip, convertido al formato de certificado X.509. Puedes usar esta web.

Si ya no tienes esos valores, están en la aplicación de Ironchip: Options > Edit application, pestaña Identity Provider (IdP).

Crea un usuario de tipo SAML en SolarWinds y usa el mismo nombre en el acceso de Ironchip.

  1. En All Settings, ve a User Accounts y entra en Manage Accounts.

    Sección Manage Accounts dentro de User Accounts

  2. Al crear la cuenta, selecciona una de las dos opciones de tipo SAML y configura la cuenta o el grupo según tus necesidades.

    Creación de la cuenta de tipo SAML

  3. Da acceso a la aplicación de Ironchip a ese usuario, con el mismo nombre de usuario en Username composition. Consulta Dar acceso a usuarios y grupos.

Este vídeo (en inglés) muestra una prueba de funcionamiento de la integración:

Prueba de la integración de SolarWinds con IronchipReproducir el vídeo

WordPress

Proteger el acceso de administración de WordPress con Ironchip por SAML usando los plugins WP SAML Auth o miniOrange: metadatos, certificado y pruebas.

Ironchip se integra con WordPress mediante SAML para proteger el panel de administración. Hay dos plugins posibles: WP SAML Auth y miniOrange. Elige uno y sigue su sección.

  • Acceso a la consola de administración de Ironchip.
  • Acceso a WordPress con permisos de administrador.

Con este plugin, WordPress actúa como proveedor de servicios (SP) e Ironchip como proveedor de identidad (IdP).

Con el plugin ya instalado, copia primero los datos de WordPress que pedirá la aplicación que crearás en Ironchip.

  1. En el menú de la izquierda de WordPress, ve a Ajustes > WP SAML Auth.
  2. Ve al apartado Service Provider Settings y copia los valores Entity ID y Assertion Consumer Service.

Crea una aplicación SAML con los datos de WordPress.

  1. En la consola de Ironchip, ve a Applications y haz clic en New application.

    Página Your applications con el botón New application

  2. En Select service type, sección Standard authentication protocols, haz clic en SAML.

  3. En la pestaña General, escribe el nombre de la aplicación en Name.

  4. En la pestaña Service Provider (SP), escribe en Entity ID el Entity ID de WordPress y, en Assertion Consumer Services, el Assertion Consumer Service de WordPress en Location.

    Pestaña Service Provider (SP) con los campos Entity ID y Assertion Consumer Services

  5. En la pestaña Identity Provider (IdP), copia la URL Metadata, ábrela en el navegador y guarda el XML como archivo. Son los metadatos de Ironchip que configurarás en WordPress.

    Pestaña Identity Provider (IdP) con los datos de Ironchip como proveedor de identidad

  6. Haz clic en Add.

Configuración del proveedor de identidad en WordPress (IdP)

Sección titulada «Configuración del proveedor de identidad en WordPress (IdP)»
  1. Vuelve a WordPress, al mismo apartado Ajustes > WP SAML Auth, y configura Identity Provider Settings con el archivo de metadatos de Ironchip que acabas de guardar.
  2. Para el certificado, copia el Signing X.509 Certificate de la pestaña Identity Provider (IdP) de Ironchip (o el certificado de sus metadatos) y dale formato con una herramienta como Format X.509 Certificate de samltool.com. El resultado empieza por -----BEGIN CERTIFICATE----- y termina con -----END CERTIFICATE-----.
  3. Copia el contenido formateado y crea un fichero de certificado con extensión .crt. Guárdalo en una carpeta de WordPress.
  4. Copia la ruta de ese certificado en x509 Certificate Path.
  5. Configura el atributo user_login con este valor para que la comunicación sea correcta: urn:oid:0.9.2342.19200300.100.1.1.
  1. Instala el plugin de miniOrange. Cuando termine, el plugin aparece en la columna de la derecha para configurarlo.

  2. En la primera pestaña, el plugin te pide configurar el IdP. Puedes hacerlo de forma manual o automática. Para obtener los metadatos de Ironchip, empieza a crear una aplicación SAML: en la consola de Ironchip, ve a Applications > New application, haz clic en SAML y escribe el nombre de la aplicación en Name, en la pestaña General.

    Página Your applications con el botón New application

  3. En la pestaña Identity Provider (IdP), copia la URL Metadata, ábrela en el navegador, guarda el XML como archivo e impórtalo en WordPress. No cierres la ventana de Ironchip: si la cierras antes de hacer clic en Add, se pierde lo que hayas rellenado.

    Pestaña Identity Provider (IdP) con los datos de Ironchip y la URL Metadata

  1. Vuelve a la ventana de Ironchip y abre la pestaña Service Provider (SP). Despliega Import Metadata y, en SP Metadata, elige File y sube el archivo de metadatos del plugin, o elige Text y pega su contenido. Haz clic en Import.

    Pestaña Service Provider (SP) con la sección Import Metadata

  2. Haz clic en Add para crear la aplicación.

Antes de probar, da acceso a la aplicación de Ironchip al usuario con el que vas a iniciar sesión. Los pasos están en Dar acceso a usuarios y grupos.

  • WP SAML Auth: cierra la sesión de WordPress e inicia una nueva con SAML. WordPress te redirige a Ironchip para autenticarte y después te devuelve al panel de administración.
  • miniOrange: vuelve a Service Provider Setup en WordPress y haz clic en Test Configuration para probar el inicio de sesión con Ironchip.
Problema Causa probable Solución
WordPress rechaza el certificado El certificado no tiene formato ni cabecera Dale formato con samltool.com, comprueba que empieza por -----BEGIN CERTIFICATE----- y guárdalo como .crt
WordPress no reconoce al usuario El atributo user_login no coincide con el que envía Ironchip Usa urn:oid:0.9.2342.19200300.100.1.1, el nombre de usuario que envía Ironchip (consulta los atributos SAML)
La consola de Ironchip no deja crear la aplicación Falta el Entity ID o la Location de Assertion Consumer Services en la pestaña Service Provider (SP) Escribe los valores de WordPress o importa los metadatos del plugin con Import Metadata

Zoho One

Integrar Zoho One con Ironchip por SAML: crear la aplicación, añadir el proveedor de identidades, formatear el certificado X.509 y activar la directiva.

Ironchip actúa como proveedor de identidad SAML de Zoho One. Esta guía explica cómo configurar ambas partes y asignar los usuarios que podrán autenticarse con Ironchip.

  • Acceso a la consola de administración de Ironchip.
  • Un usuario con permisos para realizar la configuración en Zoho One.
  1. En la consola de Ironchip, ve a Applications y haz clic en el botón verde New application.

    Botón New application en la sección Applications de la consola de Ironchip

  2. En el diálogo, selecciona SAML en Standard authentication protocols.

    Selección de SAML entre los protocolos de autenticación estándar

  3. En la pestaña General, escribe un nombre descriptivo en Name, por ejemplo Zoho One.

Sigue los pasos de esta guía sin cerrar la ventana Add new application: la consola no crea la aplicación hasta que rellenas los datos de Zoho One en la pestaña Service Provider (SP), y si cierras la ventana antes de hacer clic en Add se pierde lo que hayas rellenado. El procedimiento general está en Aplicaciones SAML.

En el paso Configure service de la aplicación, abre la pestaña Identity Provider (IdP) y copia estos valores, que necesitarás en Zoho One:

  • URL SSO (Single Sign On Service): será tu URL de inicio de sesión en Zoho.
  • URL SLO: se obtiene sustituyendo /sso por /slo en la URL anterior.
  • Certificado X.509: copia el Signing X.509 Certificate con su botón de copiar.

Pestaña Identity Provider (IdP) del paso Configure service con la URL del Single Sign On Service

  1. Accede al panel de Zoho One. En el menú superior, despliega el selector de espacios y haz clic en Administrar espacios.

    Selector de espacios con la opción Administrar espacios

  2. En el panel lateral izquierdo, ve a Seguridad > Proveedor de identidades y haz clic en Agregar proveedor de identidades.

    Sección Seguridad con el botón Agregar proveedor de identidades

  3. Selecciona el tipo SAML y rellena los campos con los datos que copiaste de Ironchip:

    • URL de inicio de sesión: pega la URL SSO de Ironchip.
    • URL de cierre de sesión: pega la misma URL cambiando /sso por /slo.
    • Formato de ID de nombre: selecciona Dirección de correo electrónico.
    • Certificado X509: sube el archivo .crt con el certificado formateado (consulta el apartado siguiente).

El certificado copiado de Ironchip debe tener el formato correcto antes de importarlo.

  1. Ve a https://www.samltool.com/format_x509cert.php.

  2. Pega el contenido del certificado en el campo X.509 cert y haz clic en FORMAT X.509 CERTIFICATE.

    Herramienta para formatear un certificado X.509 con el botón FORMAT X.509 CERTIFICATE

  3. Copia el resultado y guárdalo como archivo de texto con extensión .crt (por ejemplo, SAMLcert.crt).

  4. Vuelve a Zoho One e importa el archivo .crt en el campo Certificado X509.

    Formulario Agregar proveedor de identidades de Zoho One con las URL de Ironchip y el certificado SAMLcert.crt

Cuando guardes el proveedor de identidades en Zoho One, el sistema muestra los metadatos del Service Provider.

  1. Copia estos valores:

    • EntityID / Emisor (Issuer).
    • URL del Assertion Consumer Service (ACS).

    Configuración de SSO de Zoho One con la URL de servicios de consumidor de aserciones y el emisor

  2. Vuelve a la ventana Add new application de Ironchip y abre la pestaña Service Provider (SP).

  3. Pega el EntityID en Entity ID y la URL del ACS en Location, dentro de Assertion Consumer Services.

    Campos Entity ID y Assertion Consumer Services de la aplicación SAML en Ironchip

Activar el proveedor de identidades en la directiva

Sección titulada «Activar el proveedor de identidades en la directiva»
  1. En Zoho One, ve a Seguridad > Directivas de enrutamiento y edita la directiva Valor predeterminado.

    Directivas de enrutamiento con la directiva Valor predeterminado

  2. Abre la pestaña Modos de autenticación, activa la opción Proveedor de identidades y marca la casilla de Ironchip.

  3. Haz clic en Actualizar.

    Modos de autenticación de la directiva con el proveedor de identidades de Ironchip marcado

  1. Vuelve a la consola de Ironchip y termina de crear la aplicación haciendo clic en Add.

  2. En Your applications, busca la aplicación y, en la columna Add access, haz clic en Add.

  3. Asigna los usuarios o grupos que podrán autenticarse en Zoho One a través de Ironchip. Consulta Dar acceso a usuarios y grupos.

    Lista Your applications de Ironchip con el botón Add de la columna Add access junto a Zoho One

  1. Pide a un usuario al que hayas dado acceso que inicie sesión en Zoho One con el proveedor de identidades de Ironchip.
  2. Zoho One lo redirige a Ironchip para autenticarse.
  3. Cuando completa la autenticación en su dispositivo, vuelve a Zoho One con la sesión iniciada.
Problema Causa probable Solución
El inicio de sesión falla después de importar el certificado El certificado no tiene el formato correcto Vuelve a formatearlo con la herramienta indicada y comprueba que empieza por -----BEGIN CERTIFICATE----- y termina con -----END CERTIFICATE-----
Zoho One no reconoce al usuario El Formato de ID de nombre no es Dirección de correo electrónico, o el nombre de usuario del acceso en Ironchip no es el correo del usuario Corrige el formato en Zoho One y edita el acceso del usuario a la aplicación en Ironchip para usar como nombre de usuario su correo de Zoho One
El usuario no puede autenticarse No tiene acceso a la aplicación en Ironchip En la columna Add access de la aplicación, haz clic en Add y asigna el usuario o su grupo

Red, VPN y cortafuegos

Ironchip RADIUS server

Instalar el Ironchip RADIUS server para proteger servicios compatibles con RADIUS con una API key, sin NPS ni contraseñas: aplicación, instalación y ejemplo.

El Ironchip RADIUS server es un servidor RADIUS propio de Ironchip que permite integrar servicios compatibles con RADIUS mediante una API key, sin necesidad de usar NPS. Esta guía es para quien administra el servicio y lo instala en Windows o Linux. Funciona sin contraseñas: el usuario aprueba el acceso en su dispositivo.

  • Acceso a la consola de administración de Ironchip.
  • Un servidor Windows (64 bits) o Linux (64 bits) donde ejecutar el servidor RADIUS.
  • Que el equipo o servicio que quieres proteger (VPN, cortafuegos, wifi) pueda enviar peticiones RADIUS al puerto UDP 1812 de ese servidor.
  • Los usuarios dados de alta en Ironchip, o la sincronización de identidades configurada.

Crea una aplicación Passwordless RADIUS. La consola te da una API key que el servidor RADIUS usa para hablar con Ironchip.

  1. Ve a Applications y haz clic en New application.

  2. En la sección Standard authentication protocols, elige Passwordless RADIUS.

  3. Ponle un nombre identificativo (mínimo 3 caracteres) y haz clic en Add.

  4. Copia la API key o haz clic en Download credentials para descargarla en el fichero credentials.json.

  5. Da acceso a la aplicación a los usuarios o grupos que van a entrar por RADIUS. En Username composition, define la plantilla para que genere el nombre de usuario que envía el servicio protegido en la petición RADIUS. Consulta Dar acceso a usuarios y grupos.

  1. Descarga el ejecutable de la última versión: ironchip_lbauth_radius_server.exe para Windows o ironchip_lbauth_radius_server para Linux.

  2. Cópialo a una carpeta definitiva del servidor. El servicio se ejecuta desde esa ubicación, así que no la muevas después.

  3. Crea junto al ejecutable un fichero de configuración con el mismo nombre que el ejecutable y extensión .json: ironchip_lbauth_radius_server.json. Si renombras el ejecutable, renombra también el fichero.

  4. Pega este contenido y sustituye los valores entre <>:

    ironchip_lbauth_radius_server.json
    {
    "radius_address": "0.0.0.0:1812",
    "radius_key": "<SHARED_SECRET>",
    "ironchip_api_host": "https://api.ironchip.com",
    "ironchip_api_secret": "<API_KEY>",
    "log_level": "info"
    }
  5. Abre una terminal con permisos de administrador (PowerShell en Windows, o sudo en Linux) y ve a la carpeta del ejecutable.

  6. Instala el servicio:

    Windows
    .\ironchip_lbauth_radius_server.exe service install
    Linux
    chmod +x ironchip_lbauth_radius_server
    sudo ./ironchip_lbauth_radius_server service install
  7. Inicia el servicio:

    Windows
    .\ironchip_lbauth_radius_server.exe service start
    Linux
    sudo ./ironchip_lbauth_radius_server service start
  8. Configura el servicio que quieres proteger para que use este servidor como servidor RADIUS: la dirección del equipo donde corre, el puerto 1812 y el mismo secreto compartido que pusiste en radius_key.

Campo Obligatorio Valor por defecto Descripción
radius_address No 0.0.0.0:1812 Dirección y puerto UDP en los que escucha el servidor.
radius_key Sí Secreto compartido con el equipo que envía las peticiones RADIUS. Lo eliges tú, pero debe ser el mismo en el fichero y en ese equipo.
ironchip_api_host No https://api.ironchip.com URL de la API de Ironchip.
ironchip_api_secret Sí La API key de la aplicación Passwordless RADIUS.
log_level No info Nivel de registro: debug, info, warning, error o fatal.
attributes No Atributos RADIUS estándar que se añaden a la respuesta de acceso aceptado. Mira Atributos de respuesta.
vendor-specific_attributes No Atributos específicos de fabricante que se añaden a la respuesta. Mira Atributos de respuesta.

El ejecutable lee este fichero con cualquier comando, también con service install, así que créalo antes de instalar el servicio. Si no lo encuentra, falta un campo obligatorio o log_level no es válido, termina con un error.

Algunos equipos necesitan atributos en la respuesta RADIUS, por ejemplo para asignar a cada usuario un grupo de la VPN. Defínelos en attributes (atributos estándar del RFC 2865) y en vendor-specific_attributes (atributos de fabricante, que el servidor envía dentro del atributo 26). Cada atributo tiene tres campos:

  • number: el número del atributo. En vendor-specific_attributes es el número de fabricante (Vendor-Id).
  • type: el tipo del dato: string, short, integer o integer64.
  • data: un valor fijo o una plantilla con datos del usuario que acaba de autenticarse.

Puedes repetir el mismo number en varios atributos. La plantilla tiene que ser todo el valor de data, como en el ejemplo de abajo: si la mezclas con otro texto, el atributo no se envía. Estas son las plantillas disponibles:

Plantilla Dato
{{.subject}} Identificador del usuario.
{{.name}} Nombre del usuario.
{{.email}} Correo electrónico del usuario.
{{.timestamp}} Marca de tiempo de la autorización.
{{.external_username}} Nombre de usuario en el servicio externo.
{{.external_service_id}} Identificador del servicio externo.
{{.customer_name}} Nombre de la compañía.
{{.group_names}} Grupos del usuario. Se envía un atributo por cada grupo.
{{.location_name}} Nombre de la ubicación desde la que accede.
{{.location_score}} Puntuación de la ubicación.
ironchip_lbauth_radius_server.json
{
"radius_address": "0.0.0.0:1812",
"radius_key": "<SHARED_SECRET>",
"ironchip_api_host": "https://api.ironchip.com",
"ironchip_api_secret": "<API_KEY>",
"log_level": "info",
"attributes": [{ "number": 11, "type": "string", "data": "{{.group_names}}" }],
"vendor-specific_attributes": [{ "number": 43, "type": "string", "data": "1304" }]
}

En este ejemplo, el atributo Filter-Id (11) lleva el nombre de cada grupo del usuario. Usa el tipo string salvo que el equipo exija otro.

  1. Comprueba que el servicio está en marcha:

    Windows
    .\ironchip_lbauth_radius_server.exe service status
    Linux
    sudo ./ironchip_lbauth_radius_server service status

    La salida incluye status: running.

  2. Inicia sesión desde el servicio protegido con un usuario de Ironchip. El usuario recibe la petición de aprobación en su dispositivo y, al aprobarla, el servidor responde con acceso aceptado. Si Ironchip no autoriza al usuario, responde con acceso rechazado.

El servidor usa solo el nombre de usuario de la petición; la contraseña se ignora. Aun así, algunos equipos exigen rellenarla, como se ve en el ejemplo siguiente.

El ejecutable se maneja con service (alias s). service status también tiene el alias s, así que s s equivale a service status.

Comando Qué hace
service install Instala el servicio IronchipRADIUS (nombre visible: Ironchip RADIUS server).
service start Inicia el servicio.
service stop Detiene el servicio.
service restart Reinicia el servicio. Hazlo tras cambiar el fichero de configuración.
service status Muestra si el servicio está en marcha (running) o detenido (stopped).
service uninstall Desinstala el servicio.
service run Ejecuta el servidor en la terminal, fuera del gestor de servicios. Falla si el servicio no está instalado o ya está en marcha.

En Windows, el servidor escribe en el Visor de eventos, en el registro Application, con el origen Ironchip RADIUS Server. En Linux escribe en la salida del proceso, que recoge el gestor de servicios del sistema (con systemd, consúltala con journalctl -u IronchipRADIUS). Sube log_level a debug para ver el detalle de cada autorización, y vuelve a info cuando termines.

  • El servicio no arranca: comprueba que existe el fichero .json con el mismo nombre que el ejecutable, en la misma carpeta, y que radius_key e ironchip_api_secret tienen valor.
  • El equipo no recibe respuesta: abre el puerto UDP 1812 (o el de radius_address) en el cortafuegos del servidor y comprueba que el equipo apunta a la IP correcta.
  • Acceso rechazado para un usuario que existe: comprueba que ironchip_api_secret es la API key de la aplicación Passwordless RADIUS y que el nombre de usuario de la petición es el que Ironchip conoce. El servidor anota el error de autorización en el registro.
  • El secreto compartido no coincide: el equipo descarta las respuestas. Usa exactamente el mismo valor en radius_key y en el equipo.
  • Faltan atributos en la respuesta: comprueba que cada data es un valor fijo o una sola plantilla y que el dato es del tipo indicado en type. Si un atributo falla, el servidor acepta el acceso igualmente, pero no envía ese atributo ni los siguientes, y anota el error en el registro.

El vídeo muestra el acceso a una VPN de WatchGuard con el Ironchip RADIUS server en funcionamiento.

En el vídeo se escribe una contraseña porque WatchGuard no permite campos vacíos. El texto de ese campo puede ser aleatorio, como en los dos ejemplos del vídeo.

Acceso a una VPN de WatchGuard con el Ironchip RADIUS serverReproducir el vídeo

Microsoft NPS

Protege Microsoft NPS con el plugin de Ironchip: crea la política de red, instala el plugin, registra la aplicación y prueba el acceso RADIUS con NTRadPing.

NPS (Servidor de directivas de redes) permite crear y aplicar directivas de acceso a la red de toda la organización para autenticar y autorizar solicitudes de conexión. Esta guía lo protege con Ironchip para poder usar Ironchip en otros servicios, como RDP o VPN, mediante RADIUS.

  • Un Directorio Activo funcional.
  • Servicios DHCP y DNS activos. Si no los tienes, consulta Preparar el entorno Windows.
  • Acceso a la consola de administración de Ironchip.

En Ironchip creas un servidor NPS, cuya API key usa el plugin, y una aplicación para cada política de red que protege el plugin. Los detalles están en Servidores NPS (RADIUS).

  1. Ve a Applications y haz clic en New application.

  2. En la sección RADIUS NPS server configuration, haz clic en New NPS server. En la ventana Add RADIUS Server, escribe un nombre reconocible en Name y haz clic en Add.

    Ventana Add RADIUS Server con el campo Name

  3. En la ventana Credentials for your new RADIUS Servers, copia la API key o descárgala con Download credentials. Guárdala: solo aparece esta vez y la necesitarás al instalar el plugin.

    Ventana Credentials for your new RADIUS Servers con la API key y el botón Download credentials

  4. En Applications > New application, sección RADIUS NPS server configuration, haz clic en Assign policy en la tarjeta del servidor que acabas de crear. En la pestaña General, escribe el nombre de la aplicación en Name.

  5. En la pestaña NPS, comprueba que NPS Server tiene seleccionado el servidor y escribe en Policy el nombre de la política de red que vas a proteger con el plugin (en esta guía, IronchipProtected). Haz clic en Add.

    Pestaña NPS con el servidor seleccionado en NPS Server y el nombre de la política de red en Policy

  6. Da acceso a la aplicación a los usuarios o grupos que se autentican por NPS. En Username composition, define la plantilla para que el nombre de usuario tenga el formato Dominio\Usuario. Consulta Dar acceso a usuarios y grupos.

Crear la aplicación en Ironchip y añadir usuarios para NPSReproducir el vídeo

Instala el rol Servicios de acceso y directivas de redes desde Agregar roles y características.

Animación disponible en la versión en línea: Asistente para agregar roles y características con el rol de servicios de directivas de redes

  1. Abre el servidor de directivas de redes. En la pestaña Directivas, haz clic derecho en Directivas de red y crea una nueva política.

    Menú contextual para crear una política de red nueva

  2. Ponle un nombre identificativo y haz clic en Siguiente. Este nombre se usa al instalar el plugin NPS para determinar qué política proteger.

    Nombre de la política de red

  3. Selecciona el grupo de usuarios al que se aplicará la política.

    Animación disponible en la versión en línea: Selección del grupo de usuarios de la política

  4. En la pestaña siguiente, deja seleccionado Acceso concedido.

    Opción Acceso concedido

  5. Configura los métodos de autenticación que usará la política y haz clic en Siguiente.

    Métodos de autenticación de la política

  6. Configura las restricciones que denegarán automáticamente el acceso si no se cumplen. Complétalo con las opciones que quieras y haz clic en Siguiente.

    Restricciones de la política

  7. Añade la configuración que se aplicará cuando se cumplan las restricciones de la política y haz clic en Siguiente.

    Configuración de la política

  8. Revisa el resumen de la configuración y haz clic en Finalizar.

    Resumen de la política de red

La política de red queda creada. Ya puedes instalar el plugin NPS.

Política de red añadida en el servidor de directivas de redes

  1. En la consola de Ironchip, ve a Plugins y, en la sección Windows Integrations, haz clic en Download en la tarjeta Windows NPS.

    Página Plugins de la consola con las secciones Logon y Authenticators y, debajo, el comienzo de la sección Windows Integrations

  2. Ejecuta el instalador.

    Pantalla inicial del instalador del plugin

  3. Haz clic en Next, acepta los términos de uso y vuelve a hacer clic en Next.

    Términos de uso del instalador

  4. Completa la pantalla siguiente y haz clic en Next:

    • Ironchip Host: tu host de Ironchip. Si usas la solución en la nube, es api.ironchip.com; si no, indica tu host personalizado.
    • Ironchip API Key: la API key del servidor NPS, que guardaste al crearlo en Configuración en Ironchip.
    • NPS Policies: el nombre de la política de red que quieres proteger con Ironchip NPS. En el ejemplo, la política creada, IronchipProtected. Para añadir más de una, sepáralas con comas.

    Datos del host, la API key y la política de red

  5. Con todos los parámetros correctos, haz clic en Install.

    Pantalla de confirmación de la instalación

  6. Cuando termine la instalación, haz clic en Finish.

    Instalación completada

Instala el certificado de https://api.ironchip.com en todos los dispositivos que vayan a utilizar este servicio.

Instalar en Windows Server 2008 y Windows Server 2012

Sección titulada «Instalar en Windows Server 2008 y Windows Server 2012»

Antes de instalar el plugin NPS de Ironchip en estas versiones, necesitas instalar JDK y .NET (nuestro equipo te proporciona estos componentes) y cambiar el formato del certificado de Ironchip para que sea aceptado.

  1. Abre el programa y haz clic en Next.
  2. Acepta los términos del acuerdo y haz clic en Next de nuevo.
  3. La ventana siguiente permite personalizar la instalación. La configuración por defecto es suficiente: haz clic en Next.
  4. Haz clic en Install.
  5. Cuando termine la instalación, haz clic en Finish.

Este paso es opcional en Windows Server 2012.

  1. Ejecuta el programa, acepta los términos y condiciones y haz clic en Install.
  2. Cuando termine la instalación, haz clic en Finish.

Cambiar el formato del certificado de Ironchip

Sección titulada «Cambiar el formato del certificado de Ironchip»
  1. Abre api.ironchip.com en tu navegador (vale cualquiera).
  2. Haz clic en No seguro y después en El certificado no es válido.
  3. En la ventana siguiente, ve a Detalles y haz clic en Copiar en archivo….
  4. Elige la tercera opción y selecciona Incluir todos los certificados en la ruta de acceso de certificación, si es posible. Haz clic en Siguiente.
  5. En la ventana nueva, haz clic en Siguiente.
  6. Elige la ruta donde quieres exportar el certificado y el nombre del archivo. Haz clic en Siguiente.
  7. Cuando termine la exportación, haz clic en Finalizar.

El certificado ya está en tu equipo con el formato correcto. Impórtalo ahora:

  1. Busca mmc en el buscador de programas y ábrelo.
  2. Elige Archivo y después Agregar o quitar complemento….
  3. Selecciona Certificados y haz clic en Agregar.
  4. Elige Cuenta de equipo y haz clic en Siguiente.
  5. Elige la primera opción y haz clic en Finalizar.
  6. En Raíz de consola, haz clic en Certificados (equipo local) y elige Entidades de certificación raíz de confianza.
  7. Despliega la carpeta Certificados. En el panel de la derecha, elige Más acciones, después Todas las tareas y Importar.
  8. Elige la ubicación donde exportaste el certificado. Selecciona la extensión correcta: elige Todos los archivos (*.*). Haz clic en Siguiente.
  9. En la ventana siguiente, haz clic en Siguiente de nuevo.
  10. Revisa el resumen de la importación y haz clic en Finalizar.
  11. Cuando aparezca el mensaje de importación correcta, haz clic en Aceptar.
  1. Abre el Visor de eventos para ver los registros del plugin NPS de Ironchip.
  2. Si todo está bien, verás NPSP Ironchip Plugin en la lista de registros de aplicaciones y servicios. Haz clic en él. Si el plugin está instalado, los registros muestran Ironchip NPS plugin initialized successfully.

Para comprobar que todo está bien configurado y funciona, usa la herramienta de terceros NTRadPing.

Aplicación NTRadPing

  1. Descarga la aplicación desde NTRadPing.

  2. Crea un cliente RADIUS para poder hacer la prueba: abre el servidor de directivas de redes, ve a Clientes y servidores RADIUS y crea uno nuevo con clic derecho en Clientes RADIUS.

    Menú contextual para crear un cliente RADIUS

  3. En el panel que se abre, introduce estos datos:

    1. Un nombre identificativo para el cliente RADIUS.
    2. La IP del servidor en el que vas a instalarlo.
    3. Una clave secreta para RADIUS.

    Panel de propiedades del cliente RADIUS

  4. Reinicia el servicio para que se apliquen los ajustes.

  5. Abre NTRadPing y completa los campos:

    1. IP de tu servidor.
    2. Puerto de conexión (por defecto, 1645).
    3. Tiempo antes de abortar y número de veces que se ejecutará.
    4. Contraseña del usuario.
    5. Clave del servidor RADIUS.
    6. Usuario que se va a utilizar.

    Campos de NTRadPing rellenados

Tutorial de Ironchip con NPSReproducir el vídeo

El plugin muestra sus mensajes en inglés. Cada apartado cita el mensaje tal como aparece y explica qué significa.

“User XXX is not authenticated in service XXX. Please, try again.”

Sección titulada «“User XXX is not authenticated in service XXX. Please, try again.”»

El usuario no está autenticado o la autenticación no ha sido válida. Vuelve a intentar la autenticación en la misma página.

El mensaje completo es: “Unable to load IronChip license key. Check that it is the correct license and try again. If problem persist contact IronChip support for help.” (No se puede cargar la clave de licencia de Ironchip).

El formato de la licencia no es válido. Escribe a info@ironchip.net con el error: validaremos la clave de licencia que usas y te daremos una válida si no lo es.

“Id. de evento 4402: no hay ningún controlador de dominio disponible para el dominio”

Sección titulada «“Id. de evento 4402: no hay ningún controlador de dominio disponible para el dominio”»

No necesitas cambiar el nombre de tu dominio ni volver a una revisión anterior. Se resuelve añadiendo esta clave de registro, que fuerza a la autenticación a usar el nombre DNS en lugar del nombre NetBIOS:

  • Nuevo valor de cadena (REG_SZ): Default Domain.
  • Datos: ejemplo.loc (o ejemplo.dominio.loc).

El mensaje completo es: “The API-Key provided is not valid. Please, contact IronChip support and send logs for assistance.” (La API key proporcionada no es válida).

La licencia tiene el formato correcto, pero es antigua o no es válida. Escribe a info@ironchip.net con el error: validaremos la clave de licencia que usas y te daremos una válida si no lo es.

El mensaje completo es: “Ironchip has failed. Sorry. Contact support to allow us to solve the problem.” (Ironchip ha fallado).

Ha ocurrido algo inesperado. Escribe al soporte de Ironchip, info@ironchip.net, y adjunta el registro de error que aparece en los registros MFA de Ironchip del Visor de eventos.

Check Point

Proteger la VPN de acceso remoto de Check Point con Ironchip por RADIUS, con un servidor NPS para usuarios del dominio o con el Ironchip RADIUS server.

Esta guía explica cómo proteger el acceso remoto de Check Point con la autenticación de Ironchip mediante RADIUS. Hay dos opciones de servidor RADIUS, y la configuración en Check Point es la misma para las dos: un servidor NPS para los usuarios del dominio (Active Directory) o el Ironchip RADIUS server para los usuarios propios de Check Point.

  • Para usuarios del dominio (Active Directory): un servidor NPS con el plugin de Ironchip y una aplicación de Ironchip para su política de red, creada con Assign policy en la tarjeta del servidor NPS. Consulta Servidores NPS (RADIUS).
  • Para usuarios propios de Check Point: el Ironchip RADIUS server instalado y configurado con la API key de una aplicación Passwordless RADIUS.
  • Acceso a la aplicación de Ironchip (la de NPS o la Passwordless RADIUS) para los usuarios que van a conectarse. Consulta Dar acceso a usuarios y grupos.
  • Acceso a la Smart Console de Check Point.

Escenario base de Check Point:

Diagrama del escenario base de Check Point sin Ironchip

Integración con Ironchip:

Diagrama de la integración de Check Point con Ironchip

  1. Abre la Smart Console de Check Point.

    Pantalla principal de la Smart Console de Check Point

  2. En la parte superior derecha, haz clic en New y elige Host.

    Menú New con la opción Host

  3. Escribe un nombre para el host en Enter Object Name y, en IPv4 address, la IP del equipo donde se ejecuta el servidor RADIUS (el servidor NPS o el Ironchip RADIUS server). Haz clic en OK.

    Ventana de creación del host con nombre e IP

    Se crea el host.

    Host creado en la Smart Console

  1. En el buscador de la esquina superior derecha, busca RADIUS y clona el protocolo de la sección UDP service. Así generas un nuevo servicio RADIUS con las propiedades que habilitan el acceso.

  2. En la pestaña General, ponle un nombre al servicio (por ejemplo, Ironchip_Protected_Protocol), comprueba que el protocolo y el puerto coinciden con los de tu servidor RADIUS y haz clic en OK.

    Propiedades generales del servicio RADIUS: nombre, protocolo y puerto

  3. En la pestaña Advanced, en Virtual session timeout, elige Specific con valor 60, deja desmarcada Enable aggressive aging y haz clic en OK.

    Pestaña Advanced del servicio UDP con Virtual session timeout en 60 segundos

  1. Con el host y el servicio ya creados, crea un servidor RADIUS: en la parte superior derecha, ve a New > More > Server > RADIUS….

    Creación de un nuevo servidor RADIUS

  2. Ponle un nombre descriptivo y configúralo en la ventana siguiente. En este ejemplo se llama NPS_IRONCHIP_RADIUS.

    Configuración del servidor RADIUS NPS_IRONCHIP_RADIUS

    • Host: el host creado en el primer paso.
    • Service: el servicio creado en el paso anterior.
    • Shared secret: una cadena segura que debe coincidir con la configurada en NPS o en el Ironchip RADIUS server.
    • Protocol: PAP.
  3. Haz clic en OK.

Crea un perfil de usuario externo (External User Profile), necesario para autenticar usuarios que no están registrados internamente en Check Point.

  1. En la página principal de la Smart Console, en el menú de la izquierda, ve a Manage & Settings > Mobile Access y haz clic en Configure in SmartDashboard….

    Activación de Mobile Access en Manage & Settings

  2. En SmartDashboard, en el panel Users de la parte inferior izquierda, crea un nuevo External User Profile. Configura sus parámetros según tu dominio y haz clic en OK.

    Perfil de usuario externo (External User Profile)

  3. Crea un grupo para los usuarios del dominio. En la parte superior derecha ve a New > More > User/Identity > User Group.

    Menú New > More > User/Identity > User Group

  4. Ponle un nombre identificativo y haz clic en el icono +.

    Ventana del grupo de usuarios con el botón +

  5. Haz clic en All, después en External User Profiles y selecciona el perfil que has creado.

    Lista All con la opción External User Profiles

    Selección del perfil externo creado

  1. Ve a Security Policies > VPN Communities, haz clic derecho sobre Remote Access y elige Edit.

    Menú contextual de Remote Access en VPN Communities

  2. En la pestaña Participating Gateways, haz clic en + y selecciona tu cortafuegos.

    Pestaña Participating Gateways con el cortafuegos seleccionado

  3. En la pestaña Participant User Groups, haz clic en + y selecciona el grupo que has creado.

    Pestaña Participant User Groups con el grupo seleccionado

  4. En la pantalla principal, abre el gateway que tiene configurada la VPN y, en el panel izquierdo, selecciona VPN Clients > Authentication.

  5. Haz clic en Add y después en New, selecciona el tipo y haz clic en OK.

  6. En las opciones de Login Option, escribe un nombre (por ejemplo, NPS_IRONCHIP_ACCESS o RADIUS_IRONCHIP_ACCESS). Puedes rellenar también Comment y Display Name, que es el nombre que se muestra en la pantalla inicial. Haz clic en OK.

  7. En Authentication Methods, haz clic en Add, elige RADIUS como método y selecciona el servidor RADIUS que has creado. Haz clic en OK.

  8. En User Directories, selecciona Manual configuration y habilita la autenticación solo para External user profiles.

  1. En la parte superior izquierda, haz clic en Global Properties.

    Acceso a Global Properties en la Smart Console

  2. Ve al último apartado, Advanced, y haz clic en Configure.

    Apartado Advanced con el botón Configure

  3. Despliega Firewall-1, haz clic en Authentication y establece au_connect_timeout en 60.

    Parámetro au_connect_timeout en 60 dentro de Authentication

  4. Haz clic en RADIUS, establece radius_retrant_num en 1 y radius_retrant_timeout en 60.

    Parámetros radius_retrant_num y radius_retrant_timeout

Cuando todo esté configurado, haz una prueba de autenticación desde el cliente VPN con un usuario que tenga acceso. Elige el método de inicio de sesión que has creado (aparece con su Display Name) e introduce tus credenciales: después se te pedirá que te autentiques con Ironchip.

  • La autenticación falla porque se agota el tiempo de espera: Ironchip espera la respuesta del usuario, así que los tiempos tienen que ser largos. Comprueba Virtual session timeout (60), au_connect_timeout (60), radius_retrant_timeout (60) y radius_retrant_num (1).
  • El servidor RADIUS rechaza la petición: comprueba que el secreto compartido es el mismo en Check Point y en NPS o en el Ironchip RADIUS server, y que el host del servidor RADIUS tiene la IP correcta.

Citrix VPN

Proteger Citrix Gateway con Ironchip por RADIUS y NPS: configurar RADIUS, LDAP y el servidor virtual de Citrix, y depurar problemas de autenticación.

Esta guía explica cómo integrar tu VPN de Citrix con la autenticación de Ironchip mediante RADIUS.

  • Un servidor Windows con NPS protegido por Ironchip.
  • Una aplicación de Ironchip para la política de red de NPS que usa Citrix, creada con Assign policy en la tarjeta del servidor NPS y con el nombre de la política en Policy. Consulta Servidores NPS (RADIUS).
  • Acceso a la consola de administración de Ironchip.
  • Citrix VPN implementado y funcional.
  1. Crea un cliente RADIUS que apunte a la dirección IP de tu instalación de Citrix.

    Cliente RADIUS en NPS apuntando a la IP de Citrix

  2. Comprueba que el cortafuegos del servidor tiene una regla que acepta los puertos de LDAP y RADIUS.

  1. En el panel de configuración de Citrix, ve a Citrix Gateway > Policies > Authentication > RADIUS > Servers y haz clic en Add.

    Menú Citrix Gateway > Policies > Authentication > RADIUS > Servers

  2. Rellena los datos:

    • Name: un nombre descriptivo para la configuración.
    • IP Address y Port: la IP y el puerto por los que Citrix se comunicará con tu servidor RADIUS.
    • Secret Key y Confirm Secret Key: el secreto compartido de tu servidor RADIUS.
    • Transport: el protocolo de transporte.
    • Time-out (seconds): 60.

    Formulario del servidor RADIUS en Citrix

  3. Despliega More.

    Desplegable More del servidor RADIUS

  4. Ve al final de la página y modifica estos parámetros:

    • Password Encoding: mschapv2.
    • Authentication Server Retry: 1.
    • Comprueba que la casilla Authentication está marcada.

    Parámetros Password Encoding, Server Retry y Authentication

  5. Haz clic en OK y guarda la configuración.

  6. Ve al apartado Policies y crea dos políticas que apunten al servidor RADIUS creado. Los nombres son opcionales, pero te recomendamos usar los mismos para facilitar los pasos siguientes.

    Nombre Expresión
    ReceiverSelfService REQ.HTTP.HEADER User-Agent CONTAINS CitrixReceiver
    ReceiverForWeb REQ.HTTP.HEADER User-Agent NOTCONTAINS CitrixReceiver

    Políticas RADIUS ReceiverSelfService y ReceiverForWeb

Hace falta una segunda autenticación por LDAP. Solo sirve para que Citrix lea los usuarios del Active Directory, no para iniciar sesión.

  1. Ve a Citrix Gateway > Policies > Authentication > LDAP > Servers y haz clic en Add.

    Menú Citrix Gateway > Policies > Authentication > LDAP > Servers

  2. Modifica los parámetros:

    • Name: un nombre descriptivo.
    • IP Address, Security Type y Port: la IP de tu servidor RADIUS, el tipo de seguridad y el puerto LDAP. Te recomendamos SSL con el puerto 636.
    • Server Type, Time-out (seconds) en 60 y la opción Authentication desmarcada.
    • En Connection Settings, tu dominio en formato DC=,DC= en Base DN (location of users) y el Administrator Bind DN con su contraseña. Para obtener el Bind DN, ejecuta en PowerShell get-aduser <usuario> -Properties * y busca el parámetro DistinguishedName.

    Formulario del servidor LDAP en Citrix

  3. Cambia Server Logon Name Attribute a SamaccountName y guarda la configuración.

    Parámetro Server Logon Name Attribute con SamaccountName

  4. Ve al apartado Policies y crea dos políticas que apunten al servidor LDAP creado. Los nombres son opcionales, pero te recomendamos usar los mismos.

    Nombre Expresión
    LDAP-Corp-ReceiverSelfService REQ.HTTP.HEADER User-Agent CONTAINS CitrixReceiver
    LDAP-Corp-ReceiverForWeb REQ.HTTP.HEADER User-Agent NOTCONTAINS CitrixReceiver

    Políticas LDAP LDAP-Corp-ReceiverSelfService y LDAP-Corp-ReceiverForWeb

  1. Ve a la configuración de Virtual Servers y edita el que aloja la VPN.

    Lista de Virtual Servers en Citrix

  2. En Basic Authentication, añade las cuatro políticas creadas en este orden:

    Política Tipo Prioridad
    LDAP-Corp-ReceiverForWeb LDAP Primary
    ReceiverSelfService RADIUS Primary
    LDAP-Corp-ReceiverSelfService LDAP Secondary
    ReceiverForWeb RADIUS Secondary

    Políticas de autenticación añadidas al servidor virtual

En la consola de administración de Ironchip, da acceso a los usuarios a la aplicación de la política de red que usa Citrix; consulta Dar acceso a usuarios y grupos. Al iniciar sesión en la VPN, después de introducir usuario y contraseña, se te pedirá que te autentiques con Ironchip.

Para depurar la autenticación y ver un registro completo en tiempo real:

  1. Conéctate a la interfaz de línea de comandos del ADC (Application Delivery Controller) con un cliente SSH.

  2. Cambia al indicador de comandos de la shell:

    Ventana de terminal
    shell
  3. Cambia al directorio /tmp:

    Ventana de terminal
    cd /tmp
  4. Inicia la depuración:

    Ventana de terminal
    cat aaad.debug

Fortinet

Proteger la VPN de FortiGate con Ironchip: SSL VPN por SAML o RADIUS con NPS, y túnel IPsec de acceso remoto con SAML, con comprobación con FortiClient.

Esta guía explica las formas de integrar Fortinet (FortiGate) con Ironchip: SSL VPN con SAML, SSL VPN con RADIUS a través de NPS, e IPsec de acceso remoto con SAML.

Integra la VPN SSL de FortiGate con la autenticación de Ironchip por SAML.

  • Acceso a la consola de administración de Ironchip.
  • Un usuario con permisos para realizar la configuración en Fortinet.
  1. En la consola de administración de Ironchip, ve a Applications y haz clic en New application.

    Página Your applications con el botón New application

  2. En Select service type, haz clic en SAML. En la pestaña General, escribe el nombre de la aplicación en Name.

  3. En la pestaña Identity Provider (IdP), copia la dirección de URL Metadata y ábrela en el navegador para descargar el XML con los metadatos de Ironchip. Lo usarás para terminar la configuración en FortiGate.

    Pestaña Identity Provider (IdP) con los datos de Ironchip como proveedor de identidad

Deja abierta la ventana Add new application: la consola no crea una aplicación SAML sin los datos del proveedor de servicio, y los de FortiGate los importarás en Volver a Ironchip: metadatos de FortiGate. Consulta Aplicaciones SAML.

  1. En el panel de administración de FortiGate, ve a User & Authentication > Single Sign-On y haz clic en Create New, arriba a la izquierda.

    Botón Create New en Single Sign-On

  2. Configura estos parámetros, todos obligatorios:

    • Name: un nombre identificativo.
    • Address, en Service Provider Configuration: la dirección IP pública a la que se enviará la solicitud de autenticación. Normalmente es la misma IP que la de la VPN.
    • Entity ID, Assertion consumer service URL y Single logout service URL: las URL que usará Ironchip para comunicarse con Fortinet.
    • Certificate: el certificado de Fortinet que se utilizará.

    Primera pantalla de configuración del SSO en FortiGate

  3. Haz clic en Next. El segundo apartado se edita con comandos: haz clic en Edit in CLI.

    Botón Edit in CLI

  4. En la consola que se abre, ejecuta estos comandos y sustituye <IP VPN> por la IP de tu VPN:

    set entity-id "https://<IP VPN>/remote/saml/metadata/"
    set single-sign-on-url "https://<IP VPN>/remote/saml/login"
    set single-logout-url "https://<IP VPN>/remote/saml/logout"
    end
  5. Cierra la terminal y haz clic en Cancel. Así evitas que se restablezcan los datos por defecto.

Importa en la aplicación de Ironchip los metadatos de FortiGate como proveedor de servicio.

  1. Abre una terminal en Fortinet y ejecuta:

    diag vpn ssl saml-metadata "<SAML NAME HERE>"
  2. Copia el resultado. En la ventana Add new application de Ironchip, abre la pestaña Service Provider (SP) y despliega Import Metadata. En SP Metadata, elige Text, pega el resultado y haz clic en Import.

    Pestaña Service Provider (SP) con la sección Import Metadata desplegada y las opciones URL, Text y File

  3. Haz clic en Add para crear la aplicación en Ironchip.

  4. Da acceso a la aplicación a los usuarios o grupos que van a conectarse a la VPN. Consulta Dar acceso a usuarios y grupos.

Vuelve a la pantalla de Fortinet donde lo dejaste. Ten abierto el archivo de metadatos de Ironchip que descargaste desde URL Metadata.

  1. En Type, selecciona Custom.

  2. Rellena las URL del IdP con los datos del archivo de metadatos:

    • EntityID: la propiedad entityID de la etiqueta XML EntityDescriptor.
    • Assertion consumer service URL: la propiedad Location de la etiqueta XML SingleSignOnService.
    • Single logout service URL: la propiedad Location de la etiqueta XML SingleLogoutService.
    • Certificate: crea un fichero con extensión .crt y pega en él el resultado de introducir el contenido de la etiqueta XML X509Certificate del archivo de metadatos en el primer campo de SAML Tool. Los dos certificados son idénticos.
  3. Introduce los atributos:

    • Attribute used to identify users: urn:oid:0.9.2342.19200300.100.1.1
    • Attribute used to identify groups: urn:oid:1.3.6.1.4.1.5923.1.1.1.1

    Configuración de los datos del IdP y los atributos en FortiGate

  4. Haz clic en Submit para guardar la configuración.

  1. Crea un grupo que tenga como miembro la configuración de SSO de Fortinet.

    Grupo de usuarios con la configuración de SSO como miembro

  2. Añade el grupo a la configuración de la SSL VPN, en Authentication/Portal Mapping.

    Grupo añadido en Authentication/Portal Mapping

  3. Añade el grupo a la política de la VPN, en el apartado Source.

    Grupo añadido en el campo Source de la política de la VPN

  4. Configura los tiempos de autenticación. Abre una terminal de Fortinet con el icono de la parte superior derecha y ejecuta estos comandos, que dan 60 segundos para autenticarse a los usuarios del grupo asociado:

    config user group
    edit <NOMBRE_DEL_GRUPO_PROTEGIDO>
    set authtimeout 60
    end
    config system global
    set remoteauthtimeout 60
    end

Autenticación por SAML o contraseña simultáneamente (opcional)

Sección titulada «Autenticación por SAML o contraseña simultáneamente (opcional)»

Para que los usuarios puedan entrar tanto por SAML como con contraseña local, elige una de estas opciones.

Opción 1. Añade los usuarios locales al grupo creado antes.

Usuarios locales añadidos al grupo de SAML

Opción 2. Crea un grupo nuevo con los usuarios locales.

Nuevo grupo con los usuarios locales

Después añade ese grupo a SSL-VPN Settings y a la política creada anteriormente.

Grupo local añadido a SSL-VPN Settings

Grupo local añadido a la política de la VPN

Implementa el servicio RADIUS en Fortinet e intégralo con un servidor NPS en un entorno de Active Directory.

  • Un Active Directory funcional.
  • El rol de NPS instalado en un Windows Server y protegido por Ironchip. Consulta Microsoft NPS.
  • El servidor NPS de Ironchip cuya API key usa el plugin, creado al proteger NPS. Consulta Servidores NPS (RADIUS).
  • La app de Ironchip descargada.
  1. En tu servidor AD, abre la configuración de NPS (Servidor de directivas de redes) y crea un nuevo cliente RADIUS que apunte a la IP de Fortinet.

    Creación de un cliente RADIUS en NPS

  2. Introduce estos datos:

    • Un nombre identificativo para RADIUS.
    • La IP de Fortinet.
    • Una clave secreta para RADIUS.

    Datos del cliente RADIUS: nombre, IP y secreto

  1. Entra en el panel de configuración de Fortinet desde un navegador, con la IP de tu Fortinet.

    Pantalla de acceso al panel de FortiGate

  2. Ve a User & Authentication > RADIUS Servers y añade uno nuevo.

    Menú User & Authentication > RADIUS Servers

  3. Rellena los datos: un nombre identificativo, la IP del servidor donde creaste el RADIUS y el secreto de RADIUS.

    Formulario del servidor RADIUS en FortiGate

  4. Para confirmar que se conectó correctamente, haz clic en Test Connectivity. Si el resultado es Successful, haz clic en Test User Credentials e inicia sesión con un usuario de tu dominio. Si falla, comprueba que el cortafuegos de Windows Server tiene una regla de entrada que permite el tráfico RADIUS (UDP) desde la IP de Fortinet.

  5. Crea un grupo y usuarios que hagan referencia al dominio en Fortinet. Ve a User & Authentication > User Groups y añade uno nuevo.

    Menú User & Authentication > User Groups

  6. Ponle un nombre, selecciona la opción Firewall y en Remote groups selecciona tu servidor RADIUS.

    Formulario del grupo de usuarios con el servidor RADIUS remoto

  7. Para configurar los usuarios, ve a la pestaña User Definition y repite estos pasos por cada usuario:

    1. Haz clic en Create New.
    2. Selecciona Remote RADIUS User.
    3. Escribe el usuario con formato dominio\usuario y selecciona el servidor RADIUS creado antes.
    4. Deja Two-factor deshabilitado.
    5. Habilita User Group y selecciona el grupo creado.
Crear usuarios RADIUS remotos en FortiGateReproducir el vídeo

Para no crear los usuarios uno a uno, añade un atributo a la directiva de red del dominio.

  1. Abre el Servidor de directivas de red.

    Ventana del Servidor de directivas de red

  2. Ve a Directivas > Directivas de red y haz doble clic en la directiva.

    Lista de directivas de red

    Propiedades de la directiva de red

  3. Ve a Configuración, en Atributos RADIUS selecciona Específico del proveedor y haz clic en Agregar.

    Atributos RADIUS específicos del proveedor

  4. En el desplegable Proveedor, selecciona Personalizado y después la opción vendor-specific.

    Selección del proveedor personalizado

  5. Haz clic en Agregar. Aparece esta ventana:

    Ventana de información del atributo específico del proveedor

  6. Haz clic en Agregar y deja la ventana siguiente configurada así:

    Configuración del identificador de proveedor

  7. Haz clic en Configurar atributo y en la ventana que aparece establece:

    1. Número de atributo asignado por el proveedor: 1.
    2. Formato del atributo: Cadena.
    3. Valor de atributo: el grupo creado antes en Fortinet.

    Configuración del atributo con número 1, formato cadena y el grupo

  1. Ve a VPN > SSL-VPN Settings.

    Menú VPN > SSL-VPN Settings

  2. Modifica los campos así:

    • Selecciona las interfaces que vas a usar, por ejemplo la WAN o la LAN.
    • Cambia el puerto para evitar conflictos. Te recomendamos 4443 o 10443.
    • No es necesario crear un certificado, pero puedes crear uno autofirmado si lo necesitas.
  3. Baja hasta el final de la página, donde hay otros dos campos por configurar.

    Campos finales de SSL-VPN Settings: asignación de portal

  4. En Authentication/Portal Mapping, haz clic en Create New, selecciona tu grupo de usuarios y asígnale el portal tunnel-access.

  5. Haz clic en Apply.

  1. Ve a Policy & Objects > Firewall Policy y crea una política nueva.

    Pantalla Firewall Policy

  2. Configúrala así:

    • Name: un nombre para la política. Es el que escribirás en Policy al crear la aplicación en la consola de Ironchip y en el plugin.
    • Incoming Interface: SSL-VPN tunnel interface.
    • Outgoing Interface: la interfaz física.
    • Source: all y, muy importante, el grupo que has creado.
    • Destination: all.
    • Service: ALL.
  3. Haz clic en OK.

  4. Configura el timeout de Fortinet y de la conexión RADIUS en 60 segundos, para que los usuarios tengan tiempo de completar la autenticación. Abre una terminal de Fortinet con el icono de la parte superior derecha. Este comando da 60 segundos a los usuarios del grupo asociado:

    config user group
    edit <NOMBRE_DEL_GRUPO_PROTEGIDO>
    set authtimeout 60
    end
  5. Haz lo mismo para la conexión RADIUS:

    config system global
    set remoteauthtimeout 60
    end
  6. Cambia la configuración para que, al autenticarte, Fortinet no mande más de una petición:

    config user radius
    edit <NOMBRE_DEL_SERVIDOR_RADIUS_EN_FORTI>
    set timeout 60
    end

Crea la aplicación del servidor NPS para esta política y da acceso a los usuarios. Los detalles están en Servidores NPS (RADIUS).

  1. Ve a Applications y haz clic en New application. En la sección RADIUS NPS server configuration, haz clic en Assign policy en la tarjeta del servidor NPS.

  2. En la pestaña General, escribe el nombre de la aplicación en Name.

  3. En la pestaña NPS, comprueba que NPS Server tiene seleccionado el servidor y escribe en Policy el nombre de la política que pusiste en Política de cortafuegos y en el plugin. Haz clic en Add.

    Pestaña NPS con el servidor seleccionado en NPS Server y el nombre de la política en Policy

  4. Da acceso a la aplicación a los usuarios o grupos que van a conectarse a la VPN. En Username composition, usa el mismo formato de usuario que en los usuarios de FortiGate (dominio\usuario). Consulta Dar acceso a usuarios y grupos.

Crear la aplicación de Fortinet en la consola de IronchipReproducir el vídeo

El servidor NPS y Fortinet deben estar iniciados al hacer las pruebas.

  1. En FortiClient, selecciona ACCESO REMOTO.

    Opción Acceso remoto en FortiClient

  2. En la ventana siguiente, elige Configurar VPN.

    Opción Configurar VPN

  3. Rellena los datos de la VPN. Respeta el mismo patrón de identificación de usuario que hayas establecido en el grupo y en el acceso de la aplicación de Ironchip (Username composition). Haz clic en Guardar.

    Formulario de configuración de la VPN en FortiClient

  4. En la pantalla siguiente verás el nombre de la conexión y el usuario. Escribe la contraseña y haz clic en Conectar. Si el cortafuegos del equipo bloquea la conexión, crea una regla que permita a FortiClient conectar con la IP y el puerto de la VPN en lugar de desactivar el cortafuegos.

    Pantalla de conexión con usuario y contraseña

  5. Aparece una alerta de seguridad. Léela y haz clic en Sí.

    Alerta de seguridad al conectar

  6. Continúa el proceso de conexión. Recibirás un mensaje para autorizar el acceso desde la app de Ironchip. Al aceptarlo, se completa la conexión.

  7. Cuando se establece la conexión, aparece una ventana con una breve descripción.

    Ventana de conexión VPN establecida

Demostración de acceso a la VPN de Fortinet con IronchipReproducir el vídeo

Protege un túnel VPN IPsec de acceso remoto (dial-up, IKEv2) en FortiGate con autenticación SAML mediada por Ironchip.

  • Acceso administrativo a la GUI y a la CLI de FortiGate.
  • Una cuenta de administrador en la consola de Ironchip con permisos para crear aplicaciones SAML.
  • FortiClient VPN instalado en los equipos cliente, con soporte de SSO/SAML para IPsec.
  • Una VPN IPsec de acceso remoto (IKEv2).

Desde la CLI de Fortinet, ejecuta:

config system global
set auth-ike-saml-port 1001
end

Configura el SSO con SAML en Fortinet y en Ironchip.

  1. En FortiGate, ve a User & Authentication > Single Sign-On y haz clic en Create New.

    Botón Create New en Single Sign-On

  2. Indica un nombre para la configuración, la IP o el DNS de la VPN junto con el puerto SAML configurado antes y el certificado que uses en la VPN.

    Datos del proveedor de servicio: nombre, dirección, puerto SAML y certificado

  3. La siguiente ventana pide los metadatos del proveedor de identidad (IdP), en este caso Ironchip. Para obtenerlos, ve a la consola de administración de Ironchip > Applications > New application > SAML.

    Página Your applications con el botón New application

    Selección del tipo SAML

  4. Al crear la aplicación te pide un nombre. Usa uno descriptivo, porque aparecerá más tarde en los dispositivos autenticadores de los usuarios.

    Nombre de la aplicación SAML en Ironchip

  5. Ve al apartado Identity Provider (IdP) y copia estos datos:

    • IdP Entity ID or Issuer
    • Single Sign On Service (URL)
    • Signing X.509 Certificate. Este certificado debes importarlo en Fortinet.

    Datos del Identity Provider en Ironchip

    Deja abierta la ventana Add new application: crearás la aplicación al final, con los metadatos de Fortinet.

  6. Pega los datos en la configuración de Fortinet:

    • IdP Entity ID or Issuer en Entity ID.
    • Single Sign On Service en Assertion consumer service URL.
    • Single logout service URL: usa la misma URL que la de Assertion consumer service URL, pero cambia sso por slo en la ruta.
  7. Indica los atributos que pide Fortinet para autenticar a los usuarios:

    • Attribute used to identify users: urn:oid:0.9.2342.19200300.100.1.1
    • Attribute used to identify groups: urn:oid:1.3.6.1.4.1.5923.1.1.1.1

    Atributos de usuario y grupo en la configuración SAML de FortiGate

  8. Obtén los metadatos de Fortinet para importarlos en Ironchip. Abre la CLI global de Fortinet y ejecuta:

    diag vpn ssl saml-metadata "<SAML NAME HERE>"
  9. Copia el resultado. En la ventana Add new application de Ironchip, abre la pestaña Service Provider (SP) y despliega Import Metadata. Elige Text en SP Metadata, pega el resultado y haz clic en Import.

    Campo SP Metadata en el apartado Service Provider

  10. Haz clic en Add para terminar de crear la aplicación en Ironchip.

  11. Da acceso a la aplicación a los usuarios o grupos que van a conectarse a la VPN. Consulta Dar acceso a usuarios y grupos.

Asigna esta configuración SAML a un grupo, para poder asociarlo después a las políticas del cortafuegos.

Creación del grupo de usuarios con la configuración SAML

Grupo de usuarios creado

Edita la interfaz de fase 1 para sustituir PSK por EAP contra el grupo de usuarios de Ironchip:

config vpn ipsec phase1-interface
edit IPSEC-DIALUP
set eap enable
set eap-identity send-request
set authusrgrp SAML-Group
end

FortiWeb

Proteger el acceso a una web publicada con FortiWeb usando SAML e Ironchip: crear la aplicación, el servidor SAML y la regla de Site Publish.

Esta guía explica cómo proteger con Ironchip y SAML el acceso a una web publicada con FortiWeb.

  • Acceso a la consola de administración de Ironchip.
  • Un usuario con permisos para realizar la configuración en FortiWeb.
  1. En la consola de administración de Ironchip, ve a Applications y haz clic en New application.

    Página Your applications con el botón New application

  2. En Select service type, haz clic en SAML.

    Selección del tipo de aplicación SAML

  3. En la pestaña General, escribe el nombre de la aplicación en Name. Junto a General están las pestañas Service Provider (SP) e Identity Provider (IdP).

    Pestaña General con el nombre de la aplicación y las pestañas Service Provider (SP) e Identity Provider (IdP)

    • En Service Provider (SP) importarás los metadatos de FortiWeb.
    • En Identity Provider (IdP) están los metadatos de Ironchip, que importarás en FortiWeb.

Deja abierta la ventana Add new application: la consola no crea una aplicación SAML sin los datos del proveedor de servicio, y los de FortiWeb los importarás al configurar el servidor SAML. Consulta Aplicaciones SAML.

  1. En FortiWeb, ve a User > Remote Server > SAML Server y haz clic en Create New.

  2. Ponle un nombre (Name) al servidor SAML y, en Entity ID, escribe la IP o el DNS de la web que quieres proteger.

  3. Obtén los metadatos de Ironchip. Su URL está en el campo URL Metadata, al final de la pestaña Identity Provider (IdP) de la aplicación que estás creando en la consola de Ironchip.

    Campo URL Metadata al final de la pestaña Identity Provider (IdP) de la aplicación de Ironchip

  4. Abre esa URL en el navegador para descargar el XML. En FortiWeb, en Identity Provider Metadata, haz clic en Upload y sube ese XML. Haz clic en OK.

    Servidor SAML de FortiWeb con el Entity ID y el botón Upload de Identity Provider Metadata

  5. Con el servidor SAML creado, selecciónalo en la pestaña SAML Server y haz clic en Generate Service Provider Metadata. Se descarga otro XML.

    Opción Generate Service Provider Metadata

  6. En la ventana Add new application de Ironchip, abre la pestaña Service Provider (SP) y despliega Import Metadata. En SP Metadata, elige File, selecciona ese XML y haz clic en Import.

    Importación de los metadatos de FortiWeb en la aplicación de Ironchip

  7. Haz clic en Add para terminar de crear la aplicación.

Aplica el servidor SAML a la regla de Site Publish para que pida autenticación al acceder.

  1. En FortiWeb, ve a Application Delivery > Site Publish > Site Publish y edita la regla en la pestaña Site Publish Rule.

  2. En Client Authentication Method, selecciona SAML Authentication.

  3. En SAML Server, selecciona el servidor SAML que has creado y haz clic en OK.

    Regla de Site Publish con el servidor SAML aplicado

Da acceso a los usuarios en la aplicación creada en la consola de administración de Ironchip: ve a Applications, busca la aplicación de FortiWeb y, en la columna Add access, haz clic en Add. Los pasos de la ventana Add a new access están en Dar acceso a usuarios y grupos.

Botón Add para dar acceso en la aplicación de FortiWeb

Abre la web publicada con un usuario que tenga acceso a la aplicación. FortiWeb te pide que te autentiques con Ironchip antes de dejarte entrar.

OpenVPN

Proteger OpenVPN Access Server con Ironchip mediante SAML o RADIUS con NPS: crear la aplicación, configurar el servidor, dar acceso y probar el cliente.

Esta guía explica cómo integrar OpenVPN Access Server con Ironchip por SAML o por RADIUS a través de NPS.

  • OpenVPN Access Server configurado.
  • Acceso a la consola de administración de Ironchip.
  1. Ve a Applications y haz clic en New application.

  2. En Select service type, haz clic en SAML. En la pestaña General, escribe un nombre descriptivo en Name.

  3. En la pestaña Identity Provider (IdP), copia la dirección de URL Metadata y ábrela en el navegador para descargar el XML con los metadatos de Ironchip. Se los proporcionarás al proveedor de servicio (SP), en este caso OpenVPN.

    Pestaña Identity Provider (IdP) con los datos de Ironchip como proveedor de identidad

Deja abierta la ventana Add new application: la consola no crea una aplicación SAML sin los datos del proveedor de servicio, y los de OpenVPN los importarás en el paso 6 de Configuración en OpenVPN. Consulta Aplicaciones SAML.

  1. En OpenVPN, ve a Authentication > SAML.

    Apartado Authentication > SAML en OpenVPN

  2. Activa SAML. A continuación introducirás los metadatos de Ironchip que descargaste.

    Activación de SAML en OpenVPN

  3. OpenVPN ofrece dos opciones para introducir los metadatos: con el archivo descargado o de forma manual. En esta guía se usa el archivo: en Configure Identity Provider (IdP) Automatically via Metadata, haz clic en Seleccionar archivo.

    Selección del archivo de metadatos

  4. Selecciona el archivo de metadatos y haz clic en Upload. Para comprobar que se ha añadido correctamente, ve a la configuración manual: los campos deben estar rellenos con los datos correspondientes.

    Campos de la configuración manual rellenos con los metadatos

  5. Añade los metadatos del SP (OpenVPN) a la aplicación de Ironchip. En el apartado Service Provider (SP) identity and URL, copia la URL de SP Identity.

    Apartado Service Provider (SP) identity and URL

  6. En la ventana Add new application de Ironchip, abre la pestaña Service Provider (SP) y despliega Import Metadata. En SP Metadata, elige URL, pega la URL en URL of SP’s Metadata y haz clic en Import. Después, haz clic en Add para crear la aplicación.

    Pestaña Service Provider (SP) con la sección Import Metadata desplegada y las opciones URL, Text y File

  7. En OpenVPN, ve a Authentication > Settings, selecciona SAML como método de autenticación, haz clic en Save Settings y después en Update Running Server para aplicar los cambios.

    Settings con SAML como método de autenticación

Los pasos de la ventana Add a new access se explican con detalle en Dar acceso a usuarios y grupos.

  1. Entra en la aplicación creada en la consola de Ironchip y, en la pestaña Accesses, haz clic en Add access.

    Página de la aplicación con la pestaña Accesses y el botón Add access

  2. En Select a group, marca el usuario que hará la autenticación (o un grupo) y haz clic en Next.

    Paso Select a group con la lista de grupos y usuarios

  3. En Select usernames, define en Username composition el nombre de usuario con el que accederá a la VPN y haz clic en Next.

    Paso Select usernames con la plantilla del nombre de usuario

  4. En Select authentication policies, elige las políticas de autenticación que debe cumplir y haz clic en Next.

    Paso Select authentication policies con las políticas del acceso

  5. En Review, comprueba el resumen y haz clic en Add.

Al crear una nueva conexión en el cliente, te redirige al portal de cliente de OpenVPN, donde puedes elegir entre usar un usuario local o SAML.

Portal del cliente de OpenVPN con la opción de SAML

Autenticación con Ironchip desde el portal

Conexión establecida en el cliente de OpenVPN

  • El rol de NPS instalado en un servidor.
  • Acceso a la interfaz de administración de OpenVPN con permisos de administrador.
  • Acceso a la consola de administración de Ironchip con permisos de administrador.

Crea un servidor NPS y una aplicación para la política de red que protegerá el plugin. Los detalles están en Servidores NPS (RADIUS).

  1. Ve a Applications y haz clic en New application.

  2. En la sección RADIUS NPS server configuration, haz clic en New NPS server. En la ventana Add RADIUS Server, escribe un nombre descriptivo en Name, en este caso OpenVPN, y haz clic en Add.

    Ventana Add RADIUS Server con el campo Name

  3. En la ventana Credentials for your new RADIUS Servers, copia la API key o descárgala con Download credentials. Solo aparece esta vez y la necesitarás al instalar el plugin de NPS.

    Ventana Credentials for your new RADIUS Servers con la API key y el botón Download credentials

  4. En Applications > New application, sección RADIUS NPS server configuration, haz clic en Assign policy en la tarjeta del servidor OpenVPN. En la pestaña General, escribe un nombre descriptivo en Name. En la pestaña NPS, escribe en Policy el nombre de la política de red que crearás más tarde en el servidor y haz clic en Add.

    Pestaña NPS con el servidor seleccionado en NPS Server y el nombre de la política en Policy

  1. Crea dos grupos en el Directorio Activo: uno para autenticar con Ironchip y otro para los usuarios que no necesitan MFA.

  2. Con los grupos creados y los usuarios asignados, abre la administración de NPS y crea una política de red.

    Creación de una política de red en NPS

  3. En la ventana siguiente, haz clic en Add > User Groups y añade uno de los grupos creados.

    Adición de un grupo de usuarios a la política

  4. Haz clic en Next hasta llegar a Configure Authentication Methods. Marca Encrypted authentication (CHAP) y Unencrypted Authentication (PAP, SPAP). Haz clic en Next hasta finalizar.

    Métodos de autenticación CHAP y PAP seleccionados

  5. Ve a RADIUS Clients y crea un cliente RADIUS que apunte a OpenVPN Server. Indica un nombre descriptivo (el del SP al que apunta), la IP y el secreto compartido, que puedes escribir o generar automáticamente.

    Cliente RADIUS apuntando a OpenVPN Server

  6. En la consola de Ironchip, ve a Plugins y, en la sección Windows Integrations, haz clic en Download en la tarjeta Windows NPS para descargar el plugin en el servidor.

    Página Plugins de la consola con las secciones Logon y Authenticators y, debajo, el comienzo de la sección Windows Integrations

  7. Ejecuta el plugin, acepta los términos y condiciones y rellena los parámetros:

    • La API key del servidor NPS, que copiaste o descargaste al crearlo.
    • En NPS Policies, la política que quieres proteger con Ironchip.

    Parámetros del plugin de NPS

  1. En la interfaz de administración de OpenVPN, ve a Authentication y selecciona RADIUS. Activa RADIUS y los accounting reports.

    Activación de RADIUS y accounting reports

  2. Ve a RADIUS Server, añade la IP del servidor donde has configurado NPS y el secreto que pusiste en el cliente RADIUS.

    IP del servidor NPS y secreto en OpenVPN

Para que un usuario acceda a la VPN, además de estar en el grupo del Directorio Activo, tienes que generarle un acceso en la aplicación de la consola de Ironchip. Los pasos se explican con detalle en Dar acceso a usuarios y grupos.

  1. Entra en la aplicación en la consola de Ironchip y, en la pestaña Accesses, haz clic en Add access.

  2. En Select a group aparecen los usuarios y grupos de la plataforma. Marca el usuario que hará la autenticación y haz clic en Next.

  3. En Select usernames, el apartado Username composition empieza con la etiqueta email: quítala y escribe el nombre de usuario. Si tienes el Directorio Activo sincronizado, con AD Connect para un directorio on-premise o con una aplicación empresarial de Entra ID (antes Azure AD), puedes elegir en Enter a tag la etiqueta samAccountName, que aparece cuando los usuarios tienen ese atributo. Haz clic en Next.

    Paso Select usernames con la plantilla del nombre de usuario

  4. En Select authentication policies, elige las políticas de autenticación que debe cumplir y haz clic en Next.

  5. En Review, comprueba el resumen y haz clic en Add.

En el cliente de OpenVPN, genera un nuevo perfil y usa las credenciales del dominio para conectarte a la VPN.

Nuevo perfil en el cliente de OpenVPN

Al generar el perfil, te pide autenticarte.

Solicitud de autenticación al conectar

Palo Alto

Proteger GlobalProtect en Palo Alto con Ironchip mediante SAML o RADIUS con NPS: perfiles de autenticación, puerta de enlace y portal GlobalProtect.

Esta guía explica cómo integrar dispositivos Palo Alto con Ironchip mediante SAML o RADIUS. Con la integración puedes centralizar la gestión de usuarios y reforzar la seguridad en el acceso.

  • Acceso a la consola de administración de Ironchip.
  • Un usuario con permisos para realizar la configuración en Palo Alto.
  • GlobalProtect configurado, con un portal y una puerta de enlace.
  1. En la consola de administración de Ironchip, ve a Applications y haz clic en New application.

  2. En Select service type, haz clic en SAML. En la pestaña General, escribe el nombre de la aplicación en Name.

  3. En la pestaña Identity Provider (IdP), copia la dirección de URL Metadata y ábrela en el navegador para descargar el XML con los metadatos de Ironchip. Lo subirás a Palo Alto.

    Pestaña Identity Provider (IdP) con los datos de Ironchip como proveedor de identidad

Deja abierta la ventana Add new application: la consola no crea una aplicación SAML sin los datos del proveedor de servicio, y los de Palo Alto los importarás en Obtener los metadatos para Ironchip. Consulta Aplicaciones SAML.

  1. Inicia sesión en la consola de administración de Palo Alto Networks con privilegios suficientes.

  2. Ve a Device > Perfiles de servidor > Proveedor de identidad y haz clic en Importar para definir un nuevo IdP SAML.

    Menú Device > Perfiles de servidor > Proveedor de identidad

    Ventana de importación del IdP SAML

  3. Introduce estos datos:

    • Nombre de perfil: un nombre único e identificativo.
    • Metadatos de proveedor de identidad: el XML con los metadatos de Ironchip que descargaste en Configuración en Ironchip. Súbelo con Examinar….
    • Sesgo máximo de reloj (sec): 60.

    Ventana Importar perfil de servidor de proveedor de identidad SAML

  4. Haz clic en Aceptar y abre el perfil creado.

  5. Desmarca Validate Identity Provider Certificate y Firmar mensaje SAML en IDP.

  6. Haz clic en Aceptar para guardar.

    Perfil SAML con Validate Identity Provider Certificate y Firmar mensaje SAML en IDP desmarcados

  1. Ve a Device > Perfil de autenticación y haz clic en Añadir.

    Menú Device > Perfil de autenticación

  2. Modifica estos parámetros:

    • Nombre: un nombre identificativo.
    • Type: SAML.
    • Perfil de servidor IdP: el perfil SAML creado.
    • Habilitar cierre de sesión único: marcado.
    • Username Attribute: uid.
    • User Group Attribute: eduPersonAffiliation.

    Parámetros del perfil de autenticación SAML

  3. Haz clic en Aceptar. En la lista de perfiles de autenticación, haz clic en el enlace Metadatos del perfil que acabas de crear.

    Enlace Metadatos del perfil en la lista de perfiles de autenticación

  4. En la ventana Exportar metadatos de SAML, selecciona management en Servicio, introduce la IP de conexión de tu VPN y descarga los metadatos.

    Ventana Exportar metadatos de SAML con el servicio management y la IP de la VPN

  5. En la ventana Add new application de Ironchip, abre la pestaña Service Provider (SP) y despliega Import Metadata. En SP Metadata, elige File, selecciona el archivo descargado y haz clic en Import.

    Pestaña Service Provider (SP) con la sección Import Metadata desplegada y las opciones URL, Text y File

  6. Haz clic en Add para crear la aplicación en Ironchip.

Aplicar el perfil SAML a la puerta de enlace

Sección titulada «Aplicar el perfil SAML a la puerta de enlace»
  1. Ve a Network > GlobalProtect > Puertas de enlace y abre tu puerta de enlace GlobalProtect.

  2. En la pestaña Autenticación, dentro de Autenticación de cliente, haz clic en Añadir para actualizar la autenticación del cliente con el perfil que acabas de configurar.

  3. Deja la configuración predeterminada excepto estos campos:

    • Nombre: un nombre único e identificativo.
    • SO: Any.
    • Perfil de autenticación: el perfil de autenticación que configuraste antes.
    • Mensaje de autenticación: instrucciones para los usuarios finales, como Introduce tus credenciales.
  4. Haz clic en Aceptar para guardar.

    Autenticación de cliente de la puerta de enlace con el perfil SAML

Aplicar el perfil SAML al portal GlobalProtect

Sección titulada «Aplicar el perfil SAML al portal GlobalProtect»

Aplica al portal la misma configuración que acabas de aplicar a la puerta de enlace.

  1. Ve a Network > GlobalProtect > Portales y abre tu portal GlobalProtect.

  2. En la pestaña Autenticación, dentro de Autenticación de cliente, haz clic en Añadir para actualizar la autenticación del cliente con el perfil SAML.

  3. Deja la configuración predeterminada excepto estos campos:

    • Nombre: un nombre único e identificativo.
    • SO: Any.
    • Perfil de autenticación: el perfil de autenticación que configuraste antes.
    • Mensaje de autenticación: instrucciones para los usuarios finales, como Introduce tus credenciales.
  4. Haz clic en Aceptar para guardar.

    Autenticación de cliente del portal con el perfil SAML

Da acceso a los usuarios a la aplicación creada en la consola de Ironchip; consulta Dar acceso a usuarios y grupos. Conéctate con el cliente GlobalProtect con uno de ellos: al iniciar sesión se te pedirá que te autentiques con Ironchip.

  1. Ve a Device > Administradores y crea un perfil de administración o edita uno existente.

    Apartado Device > Administradores

  2. En Perfil de autenticación, selecciona el perfil SAML creado.

    Perfil de autenticación SAML en el administrador

  3. Ve a Device > Configuración y, en la pestaña Gestión, edita Configuración de autenticación con el icono del engranaje.

    Apartado Configuración de autenticación en Device > Configuración

  4. En Perfil de autenticación, selecciona el perfil SAML creado.

    Perfil de autenticación SAML en la configuración del dispositivo

Configura Palo Alto para que autentique contra RADIUS e intégralo con un servidor NPS en un entorno de Active Directory. Si prefieres no usar NPS, puedes usar el Ironchip RADIUS server: los datos de conexión (IP, secreto y puerto) son los de ese servidor.

  • Un servidor Windows con el rol de NPS configurado y protegido por Ironchip.
  • Una aplicación de Ironchip para la política de red de NPS que usa Palo Alto, creada con Assign policy en la tarjeta del servidor NPS y con el nombre de la política en Policy. Consulta Servidores NPS (RADIUS).
  • Un cliente RADIUS creado en NPS que apunte a la IP de Palo Alto, con su secreto compartido.
  • Acceso a la consola de administración de Ironchip.
  • Un usuario con permisos para realizar la configuración en Palo Alto.
  • Un servicio de VPN configurado y funcional.
  1. Inicia sesión en la consola de administración de Palo Alto Networks con privilegios suficientes.

  2. Ve a Device > Server Profiles > RADIUS y haz clic en Add para definir un perfil de servidor RADIUS.

    Ventana RADIUS Server Profile con el tiempo de espera, los reintentos y el servidor NPS

  3. Escribe un Profile Name único e identificativo y configura:

    • Timeout (sec): 60.
    • Authentication Protocol: PAP.
    • Retries: 1.
  4. En Servers, haz clic en Add e introduce:

    • Name: un nombre único e identificativo.
    • RADIUS Server: la dirección IP del servidor NPS.
    • Secret: el secreto compartido que definiste en el cliente RADIUS de NPS.
    • Port: el puerto UDP en el que escucha NPS para RADIUS, por ejemplo 1812.
  5. Haz clic en OK para guardar.

  1. Ve a Device > Authentication Profile y haz clic en Add.

  2. En la pestaña Authentication, deja los valores predeterminados excepto:

    • Type: RADIUS.
    • Server Profile: el perfil de servidor que definiste en el apartado anterior.

    Pestaña Authentication del perfil con el tipo RADIUS y el perfil de servidor

  3. En la pestaña Advanced, dentro de Allow List, haz clic en Add y selecciona all.

    Pestaña Advanced con all en la Allow List

  4. Haz clic en OK y después en Commit para guardar el perfil de autenticación RADIUS.

  5. Abre la CLI de Palo Alto Networks y prueba el perfil de autenticación.

Aplicar el perfil RADIUS a la puerta de enlace

Sección titulada «Aplicar el perfil RADIUS a la puerta de enlace»
  1. Ve a Network > GlobalProtect > Gateways y abre tu puerta de enlace GlobalProtect.

  2. En la pestaña Authentication, haz clic en Add para actualizar la autenticación del cliente con el perfil RADIUS que acabas de configurar.

  3. Deja la configuración predeterminada excepto estos campos:

    • Name: un nombre único e identificativo.
    • OS: Any.
    • Authentication Profile: el perfil de autenticación que configuraste antes.
    • Authentication Message: instrucciones para los usuarios finales, como Introduce tus credenciales.
  4. Ve a Agent > Client Settings, abre la configuración del cliente y, en la pestaña Authentication Override, marca Generate cookie for authentication override y Accept cookie for authentication override.

    Pestaña Authentication Override con las dos casillas de cookie marcadas

  5. Haz clic en OK para guardar.

Aplicar el perfil RADIUS al portal GlobalProtect

Sección titulada «Aplicar el perfil RADIUS al portal GlobalProtect»

Aplica al portal la misma configuración que acabas de aplicar a la puerta de enlace.

  1. Ve a Network > GlobalProtect > Portals y abre tu portal GlobalProtect.

  2. En la pestaña Authentication, haz clic en Add para actualizar la autenticación del cliente con el perfil RADIUS que acabas de configurar.

  3. Deja la configuración predeterminada excepto estos campos:

    • Name: un nombre único e identificativo.
    • OS: Any.
    • Authentication Profile: el perfil de autenticación que configuraste antes.
    • Authentication Message: instrucciones para los usuarios finales, como Introduce tus credenciales.
  4. Ve a Agent, abre la configuración del agente y, en la pestaña Authentication, dentro de Authentication Override, marca Generate cookie for authentication override y Accept cookie for authentication override.

    Pestaña Authentication del agente del portal con las dos casillas de cookie marcadas

  5. Haz clic en OK para guardar.

Haz clic en Commit para guardar la configuración RADIUS en la consola de administración de Palo Alto Networks.

Por defecto, las conexiones RADIUS salen por la interfaz de administración. Para cambiarlo, consulta la base de conocimiento de Palo Alto Networks.

Da acceso a los usuarios a la aplicación de la política de red de NPS, o a la aplicación Passwordless RADIUS si usas el Ironchip RADIUS server; consulta Dar acceso a usuarios y grupos. Conéctate con el cliente GlobalProtect con uno de ellos: después de introducir usuario y contraseña, se te pedirá que te autentiques con Ironchip.

  • La autenticación falla por tiempo de espera: comprueba que el tiempo de espera del perfil de servidor RADIUS es 60 segundos y los reintentos 1, para dejar tiempo a que el usuario responda a Ironchip.
  • El servidor RADIUS rechaza la conexión: comprueba que la IP de Palo Alto está configurada como cliente RADIUS en NPS y que el secreto compartido es el mismo en los dos lados.

Pulse Secure

Proteger el acceso VPN de Pulse Secure con Ironchip por RADIUS: crear el servidor de autenticación, el dominio de usuario y la política de inicio de sesión.

Esta guía explica cómo configurar Pulse Secure (ahora Ivanti Connect Secure) para autenticar a los usuarios contra Ironchip mediante RADIUS.

  • Un servidor RADIUS: un servidor NPS protegido por Ironchip o el Ironchip RADIUS server.
  • La IP, el puerto y el secreto compartido de ese servidor RADIUS.
  • Acceso de administrador a Pulse Secure.
  1. Inicia sesión como administrador en Pulse Secure.
  2. Ve a Authentication > Authentication Servers > New. Crea un servidor para realizar la autenticación e introduce los valores del servidor RADIUS.
  3. Si lo necesitas, crea un servidor de respaldo. Ignora la sección de contabilidad RADIUS.
  4. En la sección Custom RADIUS Rules, haz clic en New RADIUS Rule e introduce los datos de la regla en la ventana que aparece.
  5. Haz clic en Save Changes e ignora las advertencias que aparezcan.
  6. Haz clic de nuevo en Save Changes para guardar el servidor de autenticación.
  1. Ve a Users > User Realms > New.
  2. Define un nuevo dominio de autenticación (realm) e introduce los valores.
  3. Haz clic en Save Changes.

Opcionalmente, puedes configurar la asignación de roles (Role Mapping) a partir de los atributos del usuario. También puedes apoyarte en la configuración avanzada de RADIUS para roles dinámicos.

  1. Ve a Authentication > Signing In > Sign-in Policies.
  2. Identifica la política y haz clic en su URL para confirmar o editar los dominios (realms) seleccionados.
  3. Abre la sección Authentication realm de la página de detalles de la política.

Da acceso a los usuarios a la aplicación de Ironchip que usa tu servidor RADIUS en la consola de administración de Ironchip: la aplicación de la política de red de NPS, creada con Assign policy en la tarjeta del servidor NPS, o la aplicación Passwordless RADIUS del Ironchip RADIUS server. Consulta Dar acceso a usuarios y grupos. Inicia sesión en la VPN con uno de ellos: después de introducir usuario y contraseña, se te pedirá que te autentiques con Ironchip.

  • El servidor RADIUS rechaza la conexión: comprueba que el secreto compartido es el mismo en Pulse Secure y en tu servidor RADIUS (radius_key en el Ironchip RADIUS server) y, si usas NPS, que la IP de Pulse Secure está configurada como cliente RADIUS.

SonicWall

Proteger el acceso a SonicWall con Ironchip por RADIUS con NPS o por SAML: servidores de autenticación, control de acceso y metadatos de la aplicación.

Esta guía explica cómo proteger SonicWall con Ironchip por RADIUS a través de NPS o por SAML.

  • Un Directorio Activo funcional.
  • NPS protegido por Ironchip. Consulta Microsoft NPS.
  • Una aplicación de Ironchip para la política de red de NPS que usa SonicWall, creada con Assign policy en la tarjeta del servidor NPS y con el nombre de la política en Policy. Consulta Servidores NPS (RADIUS).
  • Acceso a esa aplicación para los usuarios que van a entrar. Consulta Dar acceso a usuarios y grupos.
  • La app de Ironchip descargada.
  1. En el menú de la izquierda, dentro de System Configuration, entra en Authentication Servers.

    Apartado Authentication Servers en System Configuration

  2. Haz clic en New para crear una configuración.

    Botón New en Authentication Servers

  3. Selecciona el tipo RADIUS (Username/Password).

    Selección del tipo RADIUS (Username/Password)

  4. Introduce los datos de tu servidor RADIUS:

    • Name: un nombre descriptivo para la configuración.
    • Primary RADIUS server: la IP de tu servidor RADIUS. Con Test puedes comprobar que SonicWall llega al servidor.
    • Shared secret: el secreto compartido de RADIUS.
    • Match RADIUS groups by: el atributo Filter-ID (11), que en el desplegable aparece como filterid attribute.
    • Timeout: 60 segundos.

    Datos del servidor RADIUS en SonicWall

  5. Guarda los cambios, ve a Security Administration y crea una entrada nueva en Access Control.

    Apartado Access Control en Security Administration

  6. Rellena los campos como en la imagen. La descripción puede ser personalizada:

    • Position: 1, con Enabled marcado.
    • Description: el texto que prefieras.
    • Action: Permit.
    • Direction: User.
    • From: Any user.
    • To: Any resource.
  7. Guarda los cambios.

    Entrada de Access Control rellena

  8. Por último, en NPS (Servidor de directivas de redes), crea un cliente RADIUS que apunte a la IP de SonicWall.

    Clientes RADIUS de NPS con el cliente que apunta a SonicWall

Al iniciar sesión en SonicWall Workplace, selecciona en Log in to el servidor de autenticación que has creado, introduce tus credenciales de usuario y acepta la notificación de Ironchip en tu teléfono para entrar.

Inicio de sesión en SonicWall Workplace con el servicio de Ironchip seleccionado en Log in to

Usuario y contraseña en el inicio de sesión de SonicWall Workplace

  • Acceso a la consola de administración de Ironchip.
  • La app de Ironchip descargada.
  1. En el menú de la izquierda, dentro de System Configuration, entra en Authentication Servers.

    Apartado Authentication Servers en System Configuration

  2. Haz clic en New para crear una configuración.

    Botón New en Authentication Servers

  3. Selecciona SAML 2.0.

    Selección del tipo SAML 2.0

  1. Antes de continuar, ve a la consola de administración de Ironchip, haz clic en Applications > New application y elige SAML. En la pestaña General, escribe el nombre de la aplicación en Name. En la pestaña Identity Provider (IdP), copia la dirección de URL Metadata y ábrela en el navegador para descargar el archivo de metadatos.

    Pestaña Identity Provider (IdP) con los datos de Ironchip como proveedor de identidad

    Deja abierta la ventana Add new application: la consola no crea una aplicación SAML sin los datos del proveedor de servicio, y los de SonicWall los importarás en el paso 4. Consulta Aplicaciones SAML.

  2. Vuelve a SonicWall y sube el archivo en la nueva configuración.

    Subida del archivo de metadatos en SonicWall

  3. Una vez importado, exporta el archivo que ha generado SonicWall.

    Exportación del archivo generado por SonicWall

  4. En la ventana Add new application de Ironchip, abre la pestaña Service Provider (SP) y despliega Import Metadata. En SP Metadata, elige File, selecciona el archivo exportado y haz clic en Import. Después, haz clic en Add para crear la aplicación.

    Pestaña Service Provider (SP) con la sección Import Metadata desplegada y las opciones URL, Text y File

  5. Da acceso a los usuarios en esta aplicación, con el mismo nombre de usuario que en SonicWall (Username composition). Consulta Dar acceso a usuarios y grupos.

Al iniciar sesión en SonicWall Workplace, selecciona en Log in to el servidor de autenticación SAML que has creado.

Selección de la autenticación SAML en SonicWall

Se abre una pestaña nueva de Ironchip en la que tienes que introducir tu nombre de usuario. Recibirás una notificación en la app.

Pestaña de Ironchip para introducir el nombre de usuario

Sophos Firewall

Proteger Sophos Firewall con Ironchip por RADIUS con NPS o con códigos OTP: servidor RADIUS, atributo Filter-Id, portal de usuario, VPN SSL y OTP.

Esta guía explica cómo proteger Sophos Firewall con Ironchip por RADIUS a través de NPS o con códigos OTP.

Implementa el servicio RADIUS en Sophos e intégralo con un servidor NPS en un entorno de Active Directory.

  • Acceso a la consola de administración de Ironchip.
  • Un servidor Windows con el rol de NPS configurado y protegido por Ironchip.
  • Una aplicación de Ironchip para la política de red de NPS que usa Sophos, creada con Assign policy en la tarjeta del servidor NPS y con el nombre de la política en Policy. Consulta Servidores NPS (RADIUS).
  • Una cuenta con permisos para realizar la configuración en Sophos.
  1. Ve al apartado Autenticación.

  2. En la sección Servers, haz clic en ADD para añadir el servicio RADIUS.

  3. En Server Type, selecciona RADIUS Server y completa los campos:

    1. Nombre del servidor NPS.
    2. IP del servidor NPS.
    3. Puerto de autenticación. Viene con 1812 por defecto; en este ejemplo se cambia a 1645. Usa el puerto en el que escuche tu servidor NPS.
    4. Tiempo de espera para la autenticación. Te recomendamos 60 segundos, como en el resto de integraciones RADIUS, para que dé tiempo a aceptar la notificación de Ironchip.
    5. Secreto compartido.
    6. Group name attribute: para probar la conexión, déjalo de momento en group.
  4. Comprueba la conexión con el servidor con las credenciales de un usuario que tenga acceso a la aplicación de NPS en la consola de administración de Ironchip. Consulta Dar acceso a usuarios y grupos.

Si usas ahora la autenticación RADIUS en un servicio de Sophos, falla, porque los usuarios no están en la base de datos local de Sophos. Para solucionarlo, crea un grupo en Sophos donde se almacenarán los usuarios con permisos de autenticación.

  1. Ve a la sección Grupos y haz clic en Add. Si ya tienes un grupo creado, no hace falta.
  2. Rellena los campos obligatorios.

Indica al servidor NPS, mediante un atributo, qué grupo gestiona los usuarios de autenticación.

  1. En NPS, abre la directiva de red generada anteriormente haciendo doble clic sobre ella.
  2. Ve al apartado Configuración.
  3. En Atributos RADIUS, elige Estándar, haz clic en Agregar, selecciona el atributo Filter-Id y haz clic en Agregar.
  4. En la ventana siguiente, indica el valor del atributo: formato Cadena y, debajo, el grupo que creaste en Sophos.
  5. En Sophos, ve a Autenticación, en la sección Servers edita la configuración hecha antes y en Group name attribute indica Filter-Id.

En la sección Services están todos los servicios de Sophos en los que puedes usar RADIUS. En este ejemplo se prueba con el portal de usuario de Sophos.

  1. Ve a User portal authentication methods, activa la casilla RADIUS y muévelo por encima de Local para que tenga prioridad. Haz clic en Aplicar.
  2. En Administración > Admin and Users settings está el apartado con los puertos de los distintos portales de Sophos. En este ejemplo el portal de usuario está en el 4443.
  3. Entra en el portal de usuario e inicia sesión con un usuario que esté en el dominio y configurado en la consola de administración de Ironchip. En el ejemplo se usa un usuario de prueba.
  4. Al conectar con un usuario que no existe en la base de datos local de Sophos, Sophos lo crea y lo añade al grupo indicado en la directiva de red.
  5. Al introducir las credenciales, recibes una notificación del autenticador de Ironchip para aceptarla.

Para el servicio de VPN, el proceso es similar:

  1. Ve a Autenticación, abre el apartado VPN SSL, activa la casilla RADIUS y colócalo por encima de Local para que tenga prioridad.
  2. Descarga el archivo de configuración desde el portal de usuarios y añádelo al cliente VPN.
  • La prueba de conexión o el inicio de sesión fallan por tiempo de espera: sube el tiempo de espera del servidor RADIUS a 60 segundos. El usuario tiene que aceptar la notificación de Ironchip antes de que se agote.
  • El servidor NPS rechaza la petición: comprueba que el secreto compartido y el puerto son los mismos en Sophos y en NPS, y que Sophos está configurado como cliente RADIUS en NPS.

Configura los códigos OTP en Sophos y añádelos al autenticador de Ironchip.

  • La app de Ironchip instalada y configurada en tu dispositivo.
  • Sophos desplegado e instalado correctamente.
  1. En el panel de administración de Sophos, entra en Autenticación.

    Apartado Autenticación en el panel de Sophos

  2. Ve a Autenticación multifactor y activa y configura el OTP en esta pestaña.

    Pestaña Autenticación multifactor con las opciones de OTP

    1. Selecciona si el OTP no se utiliza, se utiliza o se utiliza para grupos y usuarios concretos.
    2. Activa esta opción para que los usuarios tengan que configurar el OTP en el siguiente inicio de sesión.
    3. Selecciona qué servicios utilizan OTP.
  3. Para usar OTP con la cuenta de administrador, ve a Administración y entra en Acceso de dispositivo.

    Apartado Acceso de dispositivo en Administración

  4. Baja hasta la sección MFA y activa MFA para el administrador predeterminado.

    Opción MFA para el administrador predeterminado

  5. Al hacer clic en Aplicar, aparece una ventana en la que debes seleccionar Generar un token de software.

    Ventana para generar un token de software

  6. Aparece un código QR. Escanéalo con la app de Ironchip desde la sección OTP y escribe la contraseña del administrador y el código OTP en la misma línea:

    <contraseña><000000>

    Código QR para escanear con la app de Ironchip

A partir de ahora, cada vez que un usuario con OTP habilitado entre en alguno de los servicios configurados con OTP, tendrá que escribir la contraseña y el código OTP en la misma línea: <contraseña><000000>.

Si el usuario y la contraseña con el OTP son correctos pero no permite la entrada:

  1. En el panel de administración de Sophos, entra en Autenticación.

    Apartado Autenticación en el panel de Sophos

  2. Ve a Autenticación multifactor. Al final de la página hay una lista de usuarios con OTP habilitado.

    Lista de usuarios con OTP habilitado

  3. Haz clic en el icono de sincronización del usuario afectado.

    Icono de sincronización del usuario

  4. Introduce el código OTP de esa cuenta de usuario y ejecuta la sincronización.

    Ventana de sincronización con el código OTP

Stormshield

Proteger la VPN SSL de Stormshield con Ironchip por RADIUS y NPS: crear el objeto de red, habilitar el portal cautivo y ajustar el tiempo de espera.

Esta guía explica cómo proteger la VPN SSL de Stormshield con Ironchip por RADIUS a través de NPS.

  • Acceso a la consola de administración de Ironchip.
  • Un servidor Windows con el rol de NPS instalado.
  • Una aplicación de Ironchip para la política de red de NPS que usa Stormshield, creada con Assign policy en la tarjeta del servidor NPS y con el nombre de la política en Policy. Consulta Servidores NPS (RADIUS).
  • Un cliente RADIUS creado en NPS que apunte a la IP de Stormshield, con su secreto compartido.
  • Un usuario con los permisos necesarios para realizar la configuración en Stormshield.

Inicia sesión como administrador.

  1. Ve a Objects > Network Objects, haz clic en +Add y crea un objeto llamado Ironchip.

  2. Ve a VPN > SSL VPN.

    Menú Configuration con VPN > SSL VPN seleccionado

  3. En la ventana General, marca Enable SSL VPN. En la misma ventana, configura los servidores de aplicaciones, los servidores web y los perfiles de usuario según tus necesidades.

    Ventana SSL VPN con Enable SSL VPN marcado

  4. Ve a Users > Authentication. En la pestaña General, habilita el Captive Portal.

  5. En la pestaña Available Methods, haz clic en Add an authentication method y selecciona Radius.

    Menú Add an authentication method con la opción Radius

  6. En Access to the server, rellena la configuración de RADIUS y haz clic en Apply:

    • Server: el objeto de red que corresponde al servidor NPS.
    • Port: el puerto RADIUS en el que escucha NPS.
    • Pre-shared Key: el secreto compartido del cliente RADIUS configurado en NPS para Stormshield.

    Si tienes un segundo servidor NPS, configúralo en Backup server.

    Configuración de RADIUS en Stormshield con Server, Port y Pre-shared Key

Para configurar el tiempo de espera de RADIUS, ejecuta estos comandos:

CONFIG AUTH RADIUS timeout=30000 retry=1 btimeout=30000 bretry=1
CONFIG AUTH ACTIVATE

Da acceso a los usuarios a la aplicación de la política de red de NPS en la consola de administración de Ironchip; consulta Dar acceso a usuarios y grupos. Inicia sesión en la VPN SSL con uno de ellos: después de introducir usuario y contraseña, se te pedirá que te autentiques con Ironchip.

  • La autenticación falla por tiempo de espera: comprueba que has ejecutado los comandos de tiempo de espera de RADIUS (timeout=30000 y retry=1 para el servidor principal y el de respaldo), para dejar tiempo a que el usuario responda a Ironchip.
  • El servidor RADIUS rechaza la conexión: comprueba que la IP de Stormshield está configurada como cliente RADIUS en NPS y que el secreto compartido es el mismo en Pre-shared Key y en NPS.

WatchGuard

Proteger la VPN SSL de WatchGuard con Ironchip por RADIUS y NPS: cliente RADIUS, servidor de autenticación, usuarios y grupos, y acceso en Ironchip.

Esta guía explica cómo proteger la VPN SSL de WatchGuard con Ironchip por RADIUS a través de NPS.

  • Un Directorio Activo funcional.
  • Una VPN de WatchGuard configurada y en funcionamiento.
  • NPS protegido por Ironchip. Consulta Microsoft NPS.
  • Una aplicación de Ironchip para la política de red de NPS que usa WatchGuard, creada con Assign policy en la tarjeta del servidor NPS y con el nombre de la política en Policy. Consulta Servidores NPS (RADIUS).
  • La app de Ironchip descargada.

Crea un cliente RADIUS que apunte a la dirección IP por la que te conectas a la VPN de WatchGuard.

  1. En el NPS (Network Policy Server) de tu Active Directory, crea un cliente RADIUS nuevo.

    Creación de un cliente RADIUS en NPS

  2. Ponle un nombre identificativo, indica la IP por la que te conectas a la VPN y un secreto compartido que debes apuntar o recordar.

    Datos del cliente RADIUS: nombre, IP y secreto compartido

Indica a WatchGuard los datos necesarios para conectarse a RADIUS.

  1. Ve a Authentication > Servers y selecciona RADIUS.

    Apartado Authentication > Servers con la opción RADIUS

  2. Haz clic en ADD.

    Botón ADD para añadir el servidor RADIUS

  3. Rellena los campos:

    1. Domain Name: el nombre de tu dominio de Active Directory donde está RADIUS.
    2. IP Address: la IP pública de tu dominio de Active Directory donde está RADIUS.
    3. Port: el puerto de RADIUS (1812 o 1645).
    4. Shared Secret y Confirm Secret: el secreto compartido de RADIUS que pusiste antes.
    5. Timeout en 60 segundos y Retries en 1, para que el usuario tenga tiempo de autorizar la conexión.
    6. Dead Time, opcional: puedes modificarlo a tu gusto. 0 significa desactivado.
  4. Guarda los cambios.

    Formulario del servidor RADIUS en WatchGuard

Crea usuarios que hagan referencia a los usuarios de tu AD.

  1. Ve a Users and Groups y haz clic en ADD.

    Apartado Users and Groups

  2. Selecciona si quieres crear un grupo o un usuario.

  3. El nombre debe ser exactamente el mismo que el del usuario de tu Active Directory.

  4. En Authentication Server, selecciona el servidor RADIUS que acabas de crear.

  5. Haz clic en OK y guarda los cambios.

    Formulario de usuario con el servidor de autenticación RADIUS

Cambia el método de autenticación de la VPN.

  1. Ve a VPN y, dentro de Mobile VPN, entra en SSL. Si no tienes configurado este método de conexión VPN, configúralo antes de continuar.

    Apartado VPN > Mobile VPN > SSL

  2. En Authentication Server, añade el servidor RADIUS creado y colócalo como Default.

  3. Marca las casillas de los usuarios y grupos que quieres usar.

  4. Guarda los cambios.

    Servidor RADIUS como Default en la configuración de SSL VPN

Da acceso a los usuarios a la aplicación de la política de red de NPS en la consola de Ironchip. En Username composition, define la plantilla para que los nombres de usuario sean los mismos que los de WatchGuard. Consulta Dar acceso a usuarios y grupos.

Página de una aplicación con la pestaña Accesses y las columnas Group y Username template

Inicia sesión en la VPN SSL de WatchGuard con un usuario que tenga acceso a la aplicación: después de introducir usuario y contraseña, se te pedirá que te autentiques con Ironchip.

Acceso a la VPN de WatchGuard con IronchipReproducir el vídeo

Referencia

Arquitectura de la plataforma de identidad

Componentes de la plataforma de identidad de Ironchip: aplicación de autenticación, consola, agentes de integración, Location Based Security, backend y Dex.

La plataforma de identidad de Ironchip se compone de herramientas para los usuarios y los administradores, agentes de integración y componentes internos.

Diagrama de la arquitectura: la aplicación de autenticación, la consola de administración y los agentes de integración se comunican con el backend, que usa Location Based Security y Dex

Estos componentes arquitectónicos están diseñados para ser utilizados por dos tipos diferentes de usuarios:

  1. Administrador de la compañía: el técnico informático encargado de gestionar las políticas, los usuarios y los servicios relacionados con la autenticación basada en la localización.
  2. Usuario: las personas que se autentican con la plataforma de identidad de Ironchip.

Aplicación móvil que usan los usuarios de la plataforma para autorizar los accesos a los servicios integrados, de acuerdo con la política de acceso establecida.

Tiene dos modos de funcionamiento: uno con localización y otro sin ella, solo con el dispositivo.

La aplicación de autenticación está diseñada para ser segura, con medidas de seguridad adicionales a la seguridad basada en la localización. Proporciona mecanismos biométricos para el desbloqueo del almacenamiento local cuando está disponible, haciendo prácticamente imposible que un atacante externo pueda clonar el dispositivo.

También es muy fácil de usar y tiene una interfaz amigable. El Authenticator es una aplicación pública para cualquier usuario de los servicios de tu compañía, y su experiencia de uso está cuidada para que todo tipo de usuarios pueda autenticarse con ella.

Si contactas con soporte, también puedes obtener una aplicación corporativa específica, con diseño, paleta de colores, logotipo y nombre personalizados.

Aplicación de gestión de la compañía para administrar los usuarios, los servicios integrados, las políticas de acceso y los métodos de integración de la plataforma.

La plataforma de identidad de Ironchip utiliza protocolos estándar para integrar servicios externos. Gracias a ellos, Ironchip se integra con los servicios más habituales, como Microsoft Active Directory, Microsoft 365, correos web o productos de Adobe.

La consola permite un control de grano fino sobre las políticas de acceso de tu organización: qué usuarios tienen acceso a qué servicios y en qué zonas seguras es posible ese acceso. Este control permite a cualquier administrador de TI tener el control total y la trazabilidad de los accesos en tiempo real.

Ironchip ofrece soporte para las dudas sobre el uso de la consola y varios recursos para aprender todas sus funciones: un recorrido completo por la plataforma, tutoriales de acciones concretas y documentación de usuario.

Estos agentes son los componentes necesarios para la integración in situ entre la plataforma de identidad y algunos servicios que dependen de protocolos específicos.

Estos componentes son internos y transparentes para ti.

Location Based Security es el núcleo de negocio de Ironchip. Este componente alberga la inteligencia artificial responsable de detectar qué localizaciones están relacionadas y también la distancia entre estas localizaciones.

Location Based Security es un producto en sí mismo que permite a una empresa integrarse de forma personalizada con la IA de seguridad de Ironchip. Para saber más sobre sus posibilidades, consulta con tu contacto comercial.

Location Based Security se utiliza no solo en el contexto de la autenticación, incluso tiene muchas aplicaciones en el mundo de la detección de fraudes. Debido a estas aplicaciones en tareas críticas, está diseñado para ser resistente, sensible y rápido. Estos requisitos se traducen en una mayor seguridad y rendimiento para la plataforma de identidad.

El corazón de Ironchip se basa tanto en algoritmos deterministas clásicos basados en la física como en tecnologías de IA de última generación que permiten que nuestro algoritmo sea al mismo tiempo estable, seguro, fiable y adaptable a nuevas circunstancias.

Backend de autenticación basada en la localización

Sección titulada «Backend de autenticación basada en la localización»

El backend de la plataforma de identidad expone la API que implementa toda la lógica de las características y la comunicación con los servicios dependientes, es decir, la seguridad basada en la localización y Dex.

Como el backend es el pilar de un producto de seguridad, la seguridad es uno de los principales criterios en las decisiones de desarrollo. El backend está construido en torno a características de seguridad como la monitorización activa, la exclusión de datos privados de las bases de datos y los hashes de tokens y contraseñas cifrados y con sal y pimienta.

Como el modelo de negocio abarca tanto a grandes como a pequeñas empresas, el backend está diseñado para escalar. Se despliega en un entorno dinámico que asigna y desasigna la capacidad en función del uso actual de la plataforma.

Por último, el backend es estable, ya que se compone de tecnologías, técnicas y metodologías probadas y depende únicamente de servicios de alta disponibilidad.

Ironchip utiliza Dex. Dex actúa como un portal a otros proveedores de identidad a través de conectores. Esto le permite delegar la autenticación a servidores LDAP, proveedores SAML o proveedores de identidad establecidos como GitHub, Google y Active Directory. Los clientes escriben su lógica de autenticación una vez para hablar con Dex, y Dex maneja los protocolos para un determinado backend.

Dex es un proyecto de código abierto que figura en la Fundación de Computación Nativa en la Nube (CNCF). Esto proporciona una base para considerar a Dex como un proyecto estable y respaldado. Dex tiene una comunidad de desarrolladores en constante crecimiento y es muy activo entre los desarrolladores.

Versiones

Historial de versiones de la plataforma de identidad de Ironchip: novedades y correcciones de las versiones 1.1.2, 1.1.0 y 1.0.2.

Historial de cambios de la plataforma de identidad, de la versión más reciente a la más antigua.

La última versión publicada de cada componente que se instala en tus equipos y servidores. Se actualiza sola con cada publicación; en el enlace de cada uno están todas las versiones con sus notas.

ComponenteVersiónPublicada
Ironchip Windows Logonv2.3.629 sept 2026
Ironchip Windows Authenticatorv1.10.221 oct 2026
Ironchip macOS Logonv1.0.08 may 2025
Ironchip Authenticator para macOS1.1.020 ene 2026
Ironchip Linux Logonv1.0.026 mar 2025
Ironchip Authenticator para Linux1.3.119 may 2026
Ironchip Card Reader (RFID)v1.1.428 oct 2026
Ironchip AD Connect para Windowsv1.7.511 ago 2026
Ironchip AD Connect para Linuxv1.7.426 may 2026
Ironchip RADIUS Serverv1.2.015 nov 2024
Plugin de Ironchip para NPSv1.0.115 nov 2024
Plugin de Ironchip para ADFSv1.2.2.215 nov 2024
Proxy LDAP de Ironchipv1.0.115 nov 2024
Herramienta de diagnóstico de Logonv1.1.04 feb 2026
  • Se ha añadido información sobre las licencias a la consola de administración.
  • Nueva función de importación de usuarios.
  • Skins personalizados para la aplicación de autenticación móvil, configurables desde el backoffice.
  • Integración de IDS con LBFraud.
  • Mejora del aspecto visual y de la experiencia de usuario de la consola.
  • Mejora del aspecto visual y de la experiencia de usuario de la aplicación de autenticación.
  • Estandarización del formato de errores de la API de LBAuth.
  • Mejora de la seguridad del almacenamiento en la aplicación de autenticación de Android e iOS.
  • El nombre de HTTP-MFA ya no distingue entre mayúsculas y minúsculas.
  • Como medida de seguridad, se invalida el token antiguo cuando se recupera la API key de la cuenta.
  • El correo electrónico ya no distingue entre mayúsculas y minúsculas.
  • Mejora de la definición y de los requisitos de creación de zonas seguras.
  • Eliminación de endpoints de la API innecesarios para reducir la superficie de ataque.
  • Mejora del estilo de la página de inicio de sesión de Dex OIDC.
  • Eliminado el retorno de código HTTP duplicado, que hacía inestable la API en algunos endpoints.
  • Eliminada la posibilidad de crear claves duplicadas en algunas circunstancias.
  • Optimización de las consultas a la base de datos al buscar por ID externo en los servicios.
  • Mejora de la seguridad de los middlewares de enrutamiento interno.
  • Mejora del rendimiento y de la fluidez de la línea de tiempo de la consola.
  • Mejora de la interfaz de creación de accesos.
  • Corrección de la interfaz de la consola, que mostraba el alias del servicio en lugar del ID externo correcto.
  • La aplicación de autenticación puede ahora comprobar la conectividad entre ella y el backend.

SLA de la plataforma de identidad

Tiempos de respuesta del soporte de Ironchip según la prioridad de la incidencia y disponibilidad comprometida de la consola para clientes empresariales.

Compromisos de tiempo de respuesta del soporte y de disponibilidad de la plataforma de identidad de Ironchip. Para la detección de fraude, consulta el SLA de detección de fraude.

Ironchip tiene un portal de soporte disponible para reportar incidencias. Las solicitudes de soporte se responden en estos plazos:

  • En 12 h para solicitudes críticas, con disponibilidad 24/5.
  • En 24 h para solicitudes de prioridad alta, con disponibilidad 8/5.
  • En 72 h para solicitudes de prioridad media, con disponibilidad 8/5.
  • En 7 días para solicitudes de prioridad baja, con disponibilidad 8/5.
Prioridad SLA Descripción
Crítico En 12 h Las consolas de gestión o las API que se usan en producción no están disponibles, lo que afecta al menos al 15 % de los usuarios.
Alto En 24 h Las consolas de gestión o las API que se usan en producción están perjudicadas o degradadas, lo que afecta al menos al 15 % de los usuarios.
Medio En 72 h Las consolas de gestión o las API que no se usan en producción no están disponibles, están deterioradas o degradadas.
Bajo En 7 días Dudas generales sobre el producto y peticiones personalizadas.

Ironchip se reserva el derecho de ajustar la prioridad de las incidencias tras realizar un análisis inicial de la situación.

El SLA y la disponibilidad de Ironchip para los clientes empresariales son los siguientes:

Sistema Disponibilidad
Consola de administración Disponible el 99,5 % del tiempo.

Mensajes de error y soluciones

Errores frecuentes de autenticación y licencia en Ironchip, qué significan y cómo resolverlos: nombre de dispositivo en iOS, inicio de sesión y hora automática.

Errores habituales durante la instalación y configuración de Ironchip, con su significado y su solución. Si un error persiste, contacta con el soporte de Ironchip.

El usuario XXX no está autenticado en el servicio XXX. Inténtelo de nuevo.

El usuario no está autenticado, o el proceso de autenticación no fue válido. Vuelve a intentar la autenticación en la misma página.

El protocolo de autenticación utilizado no es compatible. Comuníquese con el soporte de IronChip proporcionando el error impreso en EventViewer

Si aparece durante la autenticación de un usuario, el proveedor de servicios está mal configurado y no envía el servicio en la solicitud de autenticación. Contacta con el soporte de Ironchip y facilita el registro de errores que aparece en el Visor de eventos.

Ironchip ha fallado. Lo sentimos. Comuníquese con el soporte técnico para permitirnos resolver el problema.

Ha ocurrido algo inesperado. Contacta con el soporte de Ironchip y facilita el registro de errores del Visor de eventos para que podamos resolver el problema.

No se puede cargar la clave de licencia de IronChip. Verifique que sea la licencia correcta e inténtelo nuevamente. Si el problema persiste, comuníquese con el soporte de IronChip para obtener ayuda

El formato de la licencia no es válido. Escribe a support@ironchip.com con el error: validaremos la clave de licencia utilizada y, si no es válida, te daremos una válida.

La clave API proporcionada no es válida. Comuníquese con el soporte de IronChip y, envíe registros para obtener ayuda

La licencia tiene el formato correcto, pero es antigua o no es válida. Escribe a info@ironchip.net con el error: validaremos la clave de licencia utilizada y, si no es válida, te daremos una válida.

Si tienes un dispositivo iOS y ves este error:

Enroll error de la aplicación por un nombre de dispositivo (DeviceName) no válido

El nombre del dispositivo en iOS no puede contener acentos, -, /, $, %, @, &, ., _ ni caracteres similares. Para corregirlo, cambia el nombre del dispositivo.

Si ves este error:

Login error de la aplicación móvil con una excepción del almacén de claves del dispositivo

Ironchip recomienda que lo primero que haga un usuario nuevo sea crear una zona segura de recuperación. Para solucionar este error, borra los datos de la aplicación o reinstálala y recupera la cuenta.

Cómo establecer la fecha y hora automáticas

Sección titulada «Cómo establecer la fecha y hora automáticas»

Una hora desfasada en el dispositivo puede hacer que se rechacen los códigos de verificación. Activa el ajuste automático de fecha y hora.

Ve a Configuración > Hora e idioma > Fecha y hora y activa Establecer la hora automáticamente.

Ve a Configuración, apartado Fecha y hora, y activa Fecha y hora automáticas.

Depende del modelo, pero en general: ve a Ajustes, busca el apartado de fecha y hora y selecciona establecer la fecha y la hora de forma automática.

Ve a Ajustes > General > Fecha y hora y activa Ajuste automático.

Presentaciones y documentación de identidad

Material comercial de la plataforma de identidad de Ironchip: presentaciones, battlecards frente a la competencia, casos de uso y casos de éxito.

Material comercial de la plataforma de identidad de Ironchip.