Oktaシステムログをエクスポートする方法

Oktaシステムログをエクスポートする方法

SOC Prime Team
SOC Prime Team linkedin icon フォローする

Okta管理コンソールで、 レポート → システムログ によってイベントを検索し、結果をダウンロードできます。JSONの場合、システムログAPIを使用します: GET /api/v1/logs with since and until、次のリンクに従い、それがなくなるまで続けます。以下に短いスクリプトがあります。Oktaはシステムログイベントを90日間保持します。

アイデンティティが境界である場合、Oktaのシステムログはゲートログです。それはすべてのサインイン、すべてのMFAプッシュ、すべてのファクターリセット、そしてすべての管理者役割の変更を記録します。プライムコアには、32のMITRE ATT&CK技術にマッピングされたOktaデータ用の58の検出ルールがあります。その中には、パスワードスプレー(T1110.003)、MFA疲労(T1621)、MFA登録の改ざん(T1556.006)があります。

無料で始める

始める前に

保持期間は90日です。 それより古いものは、SIEMなど、Oktaログをストリーミングまたは転送している場所にのみ存在します。

トークンが必要です。 APIトークン(セキュリティ → API → トークン)は、それを作成した管理者の権限を引き継ぎます。ログには読み取り専用の管理者で十分です。自動化されたものには、okta.logs.readスコープを持つOAuthサービスアプリがよりクリーンな選択です。どちらの場合も、トークンは資格情報です。それをシェル履歴から除外し、終了したら取り消してください。

レート制限が適用されます。 ログエンドポイントには独自のレート制限があります。大きなウィンドウは大丈夫ですが、即座ではありません。

システムログAPIを使用してエクスポート

このPythonスクリプトは、タイムウィンドウをページングし、1行あたり1つのイベントを書き込みます。requestsを必要とします(pip install requests):

import json, os, requests



org = "https://yourorg.okta.com"

headers = {"Authorization": f"SSWS {os.environ['OKTA_TOKEN']}", "Accept": "application/json"}

url = f"{org}/api/v1/logs"

params = {"since": "2026-10-19T00:00:00Z", "until": "2026-10-20T00:00:00Z", "limit": 1000}



with open("okta_1019.jsonl", "w") as out:

    while url:

        r = requests.get(url, headers=headers, params=params, timeout=60)

        r.raise_for_status()

        events = r.json()

        for e in events:

            out.write(json.dumps(e) + "n")

        if not events:

            break

        url = r.links.get("next", {}).get("url")

        params = None  # the next link already carries the query

常に設定 until. それがないと、Oktaはリクエストをライブポールとして扱い、次のリンクを手渡し続けます。ループは新しいイベントを待ちながら永遠に続くでしょう。

絞り込むには、paramsにフィルタを追加します。例えば、”filter”: ‘eventType eq “user.session.start”‘とするか、または”q”: “jane”を使ったキーワード検索です。

何を探すか

eventTypeそれが重要な理由
user.session.start with outcome.result: FAILUREログイン失敗;1つのIP範囲から多くのユーザーがいる場合、スプレーです
user.mfa.okta_verify.deny_pushユーザーがプッシュを拒否;これが急増するのはMFA疲労の進行中であることを示します
user.mfa.factor.deactivate, user.mfa.factor.reset_allファクターが削除されることが多く、その後すぐにヘルプデスク詐欺電話が発生します
user.account.privilege.grant管理者役割が付与されました
policy.rule.update, policy.lifecycle.updateサインオンまたはMFAポリシーが変更され、弱体化する可能性があります
system.api_token.create新しいAPIトークン、アクセスを維持する静かな方法です

物語を語るフィールド: actor.alternateId (誰が), client.ipAddress and client.geographicalContext (どこから), outcome (何が起きた), および debugContext.debugData (詳細)。

LogTotalでアップロード、消毒、レビュー

  1. アップロード。 開く logtotal.com で、.jsonlファイルをドロップします。
  2. 消毒。
  3. レビュー。

それがうまくいかないとき

症状考えられる原因Fix
401間違ったまたは取り消されたトークン、またはSSWSプレフィックスの不足ヘッダーフォーマットを確認し、新しいトークンを作成します
403トークン作成者にログを読む権限がないログアクセス権を持つ管理者からのトークンを使用してください
429レート制限ヒットX-Rate-Limit-Resetの時間を待ってから続行
スクリプトが終了しないクエリにuntilがないuntilを設定します
90日以上前のものがないOkta保持SIEMまたはログストリーミング先を確認します

FAQ

管理コンソールを使うことはできませんか?

短いウィンドウの簡単な確認には、はい。分析したり保持したいものに対しては、APIがすべてのフィールドを含む完全なJSONを提供します。

これはAuth0をカバーしていますか?

いいえ。このガイドはOktaワークフォースアイデンティティに関するものです。Auth0には独自のログ形式とAPIがあります。

SOC PrimeのDetection as Codeプラットフォームに参加し ビジネスに最も関連性のある脅威に対する可視性を向上させましょう。開始して即座に価値をもたらすためには、今すぐSOC Primeの専門家とのミーティングを予約してください。