> ## Documentation Index
> Fetch the complete documentation index at: https://docs.livingsecurity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 슬랙 연동

> Living Security를 슬랙에 연결하여 교육 알림, 보안 경고 및 플레이북 업데이트를 워크스페이스로 전송하십시오.

슬랙 연동을 사용하면 Living Security가 슬랙 워크스페이스로 직접 알림을 보낼 수 있습니다. 사용자에게 교육 할당을 알리고, 보안 팀에 위험 이벤트를 경고하며, 관리자에게 팀 진행 상황을 지속적으로 공유할 수 있습니다.

<Note>
  넛지 및 플레이북 전송 설정은 **설정 → 통신 → 채널**에서 시작하여 **슬랙** 카드를 클릭하십시오. 이 페이지에서는 기본이 되는 슬랙 앱 구성을 다룹니다.
</Note>

## 사전 요구 사항

슬랙 연동을 구성하기 전에 다음 사항을 확인하십시오.

* 슬랙 워크스페이스 관리자 또는 앱 설치 권한
* [api.slack.com](https://api.slack.com)의 슬랙 API 포털에 대한 액세스 권한
* Living Security 관리자 권한

## 슬랙 앱 만들기

<Steps>
  <Step title="새 슬랙 앱 만들기">
    1. [api.slack.com/apps](https://api.slack.com/apps)로 이동합니다.
    2. **Create New App**을 클릭합니다.
    3. **From scratch**를 선택합니다.
    4. 앱 이름을 입력합니다(예: "Living Security").
    5. 워크스페이스를 선택합니다.
    6. **Create App**을 클릭합니다.

    <Check>
      슬랙 API 대시보드에 앱이 표시됩니다.
    </Check>
  </Step>

  <Step title="OAuth 범위 구성">
    1. 왼쪽 사이드바에서 **OAuth & Permissions**를 클릭합니다.
    2. **Bot Token Scopes**까지 스크롤합니다.
    3. 다음 범위를 추가합니다.

    | 범위 | 용도 |
    | - | - |
    | `chat:write` | 채널에 메시지 전송 |
    | `chat:write.public` | 채널에 참여하지 않고 메시지 전송 |
    | `users:read` | 사용자 정보 조회 |
    | `users:read.email` | 이메일 주소로 사용자 매칭 |

    <Tip>
      조직에 필요한 범위만 추가하십시오. 범위가 적을수록 보안이 강화됩니다.
    </Tip>
  </Step>

  <Step title="워크스페이스에 앱 설치">
    1. **OAuth & Permissions** 상단으로 스크롤합니다.
    2. **Install to Workspace**를 클릭합니다.
    3. 권한을 검토한 후 **Allow**를 클릭합니다.

    <Check>
      `xoxb-`로 시작하는 **Bot User OAuth Token**이 표시됩니다.
    </Check>
  </Step>

  <Step title="서명 비밀 가져오기">
    1. 왼쪽 사이드바에서 **기본 정보**를 클릭합니다.
    2. **App Credentials**까지 스크롤합니다.
    3. **Signing Secret**을 복사합니다.

    <Warning>
      서명 비밀은 비공개로 유지하십시오. 공개 저장소나 로그에 절대 공유하지 마십시오.
    </Warning>
  </Step>
</Steps>

## Living Security에 자격 증명 추가

<Steps>
  <Step title="아웃바운드 통합으로 이동">
    **설정 → 통합 → 아웃바운드**로 이동하여 **슬랙** 카드를 클릭합니다.
  </Step>

  <Step title="자격 증명 추가">
    **Add Credential**을 클릭한 후 다음을 입력합니다.

    <ParamField body="botToken" type="string" required>
      `xoxb-`로 시작하는 Bot User OAuth Token입니다. **OAuth & Permissions**에서 확인할 수 있습니다.
    </ParamField>

    <ParamField body="signingSecret" type="string" required>
      앱의 Signing Secret입니다. **기본 정보 → App Credentials**에서 확인할 수 있습니다.
    </ParamField>

    <ParamField body="appToken" type="string">
      선택 사항입니다. Socket Mode 연결에만 필요합니다. `xapp-`로 시작합니다.
    </ParamField>

    <ParamField body="label" type="string">
      선택 사항입니다. 이 자격 증명을 식별하기 위한 알기 쉬운 이름입니다(예: "Production Slack").
    </ParamField>
  </Step>

  <Step title="저장 및 확인">
    **저장**을 클릭합니다. 자격 증명이 목록에 **활성** 상태로 표시됩니다.

    <Check>
      이제 슬랙 연동이 연결되어 알림을 보낼 준비가 되었습니다.
    </Check>
  </Step>
</Steps>

## 알림 유형

연결이 완료되면 Living Security는 다음 알림 유형을 슬랙으로 보낼 수 있습니다.

| 알림 | 설명 |
| - | - |
| 교육 할당 | 새 교육이 할당되면 사용자에게 알림 |
| 교육 미리 알림 | 다가오는 기한을 사용자에게 상기 |
| 완료 확인 | 교육이 완료되면 확인 메시지 전송 |
| 보안 경고 | 위험 이벤트를 보안 팀에 통지 |
| 플레이북 요약 | 플레이북 성과 업데이트를 정기적으로 전송 |

## 문제 해결

<AccordionGroup>
  <Accordion title="채널에 메시지가 표시되지 않음">
    * 봇이 채널에 초대되었는지 확인합니다(`/invite @YourBotName`).
    * 참여하지 않고 공개 채널에 게시하기 위한 `chat:write.public` 범위가 추가되었는지 확인합니다.
    * 채널 ID가 올바른지 확인합니다(이름이 아닌 채널 ID를 사용하십시오).
  </Accordion>

  <Accordion title="잘못된 토큰 오류">
    * `xoxb-`로 시작하는 전체 토큰을 복사했는지 확인합니다.
    * 앱이 여전히 워크스페이스에 설치되어 있는지 확인합니다.
    * 토큰이 재생성되었는지 확인합니다(재생성된 경우 Living Security에서 업데이트해야 합니다).
  </Accordion>

  <Accordion title="속도 제한">
    슬랙은 API 요청 수를 제한합니다. 속도 제한 오류가 표시되는 경우 다음을 수행하십시오.

    * 알림 빈도를 줄입니다.
    * 여러 알림을 하나의 요약 메시지로 통합합니다.
    * 대량 사용 사례의 경우 지원팀에 문의합니다.
  </Accordion>
</AccordionGroup>

## 모범 사례

<Tip>
  Living Security 알림 전용 슬랙 채널(예: `#security-training`)을 만들어 경고를 체계적으로 관리하고 일반 채널의 불필요한 알림을 줄이십시오.
</Tip>

* 여러 워크스페이스를 관리할 때는 의미 있는 자격 증명 레이블을 사용하십시오.
* 알림을 수신하는 채널을 정기적으로 점검하십시오.
* 대량 경고의 경우 개별 메시지 대신 알림 요약을 설정하십시오.
* 슬랙 앱 권한을 분기별로 검토하고 사용하지 않는 범위를 제거하십시오.

## 관련 항목

<CardGroup cols={2}>
  <Card title="이메일 연동" icon="envelope" href="/ko/integrations/outbound/email">
    이메일을 전송 채널로 구성합니다.
  </Card>

  <Card title="Teams 연동" icon="microsoft" href="/ko/integrations/outbound/teams">
    Microsoft Teams를 전송 채널로 구성합니다.
  </Card>

  <Card title="통신 로그" icon="clock-rotate-left" href="/ko/features/communications/log">
    슬랙 전송 상태와 기록을 추적합니다.
  </Card>

  <Card title="새 연동 설정 방법" icon="plug" href="/ko/integrations/managing/setup">
    일반 연동 설정 가이드입니다.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.