Okta について
Okta コネクタは、Okta 組織からディレクトリデータ、グループメンバーシップ、アプリケーションの割り当て、ポリシー、MFA の状態、監査関連のシグナルを読み取り、Iru Compliance にアーティファクトとして表示します。認証には、Okta Management API 経由で Okta API トークン を使用します。この連携は 読み取り専用 のエビデンス収集を目的としています。Iru は、API の読み取り中にトークンの管理者権限で許可される範囲を超えて、Okta でユーザーをプロビジョニングしたりポリシーを変更したりすることはありません。仕組み
Okta は SSWS スキームを使用して API トークンを受け付けます:
ドキュメント: API トークンの作成、API トークンの管理、レート制限。
前提条件
- API トークンを作成 できる Okta 管理者ロール(組織が自動化アカウントに許可している内容に応じて、Super Admin、組織管理者、または Read-only Admin)。
- 組織の サブドメイン または完全な Okta ドメイン(例: ユーザーが
https://acme.okta.comでサインインする場合はacme)。
Okta を Iru に接続する
- Okta
- Iru Compliance
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 でトークンを再作成してください。
403 Forbidden
403 Forbidden
トークンに関連付けられた管理者プロファイルに、一部のエンドポイントへの読み取りアクセス権がない可能性があります。必要なエビデンスに対して、少なくとも 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 の管理
ソースやアクションから得たエビデンスをアップロード、確認、整理します。
