# 서버의 모든 보안 이벤트 를 휴대폰으로 받아보세요.

> SSH 로그인, sudo 사용, fail2ban 차단을 푸시 알림으로 받아보세요. 로그인 스크립트에서 curl 한 번이면 사용자, 접속 IP, 규칙 정보가 1초 안에 휴대폰으로 도착해요.

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

마지막 업데이트: 2026-08-11

SSH 로그인, fail2ban 차단, CrowdSec이나 auditd 규칙처럼 서버에 무언가 접근하면 사용자, 출발지 IP, 규칙이 1초 안에 휴대폰에 도착합니다. 입력이 끝나기 전에 누가 로그인했는지 확인하세요.

## 로그인 알림까지 세 단계

1. **API 키 발급받기** — API 키와 서버별 애플리케이션을 만든 뒤, 키는 서버의 환경 변수에 보관하세요.
2. **이벤트 연결하기** — 로그인 스크립트, fail2ban 액션, IDS 규칙에 사용자와 출발지 IP를 보내는 curl을 추가하세요.
3. **서버 지켜보기** — 로그인과 차단 알림은 1초 안에 휴대폰에 도착합니다. 이벤트 내용을 제목에 넣어 새 IP에서의 root 로그인이 정기 배포와 확실히 구분되도록 하세요.

## 로그인에서 푸시 알림까지

로그인, 차단, 규칙 트리거를 curl 한 줄에 연결하면 이벤트가 푸시 알림으로 휴대폰에 도착합니다.

- **SSH 로그인 푸시 알림** — /etc/profile.d의 로그인 스크립트나 sshrc가 대화형 세션마다 사용자와 출발지 IP를 curl로 Pocket Alert에 보냅니다.
- **fail2ban 차단 알림** — fail2ban은 actionban에서 curl을 실행합니다. 차단된 IP마다 어떤 jail이 잡았는지 함께 휴대폰에 표시됩니다.
- **sudo 및 관리자 로그인** — 권한 상승이 일어나면 PAM 훅이나 sudo 트리거가 실행되고, 새 관리자 로그인도 같은 방식으로 알려줍니다.
- **IDS 및 감사 트리거** — CrowdSec, Wazuh, OSSEC, auditd는 규칙이 일치하면 curl을 호출합니다.
- **필드 매핑** — GJSON 필드 매핑으로 SIEM 페이로드에서 사용자, 출발지 IP, 규칙을 추출해 제목과 메시지에 넣습니다.
- **1초 미만 전달** — 푸시 알림은 1초가 채 걸리지 않게 도착하므로, 세션이 열려 있는 동안 바로 확인할 수 있습니다.

## 모든 로그인에 알림 받기

### 1. API 키 발급받기

Pocket Alert에서 애플리케이션을 만들고 API 키를 복사하세요. `Token` 헤더에 담아 보내면 됩니다. 서버마다 애플리케이션을 따로 만들면 prod, bastion, personal 서버의 채널이 분리된 상태로 유지됩니다.

### 2. SSH 로그인 (sshrc 또는 /etc/profile.d)

`/etc/profile.d`에 스크립트를 넣으면, 대화형 로그인마다 `$SSH_CONNECTION`의 사용자와 출발지 IP를 메시지 API로 보내게 됩니다:

```
# /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. fail2ban 차단 (커스텀 액션)

`/etc/fail2ban/action.d/pocketalert.conf`에 액션을 추가하고 jail에서 참조하세요. 차단이 발생하면 fail2ban이 `<ip>`와 `<name>`을 치환합니다:

```
[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 (웹훅)

Wazuh, CrowdSec처럼 JSON을 출력하는 SIEM이나 IDS라면, 페이로드를 매핑하는 GJSON `message` 템플릿으로 웹훅을 만든 뒤 도구에 수신 URL을 설정하세요:

```
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"}'
```

도구의 연동 설정에 붙여 넣을 `https://p4a.me/wh/1234abcd` 주소가 발급됩니다.

메시지 API와 GJSON 필드 매핑은 [웹훅 설정 문서](https://info.pocketalert.app/api/webhooks/settings.html)를 참고하세요.

## 자주 묻는 질문

### SSH 로그인할 때마다 알림을 받으려면 어떻게 하나요?

curl로 $USER와 $SSH_CONNECTION의 IP를 Pocket Alert에 보내는 작은 스크립트를 /etc/profile.d에 넣어 보세요. 그러면 대화형 로그인마다 휴대폰으로 푸시 알림이 갑니다.

### fail2ban 차단도 푸시 알림으로 받을 수 있나요?

fail2ban은 actionban에서 curl을 실행할 수 있습니다. 차단된 IP와 jail을 메시지 본문에 넣으면 차단이 일어날 때마다 바로 확인할 수 있습니다.

### 긴급한 로그인과 일상적인 로그인은 어떻게 구분하나요?

이벤트 내용을 제목에 넣으면 한눈에 파악할 수 있습니다. 새 IP에서의 root 로그인과 정기 배포 사용자의 로그인은 서로 다른 알림으로 명확히 구분됩니다. 민감한 서버는 별도의 애플리케이션으로 나누면 더 확실하게 분리할 수 있습니다.

### CrowdSec, Wazuh, auditd와도 연동되나요?

네. CrowdSec, Wazuh, OSSEC, auditd 모두 트리거가 발생하면 curl을 호출할 수 있습니다. GJSON 필드 매핑으로 사용자, 출발지 IP, 규칙을 제목과 메시지에 넣을 수 있습니다.

### 서버별로 알림을 나누려면 어떻게 하나요?

서버마다 애플리케이션을 따로 만드세요. 예를 들어 prod, bastion, personal로 나누면 됩니다. 애플리케이션별로 채널이 분리되어 있어 어느 서버에서 알림이 왔는지 바로 알 수 있습니다. Pocket Alert는 이벤트를 전달할 뿐이며, 침입 탐지 시스템(IDS)이 아닙니다.

### 새벽 3시에 root 로그인이 무음 모드를 뚫고 올 수 있나요?

네. curl 요청에 "level":"critical"을 추가하면 Android에서는 방해 금지 모드를 무시하는 전용 알림 채널로 전달됩니다. 방해 금지 접근 권한은 한 번만 허용하면 됩니다. iPhone에서는 high와 critical이 집중 모드를 뚫고 도착하는 시간 민감형 알림으로 전달됩니다. 반대로 정기 배포 사용자의 로그인은 level을 silent로 설정하세요. 소리와 진동은 없지만, 감사 기록이 필요할 때 히스토리에서 확인할 수 있습니다. 무료 플랜에서는 critical이 high로 전달됩니다. 즉시 도착하는 점은 같지만 방해 금지 모드 무시 기능은 없습니다.
