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でアップロード、消毒、レビュー
- アップロード。 開く logtotal.com で、.jsonlファイルをドロップします。
- 消毒。
- レビュー。
それがうまくいかないとき
| 症状 | 考えられる原因 | Fix |
|---|---|---|
| 401 | 間違ったまたは取り消されたトークン、またはSSWSプレフィックスの不足 | ヘッダーフォーマットを確認し、新しいトークンを作成します |
| 403 | トークン作成者にログを読む権限がない | ログアクセス権を持つ管理者からのトークンを使用してください |
| 429 | レート制限ヒット | X-Rate-Limit-Resetの時間を待ってから続行 |
| スクリプトが終了しない | クエリにuntilがない | untilを設定します |
| 90日以上前のものがない | Okta保持 | SIEMまたはログストリーミング先を確認します |
FAQ
管理コンソールを使うことはできませんか?
短いウィンドウの簡単な確認には、はい。分析したり保持したいものに対しては、APIがすべてのフィールドを含む完全なJSONを提供します。
これはAuth0をカバーしていますか?
いいえ。このガイドはOktaワークフォースアイデンティティに関するものです。Auth0には独自のログ形式とAPIがあります。