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

# Sentry

> 認証トークンと正しいリージョンの API ホストを使用して Sentry を Iru Compliance に接続し、プロジェクト、Issue、リリース、組織の監査ログを収集します。

### Sentry について

Iru は **Sentry 組織**から**プロジェクト**、**Issue/イベント**、**チーム**、**リリース**、**監査**データを読み取ります。デプロイメントに一致する **API ホスト** (**sentry.io**、**US**、**EU**、またはセルフホスト) を選択してください。認証には **Bearer** トークン (**個人**認証トークンまたは**組織**トークン) を使用します。

### 仕組み

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

| 詳細 | 値 |
| - | - |
| **カテゴリ** | モニタリング |
| **認証** | Bearer トークン (個人または組織の認証トークン) |
| **監査ログ** | 通常は **Business** または **Team**。完全な監査アクセスには **所有者** または **Manager** が必要 |

**組織レベルのトークン** (組織設定 → Auth Tokens) はユーザーの入れ替わりの影響を受けません。**個人**トークンは、ユーザーが組織を離れると機能しなくなります。

公式リファレンス: [Auth tokens](https://docs.sentry.io/account/auth-tokens/)、[Create a token](https://docs.sentry.io/api/guides/create-auth-token/)、[API](https://docs.sentry.io/api/)。

### 前提条件

* コンプライアンスに必要な Sentry **組織**へのアクセス権。
* 監査ログのエビデンスが必要な場合は **所有者** または **Manager** 権限。

### Sentry を Iru に接続する

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

    <Steps>
      <Step title="Sentry にサインインする">
        対象**組織**の**認証トークン**を作成できるユーザーで、**sentry.io** (またはセルフホストの Sentry URL) にサインインします。
      </Step>

      <Step title="個人トークンと組織トークンのどちらを使用するか選択する">
        Iru で**個人**トークン (ユーザーに紐づく) と**組織**トークン (ユーザーの入れ替わりの影響を受けない) のどちらを使用するかを決定します。多くの構成では、組織トークンには **所有者** または **Manager** 権限が必要です。
      </Step>

      <Step title="Personal Tokens を開く (個人トークンの場合)">
        個人トークンを選択した場合: **設定** → **Personal Tokens** (例: `https://sentry.io/settings/account/api/auth-tokens/`)。
      </Step>

      <Step title="Organization Auth Tokens を開く (組織トークンの場合)">
        組織トークンを選択した場合: **組織設定** → **Auth Tokens** を開きます (表記は **Developer settings** → **Auth tokens** の場合もあります)。
      </Step>

      <Step title="トークンを作成して読み取りスコープを設定する">
        トークンを作成して名前を付け (例: **Iru Compliance**)、コントロールに必要な読み取りスコープを有効にします。一般的には **org:read**、**project:read**、**team:read**、**event:read** です (プランとロールで許可されている場合は、監査関連のスコープも追加します)。
      </Step>

      <Step title="トークンを一度だけコピーする">
        Sentry にトークンの値が表示されたらコピーします。トークンは**一度だけ**表示されます。
      </Step>
    </Steps>

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

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

      <Step title="Sentry API ホストを選択する">
        アカウントに一致する**サーバー**を選択します:

        * **`https://sentry.io`**: デフォルトの SaaS。
        * **`https://YOUR_REGION.sentry.io`**: データレジデンシー (例: **`us`** または **`de`**)。

        認証情報を入力する前に、サーバーを確認してください。
      </Step>

      <Step title="Bearer トークンを貼り付ける">
        プロンプトが表示されたら、**Bearer トークン**を貼り付けます。
      </Step>

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

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

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

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

  <Accordion title="401 Unauthorized">
    トークンが完全にコピーされていること、および取り消されていないことを確認してください。
  </Accordion>

  <Accordion title="監査データがない">
    プランが監査ログをサポートしていること、およびロールが **所有者**/**Manager** であることを確認してください。
  </Accordion>

  <Accordion title="リージョンが間違っている">
    EU の組織は EU ホストを使用する必要があります。US エンドポイントへの呼び出しは失敗します。
  </Accordion>

  <Accordion title="個人トークンが機能しなくなった">
    ユーザーが組織を離れています。**組織**トークンに切り替えるか、アクティブなユーザーでトークンを作成し直してください。
  </Accordion>
</AccordionGroup>

### 関連記事

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