Skip to main content

Okta について

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

仕組み

Okta は SSWS スキームを使用して API トークンを受け付けます:
トークンは、作成した管理者の権限を継承します。未使用のトークンは 30 日後に失効します。API 呼び出しが成功すると、その期間がリセットされます。 Iru コネクタでは、テナントのサーバー URL(本番、EMEA、Gov、プレビュー、またはカスタムドメイン)を順に設定し、最後のステップで API トークン を入力します。ウィザードの前半のステップでは、製品が想定する OAuth 関連の URL を整合させます。このソースの Management API 呼び出しを認可するのは SSWS トークン認証 です。 ドキュメント: API トークンの作成、API トークンの管理、レート制限。

前提条件

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

Okta を Iru に接続する

Compliance でソースを接続する前に、このタブの手順を完了してください。
1

Okta Admin Console にサインインする

組織の管理者 URL(例: https://YOUR_SUBDOMAIN.okta.com/admin)を開き、API トークン を作成できるロール(組織が自動化アカウントに許可している内容に応じて、Super Admin、組織管理者、または Read-only Admin)でサインインします。
2

セキュリティを開く

左側のナビゲーションで セキュリティ を展開します(または管理画面の検索バーで API を検索します)。
3

API トークンの管理を開く

API → Tokens を選択して、既存のトークンの一覧と トークンを作成 を開きます。
4

新しいトークンを作成する

トークンを作成 を選択し、識別しやすい名前(例: Iru Compliance)を入力して作成を確定します。Okta にシークレットが一度だけ表示されます。
5

トークンをすぐにコピーする

ダイアログを閉じる前にトークンの値をコピーします。ページを離れると再度表示することはできません。Iru に貼り付けるまでボールトに保管してください。アイドル時の失効 に備えてください。30 日間 トークンを使用した API 呼び出しが成功しない場合、Okta はトークンを無効にするため、新しいトークンを作成する必要があります。
6

任意のネットワーク制限

環境で固定の送信元 IP を使用している場合は、Okta のドキュメントに従って、任意でトークンに ネットワークゾーン ポリシーを適用します。
Iru Compliance タブに進んでください。

トラブルシューティング

Iru サイトの ポップアップブロッカー の設定を確認して、もう一度お試しください。
トークン文字列、管理者アカウントが引き続き有効であること、およびトークンが取り消されていないことを確認してください。
30 日間アイドル状態だった場合は、セキュリティ → API → Tokens でトークンを再作成してください。
トークンに関連付けられた管理者プロファイルに、一部のエンドポイントへの読み取りアクセス権がない可能性があります。必要なエビデンスに対して、少なくとも Read-only Admin(または同等の権限)があることを確認してください。
切断してから再接続し、サブドメインとリージョン(US、EMEA、Gov、プレビュー)を再確認してください。

考慮事項

API トークンは認証情報として扱う

API トークンは認証情報として扱ってください。エビデンスの要件を満たす 最小限 の管理者ロールを持つ サービスアカウント を推奨します。

Okta は Management API のトラフィックにレート制限を適用…

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

Iru はトークンがアクセスできる API で公開されたデータを読み取り…

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

関連記事

Sources の管理

すべての Compliance ソースを参照、管理します。

Compliance を使い始める

フレームワーク、アクション、アーティファクト。

Iru の概要

Endpoint、Compliance、Identity がどのように連携するか。

Artifacts の管理

ソースやアクションから得たエビデンスをアップロード、確認、整理します。