Skip to Content

Registos de auditoria

O registo de auditoria inviolável: o que é registado, como pesquisar e exportar, e como verificar uma exportação selada.

O registo de auditoria é o registo permanente da plataforma de todas as ações significativas. Cada entrada regista o que aconteceu, quem o desencadeou, quem ou o que foi afetado e quando, juntamente com o endereço IP de origem, a localização aproximada e o user agent. As entradas são apenas acrescentadas, nunca editadas nem eliminadas manualmente, e cada entrada selada é encadeada e assinada criptograficamente, para que um terceiro possa comprovar que um registo exportado não foi adulterado.

O registo encontra-se na Admin Console em Registo de auditoria → Registos.

O que é registado

O registo abrange toda a amplitude da atividade da plataforma. Em termos gerais, as entradas enquadram-se nestas áreas:

  • Autenticação: inícios de sessão bem-sucedidos e falhados, trocas de tokens de single sign-on, inícios de sessão federados (sociais/empresariais), autenticação silenciosa, step-up e reautenticação, fim de sessão e fim de sessão back-channel.
  • Autenticação multifator: registo de fatores, verificações bem-sucedidas e falhadas, utilização de códigos de recuperação, remoção de fatores e reposições de MFA iniciadas por um administrador.
  • Ciclo de vida do utilizador: criação de contas, convites, alterações de perfil, alterações de e-mail/telefone/nome de utilizador/palavra-passe, ativação/desativação/desbloqueio de contas e eliminação. Consulte Ciclo de vida do utilizador.
  • Autorização: acesso a aplicações concedido e revogado, alterações de funções e de membros de grupos, concessões de administrador de organização e revisões de acesso.
  • Administração e configuração: alterações a aplicações, diretórios, ligações, zonas de rede, workflows de aprovação, workflows de certificação, APIs e chaves de API, organizações e definições do sistema.
  • Incidentes de segurança: tentativas com palavras-passe comprometidas, deteção de força bruta, acesso a partir de uma região proibida, início de sessão a partir de um novo dispositivo e violações de limites de taxa.
  • Eventos de dispositivos: registo e remoção, comandos enviados ou colocados em fila para um dispositivo e transições online/offline do connector.
  • Eventos de sessão: sessões terminadas pelo sistema, com o registo da duração total da sessão concluída.
  • Aprovisionamento: operações de aprovisionamento SCIM de saída e respetivos resultados.
  • Aprovações: criação e eventos do ciclo de vida de workflows de aprovação, bem como campanhas de certificação de acesso e decisões de revisão.
  • Personificação (impersonation): quando um administrador começa e deixa de agir em nome de outro utilizador ou organização.

A lista completa e detalhada, com gravidades, encontra-se em Tipos de eventos de auditoria.

O modelo de ator: quem fez o quê a quem

Cada entrada distingue o titular (quem ou o que é objeto do evento) do ator (quem o desencadeou). É isto que permite responder à pergunta "o que aconteceu ao utilizador X?" pesquisando pelo titular, vendo ainda assim quem agiu.

  • Nas ações de self-service (um utilizador que altera a sua própria palavra-passe ou inicia sessão), o titular e o ator são a mesma pessoa.
  • Nas ações de administrador sobre utilizador (um administrador que atribui uma função a alguém ou desativa uma conta), o titular é o utilizador afetado e o administrador que agiu é registado ao lado.
  • Nas alterações de sistema ou de objetos (criar uma aplicação, editar uma política), o administrador que agiu é o utilizador da entrada e o objeto alterado é indicado na entrada.
  • Nas ações executadas por máquinas através da API, o ator é registado como cliente (máquina) e não como pessoa, juntamente com o canal através do qual chegou (Admin Console, API, aprovisionamento, connector ou sistema).

A vista de detalhe de cada entrada mostra o objeto afetado, os campos alterados quando aplicável, o IP/localização/user agent e o contexto completo do evento.

Pesquisar e filtrar

O registo abre com as entradas mais recentes e carrega as mais antigas à medida que se desloca na página. A barra de ferramentas acima da lista é a mesma das listas de utilizadores e de dispositivos:

  • Regras de filtro: adicione uma regra por campo e combine-as: Tipo de evento (um ou mais tipos do catálogo), Categoria e Gravidade (grupos inteiros de tipos de uma só vez), Carimbo de data/hora (um intervalo de/até com hora, no seu próprio fuso horário; deixe um dos lados em branco para um intervalo aberto), País e Cidade (a partir da geolocalização da entrada), Endereço IP, E-mail do utilizador, Nome de utilizador, Aplicação e Diretório (seleção a partir da lista), Organização e Descrição. As regras de texto oferecem contém, é igual a, começa com e as respetivas negações; as regras de lista oferecem é um de / não é nenhum de.
  • Pesquisa de texto livre: compara com a descrição, o endereço IP, o nome/nome de utilizador/e-mail do utilizador titular ou o nome da aplicação. Prima Enter para aplicar.
  • Colunas: mostre ou oculte colunas e arraste-as para as ordenar. Além das colunas predefinidas de carimbo de data/hora, evento, aplicação e utilizador, estão disponíveis endereço IP, localização, gravidade, categoria, diretório e organização.
  • Vistas: as vistas padrão à esquerda são filtros predefinidos: Ataques (força bruta, bloqueios, palavras-passe comprometidas, região proibida, localização invulgar), Inícios de sessão falhados, Segurança e deteção de anomalias, Configuração e administração do sistema e Erros. Guarde a sua própria combinação de regras e colunas como vista com nome, ou copie o URL: todos os filtros ficam na barra de endereço.
  • Exportar CSV: transfere a lista filtrada pela ordem visível das colunas (menu de partilha), das mais recentes para as mais antigas e limitada a 50 000 entradas; a caixa de diálogo indica quando a vista contém mais, pelo que deve restringir o filtro para abranger tudo.

A lista funciona também em tempo real: ative o Modo em tempo real e as novas entradas surgem automaticamente à medida que acontecem, e o gráfico de atividade é atualizado, sem necessidade de recarregar a página. Isto é útil enquanto reproduz um problema ou acompanha o desenrolar de um incidente. O gráfico e o feed em tempo real seguem o filtro ativo.

Abra qualquer entrada para ver o respetivo painel de detalhe completo, incluindo o contexto bruto do evento.

Alguns exemplos práticos de combinação de filtros:

  • Todos os inícios de sessão falhados a partir de um IP num intervalo: escolha a vista Inícios de sessão falhados e adicione uma regra Carimbo de data/hora com o intervalo e uma regra Endereço IP.
  • Tudo a partir de um país: adicione uma regra País (por exemplo, depois de o mapa de ataques do painel de proteção mostrar uma origem inesperada); adicione Carimbo de data/hora para restringir ao dia em causa.
  • Todos os eventos de MFA de um utilizador: adicione uma regra Tipo de evento com os eventos multifator e uma regra E-mail do utilizador.
  • Todas as alterações de configuração feitas por um administrador: escolha a vista Configuração e administração do sistema e pesquise o nome do administrador.
  • Tudo o que aconteceu a um dispositivo: abra o separador Histórico do dispositivo. Lista as entradas relativas a esse dispositivo (comandos, execuções de atualização, aprovação, utilizadores associados, violações de políticas), com pesquisa própria e filtros de tipo e de data; a lista de tipos mostra apenas os tipos que ocorrem no dispositivo. Abrange as entradas escritas desde a introdução do separador e é apresentado aos administradores que podem ler todo o registo de auditoria.

Nota: Os segredos de utilização única transmitidos em links (tokens de reposição de palavra-passe, códigos de verificação de e-mail) são automaticamente ocultados das entradas do registo, pelo que nunca são guardados no registo de auditoria.

Selagem inviolável

Além de só permitir acrescentar entradas, o registo de auditoria é selado para que qualquer adulteração possa ser detetada posteriormente:

  1. Cadeia de hashes. Cada entrada selada recebe um número de sequência e um hash calculado sobre o conteúdo da entrada e o hash da entrada anterior (um HMAC cuja chave é um segredo específico da implementação). Como cada hash incorpora o anterior, alterar, remover ou reordenar qualquer entrada quebra a cadeia a partir desse ponto.
  2. Assinatura criptográfica. Cada entrada selada é adicionalmente assinada com uma chave Ed25519. A chave pública de verificação correspondente é publicada, pelo que qualquer pessoa que a possua pode verificar uma assinatura sem acesso à plataforma.

A selagem decorre em segundo plano e nunca bloqueia nem descarta uma escrita no registo.

Não precisa de exportar para detetar um problema: assim que uma entrada é selada, a respetiva vista de detalhe mostra os metadados de selagem da entrada (número de sequência, hash, hash anterior) juntamente com um indicador de validade do hash. Um visto verde significa que o hash recalculado da entrada continua a corresponder; uma verificação falhada é assinalada diretamente na consola, pelo que um elo quebrado da cadeia fica visível no próprio local e não apenas no momento da exportação.

O que isto comprova e o que não comprova. A selagem permite-lhe a si (ou a um auditor externo) pegar num lote exportado de entradas de registo e comprovar mais tarde que não foi alterado, reordenado ou truncado após a exportação, e que foi assinado por esta plataforma. Foi concebida para exportar registos para outros locais e comprovar a integridade mais tarde. Não constitui uma garantia de não repúdio perante o operador da plataforma.

Verificar um registo exportado

Para verificar de forma independente uma exportação do registo:

  1. Exporte as entradas. Obtenha as entradas do registo (através da API de registos da plataforma, que inclui os metadados de selagem, ou seja, número de sequência, hash anterior, hash e assinatura, juntamente com o conteúdo de cada entrada).

  2. Obtenha a chave pública de verificação. A plataforma publica a chave pública Ed25519 utilizada para assinar as entradas; obtenha-a uma vez e guarde-a.

  3. Verifique. A verificação percorre as entradas exportadas por ordem de sequência e executa três verificações em camadas:

    • uma pré-análise estrutural que confirma que os números de sequência são contíguos e que o hash anterior registado de cada entrada corresponde à entrada que a precede (não requer qualquer segredo);
    • um recálculo do hash que volta a derivar o hash de cadeia de cada entrada a partir do seu conteúdo e o compara com o valor guardado;
    • uma verificação da assinatura que verifica a assinatura Ed25519 de cada entrada com a chave pública publicada.

    Se as entradas tiverem sido alteradas, reordenadas ou se o final tiver sido cortado, uma destas verificações falha e indica exatamente onde.

A Admin Console apresenta a chave pública publicada e o topo atual da cadeia, para que possa confirmar uma exportação face ao registo ativo.

Histórico de alterações por objeto

Separadamente do registo de auditoria central, alguns registos mantêm o seu próprio histórico de alterações com versões: um antes/depois ao nível dos campos que mostra como esse objeto evoluiu. Na página de detalhe de um utilizador, abra Ver histórico para ver cada versão com os campos adicionados, removidos ou alterados (valor antigo para valor novo) e quando.

Utilize-o quando a sua pergunta for "como chegou este registo ao seu estado atual?": lê-se como uma cronologia de diferenças limpa para esse objeto. Utilize o registo de auditoria central quando a sua pergunta for "quem fez o quê, em tudo, neste intervalo?". Os dois complementam-se: o registo de auditoria é o registo transversal; o histórico de alterações é a história de cada objeto.

Retenção

O tempo durante o qual as entradas são conservadas depende do seu nível de subscrição:

NívelRetenção do registo de auditoria
Trial7 dias
Essential30 dias
Advanced90 dias
Proaté 365 dias

As entradas mais antigas são removidas automaticamente quando ultrapassam o período de retenção. Se precisar de conservar registos durante mais tempo do que o seu nível permite, exporte-os periodicamente: os lotes exportados e selados permanecem verificáveis indefinidamente. A matriz completa encontra-se em Planos e add-ons.

Exportação

As entradas podem ser exportadas através da API de registos da plataforma, para arquivo, ingestão num sistema a jusante ou verificação independente. A exportação inclui o conteúdo de cada entrada e os respetivos metadados de selagem, o que torna possível uma verificação de integridade posterior.

A exportação é feita a pedido: obtém as entradas quando precisa delas. Não existe um destino de streaming em tempo real: a plataforma não envia um feed contínuo para um coletor de registos externo. Se conservar registos num sistema externo, agende uma exportação periódica e exporte sempre antes de as entradas saírem do período de retenção do seu nível (consulte Retenção acima): uma vez removidas, deixam de constar do registo ativo, embora qualquer lote selado que já tenha exportado continue verificável.

Relacionado

Nesta página