# Cada evento de seguridad en tu teléfono.

> Recibe una notificación push por inicios de sesión SSH, uso de sudo y bloqueos de fail2ban. Un curl desde un script de inicio de sesión envía el usuario, la IP de origen y la regla a tu teléfono en menos de un segundo.

<!-- source: https://pocketalert.app/es/use-cases/security-alerts -->

Última actualización: 2026-08-11

Cuando algo toca tu servidor —un inicio de sesión SSH, un bloqueo de fail2ban, una regla de CrowdSec o auditd— el usuario, la IP de origen y la regla llegan a tu teléfono en menos de un segundo. Sabe quién ha iniciado sesión antes de que termine de escribir.

## Tres pasos para las alertas de inicio de sesión

1. **Obtén una clave de API** — Crea una clave de API y una aplicación por servidor, y guarda la clave en una variable de entorno en la máquina.
2. **Conecta el evento** — Añade un curl a tu script de inicio de sesión, a tu acción de fail2ban o a tu regla de IDS que envíe el usuario y la IP de origen.
3. **Vigila tus servidores** — Los inicios de sesión y los bloqueos llegan a tu teléfono en menos de un segundo. Pon el evento en el título para que un inicio de sesión de root desde una IP nueva se distinga claramente de un despliegue rutinario.

## Del inicio de sesión a la notificación push

Conecta cualquier inicio de sesión, bloqueo o regla a un único curl y el evento llega a tu teléfono como notificación push.

- **Notificación push en cada inicio de sesión SSH** — Un script de inicio de sesión en /etc/profile.d o en sshrc hace curl a Pocket Alert con el usuario y la IP de origen en cada sesión interactiva.
- **Bloqueos de fail2ban** — fail2ban ejecuta un curl en su actionban, así cada IP bloqueada aparece en tu teléfono con la jail que la detectó.
- **sudo e inicios de sesión de administrador** — Un hook de PAM o un disparador de sudo se activa cuando alguien eleva sus privilegios, y un nuevo inicio de sesión de administrador llega del mismo modo.
- **Disparadores de IDS y auditoría** — CrowdSec, Wazuh, OSSEC y auditd ejecutan curl cuando una regla coincide.
- **Mapeo de campos** — El mapeo de campos con GJSON extrae el usuario, la IP de origen y la regla de un payload de SIEM y los incluye en el título y el mensaje.
- **Entrega en menos de un segundo** — Las notificaciones llegan en mucho menos de un segundo, lo bastante rápido para detectar una sesión mientras sigue abierta.

## Alerta en cada inicio de sesión

### 1. Obtén una clave de API

Crea una aplicación en Pocket Alert y copia tu clave de API. Envíala en la cabecera `Token`. Asigna a cada servidor su propia aplicación para que los servidores de producción, bastión y personales queden en canales separados.

### 2. Inicio de sesión SSH (sshrc o /etc/profile.d)

Coloca un script en `/etc/profile.d` para que cada inicio de sesión interactivo haga curl a la API de mensajes con el usuario y la IP de origen de `$SSH_CONNECTION`:

```
# /etc/profile.d/pocketalert-login.sh
[ -n "$SSH_CONNECTION" ] && curl -s -X POST "https://api.pocketalert.app/v1/messages" \
  -H "Token: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"title\":\"SSH login\",\"message\":\"$USER from ${SSH_CONNECTION%% *} on $(hostname)\"}"
```

### 3. Bloqueo de fail2ban (acción personalizada)

Añade una acción en `/etc/fail2ban/action.d/pocketalert.conf` y referénciala desde una jail. fail2ban sustituye `<ip>` y `<name>` en cada bloqueo:

```
[Definition]
actionban = curl -s -X POST "https://api.pocketalert.app/v1/messages" \
  -H "Token: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title":"fail2ban: banned <ip>","level":"critical","message":"jail <name> banned <ip>"}'
```

### 4. SIEM (webhook)

Para un SIEM o IDS que emite JSON (Wazuh, CrowdSec), crea un webhook con una plantilla de `message` en GJSON que mapee su payload y, después, apunta la herramienta a la URL de recepción:

```
curl -X POST "https://api.pocketalert.app/v1/webhooks" \
  -H "Token: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Wazuh alerts","message":"%rule.description% from %data.srcip%","application_id":"qm47b9pzxzxg"}'
```

Obtendrás `https://p4a.me/wh/1234abcd` para pegar en la configuración de integración de la herramienta.

Consulta la [documentación de configuración de webhooks](https://info.pocketalert.app/api/webhooks/settings.html) para la API de mensajes y el mapeo de campos con GJSON.

## Preguntas frecuentes

### ¿Cómo recibo una alerta en cada inicio de sesión SSH?

Coloca un pequeño script en /etc/profile.d que haga curl a Pocket Alert con $USER y la IP de $SSH_CONNECTION. Cada inicio de sesión interactivo enviará entonces una notificación push a tu teléfono.

### ¿Puede fail2ban enviarme una notificación push?

fail2ban ejecuta un curl en su actionban. Incluye la IP bloqueada y la jail en el cuerpo del mensaje y verás cada bloqueo en el momento en que ocurre.

### ¿Cómo distingo los inicios de sesión urgentes de los rutinarios?

Pon el evento en el título para que se lea de un vistazo: un inicio de sesión de root desde una IP nueva y un inicio de sesión rutinario del usuario de despliegue llegan como alertas claramente distintas. Asigna a los servidores sensibles su propia aplicación para mantenerlos separados.

### ¿Funciona con CrowdSec, Wazuh o auditd?

Sí. CrowdSec, Wazuh, OSSEC y auditd pueden ejecutar curl ante un evento. El mapeo de campos con GJSON extrae el usuario, la IP de origen y la regla y los incluye en el título y el mensaje.

### ¿Cómo separo las alertas por servidor?

Asigna a cada servidor su propia aplicación: producción, bastión, personal. Los canales por aplicación mantienen las alertas separadas para que sepas qué servidor ha generado la señal. Pocket Alert retransmite el evento; no es un IDS.

### ¿Puede un inicio de sesión de root atravesar el modo silencio a las 3 de la mañana?

Sí. Añade "level":"critical" al curl y en Android el envío va a un canal de notificación dedicado que omite No molestar; solo tienes que conceder el acceso a No molestar una vez. En iPhone, las prioridades alta y crítica llegan como notificaciones sensibles al tiempo que atraviesan los modos de Concentración. Mantén los inicios de sesión rutinarios del usuario de despliegue con nivel silent: sin sonido ni vibración, pero siguen en el historial cuando necesites el registro de auditoría. En el plan gratuito, critical se entrega como high: sigue siendo instantáneo, pero sin el omitir No molestar.
