# Slack Bot 대상
## 개요
대상은 룰, 정책, 시스템 상태 알러트, 룰 오류로부터 알러트를 수신하는 통합입니다. Panther는 알러트를 수신할 대상로 Panther Slack Bot을 구성하는 것을 지원합니다.
Panther의 Slack Bot은 하나 이상의 Slack 채널로 알러트를 보낼 수 있는 Slack 애플리케이션입니다.
다음 사항에 유의하세요:
* 알러트와 상호작용하려면 Slack 사용자 이메일 주소가 Panther에 정의된 사용자 프로필의 이메일 주소와 일치해야 합니다.
* Slack의 이메일 주소가 Panther Console의 이메일 주소와 일치하지 않는 경우, 지원을 위해 Panther 지원팀에 문의하세요.
### Slack에서 알러트 관리
Slack 내에서 알러트의 상태를 업데이트하거나 담당자를 지정하고 Boomerang 메시지를 보내는 등의 상호작용은 Panther Console로 다시 동기화됩니다. 알러트를 "Resolved"로 표시할 때의 해결 댓글은 Panther 알러트 Activity 섹션으로 동기화됩니다.
알러트 상태, 담당자, 댓글에 대한 양방향 동기화도 활성화할 수 있습니다. 이는 Panther Console(또는 Panther API)에서 알러트의 상태나 담당자가 변경되거나 댓글이 남겨지면, 해당 변경 사항이 관련 Slack Bot 알러트로 동기화된다는 뜻입니다. 마찬가지로 Jira와 같은 외부 대상에서 댓글이 추가되면 양방향 댓글 동기화가 활성화되어 있는 경우 Slack에도 동기화됩니다. 자세한 내용은 다음에서 확인하세요. [양방향 댓글 동기화](https://docs.panther.com/ko/alert-management/slack#two-way-comment-syncing).
Slack에서 알러트 관리에 대한 자세한 내용은 다음을 참조하세요. [Slack에서 알러트 관리](https://docs.panther.com/ko/alerts/alert-management/slack).
## Slack Bot 설정 비디오 안내
{% embed url="" %}
Panther의 Slack Bot 알러트 대상 통합을 설정하는 비디오 안내입니다.
{% endembed %}
{% hint style="info" %}
위 비디오에서 Panther Console의 Slack Bot 설정 화면(3:18-4:40 사이에 표시됨)은 이제 더 이상 사용 중인 Panther Console 화면과 직접적으로 일치하지 않을 수 있습니다.
{% endhint %}
## Panther에서 Slack Bot 알러트 대상을 설정하는 방법
{% hint style="info" %}
Panther 사용자는 다음 권한을 가져야 합니다 `알러트 보기` 및 `알러트 관리` 를 통해 알러트를 지정하고 알러트 상태를 변경할 수 있습니다.
{% endhint %}
### 1단계: Panther에서 첫 번째 Slack Bot 알러트 대상 생성
첫 번째 Slack Bot 알러트 대상을 생성하려면 새 Slack 애플리케이션을 만들어야 합니다. 초기 대상이 생성되면 추가 Slack Bot 알러트 대상은 동일한 Slack 애플리케이션과 해당 자격 증명을 자동으로 재사용합니다.
1. Panther Console에 로그인합니다.
2. 왼쪽 사이드바에서 **Configure > Alert Destinations**.
3. 을 클릭합니다. **+Add your first Destination**.
* 을 클릭합니다. 이미 대상이 생성되어 있다면, 새 대상을 추가하려면 페이지 오른쪽 상단의 **Create New** 를 클릭합니다.
4. 을 클릭합니다. **Slack Bot**.
5. 을 클릭합니다. **Copy** 를 클릭하여 Slack Manifest를 클립보드에 복사합니다. 다음 단계에서 이것이 필요합니다.\
다음 단계를 시작하는 동안 이 브라우저 탭을 열어 둔 상태로 유지하세요.
### 2단계: Slack에서 Slack Bot 앱 구성
1. 별도의 브라우저 탭에서 [Slack에 로그인](https://slack.com/signin) 합니다. 관리자 계정을 사용하세요.
2. 에서 [Slack - Your Apps](https://api.slack.com/apps), 다음을 클릭합니다. **Create New App**.
3. "Create an app" 대화상자에서 옵션 **From a manifest**.\
4. 를 선택합니다. "Pick a workspace to develop your app" 대화상자에서 Slack Bot을 설치할 Slack Workspace를 선택합니다.\
1. 만약 [Slack 요금제](https://app.slack.com/plans) 가 Enterprise Grid라면, Slack Bot을 사용할 Grid 내 Workspace를 선택하세요. 나중 단계에서 Grid의 다른 Workspace에도 설치할 수 있습니다.
5. 을 클릭합니다. **다음**.
6. "Create app from manifest" 대화상자에서 **YAML.** 에서 Slack Manifest를 붙여넣습니다. [이전 단계](#begin-the-slack-bot-alert-destination-configuration-in-panther) 의 내용을 사용하여 미리 채워진 `Demo App` 예시 콘텐츠를 대체합니다).\
7. 을 클릭합니다. **다음**.
8. "Review summary & create your app" 대화상자에서 **Create.**\
9. Slack 관리자 계정으로 로그인한 경우, 3단계로 건너뜁니다: [Slack Bot 설치](#installing-slack-bot-to-workspace). 그렇지 않으면 아래를 계속 진행하세요.
10. Basic Information 페이지에서 **Request to Install**.\
* 을 클릭합니다. "Request to install Panther" 대화상자에서 Slack 관리자에게 상황을 설명할 수 있도록 선택 메시지를 추가한 후 **Submit Request**.
* 를 클릭합니다. 이제 Basic Information 페이지에 다음이 표시되어야 합니다. **Request Submitted** "Install your app" 섹션 아래에 표시됩니다.
11. Slack 관리자에게 설치 요청을 승인해 달라고 요청하되, 아직 설치하지는 마세요.
* 승인되면 **Request Submitted** 버튼이 다음으로 변경됩니다. **Install to Workspace.**
### 3단계: Slack Bot 설치
만약 [Slack 요금제](https://app.slack.com/plans) 가 Enterprise Grid인 경우 아래의 Enterprise Grid 탭을 참조하세요. 다른 모든 Slack 요금제의 경우 아래의 비-Enterprise Slack 탭을 참조하세요.
{% tabs %}
{% tab title="비-Enterprise Slack" %}
**Workspace에 Slack Bot 설치하기**
1. Slack의 Basic Information 페이지에서 **Install to Workspace.**\
* Slack OAuth Authorization 페이지로 리디렉션됩니다.\
2. 을 클릭합니다. **Allow** 를 클릭하여 새 앱에 대한 액세스를 승인합니다.
* Slack의 Basic Information 페이지로 다시 리디렉션됩니다.
3. 다음으로 진행합니다. [4단계 - Panther Slack App 구성.](#step-4-configuring-panther-slack-app)
{% endtab %}
{% tab title="Enterprise Grid" %}
**Enterprise Grid에 Slack Bot 설치**
1. Slack의 Basic information 페이지에서 **Manage Distribution** 을 확장하고 **Distribute App**.\
2. 을 클릭합니다. **를 클릭합니다.** Org-Wide Installation을 활성화하려면\
3. 을 클릭합니다. **Opt-in**.\
4. 체크박스를 선택한 다음 **Yes, Opt-in**.\
%20\(4\).png?alt=media)
5. 를 클릭합니다. **다시**Settings > Install App **으로 이동한 다음**.\
6. 을 클릭합니다. **Allow** 를 클릭하여 새 앱에 대한 액세스를 승인합니다.\
7. Install to Organization **을 클릭합니다. Slack에서 설치가 성공했다는 메시지를 받게 됩니다. 링크된 텍스트**.\
8. add it to some of your workspaces\
9. 을 클릭합니다. **다음** 를 클릭하고 화면의 안내에 따라 Slack Bot을 설치할 Workspace를 선택하세요. 선택적으로 향후 Workspace에도 자동으로 추가할지 여부도 선택할 수 있습니다:
Workspace 설치가 완료되면 Slack에서 확인 메시지를 받게 됩니다:\
작업이 끝나면 다음으로 진행하세요. [4단계 - Panther Slack App 구성.](#step-4-configuring-panther-slack-app)
{% endtab %}
{% endtabs %}
### 4단계: Panther Slack App 구성
1. Panther 로고 이미지를 컴퓨터에 다운로드합니다.
{% file src="" %}
2. 를 클릭합니다. **Settings > Basic Information** 를 Slack App에서 엽니다.
3. "Display Information" 섹션까지 아래로 스크롤한 후 **+Add App Icon**:\
* 을 클릭합니다. 이전 단계에서 다운로드한 Panther App Icon을 선택합니다.
4. Basic Information 페이지의 App Credentials 섹션까지 아래로 스크롤합니다. Panther에서 구성을 완료할 때 다음 단계에서 이 정보가 필요하므로 이 페이지를 열어 둡니다:\
### 5단계: Panther에서 구성 계속하기
1. Panther Console에서 Slack Bot 알러트 대상 구성을 시작한 브라우저 탭을 엽니다.
* 해당 탭이 닫혔거나, Slack 관리자가 아니어서 앱 설치 요청을 제출한 경우에는 Panther Console에서 Slack Bot 대상 설정 프로세스로 돌아가기 위해 다음을 따라야 합니다. [이전 단계](#begin-the-slack-bot-alert-destination-configuration-in-panther) 또한 Slack Bot 앱의 manifest를 Panther Console의 최신 버전에 맞게 업데이트해야 합니다.
2. Panther Console의 manifest가 표시되는 "Create your Slack Bot app" 페이지에서 **Continue**.
3. 를 클릭합니다. 대상 구성을 위한 양식을 작성합니다:
* **표시 이름**: 알러트 대상의 설명적인 이름을 입력합니다.
* 참고: 이것은 Slack의 Bot 이름이 아니라 Panther Console의 알러트 대상 표시 이름입니다.
* **채널 ID 또는 채널 이름**: 알러트를 수신할 Slack 채널 이름(예: #hello-world) 또는 Slack 채널 ID를 입력합니다.
* Panther Console의 나중에 이 Slack Bot으로 전송된 알러트의 알러트 세부정보 페이지에서 알러트가 생성한 특정 Slack 스레드에 하이퍼링크가 걸리므로 Slack 채널 ID를 사용하는 것이 권장됩니다. (채널 이름을 사용하면 채널 전체에 대한 링크만 제공됩니다.)
* 참고: Slack Enterprise Grid를 사용하는 경우 Slack Channel ID를 제공해야 합니다. Channel ID를 찾으려면 Slack에서 Channel Name을 클릭한 다음 모달의 맨 아래로 스크롤하세요:\
* **클라이언트 ID**: 다음 항목의 Client ID 값을 입력합니다. **App Credentials** 섹션에서 Slack Bot 앱의 값을 입력합니다.
* **클라이언트 시크릿**: 다음 항목의 Client Secret 값을 입력합니다. **App Credentials** 섹션에서 Slack Bot 앱의 값을 입력합니다.
* **Signing Secret**: 다음 항목의 Signing Secret 값을 입력합니다. **App Credentials** 섹션에서 Slack Bot 앱의 값을 입력합니다.
* **Bot OAuth Token**: 다음 항목의 **Bot User OAuth Token** 값을 입력합니다. **OAuth & Permissions** 섹션에서 Slack Bot 앱의 값을 입력합니다:\
* **심각도**: 이 대상로 보낼 알러트의 심각도 수준을 선택합니다.
* **알러트 유형**: 이 대상로 보낼 알러트 유형을 선택합니다.
* **로그 유형**: 기본적으로 모든 로그 유형의 알러트를 전송합니다. 특정 로그 유형에서만 알러트를 보내려면 여기에서 로그 유형을 지정하세요.
* **수동 전송 허용**: 이 토글을 ON으로 설정하면 다음을 수행할 수 있습니다. [알러트를 수동으로 전송](https://docs.panther.com/alerts#manual-alert-dispatch) 이 대상로 보낼 수 있습니다.
* **Slack의 알러트용 시간대**: 이 대상로 전송되는 메시지에 사용할 시간대를 선택합니다.
* **양방향 상태 동기화**: 토글 `ON` 을 사용하여 Panther Console(또는 Panther API)을 통해 변경된 알러트 상태가 Slack Bot 알러트와 동기화되도록 합니다.
* **양방향 담당자 동기화**: 토글 `ON` 를 사용하여 Panther Console(또는 Panther API)을 통해 변경된 알러트 담당자가 Slack Bot 알러트와 동기화되도록 합니다.
* **AI 분류 동기화**: 토글 `ON` 를 사용하여 알러트에 대해 생성된 Panther AI 알러트 분류가 해당 Slack Bot 알러트 스레드의 댓글로 추가되도록 합니다. 자세한 내용은 다음에서 확인하세요. [AI 알러트 분류 동기화](https://docs.panther.com/ko/alert-management/slack#ai-alert-triage-sync).
다음 단계를 위해 이 브라우저 탭을 열어 두세요.
### 6단계: Panther Slack Bot을 Slack 채널에 초대하기
1. Slack 애플리케이션을 열고 Panther와 함께 사용하도록 구성한 채널로 이동합니다.
2. Slack 채널에서 다음 메시지를 입력하고 전송합니다:\
`/invite @Panther`
Panther Slack Bot이 Slack 채널에 초대되면 Slack에서 확인 메시지를 보게 되며, Panther Console로 돌아가 설정을 마무리할 수 있습니다.\
### **7단계: Panther Console에서 설정 완료**
1. Panther Console로 다시 이동합니다.
2. "Create your Slack Bot Application" 페이지에서 **Add Destination**.\
3. 을 클릭합니다. 마지막 페이지에서 선택적으로 **Send Welcome Message** 를 클릭하여 통합을 테스트할 수 있습니다. 그러면 알러트를 수신하도록 선택한 Slack 채널로 메시지가 전송됩니다.
4. 작업이 끝나면 **Finish Setup**.
을 클릭합니다. 새 Slack Bot 알러트 대상에서 Slack으로 전송된 알러트를 확인하거나 관리하는 방법에 대한 정보는 다음을 참조하세요. [알러트 분류 - Slack Bot](https://docs.panther.com/ko/alerts/alert-management/slack).
### 8단계(선택 사항): 추가 Slack Bot 대상 생성
여러 Slack Bot 대상과의 상호작용 방식에 대한 자세한 내용은 다음에서 확인하세요. [알러트를 여러 Slack Bot 대상으로 전송하기](https://docs.panther.com/ko/alert-management/slack#sending-an-alert-to-multiple-slack-bot-destinations).
추가 Slack Bot 알러트 대상을 생성하려면 Slack Workspace에서 새 애플리케이션을 만들 필요가 없습니다.
1. 왼쪽 사이드바에서 **Configure > Alert Destinations**.
2. 을 클릭합니다. **Create New** 를 클릭합니다.
3. 을 클릭합니다. **Slack Bot**.
4. 양식을 완료하여 다음을 지정합니다. **표시 이름** 및 **채널 ID 또는 채널 이름**.
* Client ID, Client Secret, Signing Secret, Bot OAuth Token은 기존 Slack Bot 알러트 대상에 따라 미리 채워집니다.
* 지정한 채널에 Panther Bot을 초대하는 것을 잊지 마세요. `/invite @Panther`.\
5. 을 클릭합니다. **Add Destination**.
## 양방향 댓글 동기화를 위해 기존 Slack Bot 설치 업데이트
{% hint style="warning" %}
Panther 버전 1.115 이전에 Slack Bot 대상을 설정했고 다음을 활성화하고 싶다면 [양방향 댓글 동기화](https://docs.panther.com/ko/alert-management/slack#two-way-comment-syncing)를 사용하려면 필요한 권한이 포함된 새 manifest로 Slack 앱을 업데이트해야 합니다.
{% endhint %}
기존 Slack Bot 설치를 업데이트하려면:
1. Panther Console의 왼쪽 탐색 바에서 **Configure** > **Alert Destinations**.
2. 를 클릭합니다. 양방향 동기화를 활성화하려는 기존 Slack Bot 알러트 대상을 찾아 이름을 클릭합니다.
3. 페이지 하단으로 스크롤한 다음 **Go to configuration**.
4. 를 클릭합니다. 새 앱 manifest를 복사합니다.
5. 다음을 엽니다. .
6. 기존 Panther 앱을 찾아 이름을 클릭합니다.
7. 왼쪽 탐색 메뉴에서 **App Manifest**.
8. 를 클릭합니다. 기존 manifest를 Panther에서 복사한 새 manifest로 교체합니다.
9. 을 클릭합니다. **변경 사항 저장**.
10. 왼쪽 탐색 메뉴에서 **앱 설치**.
11. 을 클릭합니다. **다시 설치하기 ``**.
## 대상에 대한 추가 정보
알러트 라우팅 순서, 대상 수정 또는 삭제, 워크플로 자동화에 대한 자세한 내용은 Panther 문서를 참조하세요. [대상](https://docs.panther.com/destinations).
