# Login agent deployment

> Deploy and maintain the Ironchip login agents on Windows and Linux: GPO, MDM or manual installation, single credential provider, updates and RDP.

URL: https://docs.ironchip.com/en/identidad/integraciones/puestos/agentes/

Answers to common questions about deploying, configuring and updating the Ironchip login agents on large fleets of Windows and Linux machines. For the step-by-step installation of each agent, see [Windows logon](https://docs.ironchip.com/en/identidad/integraciones/puestos/windows-logon/), [Linux logon](https://docs.ironchip.com/en/identidad/integraciones/puestos/linux-logon/) and [macOS logon](https://docs.ironchip.com/en/identidad/integraciones/puestos/macos-logon/).

## Deploy the Windows Logon agent on many machines

Choose the method that fits your environment:

- **GPO (recommended)**: distribute the MSI to all domain computers with Group Policy. The deployment is silent, with no user interaction.
- **MDM (Intune, SCCM)**: for environments with device management tools.
- **Manual**: for pilots or small groups. Not recommended for mass deployments.

The official MSI installer is available in the [releases published on GitHub](https://github.com/Ironchip-Security/Ironchip-Windows-Logon/releases). There is one installer for x64 computers (`IronchipWindowsLogon_x64.msi`) and another for ARM64 computers (`IronchipWindowsLogon_arm64.msi`). The properties the installer supports are listed in [Windows logon](https://docs.ironchip.com/en/identidad/integraciones/puestos/windows-logon/#installer-properties).

[Image: Windows Logon installer releases page on GitHub]

## Make Ironchip the only credential provider

In the installer, which you can also configure with an `.mst` file deployed through a GPO, choose an **(Exclude other providers)** option in each scenario (the `e` value in the `CPUS_*` properties). With it:

- Ironchip becomes the only credential provider in Windows in that scenario.
- The second factor is mandatory on every sign-in.
- There is no risk of bypassing the second factor through the native Windows credential provider.

:::caution[Test it in a pilot group first]
Choosing **(Exclude other providers)** without thorough testing can lock machines out. Always test first with a pilot group of IT staff.
:::

## Update Windows Logon

Ironchip publishes new versions in the [GitHub releases](https://github.com/Ironchip-Security/Ironchip-Windows-Logon/releases). Distribute the new MSI with GPO or MDM. When you install the new MSI over the existing one, the agent is updated and keeps its configuration and saved users. You cannot install an older version over a newer one. Before you roll it out to production, wait until Ironchip confirms that the version is validated.

## Compatibility with credential provider management software

Incompatibilities can occur. One documented case involved the configuration of third-party software interfering with the Ironchip credential provider and allowing the second factor to be bypassed. Ironchip fixed it in Windows Logon version 2.3.2.

If you detect an incompatibility with third-party software, report it to Ironchip support with screenshots or a video of the behavior.

## Use Ironchip with RDP

There are two options:

- **Windows Logon on the target machine**: protects the RDP session directly. Choose **Local and Remote** or **Only Remote** in the **Logon** scenario of the installer (the `0` and `1` values of `CPUS_LOGON`).
- **RD Gateway with RADIUS**: Ironchip acts as the second factor on the Gateway and protects every RDP connection that goes through it. See [Remote Desktop (RDP)](https://docs.ironchip.com/en/identidad/integraciones/puestos/rdp/).

Some customers use Ironchip both with direct RDP and with a Citrix VPN combined with RDP.

## Deploy the agent on Linux

On Linux, Ironchip integrates through PAM (Pluggable Authentication Modules). It adds the Ironchip second factor to any Linux service that uses PAM, such as SSH, `sudo`, `su` or local login. It is especially useful on production servers, bastion hosts and development environments. The steps are in [Linux logon](https://docs.ironchip.com/en/identidad/integraciones/puestos/linux-logon/).