Як експортувати системні журнали Okta

Як експортувати системні журнали Okta

SOC Prime Team
SOC Prime Team linkedin icon Стежити

У консолі адміністратора 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

  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 Workforce Identity. Auth0 має свій власний формат журналів та API.

Приєднуйтесь до платформи Detection as Code від SOC Prime щоб покращити видимість загроз, найбільш актуальних для вашого бізнесу. Щоб допомогти вам розпочати та отримати негайну цінність, забронюйте зустріч зараз з експертами SOC Prime.