> ## 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.

# Notion

> 내부 통합 토큰으로 Notion을 Iru Compliance에 연결하여 컨트롤 평가를 위한 워크스페이스, 페이지, 데이터베이스 및 멤버 액세스 증거를 수집합니다.

### Notion 정보

**Notion** 커넥터는 **페이지 메타데이터**, **데이터베이스 스키마**, **워크스페이스 멤버십** 및 통합 구성을 읽어 Iru Compliance에서 지식 베이스 증거를 컨트롤에 매핑할 수 있도록 합니다. 인증에는 \*\*[My integrations](https://www.notion.com/my-integrations)\*\*에서 생성한 **Notion 내부 통합 토큰**(연결 시크릿이라고도 함)을 사용합니다.

### 작동 방식

Notion은 **`Authorization`** 헤더에 토큰을 받습니다.

```http theme={null}
Authorization: Bearer YOUR_INTEGRATION_TOKEN
```

내부 통합은 통합과 명시적으로 **공유**한 콘텐츠에만 액세스할 수 있습니다. 공유를 신중하게 계획하세요. 일반적으로 **상위 페이지**에 통합을 연결하여 하위 페이지가 액세스 권한을 상속하도록 합니다.

| 항목 | 값 |
| - | - |
| **범주** | 생산성 |
| **인증** | Bearer 토큰(내부 통합) |
| **워크스페이스 역할** | **워크스페이스 소유자**만 통합을 생성할 수 있음 |

문서: [Create integrations](https://www.notion.com/help/create-integrations-with-the-notion-api), [Authorization overview](https://developers.notion.com/docs/authorization), [API reference](https://developers.notion.com/reference).

### 사전 요구 사항

* **워크스페이스 소유자** 권한(통합 생성에 필요).
* 컴플라이언스 증거에 포함할 **페이지 또는 데이터베이스**의 명확한 목록.

### Notion을 Iru에 연결

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

    <Steps>
      <Step title="Notion에 로그인">
        Iru가 읽을 워크스페이스에 대한 **내부 통합**을 생성할 수 있는 사용자로 [notion.so](https://www.notion.so)에 로그인합니다.
      </Step>

      <Step title="My integrations 열기">
        \*\*[notion.com/my-integrations](https://www.notion.com/my-integrations)\*\*를 방문하거나, Notion 앱에서 **설정** → **Connections**를 열고 통합을 **만들기**하거나 관리하는 경로를 따릅니다.
      </Step>

      <Step title="통합 구성">
        새 통합을 생성합니다. 이름(예: **Iru Compliance**)을 지정하고, **올바른 워크스페이스**에 할당하고, 컨트롤에 필요한 기능을 활성화합니다. 최소한 **Read content**를 활성화하고, 멤버십 증거가 중요한 경우 **Read user information including email addresses**도 활성화합니다.
      </Step>

      <Step title="저장 및 내부 통합 시크릿 복사">
        통합을 **저장**한 다음 **internal integration secret**을 복사합니다. 비밀번호처럼 취급하세요. 통합을 교체하거나 삭제하지 않는 한 만료되지 않습니다.
      </Step>

      <Step title="통합과 콘텐츠 공유">
        각 최상위 페이지 또는 데이터베이스를 열고 → **`⋯`** → **Connections** → **Iru Compliance**를 선택합니다. 상위 페이지를 공유하면 중첩된 문서에 대한 중복 작업이 줄어듭니다.

        명시적으로 공유하지 않으면 사람이 페이지를 읽을 수 있더라도 통합에는 **아무것도** 표시되지 않습니다.
      </Step>
    </Steps>

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

  <Tab title="Iru Compliance">
    <Note>
      먼저 [**Notion**](#notion) 탭을 완료하세요.
    </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="Notion 켜기">
        **Notion**을 찾습니다(**범주** 또는 **이름 또는 설명으로 검색** 사용). 해당 카드에서 **토글**을 켭니다. 커넥터 마법사를 위한 브라우저 탭 또는 창이 열릴 수 있습니다.
      </Step>

      <Step title="통합 시크릿 붙여넣기">
        Bearer 토큰 단계에서 내부 통합 **시크릿**을 붙여넣습니다.
      </Step>

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

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

### 문제 해결

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

  <Accordion title="401 Unauthorized">
    시크릿을 다시 복사하고, 통합이 삭제되거나 교체되지 않았는지 확인하세요.
  </Accordion>

  <Accordion title="데이터베이스 누락">
    각 상위 페이지를 다시 열고 **Connections**에 통합이 나열되어 있는지 확인하세요.
  </Accordion>

  <Accordion title="메뉴에 통합이 없음">
    워크스페이스 소유자만 통합을 관리할 수 있습니다. 의도한 워크스페이스에서 통합을 생성했는지 확인하세요.
  </Accordion>
</AccordionGroup>

### 고려 사항

<CardGroup cols={2}>
  <Card title="일정에 따라 시크릿을 교체하고 Iru를 업데이트하세요…" icon="circle-info">
    일정에 따라 시크릿을 교체하고 그 직후 Iru를 업데이트하세요.
  </Card>

  <Card title="Iru는 토큰에 노출된 메타데이터를 읽습니다: …" icon="shield">
    Iru는 토큰에 노출된 메타데이터를 읽으며, 페이지나 초대를 몰래 편집하지 않습니다.
  </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>