Comment exporter les journaux du système Okta

Comment exporter les journaux du système Okta

SOC Prime Team
SOC Prime Team linkedin icon Suivre

Dans la console d’administration Okta, Rapports → Journal Système vous permet de rechercher des événements et de télécharger les résultats. Pour JSON, utilisez l’API du Journal Système : GET /api/v1/logs avec since et until, en suivant le lien suivant jusqu’à ce qu’il s’épuise. Un court script est ci-dessous. Okta conserve les événements du Journal Système pendant 90 jours.

Quand l’identité est le périmètre, le Journal Système d’Okta est le journal de la porte. Il enregistre chaque connexion, chaque poussée MFA, chaque réinitialisation de facteur et chaque changement de rôle d’administrateur. Prime Core possède 58 règles de détection pour les données Okta, mappées à 32 techniques MITRE ATT&CK. Parmi elles : pulvérisation de mots de passe (T1110.003), fatigue MFA (T1621) et attaquants manipulant l’inscription MFA (T1556.006).

Commencez gratuitement

Avant de commencer

La rétention est de 90 jours. Tout ce qui est plus ancien existe uniquement là où vous avez diffusé ou transféré les journaux Okta, comme un SIEM.

Vous avez besoin d’un jeton. Un jeton API (Sécurité → API → Jetons) hérite des permissions de l’administrateur qui l’a créé. Un administrateur en lecture seule est suffisant pour les journaux. Pour tout ce qui est automatisé, une application de service OAuth avec le scope okta.logs.read est le choix le plus propre. Dans tous les cas, le jeton est une crédentialité. Gardez-le hors de l’historique du shell et révoquez-le une fois terminé.

Les limites de taux s’appliquent. Le point de terminaison des journaux a sa propre limite de taux. Les grandes fenêtres sont acceptées, mais pas instantanées.

Exporter avec l’API du Journal Système

Ce script Python parcourt une fenêtre temporelle et écrit un événement par ligne. Il nécessite 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

Toujours définir until. Sans cela, Okta considère la requête comme un sondage en direct et continue de renvoyer un lien suivant. Votre boucle s’exécuterait indéfiniment, en attendant de nouveaux événements.

Pour réduire le champ, ajoutez un filtre à params, par exemple « filter »: ‘eventType eq « user.session.start »‘. Ou utilisez « q »: « jane » pour une recherche par mot-clé.

À quoi faire attention

eventTypePourquoi c’est important
user.session.start avec outcome.result : FAILUREConnexions échouées ; beaucoup d’utilisateurs d’une même plage IP signifie pulvérisation
user.mfa.okta_verify.deny_pushUtilisateur a rejeté une poussée; une rafale de ceux-ci est une fatigue MFA en cours
user.mfa.factor.deactivate, user.mfa.factor.reset_allFacteurs supprimés, souvent juste après un appel d’ingénierie sociale à la hotline
user.account.privilege.grantRôle d’administrateur accordé
policy.rule.update, policy.lifecycle.updatePolitique de connexion ou MFA modifiée, possiblement affaiblie
system.api_token.createUn nouveau jeton API, un moyen discret de conserver l’accès

Les champs qui racontent l’histoire : actor.alternateId (qui), client.ipAddress et client.geographicalContext (d’où), outcome (ce qui s’est passé), et debugContext.debugData (les détails).

Télécharger, assainir et examiner dans LogTotal

  1. Télécharger. Ouvrir logtotal.com et déposer le fichier .jsonl.
  2. Assainir.
  3. Examiner.

Quand ça ne va pas

SymptômeCause probableFix
401Jeton incorrect ou révoqué, ou préfixe SSWS manquantVérifiez le format de l’en-tête ; créez un nouveau jeton
403Le créateur du jeton n’a pas le droit de lire les journauxUtilisez un jeton d’un administrateur ayant accès aux journaux
429Limite de taux atteinteAttendez le temps dans X-Rate-Limit-Reset, puis continuez
Le script ne se termine jamaisAucune until dans la requêteDéfinir until
Rien de plus ancien que 90 joursRétention d’OktaVérifiez votre SIEM ou la destination de streaming de journaux

FAQ

Ne puis-je pas juste utiliser la console d’administration ?

Pour un aperçu rapide d’une courte fenêtre, oui. Pour tout ce que vous souhaitez analyser ou conserver, l’API vous fournit un JSON complet avec chaque champ.

Cela couvre-t-il Auth0 ?

Non. Ce guide concerne Okta Workforce Identity. Auth0 a son propre format de journal et API.

Rejoignez la plateforme Detection as Code de SOC Prime pour améliorer la visibilité sur les menaces les plus pertinentes pour votre entreprise. Pour vous aider à démarrer et à générer une valeur immédiate, planifiez dès maintenant une réunion avec des experts de SOC Prime.