# 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.

URL: https://docs.ironchip.com/identidad/usuarios/rfid/

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.

## Requisitos

- Acceso de administrador a la consola de administración de Ironchip.
- Permisos de administrador en el sistema.
- Lectores y tarjetas compatibles.

## Instalación del agente

1. Accede a la consola de administración de Ironchip con tus credenciales.
2. En el menú lateral izquierdo, selecciona la sección **Plugins**.

   [Imagen: 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.

   [Imagen: Paquete RFID Authenticator en la sección Plugins]

## Generación de la API key

El agente necesita una API key para funcionar. Para generarla:

1. En la consola de administración, ve a **Authentication Policies > Device Policies**.

   [Imagen: Menú Authentication Policies con la opción Device Policies]

2. Haz clic en **Add device policy** para crear una entrada nueva.

   [Imagen: 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.

   [Imagen: Formulario de la política con la opción Use RFID protocol activada]

## Generación del acceso

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.

   [Imagen: 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.

   [Imagen: 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**.

   [Imagen: 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.

   [Imagen: 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.

   [Imagen: Acceso RFID generado y activo]

## Creación de tarjetas RFID en Ironchip

Para registrar tarjetas RFID en la plataforma, ve a **Directory > Devices > RFID** y sigue estos pasos:

[Imagen: Sección Directory > Devices > RFID de la consola]

1. Haz clic en **Synchronize** para acceder al proceso de importación.

   [Imagen: Botón Synchronize en la sección RFID]

2. Descarga la plantilla (template) que ofrece el sistema.

   [Imagen: 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                         |

   [Imagen: Plantilla de importación rellena con los datos de las tarjetas]

4. Sube la plantilla completada a Ironchip y pulsa **Next**.

   [Imagen: Pantalla para subir la plantilla completada]

5. En la pantalla siguiente, selecciona la política RFID que creaste antes.

   [Imagen: Selección de la política RFID para las tarjetas]

6. Confirma la operación pulsando **Add**. Las tarjetas quedan registradas en el sistema.

   [Imagen: Tarjetas RFID registradas en el sistema]

## Configuración del agente

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:

   ```powershell
   .\IronchipRFID.exe c --api_key <API_KEY>
   ```

   [Imagen: 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:

   ```powershell
   .\IronchipRFID.exe c show
   ```

   [Imagen: Parámetros activos del agente mostrados en PowerShell]

3. Instala el agente como servicio del sistema:

   ```powershell
   .\IronchipRFID.exe s install
   ```

   [Imagen: Comando de instalación del servicio del agente]

4. Inicia el servicio del agente para que empiece a funcionar:

   ```powershell
   .\IronchipRFID.exe s start
   ```

   [Imagen: Comando que inicia el servicio del agente]

### Desinstalar el agente

Para desinstalar el agente, antes tienes que detenerlo. Sigue estos dos pasos en orden:

1. Detén el servicio:

   ```powershell
   .\IronchipRFID.exe s stop
   ```

   [Imagen: Comando que detiene el servicio del agente]

2. Cuando esté detenido, desinstala el agente del sistema:

   ```powershell
   .\IronchipRFID.exe s uninstall
   ```

   [Imagen: Comando que desinstala el servicio del agente]

## Configuración del lector en el 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.

### Lector HID

Si tu lector se identifica como un dispositivo de interfaz humana (HID), usa este comando para abrir el menú de selección interactivo:

```powershell
.\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.

[Imagen: Lista de dispositivos HID detectados por el agente]

### Lector serie

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:

```powershell
.\IronchipRFID.exe srl
```
