로그인에서 푸시 알림까지
로그인, 차단, 규칙 트리거를 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초가 채 걸리지 않게 도착하므로, 세션이 열려 있는 동안 바로 확인할 수 있습니다.
로그인 알림까지 세 단계
API 키 발급받기
API 키와 서버별 애플리케이션을 만든 뒤, 키는 서버의 환경 변수에 보관하세요.
이벤트 연결하기
로그인 스크립트, fail2ban 액션, IDS 규칙에 사용자와 출발지 IP를 보내는 curl을 추가하세요.
서버 지켜보기
로그인과 차단 알림은 1초 안에 휴대폰에 도착합니다. 이벤트 내용을 제목에 넣어 새 IP에서의 root 로그인이 정기 배포와 확실히 구분되도록 하세요.
모든 로그인에 알림 받기
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 필드 매핑은 웹훅 설정 문서를 참고하세요.
궁금한 점을 답해드려요
curl로 $USER와 $SSH_CONNECTION의 IP를 Pocket Alert에 보내는 작은 스크립트를 /etc/profile.d에 넣어 보세요. 그러면 대화형 로그인마다 휴대폰으로 푸시 알림이 갑니다.
fail2ban은 actionban에서 curl을 실행할 수 있습니다. 차단된 IP와 jail을 메시지 본문에 넣으면 차단이 일어날 때마다 바로 확인할 수 있습니다.
이벤트 내용을 제목에 넣으면 한눈에 파악할 수 있습니다. 새 IP에서의 root 로그인과 정기 배포 사용자의 로그인은 서로 다른 알림으로 명확히 구분됩니다. 민감한 서버는 별도의 애플리케이션으로 나누면 더 확실하게 분리할 수 있습니다.
네. CrowdSec, Wazuh, OSSEC, auditd 모두 트리거가 발생하면 curl을 호출할 수 있습니다. GJSON 필드 매핑으로 사용자, 출발지 IP, 규칙을 제목과 메시지에 넣을 수 있습니다.
서버마다 애플리케이션을 따로 만드세요. 예를 들어 prod, bastion, personal로 나누면 됩니다. 애플리케이션별로 채널이 분리되어 있어 어느 서버에서 알림이 왔는지 바로 알 수 있습니다. Pocket Alert는 이벤트를 전달할 뿐이며, 침입 탐지 시스템(IDS)이 아닙니다.
네. curl 요청에 "level":"critical"을 추가하면 Android에서는 방해 금지 모드를 무시하는 전용 알림 채널로 전달됩니다. 방해 금지 접근 권한은 한 번만 허용하면 됩니다. iPhone에서는 high와 critical이 집중 모드를 뚫고 도착하는 시간 민감형 알림으로 전달됩니다. 반대로 정기 배포 사용자의 로그인은 level을 silent로 설정하세요. 소리와 진동은 없지만, 감사 기록이 필요할 때 히스토리에서 확인할 수 있습니다. 무료 플랜에서는 critical이 high로 전달됩니다. 즉시 도착하는 점은 같지만 방해 금지 모드 무시 기능은 없습니다.
입력이 끝나기 전에 누가 로그인했는지 확인하세요.
로그인 스크립트나 fail2ban 액션을 Pocket Alert에 연결하고, 누가 서버에 접근하는지 확인해 보세요.