Como Exportar Logs do Sistema Okta

Como Exportar Logs do Sistema Okta

SOC Prime Team
SOC Prime Team linkedin icon Seguir

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).

Comece Gratuitamente

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

eventTypePor que isso importa
user.session.start com outcome.result: FAILURELogins falhados; muitos usuários de uma mesma faixa de IP significa pulverização
user.mfa.okta_verify.deny_pushUsuário rejeitou um push; uma explosão desses é fadiga de MFA em andamento
user.mfa.factor.deactivate, user.mfa.factor.reset_allFatores removidos, frequentemente logo após uma chamada de engenharia social para o suporte
user.account.privilege.grantFunção de administrador concedida
policy.rule.update, policy.lifecycle.updatePolítica de login ou MFA alterada, possivelmente enfraquecida
system.api_token.createUm 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

  1. Envie. Abrir logtotal.com e solte o arquivo .jsonl.
  2. Sanitize.
  3. Revise.

Quando algo dá errado

SintomaCausa provávelFix
401Token errado ou revogado, ou um prefixo SSWS ausenteVerifique o formato do cabeçalho; crie um novo token
403Criador do token não tem direitos para ler logsUse um token de um administrador com acesso a logs
429Limite de taxa atingidoAguarde o tempo em X-Rate-Limit-Reset e, em seguida, continue
O script nunca terminaSem until na consultaDefina until
Nada com mais de 90 diasRetenção do OktaVerifique 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.

Junte-se à plataforma Detection as Code da SOC Prime para melhorar a visibilidade das ameaças mais relevantes para o seu negócio. Para ajudá-lo a começar e gerar valor imediato, agende uma reunião agora com os especialistas da SOC Prime.