> ## 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 トークン（内部インテグレーション） |
| **ワークスペースのロール** | インテグレーションを作成できるのは **ワークスペースオーナー** のみ |

ドキュメント: [インテグレーションの作成](https://www.notion.com/help/create-integrations-with-the-notion-api)、[認可の概要](https://developers.notion.com/docs/authorization)、[API リファレンス](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="保存して内部インテグレーションシークレットをコピーする">
        インテグレーションを **保存** し、**内部インテグレーションシークレット** をコピーします。パスワードと同様に扱ってください。ローテーションするかインテグレーションを削除しない限り、失効しません。
      </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="/ja/compliance/sources-management">
    すべての Compliance ソースを参照、管理します。
  </Card>

  <Card title="Compliance を使い始める" icon="rocket" href="/ja/compliance/getting-started-with-compliance">
    フレームワーク、アクション、**アーティファクト**。
  </Card>

  <Card title="Iru の概要" icon="layer-group" href="/ja/iru/platform-overview/iru-overview">
    Endpoint、Compliance、Identity がどのように連携するか。
  </Card>

  <Card title="Artifacts の管理" icon="folder-open" href="/ja/compliance/artifacts-management">
    ソースやアクションから得たエビデンスをアップロード、確認、整理します。
  </Card>
</CardGroup>
