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).
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
| eventType | Pourquoi c’est important |
|---|---|
| user.session.start avec outcome.result : FAILURE | Connexions échouées ; beaucoup d’utilisateurs d’une même plage IP signifie pulvérisation |
| user.mfa.okta_verify.deny_push | Utilisateur a rejeté une poussée; une rafale de ceux-ci est une fatigue MFA en cours |
| user.mfa.factor.deactivate, user.mfa.factor.reset_all | Facteurs supprimés, souvent juste après un appel d’ingénierie sociale à la hotline |
| user.account.privilege.grant | Rôle d’administrateur accordé |
| policy.rule.update, policy.lifecycle.update | Politique de connexion ou MFA modifiée, possiblement affaiblie |
| system.api_token.create | Un 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
- Télécharger. Ouvrir logtotal.com et déposer le fichier .jsonl.
- Assainir.
- Examiner.
Quand ça ne va pas
| Symptôme | Cause probable | Fix |
|---|---|---|
| 401 | Jeton incorrect ou révoqué, ou préfixe SSWS manquant | Vérifiez le format de l’en-tête ; créez un nouveau jeton |
| 403 | Le créateur du jeton n’a pas le droit de lire les journaux | Utilisez un jeton d’un administrateur ayant accès aux journaux |
| 429 | Limite de taux atteinte | Attendez le temps dans X-Rate-Limit-Reset, puis continuez |
| Le script ne se termine jamais | Aucune until dans la requête | Définir until |
| Rien de plus ancien que 90 jours | Rétention d’Okta | Vé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.