Okta 관리 콘솔에서, 보고서 → 시스템 로그 이벤트를 검색하고 결과를 다운로드할 수 있습니다. JSON의 경우, 시스템 로그 API를 사용하세요: GET /api/v1/logs를 사용하여 since와 until을 설정하고, 다음 링크가 소진될 때까지 따르세요. 아래에 짧은 스크립트가 있습니다. Okta는 시스템 로그 이벤트를 90일 동안 보관합니다.
신원이 경계선일 때, Okta의 시스템 로그는 게이트 로그입니다. 모든 로그인, 모든 MFA 푸시, 모든 요소 재설정 및 모든 관리자 역할 변경을 기록합니다. Prime Core는 Okta 데이터를 위한 58개의 탐지 규칙과 32개의 MITRE ATT&CK 기술에 매핑되었습니다. 그 중에서는 비밀번호 스프레이(T1110.003), MFA 피로(T1621) 및 공격자가 MFA 등록을 건드리는 것(T1556.006)이 포함됩니다.
시작하기 전에
보존 기간은 90일입니다. 그 이상은 SIEM처럼 Okta 로그를 스트리밍하거나 전송한 곳에서만 존재합니다.
토큰이 필요합니다. API 토큰 (보안 → API → 토큰) 생성한 관리자의 권한을 상속합니다. 로그에 대해서는 읽기 전용 관리자만으로 충분합니다. 모든 자동화된 작업은 okta.logs.read 범위를 갖춘 OAuth 서비스 앱이 더 깔끔한 선택입니다. 어쨌든 토큰은 자격 증명입니다. 셸 기록에서 이를 제외하고 사용이 끝나면 해제하십시오.
속도 제한이 적용됩니다. 로그 엔드포인트에는 자체적으로 속도 제한이 있습니다. 큰 창은 괜찮지만 즉시는 불가능합니다.
시스템 로그 API로 내보내기
이 Python 스크립트는 시간 창을 페이지하여 한 줄마다 하나의 이벤트를 작성합니다. 요청이 필요합니다 (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 # 다음 링크에는 이미 쿼리가 포함되어 있습니다.
항상 설정하기 until. 이 없으면, Okta는 요청을 실시간 폴링으로 취급하고 계속해서 다음 링크를 제공합니다. 루프는 새로운 이벤트를 기다리며 영원히 실행될 것입니다.
이를 좁히기 위해, params에 필터를 추가하세요. 예를 들어 “filter”: ‘eventType eq “user.session.start”‘. 또는 “q”: “jane”을 키워드 검색에 사용하세요.
찾아야 할 것
| eventType | 왜 중요합니까 |
|---|---|
| user.session.start with outcome.result: FAILURE | 실패한 로그인; 하나의 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와 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 워크포스 ID에 관한 것입니다. Auth0는 자체 로그 형식과 API를 가지고 있습니다.