У консолі адміністратора Okta, Звіти → Системний журнал дозволяє шукати події та завантажувати результати. Для JSON, використовуйте API системного журналу: GET /api/v1/logs з параметрами since і until, слідуючи за наступним посиланням, поки воно не вичерпається. Нижче наведено короткий скрипт. Okta зберігає події системного журналу протягом 90 днів.
Коли ідентичність є периметром, Системний журнал Okta — це журнал пропусків. Він записує кожну спробу входу, кожен пуш MFA, кожне скидання фактору та кожну зміну ролі адміністратора. Prime Core має 58 правил виявлення для даних Okta, відображені на 32 техніки MITRE ATT&CK. Серед них: розпилення паролів (T1110.003), втома від MFA (T1621) і втручання хакерів у реєстрацію MFA (T1556.006).
Перед тим, як почати
Час зберігання — 90 днів. Будь-яка інформація старша за цей період існує лише там, де ви транслювали або пересилали журнали Okta, наприклад, до SIEM.
Вам потрібен токен. API токен (Безпека → API → Токени) наслідує права адміністратора, який його створив. Адміністратор лише для читання достатній для журналів. Для автоматизації краще підходить OAuth додаток з обсягом okta.logs.read. У будь-якому випадку, токен — це облікові дані. Тримайте його подалі від історії shell і відкликайте, коли закінчите.
Діють обмеження на швидкість. Кінцева точка журналів має своє власне обмеження на швидкість. Великі вікна прийнятні, але не миттєві.
Експорт за допомогою API системного журналу
Цей Python-скрипт перегортає часові вікна та записує по одному запису на рядок. Потрібні 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 # наступне посилання вже містить запит
Завжди встановлюйте until. Без цього Okta сприймає запит як живе опитування і продовжує повертати наступне посилання. Ваш цикл працюватиме вічно, очікуючи на нові події.
Щоб звузити область, додайте фільтр до params, наприклад “filter”: ‘eventType eq “user.session.start”‘. Або використовуйте “q”: “jane” для пошуку за ключовими словами.
Що шукати
| eventType | Чому це важливо |
|---|---|
| user.session.start з outcome.result: FAILURE | Неуспішні спроби входу; багато користувачів з одного діапазону IP означає розпилення |
| user.mfa.okta_verify.deny_push | Користувач відхилив 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 Workforce Identity. Auth0 має свій власний формат журналів та API.