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

# Slack

> 봇 토큰으로 Slack을 Iru Compliance에 연결하여 워크스페이스 메타데이터, 채널 인벤토리, 사용자 및 그룹 멤버십, Enterprise Grid 감사 로그를 수집합니다.

### Slack 정보

**Slack** 커넥터는 워크스페이스 멤버십, 채널 구성 및 사용자 그룹을 읽습니다. **Enterprise Grid**에서는 **감사 로그** 이벤트도 읽습니다. 이 정보는 Iru Compliance에서 아티팩트로 표시됩니다. Iru는 Slack 앱을 워크스페이스에 설치하여 얻은 **봇 OAuth 토큰**(`xoxb-`)으로 인증합니다. 액세스는 컴플라이언스 증거를 위한 **읽기 중심**이며, 여기에 설명된 범위를 통해 메시지를 보내거나 워크스페이스 설정을 변경하지 않습니다.

### 작동 방식

Slack API는 **Authorization** 헤더에 봇 토큰이 있어야 합니다.

```http theme={null}
Authorization: Bearer xoxb-XXXX-XXXX-XXXX
```

**api.slack.com**에서 앱을 생성하고, **Bot token scopes**를 부여하고, 앱을 워크스페이스에 설치한 다음 **Bot User OAuth Token**을 복사합니다. 범위를 확장하려면 앱을 **다시 설치**해야 하며, 이때 **새** 토큰이 발급됩니다. 이 경우 항상 Iru를 업데이트하세요.

| 세부 정보 | 값 |
| - | - |
| **카테고리** | 커뮤니케이션 |
| **인증** | Bearer 토큰(봇 OAuth 토큰 `xoxb-`) |
| **감사 로그** | `auditlogs:read`는 **Enterprise Grid 전용**입니다. Grid가 없으면 이 API 경로로는 감사 로그 형식의 증거를 사용할 수 없습니다. |

참고 자료: [OAuth tokens](https://docs.slack.dev/authentication/tokens/), [Scopes](https://docs.slack.dev/scopes/), [Audit Logs API](https://docs.slack.dev/apis/audit-logs-api/).

### 사전 요구 사항

* 앱을 설치할 수 있는 **Workspace Owner** 또는 **Workspace Admin** 권한.
* 워크스페이스에서 [api.slack.com/apps](https://api.slack.com/apps)에 로그인할 수 있는 권한.
* 선택 사항: `auditlogs:read`가 필요한 경우 Enterprise Grid.

**디렉터리 및 채널 증거를 위한 일반적인 봇 범위**

| 범위 | 용도 |
| - | - |
| `users:read` | 멤버 프로필 읽기 |
| `users:read.email` | 멤버 이메일 주소 읽기 |
| `channels:read` | 공개 채널 나열 및 읽기 |
| `groups:read` | 비공개 채널 나열 및 읽기(허용되는 경우) |
| `usergroups:read` | 사용자 그룹 구성 읽기 |
| `auditlogs:read` | 감사 로그(**Enterprise Grid** 전용) |

### Slack을 Iru에 연결

<Tabs>
  <Tab title="Slack">
    <Note>
      Compliance에서 소스를 연결하기 전에 이 탭을 완료하세요.
    </Note>

    <Steps>
      <Step title="Slack API 앱 열기">
        브라우저에서 [api.slack.com/apps](https://api.slack.com/apps)로 이동하여 대상 **워크스페이스**에 **앱을 생성**할 수 있는 Slack 계정(대개 워크스페이스 관리자)으로 로그인합니다.
      </Step>

      <Step title="새 앱 생성">
        **Create New App**을 선택한 다음 **From scratch**를 선택합니다(조직에서 매니페스트를 표준으로 사용하지 않는 경우. 이 문서는 **From scratch**를 가정합니다).
      </Step>

      <Step title="앱 이름 지정 및 워크스페이스 선택">
        **Iru Compliance**와 같은 앱 이름을 입력하고 Iru를 설치할 **Slack 워크스페이스**를 선택합니다.
      </Step>

      <Step title="OAuth & Permissions 열기">
        앱의 왼쪽 사이드바에서 **OAuth & Permissions**를 엽니다.
      </Step>

      <Step title="Bot Token 범위 추가">
        **Bot Token Scopes**에서 통제에 필요한 **사전 요구 사항**의 각 범위를 추가합니다. **Enterprise Grid**를 사용 중이고 감사 증거가 필요한 경우에만 `auditlogs:read`를 추가합니다.
      </Step>

      <Step title="워크스페이스에 앱 설치">
        **OAuth & Permissions**에서 **Install to Workspace**(범위 변경 후에는 **Reinstall**)를 선택합니다. 권한을 검토하고 승인합니다.
      </Step>

      <Step title="Bot User OAuth Token 복사">
        **Bot User OAuth Token**(`xoxb-`로 시작)을 복사합니다. 나중에 범위를 변경하면 다시 설치하여 **새** 토큰을 받으세요. **Iru Compliance**에서 메시지가 표시되면 현재 토큰을 Iru 커넥터 마법사에 붙여넣습니다.
      </Step>
    </Steps>

    <Note>
      [**Iru Compliance**](#iru-compliance) 탭에서 계속 진행하세요.
    </Note>
  </Tab>

  <Tab title="Iru Compliance">
    <Note>
      먼저 [**Slack**](#slack) 탭을 완료하세요.
    </Note>

    <Steps>
      <Step title="소스 열기">
        Iru Compliance의 왼쪽 탐색 모음에서 **컴플라이언스**를 펼치고 **소스**를 선택합니다.

        <Frame>
          <img src="https://mintcdn.com/iru/tI0HDLDwHj8r9Ile/assets/media/images/iru-navigation-compliance-sources.png?fit=max&auto=format&n=tI0HDLDwHj8r9Ile&q=85&s=87dcef15fc17d2fb9a6e53f454e41710" alt="왼쪽 탐색 메뉴: Compliance 펼침, Sources 선택됨" width="410" height="1024" data-path="assets/media/images/iru-navigation-compliance-sources.png" />
        </Frame>
      </Step>

      <Step title="Slack 켜기">
        **Slack**을 찾습니다(**범주**를 **Communications**로 설정하거나 **이름 또는 설명으로 검색** 사용). 해당 카드에서 **토글**을 켭니다. 커넥터 마법사를 위한 브라우저 탭이나 창이 열릴 수 있습니다.
      </Step>

      <Step title="마법사에 봇 토큰 붙여넣기">
        마법사에서 Bearer 토큰을 요청하면 **`xoxb-`** **Bot User OAuth Token**을 붙여넣고 제출합니다.
      </Step>

      <Step title="연결 완료">
        **Bearer 토큰 제출**을 선택합니다. 연결에 성공하면 마법사에 **연결 구성됨**이 표시됩니다.
      </Step>

      <Step title="소스가 활성 상태인지 확인">
        **Iru가 외부 서비스에 대한 액세스를 요청하고 있습니다** 브라우저 탭을 닫은 다음 **컴플라이언스** → **소스**로 돌아가 **Slack** 카드가 **활성** 상태인지 확인합니다.
      </Step>
    </Steps>
  </Tab>
</Tabs>

### 문제 해결

<AccordionGroup>
  <Accordion title="소스를 켜도 아무것도 열리지 않음">
    Iru 사이트의 **팝업 차단** 설정을 확인한 후 다시 시도하세요.
  </Accordion>

  <Accordion title="not_authed / 401">
    토큰이 최신이고 `xoxb-`로 시작하며 앱이 여전히 설치되어 있는지 확인하세요.
  </Accordion>

  <Accordion title="missing_scope">
    **OAuth & Permissions**에서 범위를 추가하고, 앱을 **다시 설치**하고, **새** 토큰을 복사한 다음 Iru를 업데이트하세요.
  </Accordion>

  <Accordion title="token_revoked">
    앱을 다시 설치하거나 자격 증명을 교체하고, 새 봇 토큰으로 Iru를 업데이트하세요.
  </Accordion>

  <Accordion title="감사 데이터 없음">
    `auditlogs:read`에는 **Enterprise Grid**가 필요합니다. 그렇지 않으면 감사 로그 API 증거를 사용할 수 없습니다.
  </Accordion>
</AccordionGroup>

### 고려 사항

<CardGroup cols={2}>
  <Card title="봇 토큰은 워크스페이스에서 교체를 강제하지 않는 한…" icon="circle-info">
    봇 토큰은 워크스페이스에서 교체를 강제하지 않는 한 일반적으로 **만료되지 않습니다**. 교체가 활성화된 경우 Slack 지침을 따르세요.
  </Card>

  <Card title="앱을 제거하면 토큰이 즉시 취소됩니다." icon="shield">
    앱을 제거하면 토큰이 즉시 **취소**됩니다.
  </Card>

  <Card title="범위를 늘리려면 항상 재설치와 새 토큰이…" icon="server">
    범위를 늘리려면 항상 **재설치**와 새 토큰이 필요합니다. 유지 관리 기간 중에 변경을 계획하세요.
  </Card>
</CardGroup>

### 관련 문서

<CardGroup cols={2}>
  <Card title="Sources 관리" icon="plug" href="/ko/compliance/sources-management">
    모든 Compliance 소스를 찾아보고 관리합니다.
  </Card>

  <Card title="Compliance 시작하기" icon="rocket" href="/ko/compliance/getting-started-with-compliance">
    프레임워크, 작업 및 **아티팩트**.
  </Card>

  <Card title="Iru 개요" icon="layer-group" href="/ko/iru/platform-overview/iru-overview">
    Endpoint, Compliance 및 Identity가 함께 작동하는 방식.
  </Card>

  <Card title="Artifacts 관리" icon="folder-open" href="/ko/compliance/artifacts-management">
    소스 및 작업에서 수집된 증거를 업로드, 검토 및 정리합니다.
  </Card>
</CardGroup>