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

URL: https://docs.ironchip.com/identidad/usuarios/autenticador-windows/

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.

## Requisitos

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

:::note
Desde la versión 1.8.0, Windows Logon es un instalador aparte. Si tenías la función de inicio de sesión instalada con una versión anterior, se elimina al actualizar: instálala desde [Inicio de sesión en Windows](https://docs.ironchip.com/identidad/integraciones/puestos/windows-logon/).
:::

## Descargar el instalador

Tienes dos alternativas para descargar el instalador del autenticador.

### Desde la consola de administración

1. Entra en la consola de administración de Ironchip, [app.ironchip.com](https://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**.

### Desde GitHub

1. Entra en el repositorio oficial de Ironchip, [github.com/Ironchip-Security](https://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](https://github.com/Ironchip-Security/Ironchip-Windows-Authenticator/releases), que muestra todas las versiones disponibles, y descarga `IronchipWindowsAuthenticator.msi` de la última.

## Instalar con el asistente

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

   [Imagen: Pantalla inicial del instalador con la versión del autenticador]

2. Acepta los términos de uso.

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

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

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

   [Imagen: Pantalla final del instalador con el botón Install]

## Instalar por línea de comandos

Para instalar el autenticador de forma silenciosa, por ejemplo en un despliegue masivo, usa `msiexec.exe` desde una consola con permisos de administrador:

```powershell
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:

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

## Dar de alta al usuario

Para saber cómo dar de alta a los usuarios, consulta [Alta en la aplicación](https://docs.ironchip.com/identidad/usuarios/alta/).