> For the complete documentation index, see [llms.txt](https://docs.compliance.phalcon.blocksec.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.compliance.phalcon.blocksec.com/ko-kr/manual/notification-channels.md).

# 알림 채널

**알림 채널**은 **7개의 통합 채널**을 통해 알림을 전달합니다 — [Telegram](#telegram), [이메일](#e-mail), [Lark](#lark), [Webhook](#webhook), [Slack](#slack), [Discord](#discord), 그리고 [PagerDuty](#pagerduty).

각 채널은 독립적으로 두 가지 유형의 알림을 구독할 수 있습니다:

* **Risk Engines** — 매핑된 Risk Engines에 의해 트리거되는 알림입니다.
* **Monitor Events** — 모니터링 중인 주소에서 감지된 위험 변화입니다. 구성 세부 정보는 [Monitor](/ko-kr/manual/monitor.md#setting-up-notifications)를 참조하세요.

<figure><img src="/files/ul637jf2nYWTn3GATehD" alt="Notification channel detail page with Monitor Events enabled"><figcaption></figcaption></figure>

## Telegram <a href="#telegram" id="telegram"></a>

**Telegram 알림 채널**은 세 가지 알림 전달 모드를 제공합니다: **User Chat**, **Group Chat**, 그리고 **Channel**.

* **User Chat Mode**: 알림이 봇으로 직접 전송됩니다.
* **Group/Channel Mode**: 봇이 미리 구성된 Telegram 그룹 또는 채널로 알림 메시지를 푸시합니다.

각 모드에 대한 구성 단계는 아래에 자세히 설명되어 있습니다.

### **Telegram User Chat Mode**

* **Step 1**: Telegram에서 **@BlockSecPhalcon\_bot** (<https://t.me/BlockSecPhalcon_bot>)을 검색하고 이 봇과의 채팅을 엽니다.
* **Step 2**: 봇과의 채팅에서 `/getchatid` 명령을 전송하여 "User ID"를 받습니다.
* **Step 3**: Phalcon에서 Telegram 알림 채널을 생성하고 "User" 채팅 유형을 선택합니다.
* **Step 4**: "User ID"를 지정된 필드에 붙여넣어 채널 생성을 완료합니다.

이 채널과 연결된 위험 엔진이 트리거될 때, 봇은 자동으로 이 채팅에 구조화된 알림 메시지를 전송합니다 (아래 예제 참조).

### **Telegram Group Chat Mode**

* **Step 1**: 알림을 받을 Telegram 그룹에 @BlockSecPhalcon\_bot을 추가합니다.
* **Step 2**: 그룹 채팅에서 `/getchatid` 명령을 전송하여 "Group Chat ID"를 얻습니다.
* **Step 3**: Phalcon에서 Telegram 알림 채널을 생성하고 "Group" 채팅 유형을 선택합니다.
* **Step 4**: "Group ID"를 지정된 필드에 붙여넣어 채널 생성을 완료합니다.

### **Telegram Channel Mode**

* **Step 1**: @BlockSecPhalcon\_bot을 Telegram 채널의 관리자로 추가합니다.
* **Step 2**: 채널 채팅에서 `/getchannelid` 명령을 전송하여 "Channel ID"를 얻습니다.
* **Step 3**: Phalcon에서 Telegram 알림 채널을 생성하고 "Channel" 채팅 유형을 선택합니다.
* **Step 4**: "Channel ID"를 지정된 필드에 붙여넣어 채널 생성을 완료합니다.

## 이메일

* **Step 1**: 이메일 유형 알림 채널을 생성하고 알림을 받을 이메일 주소를 입력합니다.
* **Step 2**: 인증 코드를 입력하여 생성을 완료합니다.

이 이메일 알림 채널과 연결된 위험 엔진이 트리거될 때, 미리 구성된 이메일 주소는 구조화된 알림 메시지를 받습니다 (아래 예제 참조).

<br>

## Lark <a href="#lark" id="lark"></a>

* **Step 1**: Lark 그룹에 봇을 추가합니다.
* **Step 2**: "Custom Bot"을 유형으로 선택하고 봇을 설정합니다.
* **Step 3**: Phalcon에서 Lark 알림을 생성합니다.
* **Step 4**: Webhook URL과 Secret Signature를 입력합니다.

> Lark 봇 생성에 대한 자세한 정보는 다음을 참조하세요: <https://open.larksuite.com/document/client-docs/bot-v3/bot-overview>

이 Lark 알림 채널과 연결된 위험 엔진이 트리거될 때, Lark 그룹에 알림 메시지가 나타납니다 (아래 예제 참조).

<br>

## Webhook <a href="#webhook" id="webhook"></a>

**Webhook 채널**을 사용하면 Phalcon의 알림 메시지를 자신의 서버나 애플리케이션에서 직접 받을 수 있습니다. Phalcon과 시스템 사이에 보안 bridge를 만드는 것으로 생각할 수 있습니다—모니터가 트리거될 때마다, Phalcon은 이 bridge를 통해 자동으로 이러한 알림을 서버로 전송합니다.

* **Step 1**: Phalcon에서 Webhook 채널을 생성합니다.
* **Step 2**: Webhook Server URL을 입력합니다.

> 서버가 Basic Authentication을 사용하는 경우, 필요한 자격 증명을 제공하세요.

자세한 Webhook 메시지 형식 및 기술 사양은 다음 문서를 참조하세요:

[Webhook 형식](/ko-kr/manual/notification-channels/webhook-format.md)[<br>](https://docs.google.com/document/d/1vewc32T-jTVEaqz-W4fHtZFAf88uF4vzdJM8pWkYTVA/edit?tab=t.0#heading=h.ntu9zql97jl5)

## Slack

* **Step 1**: Phalcon에서 Slack 알림 채널을 생성합니다.
* **Step 2**: `Connect Slack` 버튼을 클릭하여 인증 페이지로 이동합니다.
* **Step 3**: 알림을 받을 채널을 구성하고 권한을 부여합니다.

이 Slack 채널과 연결된 위험 엔진이 트리거될 때, 아래 예제에 표시된 대로 Slack에서 알림 메시지를 받습니다.

## Discord

* **Step 1**: 알림을 받을 Discord 채널에서 `Edit Channel`을 클릭합니다.
* **Step 2**: `Integrations` 페이지에서 Webhook을 생성합니다.
* **Step 3**: Phalcon에서 Discord 채널을 생성합니다.
* **Step 4**: Webhook URL을 붙여넣고 채널 생성을 완료합니다.

> Discord Webhook 생성에 대한 자세한 정보는 다음을 참조하세요: <https://support.discord.com/hc/en-us/articles/228383668-Intro-to-Webhooks>

이 Discord 채널과 연결된 위험 엔진이 트리거될 때, 채널은 아래 예제에 표시된 대로 알림 메시지를 받습니다.

## PagerDuty

PagerDuty용 알림 채널을 설정하는 방법은 두 가지입니다: **Token** 또는 **이메일 인증**.

**Token 인증**

* **Step 1**: PagerDuty 계정에 `Events API V2` 통합을 추가합니다.
* **Step 2**: Phalcon에서 PagerDuty 채널을 생성하고 "Token" 모드를 선택합니다.
* **Step 3**: `Integration Key`를 붙여넣어 구성을 완료합니다.

<br>

**이메일 인증**

* **Step 1**: PagerDuty 계정에 `Email` 통합을 추가합니다.
* **Step 2**: Phalcon에서 PagerDuty 채널을 생성하고 "Email" 모드를 선택합니다.
* **Step 3**: `Integration Email` 주소를 입력하고 이메일 인증 프로세스를 완료합니다.
