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

# Contentful

> Content Management API の個人用アクセストークンを使用して Contentful を Iru Compliance に接続し、スペース、コンテンツモデル、環境、チームのメンバーシップを収集します。

### Contentful について

Iru は、**`Authorization: Bearer`** として送信される**個人用アクセストークン**（**PAT**）を使用して、**Content Management API (CMA)** 経由で**スペース**、**コンテンツモデル**、**環境**、**メンバーシップ**を読み取ります。**Content Delivery API (CDA)** のプレビュートークンは管理スコープを持たないため、使用**しないでください**。

### 仕組み

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

| 項目 | 値 |
| - | - |
| **カテゴリ** | 開発者ツール |
| **認証** | CMA 個人用アクセストークン |

公式の参考資料: [認証](https://www.contentful.com/developers/docs/references/authentication/)、[個人用アクセストークン](https://www.contentful.com/help/token-management/personal-access-tokens/)、[CMA リファレンス](https://www.contentful.com/developers/docs/references/content-management-api/)。

### 前提条件

* エビデンスに必要な**スペース**にアクセスできる Contentful ユーザー。

### Contentful を Iru に接続する

<Tabs>
  <Tab title="Contentful">
    <Note>
      Compliance でソースを接続する前に、このタブを完了してください。
    </Note>

    <Steps>
      <Step title="Contentful にサインインする">
        [Contentful Web アプリ](https://app.contentful.com)を開き、Iru に読み取らせる**スペース**にアクセスできるユーザーでサインインします。
      </Step>

      <Step title="設定を開く">
        トークンを所有する組織またはスペースの **設定**（UI に応じて歯車アイコンまたはワークスペースの設定）を選択します。
      </Step>

      <Step title="CMA トークンを開く">
        **CMA tokens**（Content Management API トークン）または同等の **Personal access tokens** 画面を選択します。
      </Step>

      <Step title="個人用アクセストークンを作成する">
        **Create personal access token**（または **トークンを生成**）を選択します。**Iru Compliance** などの名前を入力します。
      </Step>

      <Step title="有効期限を設定する（任意）">
        Contentful で**有効期限**を設定できる場合は、キーのローテーションポリシーに合わせた日付を設定します。セキュリティチームが無期限のトークンを許可している場合に限り、未設定のままにしてください。
      </Step>

      <Step title="トークンを生成してコピーする">
        トークンを生成し、値を**一度だけ**コピーします。安全に保管してください。Iru に **Bearer** トークンとして貼り付けます。
      </Step>
    </Steps>

    <Note>
      [**Iru Compliance**](#iru-compliance) タブに進みます。
    </Note>
  </Tab>

  <Tab title="Iru Compliance">
    <Note>
      先に [**Contentful**](#contentful) タブを完了してください。
    </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="Contentful をオンにする">
        **Contentful** を探します（**カテゴリ** または **名前または説明で検索** を使用します）。そのカードの**トグル**をオンにします。コネクタウィザード用のブラウザタブまたはウィンドウが開く場合があります。
      </Step>

      <Step title="個人用アクセストークンを貼り付ける">
        PAT を **Bearer** フィールドに貼り付けます。
      </Step>

      <Step title="接続を完了する">
        **Bearerトークンを送信** を選択します。接続に成功すると、ウィザードに **接続が構成されました** と表示されます。
      </Step>

      <Step title="ソースが有効であることを確認する">
        **Iru が外部サービスへのアクセスをリクエストしています** のブラウザタブを閉じてから **コンプライアンス** → **ソース** に戻り、**Contentful** カードが **有効** になっていることを確認します。
      </Step>
    </Steps>
  </Tab>
</Tabs>

### トラブルシューティング

<AccordionGroup>
  <Accordion title="ソースをオンにしても何も開かない">
    Iru サイトの**ポップアップブロッカー**の設定を確認してから、もう一度お試しください。
  </Accordion>

  <Accordion title="401 Unauthorized">
    CDA トークンではなく PAT を使用し、文字列を正確に貼り付けてください。
  </Accordion>

  <Accordion title="PAT の有効期限が切れている">
    **設定** → **CMA tokens** でローテーションし、Iru を更新してください。
  </Accordion>

  <Accordion title="スペースが表示されない">
    PAT はユーザーのメンバーシップを継承します。先にスペースへのアクセス権を付与してください。
  </Accordion>
</AccordionGroup>

### 考慮事項

<CardGroup cols={2}>
  <Card title="漏洩したトークンはすぐに取り消して再作成してください: PUT…" icon="circle-info">
    漏洩したトークンはすぐに取り消して再作成してください。自動化には、Contentful がドキュメント化している **PUT** の取り消しエンドポイントを使用できます。
  </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>