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

> API トークンを使用して Okta を Iru Compliance に接続し、ディレクトリのユーザーとグループ、アプリケーションの割り当て、MFA ポリシー、System Log の監査エビデンスを収集します。

### Okta について

**Okta** コネクタは、Okta 組織からディレクトリデータ、グループメンバーシップ、アプリケーションの割り当て、ポリシー、MFA の状態、監査関連のシグナルを読み取り、Iru Compliance にアーティファクトとして表示します。認証には、**Okta Management API** 経由で **Okta API トークン** を使用します。この連携は **読み取り専用** のエビデンス収集を目的としています。Iru は、API の読み取り中にトークンの管理者権限で許可される範囲を超えて、Okta でユーザーをプロビジョニングしたりポリシーを変更したりすることはありません。

### 仕組み

Okta は **SSWS** スキームを使用して API トークンを受け付けます:

```http theme={null}
Authorization: SSWS YOUR_API_TOKEN
```

トークンは、作成した管理者の権限を継承します。**未使用のトークンは 30 日後に失効します**。API 呼び出しが成功すると、その期間がリセットされます。

Iru コネクタでは、テナントのサーバー URL（本番、EMEA、Gov、プレビュー、またはカスタムドメイン）を順に設定し、最後のステップで **API トークン** を入力します。ウィザードの前半のステップでは、製品が想定する OAuth 関連の URL を整合させます。このソースの Management API 呼び出しを認可するのは **SSWS トークン認証** です。

| 項目 | 値 |
| - | - |
| **カテゴリ** | セキュリティ |
| **認証** | Okta API トークン（`Authorization: SSWS YOUR_TOKEN`） |
| **Okta プラン** | 必要な Management API アクセスを含む任意のプラン |

ドキュメント: [API トークンの作成](https://developer.okta.com/docs/guides/create-an-api-token/main/)、[API トークンの管理](https://help.okta.com/en-us/content/topics/security/api.htm)、[レート制限](https://developer.okta.com/docs/reference/rate-limits/)。

### 前提条件

* **API トークンを作成** できる Okta 管理者ロール（組織が自動化アカウントに許可している内容に応じて、**Super Admin**、**組織管理者**、または **Read-only Admin**）。
* 組織の **サブドメイン** または完全な **Okta ドメイン**（例: ユーザーが `https://acme.okta.com` でサインインする場合は `acme`）。

### Okta を Iru に接続する

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

    <Steps>
      <Step title="Okta Admin Console にサインインする">
        組織の管理者 URL（例: `https://YOUR_SUBDOMAIN.okta.com/admin`）を開き、**API トークン** を作成できるロール（組織が自動化アカウントに許可している内容に応じて、**Super Admin**、**組織管理者**、または **Read-only Admin**）でサインインします。
      </Step>

      <Step title="セキュリティを開く">
        左側のナビゲーションで **セキュリティ** を展開します（または管理画面の検索バーで **API** を検索します）。
      </Step>

      <Step title="API トークンの管理を開く">
        **API** → **Tokens** を選択して、既存のトークンの一覧と **トークンを作成** を開きます。
      </Step>

      <Step title="新しいトークンを作成する">
        **トークンを作成** を選択し、識別しやすい名前（例: **Iru Compliance**）を入力して作成を確定します。Okta にシークレットが一度だけ表示されます。
      </Step>

      <Step title="トークンをすぐにコピーする">
        ダイアログを閉じる前にトークンの値をコピーします。ページを離れると再度表示することはできません。Iru に貼り付けるまでボールトに保管してください。

        **アイドル時の失効** に備えてください。**30 日間** トークンを使用した API 呼び出しが成功しない場合、Okta はトークンを無効にするため、新しいトークンを作成する必要があります。
      </Step>

      <Step title="任意のネットワーク制限">
        環境で固定の送信元 IP を使用している場合は、Okta のドキュメントに従って、任意でトークンに **ネットワークゾーン** ポリシーを適用します。
      </Step>
    </Steps>

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

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

      <Step title="テナントに対応するサーバー URL を選択する">
        組織の所在地に対応する行を選択します:

        | 環境 | ベース URL のパターン |
        | - | - |
        | 本番（US） | `https://YOUR_SUBDOMAIN.okta.com` |
        | EMEA | `https://YOUR_SUBDOMAIN.okta-emea.com` |
        | プレビュー / サンドボックス | `https://YOUR_SUBDOMAIN.oktapreview.com` |
        | US Gov | `https://YOUR_SUBDOMAIN.okta-gov.com` |
        | カスタムドメイン | `https://YOUR_OKTA_DOMAIN` |

        ウィザードが正しい Management API のベース URL を構築できるよう、選択を確定します。
      </Step>

      <Step title="サブドメインとドメインの変数を入力する">
        ウィザードの各画面に従います。OAuth 関連の URL がテナントと一致するよう、求められた箇所で **サブドメイン** またはドメインの値を入力します。

        <Note>
          ウィザードの途中で OAuth の URL について言及するステップがあるのは、コネクタテンプレートがエンドポイントを完全に構成するためです。このソースで Iru が Management API の読み取りに使用するのは、最後のステップの **SSWS トークン認証** です。
        </Note>
      </Step>

      <Step title="API トークンを貼り付ける">
        認証情報のステップで、認可フィールドに **API トークン** を貼り付けます。
      </Step>

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

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

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

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

  <Accordion title="401 Unauthorized">
    トークン文字列、管理者アカウントが引き続き有効であること、およびトークンが取り消されていないことを確認してください。
  </Accordion>

  <Accordion title="トークンの有効期限切れ">
    30 日間アイドル状態だった場合は、**セキュリティ** → **API** → **Tokens** でトークンを再作成してください。
  </Accordion>

  <Accordion title="403 Forbidden">
    トークンに関連付けられた管理者プロファイルに、一部のエンドポイントへの読み取りアクセス権がない可能性があります。必要なエビデンスに対して、少なくとも **Read-only Admin**（または同等の権限）があることを確認してください。
  </Accordion>

  <Accordion title="ホスト / ドメインが間違っている">
    切断してから再接続し、サブドメインとリージョン（US、EMEA、Gov、プレビュー）を再確認してください。
  </Accordion>
</AccordionGroup>

### 考慮事項

<CardGroup cols={2}>
  <Card title="API トークンは認証情報として扱う" icon="circle-info">
    API トークンは認証情報として扱ってください。エビデンスの要件を満たす **最小限** の管理者ロールを持つ **サービスアカウント** を推奨します。
  </Card>

  <Card title="Okta は Management API のトラフィックにレート制限を適用…" icon="shield">
    Okta は Management API のトラフィックに **レート制限** を適用します。大規模な組織では、初回の収集時に同期に時間がかかる場合があります。
  </Card>

  <Card title="Iru はトークンがアクセスできる API で公開されたデータを読み取り…" icon="server">
    Iru は、トークンがアクセスできる API で公開されたデータを読み取ります。付与していない Okta の権限を上書きすることはできません。
  </Card>
</CardGroup>

### 関連記事

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