Logs de auditoria

Quem pode fazer isso: Admins da empresa
Quais planos: Plano Enterprise
Quais plataformas: Navegador

Os logs de auditoria permitem que admins da organização com as permissões relevantes acompanhem a atividade dos usuários na organização da Miro. Os logs são extremamente úteis ao investigar um problema ou ao obter um relatório detalhado de eventos importantes (por exemplo, alterações nas configurações de segurança globais, convites de novos usuários ou criação de novos boards).

✏️ Atualmente, os eventos são registrados desde a criação da assinatura Enterprise e são armazenados por 180 dias por padrão:
a) Se você atualizar para o plano Enterprise a partir de outro plano, os eventos serão registrados a partir do momento da atualização.
b) Se você migrar alguns times para a assinatura Enterprise, os dados desses times serão registrados somente quando passarem a fazer parte da assinatura.

Acessar logs de auditoria

Para acessar os logs de auditoria, siga estas etapas:

1. Vá para Configurações da empresa.
2. No painel à esquerda, clique em Segurança > Logs de auditoria.
3. Você pode filtrar os logs de auditoria escolhendo um Intervalo de datas, um ou mais Atores (incluindo aplicativos e agentes de IA agindo em nome de um usuário), uma ou mais Categorias de evento, um ou mais Eventos específicos e um ou mais Objetos afetados.

Clique no botão Visualizar eventos para pré-visualizar os eventos que correspondem aos seus critérios de filtro. O horário é exibido no formato ISO 8601, no fuso horário local. Você pode ver os detalhes de um evento específico clicando nos três pontos na coluna Detalhes.

✏️ Você pode pré-visualizar eventos até o limite do período de retenção dos logs de auditoria da sua organização (no máximo 365 dias).

Exportar logs de auditoria

Você pode exportar logs de auditoria no formato de arquivo CSV.

No arquivo de exportação CSV, a data e a hora do evento são fornecidas no formato ISO 8601, no fuso horário UTC. Não há limite para o número de registros exportados de uma só vez; no entanto, quanto mais dados você exportar, mais tempo levará para preparar o arquivo para ser baixado. Além disso, lembre-se de que aplicativos populares para trabalhar com planilhas têm limites quanto ao volume de dados que conseguem abrir. O arquivo exportado reflete quaisquer filtros que você aplicou, incluindo Objeto afetado.

Para exportar os logs, clique no botão Exportar para CSV.

A barra com os detalhes do seu arquivo de exportação aparecerá abaixo. Quando o arquivo estiver pronto para ser baixado, você poderá clicar no botão Baixar CSV. O arquivo ficará disponível para ser baixado por 24 horas.

✏️ Atualmente, apenas um arquivo de exportação está disponível para baixar por organização de cada vez. Clicar no botão Export to CSV substituirá o arquivo de exportação atual.

Acessar logs de auditoria via API

Administradores podem usar a Audit Log API ou as integrações SIEM compatíveis para acessar e coletar programaticamente os dados do log de auditoria.

A API suporta os mesmos filtros que a UI: Actor, Event category, Event e Affected object, cada um aceitando múltiplos valores. Você pode recuperar todo o histórico dos logs de auditoria da sua organização via API.

Descontinuação do Audit Logs API v1

O Audit Logs API v1 foi descontinuado. Se você tem uma integração personalizada construída sobre o v1 (GET /v1/audit/logs), migre-a para o v2 (GET /v2/audit/logs). A autenticação e os parâmetros do intervalo de tempo permanecem inalterados, porém paginação, formato da resposta e alguns nomes de campo são diferentes; consulte a referência da API para obter detalhes. Se você usa um aplicativo fornecido pela Miro ou um conector do Marketplace (por exemplo, o aplicativo da Miro para Splunk ou Microsoft Sentinel), atualize-o para a versão mais recente, que já oferece suporte ao v2.

Principais mudanças na resposta do v2:

• A paginação é baseada em cursor (um valor de cursor opaco) em vez de offset; não há contagem total de registros.
• createdBy.id é retornado como string (anteriormente como número).
• Cada evento inclui um campo category no nível superior.
• Os IDs de evento são strings UUID (anteriormente com sufixo numérico); trate-os como valores opacos.
• createdAt reflete quando o evento foi armazenado, em vez do momento exato em que a ação ocorreu (normalmente com atraso de alguns segundos).
• Os campos details usam camelCase (por exemplo, organizationId), valores numéricos grandes são serializados como strings, timestamps usam ISO 8601 e chaves com valores nulos são omitidas.
• Para ações realizadas por um aplicativo, integração ou agente de IA em nome de um usuário, o objeto actor inclui um campo onBehalfOf identificando esse usuário.
• O nome do actor para visitantes desconectados agora é "Visitante" (anteriormente "Convidado").
• Eventos relacionados a board referenciam a boardKey pública em vez de um ID numérico interno.
• Tipos e categorias de eventos que faziam referência a "project" agora usam "Espaço" (por exemplo, project_created agora é space_created); isso se aplica retroativamente a eventos históricos recuperados via v2.

Excluir logs de auditoria

Administradores podem definir uma política de retenção para logs de auditoria. Você pode escolher entre 30, 90, 180 ou 365 dias.

⚠️ Uma vez excluídos, os logs de auditoria não podem ser recuperados.

✏️ A retenção indefinida para os logs de auditoria tornou-se obsoleta.

Para definir um período de exclusão, faça o seguinte:

1. Vá para Configurações da empresa.
2. No painel à esquerda, clique em Segurança > Logs de auditoria.
3. Em Logs de auditoria, clique na guia Configurações.
4. Escolha uma opção na lista suspensa. Será solicitado que confirme sua escolha.

Eventos nos logs de auditoria

Os logs de auditoria contêm registros das seguintes categorias de eventos:

Perguntas frequentes