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

# JumpCloud

> x-api-key ヘッダーの Admin API キーとリージョンの API ホストを使用して JumpCloud を Iru Compliance に接続し、ユーザー、デバイス、ポリシーのエビデンスを収集します。

### JumpCloud について

Iru は次のヘッダーを使用して JumpCloud の HTTP API を呼び出します:

```http theme={null}
x-api-key: YOUR_API_KEY
```

キーが機能するには、**Billing Admin** が **API アクセスを有効にする** 必要があります。**データレジデンシー** に対応する **US** または **EU** の **console** / **insights** のベース URL を選択します。キーでは **任意の有効期限** を設定できます（ポリシーにより、新しいキーには最大 **365 日** が求められる場合があります）。

### 仕組み

JumpCloud は **`x-api-key`** ヘッダーで **Admin API キー** を受け付けます。キーは関連付けられた管理者の可視範囲を継承します。キーが機能するには、**Billing Admin** が **API アクセス** を有効にしておく必要があります。コネクタウィザードでは、組織の **データレジデンシー** に対応する **リージョンの API ホスト** を選択してから、キーを入力します。

| 項目 | 値 |
| - | - |
| **カテゴリ** | セキュリティ |
| **認証** | API キー（`x-api-key`） |

公式リファレンス: [Admin API キー](https://jumpcloud.com/support/manage-admin-accounts)、[ドキュメント](https://docs.jumpcloud.com/)、[Directory Insights](https://docs.jumpcloud.com/api/insights/directory/1.0/index.html)。

### 前提条件

* **管理者**（組織全体で API を有効にする場合は **Billing Admin**）。

### JumpCloud を Iru に接続する

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

    <Steps>
      <Step title="JumpCloud Admin にサインインする">
        [JumpCloud Admin Console](https://console.jumpcloud.com) を開き、**API キー** を作成できる管理者でサインインします（テナントで必要な場合は、組織で **API アクセス** が有効になっていることを確認します）。
      </Step>

      <Step title="アカウントメニューを開く">
        コンソールのヘッダーで **アカウント名** または **アバター** を選択して、アカウントメニューを開きます。
      </Step>

      <Step title="My API Key を開く">
        **My API Key**（JumpCloud の UI ラベルによっては **API Settings** → **API key**）を選択します。
      </Step>

      <Step title="新しいキーを生成する">
        **生成**（または **Generate new API key**）を選択します。JumpCloud から求められた場合は、ローテーションポリシーに合わせて **有効期限** を選択します。
      </Step>

      <Step title="キーを一度だけコピーする">
        JumpCloud に **Admin API キー** の値が表示されたら、**一度だけ** コピーします。ボールトに保管してください。[**Iru Compliance**](#iru-compliance) タブで Iru の **`x-api-key`** フィールドに貼り付けます。
      </Step>
    </Steps>

    <Note>
      [**Iru Compliance**](#iru-compliance) タブに進んでください。
    </Note>
  </Tab>

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

      <Step title="JumpCloud の API ホストを選択する">
        ウィザードに表示される選択肢から、プログラムに合った **サーバー** オプション（**US** と **EU**、**console** と **insights**）を選択します。
      </Step>

      <Step title="API キーを貼り付ける">
        求められたら、**`x-api-key`** の値を貼り付けます。
      </Step>

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

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

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

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

  <Accordion title="401 Unauthorized">
    キーの有効期限が切れているか、組織全体で API アクセスが無効になっています。
  </Accordion>

  <Accordion title="リージョンが間違っている">
    **US**/**EU** のホストを切り替えてください。
  </Accordion>
</AccordionGroup>

### 関連記事

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