# Instructivo para dummies: instalar el agente PMDefender

Propietario: Itinnovok  
Producto: PMDefender Cloud EDR/XDR  
Derechos: Copyright 2026 Itinnovok. Todos los derechos reservados.

## 1. Que vas a instalar

El agente PMDefender es el componente que se instala en cada equipo para enviar telemetria de seguridad a la consola.

Sirve para:

- Ver si el equipo esta protegido.
- Detectar malware, ransomware y comportamiento sospechoso.
- Enviar eventos de procesos, red, archivos y actividad del sistema.
- Permitir acciones autorizadas como aislar un host, recolectar evidencia o poner archivos en cuarentena.

## 2. Antes de empezar

Necesitas tres datos:

```text
TENANT_ID: identificador de la empresa o grupo.
SERVER_URL: URL de la consola PMDefender.
ENROLLMENT_TOKEN: token de registro entregado por el administrador.
```

Ejemplo:

```text
TENANT_ID=corp
SERVER_URL=https://console.pmdefender.local
ENROLLMENT_TOKEN=TOKEN
```

Importante: no compartas el token por correo abierto o chat no autorizado.

## 3. Descargar el agente

En la consola abre:

```text
http://127.0.0.1:8000/agents/download
```

Descarga el paquete segun el sistema operativo:

- Windows: `pmdefender-agent-windows.ps1`
- Linux: `pmdefender-agent-linux.sh`
- macOS: `pmdefender-agent-macos.sh`
- Moviles: `pmdefender-agent-mobile-mdm.json`

## 4. Instalar en Windows con escaneo enterprise

1. Abre PowerShell como Administrador.
2. Ve a la carpeta donde descargaste el archivo.
3. Ejecuta:

```powershell
powershell.exe -ExecutionPolicy Bypass -File .\pmdefender-agent-windows.ps1 -TenantId "corp" -ServerUrl "https://console.pmdefender.local" -EnrollmentToken "TOKEN" -RunScanNow
```

4. Si termina sin error, el agente queda instalado en:

```text
C:\Program Files\PMDefender\Agent
```

5. El instalador ejecuta un escaneo inmediato de Windows y registra una tarea programada:

```text
PMDefender Enterprise Windows Scan
```

6. Los reportes JSON del escaneo quedan en:

```text
C:\Program Files\PMDefender\Agent\reports
```

El escaneo revisa procesos, comandos sospechosos, conexiones TCP, servicios, drivers, tareas programadas, claves Run/RunOnce del registro, administradores locales, hotfixes y estado de Microsoft Defender. Si no puede subir el evento a la consola, deja una copia en `C:\Program Files\PMDefender\Agent\queue`.

## 5. Instalar en Linux

1. Abre una terminal.
2. Ve a la carpeta donde descargaste el archivo.
3. Ejecuta:

```bash
TENANT_ID=corp SERVER_URL=https://console.pmdefender.local ENROLLMENT_TOKEN=TOKEN bash pmdefender-agent-linux.sh
```

4. Si termina sin error, el bootstrap queda en:

```text
/opt/pmdefender/agent
```

## 6. Instalar en macOS

1. Abre Terminal.
2. Ve a la carpeta donde descargaste el archivo.
3. Ejecuta:

```bash
TENANT_ID=corp SERVER_URL=https://console.pmdefender.local ENROLLMENT_TOKEN=TOKEN bash pmdefender-agent-macos.sh
```

4. Si termina sin error, el bootstrap queda en:

```text
/Library/Application Support/PMDefender/Agent
```

## 7. Dispositivos moviles

Para iOS y Android normalmente no se instala manualmente.

Se hace desde un MDM como:

- Intune
- Jamf
- Kandji
- Apple Business Manager
- Android Enterprise

Pasos simples:

1. Descarga `pmdefender-agent-mobile-mdm.json`.
2. Importa el perfil en la consola MDM.
3. Asigna el perfil al grupo de dispositivos.
4. Verifica que los equipos aparezcan como registrados.

## 8. Como saber si quedo bien

Revisa en la consola PMDefender:

```text
Command Center > Endpoints y workloads
```

Debes ver:

- Nombre del equipo.
- Sistema operativo.
- Estado saludable o protegido.
- Ultima conexion del agente.

## 9. Errores comunes

### El token no funciona

Pide un token nuevo al administrador. Puede estar vencido o pertenecer a otro tenant.

### No tengo permisos

En Windows usa PowerShell como Administrador. En Linux/macOS usa una cuenta con permiso `sudo`.

### No aparece el endpoint

Verifica:

- Que `SERVER_URL` sea correcto.
- Que haya red hacia la consola.
- Que el reloj del equipo tenga fecha y hora correctas.
- Que el firewall permita salida HTTPS.

## 10. Para despliegue masivo

Usa las herramientas corporativas:

- Windows: GPO, Intune, SCCM o imagen base.
- Linux: Ansible, SSH, cloud-init o gestor de configuracion.
- macOS: Jamf, Kandji, Intune o Munki.
- Moviles: MDM.

Recomendacion: primero instala en un grupo piloto, luego por area o region.