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

# Postman

> API キーを使用して Postman を Iru Compliance に接続し、ワークスペースのインベントリ、コレクションのメタデータ、チームメンバーシップ、監査ログのエビデンスを収集します。

### Postman について

Postman は、**`X-API-Key`** で認証される API を通じてチームとワークスペースのデータを公開しています。Iru は、プランで許可されている範囲で、**ワークスペース**、**コレクション**、**API 定義**、**メンバーシップ**、**監査**ログを読み取ります。

### 仕組み

```http theme={null}
X-API-Key: YOUR_API_KEY
```

| 詳細 | 値 |
| - | - |
| **カテゴリ** | 開発者ツール |
| **認証** | API キー (`X-API-Key`) |

キーは作成者のワークスペースアクセス権を継承します。影響範囲をより狭くしたい場合は、**専用**ユーザーを使用してください。

公式リファレンス: [Managing APIキー](https://learning.postman.com/docs/administration/managing-your-team/managing-api-keys)、API の対象範囲については Postman の**パブリック**ワークスペースのドキュメント。

### 前提条件

* **API キーを生成する**権限 (組織のポリシーによって制限されている場合があります)。

### Postman を Iru に接続する

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

    <Steps>
      <Step title="Postman にサインインする">
        [postman.com](https://www.postman.com) を開き、Iru が認証に使用する**チーム**アカウントまたは**個人**アカウントの **APIキー** を管理できるユーザーでサインインします。
      </Step>

      <Step title="アバターメニューを開く">
        右上の **Avatar** を選択して、アカウントメニューを開きます。
      </Step>

      <Step title="Account Settings を開く">
        **Account Settings** (レイアウトによっては **設定** → **アカウント**) を選択します。
      </Step>

      <Step title="APIキー を開く">
        **APIキー** を選択して、既存のキーと新しいキーを生成するためのコントロールを表示します。
      </Step>

      <Step title="新しい API キーを生成する">
        **Generate API Key** を選択します。名前を付け (例: **Iru Compliance**)、組織で必要な場合は**有効期限**を設定します。
      </Step>

      <Step title="キーを一度だけコピーする">
        Postman にキーの値が表示されたらコピーします。Postman はパブリックリポジトリで見つかったキーを**自動的に取り消す**場合があるため、**Iru Compliance** に貼り付けるまでシークレットマネージャーに保管してください。
      </Step>
    </Steps>

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

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

      <Step title="API キーを貼り付ける">
        キーを **`X-API-Key`** フィールドに貼り付けます。
      </Step>

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

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

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

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

  <Accordion title="401 Unauthorized">
    キー全体が入力されていること、および有効期限切れや取り消しになっていないことを確認してください。
  </Accordion>

  <Accordion title="作成がブロックされる">
    組織の管理者が、ユーザーのロールに対して API キーを許可する必要があります。
  </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>
