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

# PagerDuty

> 読み取り専用の REST API キーを使用して PagerDuty を Iru Compliance に接続し、インシデント、サービス、エスカレーションポリシー、オンコールのエビデンスを収集します。

### PagerDuty について

Iru は PagerDuty REST API を通じて、**インシデント**、**サービス**、**エスカレーションポリシー**、**スケジュール**、**チーム**、**監査**データを読み取ります。認証には PagerDuty 独自のヘッダー形式 (通常の Bearer ではありません) を使用します:

```http theme={null}
Authorization: Token token=YOUR_API_KEY
```

Iru がインシデントやサービスを変更できないように、**読み取り専用**スコープの **General Access** REST API キーを使用することをお勧めします。

### 仕組み

PagerDuty REST API キーは、PagerDuty 独自のヘッダー形式 **`Authorization: Token token=<API_KEY>`** で送信されます (これは一般的な **`Bearer`** トークンでは**ありません**)。

| 詳細 | 値 |
| - | - |
| **カテゴリ** | 開発者ツール |
| **認証** | REST API キー (`Authorization: Token token=…`) |

**General Access** キーは管理者が作成し、アカウント全体を対象にできます。**ユーザー** トークンはそのユーザーの表示範囲を継承します。意図的にスコープを制限する場合を除き、User トークンは使用しないでください。

公式リファレンス: [API access keys](https://support.pagerduty.com/main/docs/api-access-keys)、[REST API reference](https://developer.pagerduty.com/api-reference/)、[Rate limiting](https://developer.pagerduty.com/docs/rest-api-v2/rate-limiting/)。

### 前提条件

* **General Access** API キーを作成するための **管理者** または **アカウント所有者** (または同等) の権限。

### PagerDuty を Iru に接続する

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

    <Steps>
      <Step title="PagerDuty にサインインする">
        [PagerDuty](https://www.pagerduty.com) を開き、**API Access Keys** を作成できる **管理者** または **アカウント所有者** (または同等) でサインインします。
      </Step>

      <Step title="インテグレーションを開く">
        製品のナビゲーションから **インテグレーション** を開きます (PagerDuty のエディションによっては **Automation** または **Developer** の下にあります)。
      </Step>

      <Step title="Developer Tools を開く">
        **Developer Tools** (または **API Access**) を選択し、**API Access Keys** を見つけます。
      </Step>

      <Step title="新しい API キーを作成する">
        **Create new API key** (表記は **New key** の場合もあります) を選択します。組織のポリシーで許可されている場合は、Iru の読み取りが特定の個人ユーザーの表示範囲に依存しないように、**General Access** キーを使用することをお勧めします。
      </Step>

      <Step title="キーに名前を付けて Read-only に設定する">
        **Iru Compliance** などの名前を入力します。キーの種類を **Read-only** (または PagerDuty が REST エビデンス収集用に提供する最小権限の読み取りオプション) に設定します。
      </Step>

      <Step title="キーを作成してコピーする">
        作成を完了し、PagerDuty にキーの値が表示されたら**一度だけ**コピーします。ダイアログを閉じると、再度表示されることはありません。
      </Step>
    </Steps>

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

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

      <Step title="API キーを貼り付ける">
        ウィザードに表示されるフィールドに**未加工の API キー**を貼り付けます。製品側で `Authorization: Token token=YOUR_API_KEY` の形式に整形されます。`Token token=` を自分で先頭に付けないで**ください**。
      </Step>

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

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

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

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

  <Accordion title="401 Unauthorized">
    キー全体がスペースなしで入力されていること、およびキーが無効化されていないことを確認してください。
  </Accordion>

  <Accordion title="403 Forbidden">
    **ユーザー** トークンから、十分なスコープを持つ **General Access** キーに切り替えてください。
  </Accordion>

  <Accordion title="サービスやスケジュールが表示されない">
    ユーザースコープのトークンは、そのユーザーのチームしか参照できません。**General Access** を使用してください。
  </Accordion>
</AccordionGroup>

### 考慮事項

<CardGroup cols={2}>
  <Card title="API キーは自動的に期限切れになりません: 定期的にローテーションしてください。" icon="circle-info">
    API キーは自動的に期限切れになりません。定期的にローテーションしてください。
  </Card>

  <Card title="大規模なバックフィルは PagerDuty のレート制限内で行われます。…" icon="shield">
    大規模なバックフィルは PagerDuty の**レート制限**内で行われるため、同期に時間がかかる場合があります。
  </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>