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

# Iru Endpoint

> Iru Endpoint API を使用して Iru Endpoint を Iru Compliance に接続します。API リージョンを選択し、テナント URL を構成して、Bearer トークンで認証します。

### Iru Endpoint について

**Iru Endpoint** は、**Apple**、**Windows**、**Android** デバイスを管理します。Apple の対象には macOS、iOS、iPadOS、tvOS、visionOS が含まれます。Windows と Android で登録とポリシーを使用するには、テナントでそれらをオンにします。セットアップの順序と前提条件については、**[はじめに](/ja/endpoint/getting-started/getting-started)** を参照してください。

Endpoint には、ゼロタッチ展開、アプリと OS のパッチ管理、コンプライアンステンプレート、脅威検出、および自動化のための API が含まれます。このソースを **オン** にすると、Compliance はフレームワークのアクションが求める内容に基づいて、**デバイスの管理方法** と **ポリシーが展開内容とどのように一致しているか** に関する **アーティファクト** を収集できます。

### 収集される可能性のある内容

製品の構成に応じて、次のような例があります:

* デバイスの登録と管理の記録
* Compliance に公開される構成またはポリシーの適用シグナル
* エンドポイントのコンプライアンスまたはポスチャの概要
* コントロールに関連するインベントリと割り当てのコンテキスト

### 一般的なコントロールのテーマ

* エンドポイント管理と資産インベントリ
* デバイスのセキュリティ構成
* 管理対象エンドポイントの運用上の可視性

### Endpoint のドキュメント

**[はじめに](/ja/endpoint/getting-started/getting-started)** の手順（基盤のセットアップ、プラットフォームのセットアップ、**Blueprints と Library**、登録）に従って、デバイス、ポリシー、エージェントを構成します。Compliance の **アクション** を、セキュリティチームが想定する **アーティファクト**（例: 登録の証明、構成のエクスポート、レポート）にマッピングします。

### 前提条件

* セキュリティポリシーで許可されているすべての API 権限に対して **GET** / **読み取り** が有効になっている、**Iru Endpoint** の **Iru API** トークン。このコネクタは **Iru Endpoint** からの読み取りのみを行います。ポリシーでより広い **GET** アクセスが許可されている場合、**Iru Compliance** はより多くの **アーティファクト** を自動的に添付できます。

<Note>
  **Iru Compliance** で **Iru Endpoint** ソースを使用すると、API トークンは **アーティファクト** を収集するために **Iru Endpoint Management API** で使用され、それらのリクエストはテナントのレート制限にカウントされます。[Iru API Overview](/en/endpoint/api/iru-api-overview) の **[Considerations](/en/endpoint/api/iru-api-overview#considerations)** を参照してください（**Rate limits** を開きます）。
</Note>

### Iru Endpoint を Iru に接続する

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

    <Steps>
      <Step title="Iru Endpoint API のドキュメントを確認する">
        接続する前に、**[Iru API Overview](/en/endpoint/api/iru-api-overview)** を読み、Bearer 認証、トークンの作成方法、テナントの **Iru API URL** が表示される場所（US と EU）を確認します。
      </Step>

      <Step title="API URL の app セグメントを理解する">
        **`app`** の値は、その URL のベースドメインのセグメントです。`.api.kandji.io`、`.api.eu.kandji.io`、または `.api.iru.com` の直前にあるセグメントです。Compliance のコネクタウィザードでは、同じ **リージョン** と **`app`** を入力します。
      </Step>

      <Step title="API トークンを作成する">
        **Iru Endpoint** の Web アプリで、アカウントメニューから **アクセス** を開きます。**Add Token** を選択し、**名前** と **説明** を入力してトークンを作成し、**API トークン**（**アクセス** に一度だけ表示される Bearer 認証情報）を安全な場所にコピーします。Compliance のコネクタウィザードでは、同じ値を **Bearer JWT** というラベルの入力欄に貼り付けます。このテキストは Bearer トークンを入力する場所の **フィールドラベル** であり、[Iru API Overview](/en/endpoint/api/iru-api-overview) の API トークンとは別の種類の認証情報ではありません。
      </Step>

      <Step title="コンプライアンスウィザード用にテナントの API URL を確認する">
        **アクセス** で **APIトークン** タブを開き、**Your organization's API URL** を見つけます。Compliance ウィザード（**API リージョンを選択する** と **app 変数を構成する**）を実行する際に、そのホスト名を使用して **US と EU** の別と **`app`** セグメントを再確認します。
      </Step>

      <Step title="コンプライアンス用に GET 権限を構成する">
        新しいトークンの **構成** を開いて **アクセス許可** を設定します。セキュリティポリシーで許可されているすべての API 権限に対して **GET** をオンにします。このモデルでは、**GET** は **読み取り** と同等です。Compliance の収集は読み取り専用であるため、このコネクタには他の権限レベルは必要ありません。トークンの **GET** の対象範囲が広いほど、Iru はこのソースからより多くの **アーティファクト** を自動的に検出して添付できます。
      </Step>
    </Steps>

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

  <Tab title="Iru Compliance">
    <Note>
      ここでソースをオンにする前に、先に [**Iru Endpoint**](#iru-endpoint) タブの手順を完了し、**アクセス** の **API トークン**（ウィザードの **Bearer JWT** というラベルのフィールドに貼り付けます）、**`app`** セグメント、**US** または **EU** のホスト、**GET** 権限を用意してください。
    </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="Iru Endpoint を探す">
        **Iru Endpoint** を探します（**カテゴリ** を **セキュリティ** に設定するか、**名前または説明で検索** を使用します）。
      </Step>

      <Step title="Iru Endpoint をオンにする">
        そのカードで **トグル** をオンにします。**Iru が外部サービスへのアクセスをリクエストしています**（コネクタウィザード）の **新しいブラウザタブ** が開きます。

        <Frame>
          <img src="https://mintcdn.com/iru/dsAR-tBv0zPzzTFg/assets/media/images/iru-compliance-sources-enable-iru-endpoint.png?fit=max&auto=format&n=dsAR-tBv0zPzzTFg&q=85&s=eb5d883484e0e4b3b5ad11c4c0ca6336" alt="Iru Endpoint カードと有効化トグルが表示された Sources の一覧" width="2506" height="724" data-path="assets/media/images/iru-compliance-sources-enable-iru-endpoint.png" />
        </Frame>
      </Step>

      <Step title="API リージョンを選択する">
        **サーバーを選択**: テナントがホストされている場所に合わせて **Iru API URL (US)** または **Iru API URL (EU)** を選択し、**Confirm Server** を選択します。ここでの `{app}` は Iru API のベースドメインのセグメントです。

        <Frame>
          <img src="https://mintcdn.com/iru/dsAR-tBv0zPzzTFg/assets/media/images/iru-compliance-sources-select-api-url.png?fit=max&auto=format&n=dsAR-tBv0zPzzTFg&q=85&s=8748e2d6636aff7bd9f196dbf6c25111" alt="Iru API URL の US または EU サーバーを選択するコネクタウィザード" width="1096" height="1000" data-path="assets/media/images/iru-compliance-sources-select-api-url.png" />
        </Frame>
      </Step>

      <Step title="app 変数を構成する">
        **`app`** フィールドには、**Iru API URL** のサブドメイン（ホスト名の `.api.` より前の部分）のみを入力します。たとえば、API URL が `accuhive.api.kandji.io` の場合は `accuhive` と入力します。
      </Step>

      <Step title="サーバー変数を構成する">
        **Configure Server Variables** に進みます。

        <Frame>
          <img src="https://mintcdn.com/iru/dsAR-tBv0zPzzTFg/assets/media/images/iru-compliance-sources-app-domain.png?fit=max&auto=format&n=dsAR-tBv0zPzzTFg&q=85&s=76217980ca5dc2591997fb2bfc0f87e3" alt="app のプレビューが表示されたコネクタウィザードの Configure Server Variables" width="1098" height="1172" data-path="assets/media/images/iru-compliance-sources-app-domain.png" />
        </Frame>
      </Step>

      <Step title="Bearer トークンを入力する">
        **Enter Bearer Token** で、ウィザードに **Bearer JWT** というラベルの入力欄が表示されます。**アクセス** からコピーした **API トークン** をそこに貼り付けます。このフィールド名は Bearer トークンを入力する場所を示しています。値は、**Compliance 用に GET 権限を構成する** で **GET** / **読み取り** を有効にしたトークンと同じです。

        <Frame>
          <img src="https://mintcdn.com/iru/dsAR-tBv0zPzzTFg/assets/media/images/iru-compliance-sources-bearer-token.png?fit=max&auto=format&n=dsAR-tBv0zPzzTFg&q=85&s=4caf7b4d23e4ec1a2dcdd677dbac57ba" alt="コネクタウィザードの Enter Bearer Token と送信" width="1084" height="1050" data-path="assets/media/images/iru-compliance-sources-bearer-token.png" />
        </Frame>
      </Step>

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

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

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

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

  <Accordion title="401 Unauthorized、または Submit 後に接続が失敗する">
    トークンが完全であり、有効期限が切れておらず、**Iru Compliance** がこのソースに必要とする API 権限に対して **GET**（**読み取り**）アクセスが含まれていることを確認してください。**US と EU** のサーバーの選択と **`app`** の値（Iru API のベースドメイン）が **[Iru API Overview](/en/endpoint/api/iru-api-overview)** と一致していることを確認してください。
  </Accordion>

  <Accordion title="Artifacts が同期されない">
    **Iru Endpoint** の **アーティファクト** の表示が遅い場合や更新が停止した場合は、次の項目を確認してください:

    * **レート制限:** テナントが **Iru Endpoint API のレート制限** に達している可能性があります。**Iru Compliance** は、他のスクリプトや連携と同じ 1 時間あたりのクォータでトークンを使用するため、他の場所でリクエストが集中すると、使用量が下がるまでこのソースが待機状態になる場合があります。[Iru API Overview](/en/endpoint/api/iru-api-overview) の **[Considerations](/en/endpoint/api/iru-api-overview#considerations)** にある **Rate limits** を参照してください。

    * **権限:** トークンに、このソースが必要とするルートへの **GET** アクセスが不足している可能性があります。**Iru Endpoint** で **アクセス** を開いてトークンを選択し、**編集** で有効になっている内容をフレームワークのアクションが想定する内容と照らし合わせて確認してください。

    * **タイミング:** **アーティファクト** は、**Iru Compliance** がスケジュールに従ってこのソースを実行したときに更新されるため、新しい Endpoint のデータがすぐに表示されるとは限りません。レート制限と権限の問題をすでに除外している場合は、次の収集サイクルを待ってから **アーティファクト** ページを再度確認してください。
  </Accordion>
</AccordionGroup>

### 関連記事

<CardGroup cols={2}>
  <Card title="Iru API の概要" icon="key" href="/en/endpoint/api/iru-api-overview">
    Bearer トークン、テナントの **Iru API URL**、API 権限。
  </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="Sources の管理" icon="plug" href="/ja/compliance/sources-management">
    すべての Compliance ソースを参照、管理します。
  </Card>
</CardGroup>
