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

# Segment

> Public API アクセストークンを使用して Segment を Iru Compliance に接続し、ワークスペース、ソース、デスティネーション、トラッキングプランのエビデンスを収集します。

### Segment について

このコネクタは **Segment Public API** を基盤としています。Iru は、**ワークスペース設定**、**ソースとデスティネーション**、**トラッキングプラン**、**メンバーシップ**のメタデータを読み取ります。これにより、顧客データが Segment をどのように流れているかを証明するのに十分な情報が得られます。このインテグレーションは Iru 側では**読み取り専用**であり、イベントの送信やワークスペース構成の変更は行いません。

Segment で Public API トークンを作成できるのは **Workspace Owner** のみです。

### 仕組み

Iru は **Bearer** トークン (Segment の **Public API アクセストークン**) で認証します:

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

| 詳細 | 値 |
| - | - |
| **カテゴリ** | アナリティクス |
| **認証** | Bearer トークン (Public API アクセストークン) |
| **トークンの作成に必要なロール** | Workspace Owner |

公式リファレンス: [Segment Public API](https://segment.com/docs/api/public-api/)、[API reference](https://docs.segmentapis.com/)、[Access Management](https://segment.com/docs/segment-app/iam/)。

### 前提条件

* コンプライアンスに必要な Segment ワークスペースの **Workspace Owner** 権限。
* トークンを作成して Iru に貼り付けるための数分間の作業時間。

### Segment を Iru に接続する

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

    <Steps>
      <Step title="Segment にサインインする">
        [Segment](https://segment.com) を開き、**ワークスペース**トークンを管理できるユーザーでサインインします。
      </Step>

      <Step title="設定を開く">
        Segment アプリの画面から **設定** (歯車アイコン) を選択します。
      </Step>

      <Step title="Workspace Settings を開く">
        Iru が読み取るワークスペースの **Workspace Settings** を選択します。
      </Step>

      <Step title="Access Management を開く">
        **Access Management** (または **Members & access**) を選択し、**Tokens** を開きます。
      </Step>

      <Step title="トークンを作成する">
        **トークンを作成** (または **New token**) を選択します。**Iru Compliance** などの名前を入力します。
      </Step>

      <Step title="トークンのロールを選択する">
        最小権限の原則に沿ったロールを選択します:

        * **Workspace Owner**: 広範な API アクセス。監査のためにワークスペース全体を可視化する必要がある場合に使用します。
        * **Workspace Member**: より限定的です。プログラムで重要なリソースが含まれない場合があります。
      </Step>

      <Step title="トークンをコピーして安全に保管する">
        トークンを作成し、**すぐにコピー**します。Segment はトークンを**一度だけ**表示します。**Iru Compliance** に貼り付けるまで、パスワードと同様に扱ってください。

        Segment は、パブリックリポジトリで検出されたトークンを**自動的に取り消す**場合があり、その際はオーナーに通知されます。
      </Step>
    </Steps>

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

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

      <Step title="Public API トークンを貼り付ける">
        ウィザードでトークンを求められたら、**Public API アクセストークン**を貼り付けて送信します。
      </Step>

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

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

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

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

  <Accordion title="401 Unauthorized">
    トークンを正確にコピーし、削除または自動的に取り消されていないことを確認してください。
  </Accordion>

  <Accordion title="ソースやデスティネーションが表示されない">
    権限が限定された Member トークンではなく、**Workspace Owner** トークンを使用することをお勧めします。
  </Accordion>

  <Accordion title="ワークスペースが間違っている">
    トークンは**ワークスペーススコープ**です。Iru で接続したワークスペースでトークンを作成してください。
  </Accordion>
</AccordionGroup>

### 考慮事項

<CardGroup cols={2}>
  <Card title="トークンはデフォルトでは期限切れになりません: 定期的に…" icon="circle-info">
    トークンはデフォルトでは期限切れになりません。定期的にローテーションし、ローテーション後に Iru を更新してください。
  </Card>

  <Card title="複数のワークスペースには個別の Iru 接続が必要です…" icon="shield">
    複数のワークスペースには、**個別の** Iru 接続とトークンが必要です。
  </Card>
</CardGroup>

### 関連記事

<CardGroup cols={2}>
  <Card title="ソース管理" 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="アーティファクト管理" icon="folder-open" href="/ja/compliance/artifacts-management">
    ソースとアクションから得たエビデンスをアップロード、確認、整理します。
  </Card>
</CardGroup>