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

# Okta Workflows 用に Iru テナントを承認する

> Okta Workflows 統合のために Iru Endpoint テナントを承認します。API トークンを生成し、コネクタを構成して、自動化されたデバイスワークフローを有効にします。

<Callout icon="list-check" color="#B84A7A" iconType="regular">このガイドは Mac コンピュータと Windows コンピュータに適用されます</Callout>

<Note>
  Okta Workflows では、コネクタは引き続き **Kandji** として表示されます。このガイドのうち、API トークンを作成してドメインをコピーする手順は **Iru Endpoint** で実行します。Okta Workflows で接続を構成する際は、**Kandji** を選択し、Iru Endpoint の API トークンとドメインを入力します。
</Note>

### Okta Workflows 用の Iru テナントの承認について

Okta Workflows 用に Iru Endpoint テナントを承認すると、Okta Workflows が **Kandji** コネクタを通じてテナントに接続できるようになり、ワークフローでデバイス管理タスクを自動化できます。

### 仕組み

Okta Workflows の **Kandji** コネクタは、API トークンとドメインを使用して Iru Endpoint テナントに接続します。接続を構成した後は、Iru Endpoint での手動の手順なしに、ユーザーのライフサイクルイベントやデバイス管理タスクに対応するワークフローを構築できます。

### 前提条件

開始する前に、次のものがあることを確認してください。

* Okta Workflows の管理者資格情報
* Iru Endpoint の管理者アクセス権
* Iru Endpoint テナントで API アクセスが有効になっていること

Okta Workflows 用に Iru Endpoint テナントを正常に承認した後、[Okta Workflows で Kandji コネクタのアクションカードを使用](/ja/endpoint/integrations/okta-workflows/use-kandji-connector-action-cards-with-okta-workflows)できます。

### Iru テナントを承認する

承認は 2 つの部分で構成されます。**Iru Endpoint** で API トークンを作成してドメインをコピーし、次にそれらの値を使用して **Okta Workflows** で **Kandji** コネクタを構成します。

ワークフローに初めて **Kandji** カードを追加すると、Okta Workflows から接続を構成するよう求められます。接続を保存して、今後のワークフローで再利用できます。

<Note>
  **Connections** ページから複数の接続を作成および管理できます。
</Note>

#### Iru Endpoint で API トークンを作成する

これらの手順は **Iru Endpoint** の Web アプリで実行します。

Okta Workflows の Kandji コネクタ用の API トークンを作成するには、次の手順を実行します。

<Steps>
  <Step title="Iru Endpoint にアクセスする">
    管理者の資格情報で Iru Endpoint の Web アプリにサインインします。
  </Step>

  <Step title="アクセスを開く">
    サイドバーで [**アカウントメニューボタン**](/ja/iru/platform-overview/account-menu) を選択し、**アクセス** を選択します。

    <Frame>
      <img src="https://mintcdn.com/iru/8BYPjuKZa-zyEEf_/assets/media/images/iru-nav-access.png?fit=max&auto=format&n=8BYPjuKZa-zyEEf_&q=85&s=466fdf5fb47efd6bab8b450a5a1e8302" alt="Access オプションが強調表示されたアカウントメニューのスクリーンショット" width="562" height="1040" data-path="assets/media/images/iru-nav-access.png" />
    </Frame>
  </Step>

  <Step title="トークンを追加する">
    **APIトークン** タブで **Add Token** を選択します。
  </Step>

  <Step title="トークン名を構成する">
    **名前** フィールドに、Okta Workflows などの名前を入力します。
  </Step>

  <Step title="トークンの説明を追加する">
    Description フィールドに、*Allow Okta Workflows to use the Iru Endpoint API* などの説明を入力します。
  </Step>

  <Step title="トークンを作成する">
    **作成** を選択します。
  </Step>

  <Step title="API トークンをコピーする">
    **Copy your API token** ダイアログで **Copy Token** を選択します。
  </Step>

  <Step title="トークンを安全に保管する">
    コピーしたトークンを安全な場所に保管します。トークンのテキストを紛失した場合は、使用する前に削除し、上記の手順で新しいトークンを作成できます。このトークンは次のセクションの手順 4 で使用します。
  </Step>

  <Step title="トークンのコピーを確認する">
    **トークンをコピーし、これらの詳細を再度表示できないことを理解しました**. のチェックボックスを選択します。
  </Step>

  <Step title="セットアップを続行する">
    Next を選択します。
  </Step>

  <Step title="権限を構成する">
    **Manage API Permissions** ダイアログで **構成** を選択します。
  </Step>

  <Step title="権限を選択する">
    Permissions セクションで、Okta Workflows にアクセスを許可する各領域のチェックボックスを選択します。たとえば、**Blueprints Management** のチェックボックスを選択すると、Blueprint の検査と変更に関するすべての権限が有効になります。注: 権限タイプの右側にある開閉用の三角形を選択すると、より詳細な権限が表示されます。
  </Step>

  <Step title="権限を確認する">
    API トークンに構成した権限を確認します。
  </Step>

  <Step title="構成を保存する">
    **保存** を選択し、**閉じる** を選択します。
  </Step>

  <Step title="トークンの作成を確認する">
    **APIトークン** タブで、新しいトークンが表示されていることを確認します。
  </Step>

  <Step title="API URL をコピーする">
    **Your organization's API URL is** フィールドで、Iru Endpoint のドメインをコピーするか、メモしておきます。

    <Frame>
      <img src="https://mintcdn.com/iru/97IKZnNVEzytYzut/assets/media/images/iru-okta-workflows-api-url.png?fit=max&auto=format&n=97IKZnNVEzytYzut&q=85&s=05f21971cae8156ca02cc0ab32a3e559" alt="Okta Workflows の接続のためにコピーする必要がある組織の API URL が表示された Iru Endpoint の API URL フィールド" width="1898" height="866" data-path="assets/media/images/iru-okta-workflows-api-url.png" />
    </Frame>
  </Step>
</Steps>

#### Okta Workflows で Kandji コネクタを設定する

これらの手順は **Okta Workflows** で実行します。前のセクションで取得した API トークンとドメインが必要です。

複数の接続を作成できます。たとえば、複数の Iru Endpoint テナントがある場合や、複数の API トークンをテストしている場合などです。API トークンには、少なくとも **Devices: Device Information: Device list** 権限が含まれている必要があります。使用する予定のワークフローアクションに応じて、追加の権限を付与してください。たとえば、すべてのデバイスを一覧表示するには、トークンに次の権限が必要です。

| 権限 | 説明 |
| - | - |
| **Devices: Device Information: Device list** | Iru Endpoint テナント内のすべてのデバイスの一覧を取得します |
| **Devices: Device Information: Device details** | 特定のデバイスの詳細情報をすべて取得します |

<Steps>
  <Step title="新しい接続を作成する">
    Okta Workflows で、Connections ページまたは任意のカードから **New Connection** を選択します。

    <Frame>
      <img src="https://mintcdn.com/iru/gptx2MM5S_bBcDGe/assets/media/images/iru-okta-workflows-new-connection.png?fit=max&auto=format&n=gptx2MM5S_bBcDGe&q=85&s=8660bcbc03e426c96c8324fe11b45111" alt="新しい接続を作成するために選択する必要がある New Connection ボタンが表示された Okta Workflows の Connections ページ" width="686" height="234" data-path="assets/media/images/iru-okta-workflows-new-connection.png" />
    </Frame>
  </Step>

  <Step title="Kandji コネクタを選択する">
    New Connection ウインドウで、必要に応じてスクロールし、**Kandji** を選択します。これは Okta Workflows でのコネクタ名で、Iru Endpoint テナントに接続します。

    <Frame>
      <img src="https://mintcdn.com/iru/gptx2MM5S_bBcDGe/assets/media/images/iru-okta-workflows-select-kandji-connector.png?fit=max&auto=format&n=gptx2MM5S_bBcDGe&q=85&s=efffbbe77501dc2b238574cb3a248e58" alt="利用可能なコネクタの一覧で Kandji が選択対象として強調表示された Okta Workflows の New Connection ウインドウ" width="651" height="725" data-path="assets/media/images/iru-okta-workflows-select-kandji-connector.png" />
    </Frame>
  </Step>

  <Step title="接続のニックネームを構成する">
    **Connection Nickname** フィールドに、複数の Iru Endpoint テナントや複数の Iru Endpoint API キーを区別するのに役立つ一意の名前を入力します。
  </Step>

  <Step title="API キーを入力する">
    **API key** フィールドに、前のセクションの手順 7 で生成した API トークンのテキストを入力または貼り付けます。
  </Step>

  <Step title="ドメインを入力する">
    **Kandji domain** フィールドに、前のセクションの手順 16 で取得した完全な Iru Endpoint ドメインを入力します。Okta Workflows ではこのフィールドのラベルが **Kandji domain** になっていますが、値は Iru Endpoint の API URL です (例: *accuhive.api.kandji.io* または *accuhive.api.eu.kandji.io*)。
  </Step>

  <Step title="接続を作成する">
    **作成** を選択します。

    <Frame>
      <img src="https://mintcdn.com/iru/gptx2MM5S_bBcDGe/assets/media/images/iru-okta-workflows-connection-credentials.jpg?fit=max&auto=format&n=gptx2MM5S_bBcDGe&q=85&s=a854c9253adb5fc41e84bf3e642dfff9" alt="Connection Nickname、API key、Iru Endpoint ドメインの各フィールドが入力され、Create ボタンを選択できる状態の Okta Workflows の接続構成フォーム" width="1084" height="1194" data-path="assets/media/images/iru-okta-workflows-connection-credentials.jpg" />
    </Frame>
  </Step>
</Steps>

これで **Kandji** コネクタが構成され、Iru Endpoint テナントに接続されました。利用可能なコネクタカードで使用できます。

#### ワークフローで接続を使用する

<Steps>
  <Step title="新しいフローを作成する">
    Workflows で Flows セクションに移動し、**+New Flow** を選択します。
  </Step>

  <Step title="アプリアクションを追加する">
    **Add app action** を選択します。
  </Step>

  <Step title="Kandji を選択する">
    **My Connected Apps** セクションで **Kandji** を選択します。Okta Workflows では引き続きこのアプリ名が表示されますが、Iru Endpoint テナントへのアクセスを提供します。

    <Frame>
      <img src="https://mintcdn.com/iru/gptx2MM5S_bBcDGe/assets/media/images/iru-okta-workflows-select-connected-app.png?fit=max&auto=format&n=gptx2MM5S_bBcDGe&q=85&s=8273f6867296d243a8f4c86dc45aaafb" alt="ワークフローアクションに選択できる接続済みアプリとして Iru Endpoint が表示された Okta Workflows の My Connected Apps セクション" width="684" height="470" data-path="assets/media/images/iru-okta-workflows-select-connected-app.png" />
    </Frame>
  </Step>

  <Step title="コネクタカードを選択する">
    コネクタカードを選択します。
  </Step>

  <Step title="構成して続行する">
    カードを構成し、ワークフローの構築を続けます。

    <Frame>
      <img src="https://mintcdn.com/iru/gptx2MM5S_bBcDGe/assets/media/images/iru-okta-workflows-select-action-card.png?fit=max&auto=format&n=gptx2MM5S_bBcDGe&q=85&s=b4b164f71f667efc1bebdc6654649c4a" alt="ワークフローに選択できる利用可能な Iru Endpoint アクションカードが表示された Okta Workflows のコネクタカード選択インターフェイス" width="1230" height="1248" data-path="assets/media/images/iru-okta-workflows-select-action-card.png" />
    </Frame>
  </Step>
</Steps>