No Console de Administração do Okta, Relatórios → Log do Sistema permite que você pesquise eventos e baixe os resultados. Para JSON, use a API do Log do Sistema: GET /api/v1/logs com since e until, seguindo o próximo link até que termine. Um script curto está abaixo. O Okta mantém eventos de Log do Sistema por 90 dias.
Quando a identidade é o perímetro, o Log do Sistema do Okta é o registro do portão. Registra cada login, cada empurrão de MFA, cada redefinição de fator e cada mudança de função de administrador. O Prime Core tem 58 regras de detecção para dados do Okta, mapeadas para 32 técnicas MITRE ATT&CK. Entre elas: pulverização de senha (T1110.003), fadiga de MFA (T1621) e invasores mexendo com o cadastro de MFA (T1556.006).
Antes de começar
A retenção é de 90 dias. Qualquer coisa mais antiga existe apenas onde você tem transmitido ou encaminhado logs do Okta, como em um SIEM.
Você precisa de um token. Um token da API (Segurança → API → Tokens) herda as permissões do administrador que o criou. Um administrador somente leitura é suficiente para logs. Para qualquer coisa automatizada, um aplicativo de serviço OAuth com o escopo okta.logs.read é a escolha mais limpa. De qualquer forma, o token é uma credencial. Mantenha-o fora do histórico do shell e revogue-o quando terminar.
Aplicam-se limites de taxa. O endpoint dos logs tem seu próprio limite de taxa. Grandes janelas estão bem, mas não instantaneamente.
Exporte com a API do Log do Sistema
Este script Python percorre uma janela de tempo e grava um evento por linha. Ele precisa de 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 # o próximo link já carrega a consulta
Sempre defina until. Sem isso, o Okta trata a solicitação como uma pesquisa ao vivo e continua fornecendo um próximo link. Seu loop funcionaria para sempre, aguardando novos eventos.
Para restringir, adicione um filtro aos parâmetros, por exemplo “filter”: ‘eventType eq “user.session.start”‘. Ou use “q”: “jane” para uma busca por palavra-chave.
O que procurar
| eventType | Por que isso importa |
|---|---|
| user.session.start com outcome.result: FAILURE | Logins falhados; muitos usuários de uma mesma faixa de IP significa pulverização |
| user.mfa.okta_verify.deny_push | Usuário rejeitou um push; uma explosão desses é fadiga de MFA em andamento |
| user.mfa.factor.deactivate, user.mfa.factor.reset_all | Fatores removidos, frequentemente logo após uma chamada de engenharia social para o suporte |
| user.account.privilege.grant | Função de administrador concedida |
| policy.rule.update, policy.lifecycle.update | Política de login ou MFA alterada, possivelmente enfraquecida |
| system.api_token.create | Um novo token de API, uma maneira silenciosa de manter o acesso |
Os campos que contam a história: actor.alternateId (quem), client.ipAddress e client.geographicalContext (de onde), outcome (o que aconteceu) e debugContext.debugData (os detalhes).
Envie, sanitize e revise no LogTotal
- Envie. Abrir logtotal.com e solte o arquivo .jsonl.
- Sanitize.
- Revise.
Quando algo dá errado
| Sintoma | Causa provável | Fix |
|---|---|---|
| 401 | Token errado ou revogado, ou um prefixo SSWS ausente | Verifique o formato do cabeçalho; crie um novo token |
| 403 | Criador do token não tem direitos para ler logs | Use um token de um administrador com acesso a logs |
| 429 | Limite de taxa atingido | Aguarde o tempo em X-Rate-Limit-Reset e, em seguida, continue |
| O script nunca termina | Sem until na consulta | Defina until |
| Nada com mais de 90 dias | Retenção do Okta | Verifique seu SIEM ou destino de transmissão de logs |
FAQ
Posso usar apenas o Console de Administração?
Para uma rápida visão de uma janela curta, sim. Para qualquer coisa que você queira analisar ou guardar, a API fornece JSON completo com todos os campos.
Isso cobre o Auth0?
Não. Este guia é sobre o Okta Workforce Identity. O Auth0 tem seu próprio formato de log e API.