Logs de auditoria do espaço de trabalho

Proprietários do Espaço de trabalho, use os logs de auditoria no nível do Espaço de trabalho para resolver situações como erros, ações de agentes mal-intencionados e ações maliciosas.

A disponibilidade dos recursos e os limites variam de acordo com o plano e a função do usuário. Saiba mais.

Integração via API

Integre seu log de auditoria com seus sistemas externos ou exporte os logs para usar como referência de conformidade via nossa API.

Eventos rastreados pelos logs de auditoria

Eventos são ações de usuários que ficam registradas. Estes são os logs de auditoria do Espaço de trabalho:

  • Usuário: O log de usuário rastreia eventos de autenticação e autorização, como logins e logouts de usuários, alterações de função e convites de usuários.
  • Tarefa: O log de tarefa rastreia atividades de tarefas selecionadas por usuário e tipo de atividade.
  • Campos: O log de Campos rastreia eventos de Campos personalizados, como a criação ou remoção de Campos personalizados.
  • Hierarquia: O log de Hierarquia rastreia eventos de Hierarquia, como a criação de uma Pasta ou a exclusão de uma Lista.
  • Agentes: O log de Agentes rastreia a atividade do Super Agent por usuário do Espaço de trabalho ou por Agente e tipo de atividade.
  • Outros: O log de Outros rastreia eventos de emojis personalizados.

Dados de eventos

Os logs geram os seguintes dados para cada evento:

  • Data
  • Usuário
  • Função
  • Evento
  • Status

Captura de tela destacando o cabeçalho da tabela do Log de auditoria.

O log de evento traz mais detalhes. Para visualizá-lo:

  • À esquerda da data em qualquer linha do log de auditoria, clique no dropdown.

O log de evento é um sistema interno de relatórios que usa nossos esquemas de nomenclatura. Algumas informações, como funções de usuário, são representadas por um número.

Captura de tela destacando o ícone de dropdown à esquerda da data em uma linha do Log de auditoria.

A tabela a seguir mostra exemplos de dados de log de evento gerados quando um administrador faz login com sucesso via 2FA:

Informação Descrição Log de evento
Data
31 de julho de 2024
10:59:04
A data e o horário em que o evento ocorreu. startTime: "2024-07-31T17:59:04.238Z
endTime: "2024-07-31T17:59:04.238Z
Usuário
username@email.com
O usuário que realizou a ação. userId: 123
clientIp: 123.123.123.123
userName: User Name
userEmail: username@email.com
Função
Admin
A função do usuário que realizou a ação. userRole: 2
Evento
User Login (2FA)
Ações do usuário que são registradas. title: User Login (2FA)
eventType: USER_LOGIN
Status
Success
O estado do evento — sucesso ou falha, por exemplo. eventStatus: success

Eventos rastreados pelo log de usuário

A tabela a seguir detalha os eventos rastreados pelo log de usuário:

Evento Descrição
2FA Policy Changed Um proprietário ou administrador alterou a política de exigência de 2FA do Espaço de trabalho.
Access Request Created Alguém solicitou acesso a uma tarefa.
Access Request Resolved A solicitação de acesso a uma tarefa foi aprovada ou recusada.
Advanced Settings Update Um proprietário ou administrador atualizou uma permissão avançada do Espaço de trabalho.
App Connection Created Alguém configurou uma conexão pessoal ou do Espaço de trabalho para um aplicativo. Isso inclui conexões com servidores MCP externos.
App Connection Deleted Alguém desconectou uma conexão pessoal ou do Espaço de trabalho de um aplicativo. Isso inclui conexões com servidores MCP externos.
App Connection Updated Alguém alterou as configurações de um aplicativo conectado existente, por exemplo, ativando ou desativando a Pesquisa conectada para ele.
Bypass SSO Enabled Um proprietário ou administrador ativou a configuração de bypass de SSO.
Chat Retention Setting Deleted Um proprietário ou administrador alterou a configuração de retenção de dados do Chat para o padrão Nunca expira.
Chat Retention Setting Updated Um proprietário ou administrador alterou a configuração de retenção de dados do Chat para 30, 90, 180 ou 360 dias.
AI Notetaker Retention Setting Deactivated Registrado quando um proprietário ou administrador redefine o período de retenção de dados do AI Notetaker para Nunca expira.
AI Notetaker Retention Setting Updated Registrado quando um proprietário ou administrador define um período de retenção de dados do AI Notetaker.
ClickApp Updated O ClickApp especificado foi atualizado.
Custom Role Created Um proprietário ou administrador criou uma nova função personalizada.
Custom Role Deleted Um proprietário ou administrador excluiu uma função personalizada.
Custom Role Updated Um proprietário ou administrador atualizou uma função personalizada.
Role Permission Changed O usuário alterou as permissões de outro usuário.
SSO Configuration Updated Um proprietário ou administrador alterou o requisito ou provedor de SSO do Espaço de trabalho.
Space ClickApp Bulk Updated Atualização em massa de ClickApps para Espaços.
Space ClickApp Updated Atualização de ClickApps para um Espaço específico.
Team Created Uma Equipe foi criada.
Team Deleted Uma Equipe foi excluída.
Team Updated Uma Equipe foi atualizada.
Update User Via SCIM
Consulte os artigos a seguir para saber mais sobre como usar o SCIM com o ClickUp:

• Guia de configuração do SCIM do Microsoft Entra ID
• Guia de configuração do SCIM do Okta para o ClickUp
Foram feitas atualizações no perfil do usuário via SCIM.
User Deprovisioned Via SCIM O provisionamento do usuário foi cancelado via SCIM.
User Provisioned Via SCIM O usuário foi provisionado via SCIM.
User added to Team Um usuário foi adicionado a uma Equipe.
User Changed 2FA Um usuário ativou ou desativou as configurações de 2FA da sua conta.
User Changed Email O usuário alterou o e-mail.
User Changed Password O usuário alterou a senha.
User Invited to Workspace O usuário convidou um novo usuário para entrar no Espaço de trabalho.
User Joined Workspace O usuário aceitou um convite para entrar no Espaço de trabalho.
User Left Workspace O usuário saiu do Espaço de trabalho.
User Login O usuário fez login.
User Logout O usuário fez logout.
User Removed from Team O usuário foi removido de uma Equipe.
User Removed from Workspace O usuário removeu outro usuário do Espaço de trabalho.
User Requested Password Recovery O usuário solicitou a recuperação de senha.
User Requested to Invite Um usuário com permissões de convite convidou outro usuário.
User Role Changed O usuário alterou a função de outro usuário.

Os eventos de conexão de aplicativos não permitem, por enquanto, que os administradores identifiquem quem criou ou removeu uma conexão pessoal com terceiros. Verificações iniciais e reindexações periódicas podem aparecer como acessos repetidos a arquivos no sistema de origem.

Nos planos Enterprise e Max, a permissão de função Integrações pessoais pode impedir novas conexões pessoais. Essa permissão está sendo disponibilizada gradualmente e pode ainda não estar visível no seu Espaço de trabalho. O comportamento está sujeito a alterações.

Eventos rastreados pelo log de tarefas

A tabela a seguir lista os eventos rastreados pelo log de tarefas:

Evento
Tarefa Arquivada
Tarefa com Responsáveis Alterados
Tarefa Criada
Tarefa com Valores de Campo Personalizado Alterados
Tarefa Excluída
Tarefa Movida
Tarefa com Prioridade Alterada
Tarefa Restaurada
Tarefa com Status Alterado
Tarefa Desarquivada

As ações realizadas por Super Agents também são registradas.

Eventos rastreados pelo log de Campos

A tabela a seguir lista os eventos rastreados pelo log de Campos:

Evento Descrição
Custom Field Converted O usuário converteu um campo personalizado existente em outro tipo de campo.
Custom Field Created O usuário criou um campo personalizado.
Custom Field Updated O usuário editou um campo personalizado.
Os logs de auditoria não rastreiam edições nas opções de campos personalizados do tipo lista suspensa ou rótulo. Por exemplo, alterar o nome de um campo do tipo lista suspensa.

Opções de lista suspensa nos logs de auditoria

Custom Field Removed O usuário removeu um campo personalizado de um local sem excluí-lo do Espaço de trabalho.
Custom Field Permanently Removed O usuário excluiu um campo personalizado do Espaço de trabalho. Ou o campo personalizado ficou na Lixeira por mais de 30 dias.
Após 30 dias, os campos personalizados são excluídos permanentemente.
Custom Field Restored O usuário restaurou um campo personalizado da Lixeira.
Custom Field Duplicated O usuário duplicou um campo personalizado.
Custom Field Merged O usuário mesclou um campo personalizado.
Custom Field Location Added O usuário adicionou um campo personalizado a um novo local.
Custom Field Location Updated O usuário moveu um campo personalizado de um local para outro.
Custom Field Location Removed O usuário removeu um campo personalizado de um local.
Custom Field Member Permission Set As permissões de usuário deste campo personalizado foram definidas ou editadas.
Custom Field Member Permission Removed Uma permissão de usuário deste campo personalizado foi removida.
Custom Field Group Member Permission Updated A permissão de usuário de uma Equipe neste campo personalizado foi atualizada.
Custom Field Group Member Permission Removed A permissão de usuário de uma Equipe neste campo personalizado foi removida.

As ações realizadas por Super Agents estão incluídas.

Eventos rastreados pelo log de Hierarquia

A tabela a seguir lista os eventos rastreados pelo log de Hierarquia:

Evento Descrição
Acesso à pasta atualizado As configurações de compartilhamento ou permissões de um usuário em uma Pasta ou Subpasta foram atualizadas.
Pasta arquivada Uma Pasta ou Subpasta foi arquivada.
Pasta criada Uma Pasta ou Subpasta foi criada.
Pasta excluída Uma Pasta ou Subpasta foi excluída.
Pasta duplicada Uma Pasta ou Subpasta foi duplicada.
Pasta movida Uma Pasta ou Subpasta foi movida.
Configuração pública/privada da pasta atualizada A configuração pública ou privada de uma Pasta ou Subpasta foi atualizada.
Pasta renomeada Uma Pasta ou Subpasta foi renomeada.
Pasta atualizada Uma configuração da Pasta ou Subpasta foi atualizada. Por exemplo, a cor da Pasta foi alterada.
Acesso à lista atualizado As configurações de compartilhamento ou permissões de um usuário em uma Lista foram atualizadas.
Lista arquivada Uma Lista foi arquivada.
Lista criada Uma Lista foi criada.
Lista excluída Uma Lista foi excluída.
Lista duplicada Uma Lista foi duplicada.
Lista movida Uma Lista foi movida.
Configuração pública/privada da lista atualizada A configuração pública ou privada de uma Lista foi atualizada.
Lista renomeada Uma Lista foi renomeada.
Lista desarquivada Uma Lista foi desarquivada.
Lista atualizada Uma configuração da Lista foi atualizada. Por exemplo, o status da Lista foi alterado.
Acesso ao Espaço atualizado As configurações de compartilhamento ou permissões de um usuário em um Espaço foram atualizadas.
Espaço arquivado Um Espaço foi arquivado.
Espaço criado Um Espaço foi criado.
Espaço excluído Um Espaço foi excluído.
Espaço duplicado Um Espaço foi duplicado.
Configuração pública/privada do Espaço atualizada A configuração pública ou privada de um Espaço foi atualizada.
Espaço renomeado Um Espaço foi renomeado.
Espaço atualizado Uma configuração do Espaço foi atualizada. Por exemplo, a cor e o ícone foram alterados.

As ações realizadas por Super Agents também são registradas.

Eventos rastreados pelo log de Agentes

Este log se aplica somente aos Super Agents. A atividade do Autopilot Agent é rastreada no log de Automações.

A tabela abaixo lista os eventos rastreados pelo log de Agentes:

Evento Descrição
Agent Active Setting Updated O Super Agent foi ativado.
Isso significa que o Super Agent acabou de ser criado ou que um Super Agent existente foi reativado.
Agent Assignee Setting Updated O gatilho Atribuir tarefa do Super Agent foi desativado.
Agent Created O Super Agent foi criado.
Agent DM setting Updated O gatilho Mensagem direta do Super Agent foi desativado.
Agent Deleted O Super Agent foi excluído.
Agent Knowledge Setting Updated O conhecimento do Super Agent foi editado.
Agent Mentions Setting Updated O gatilho Menção do Super Agent foi desativado.
Agent Prompt Setting Updated As instruções do Super Agent foram editadas.
Agent Tools Setting Updated As ferramentas do Super Agent foram editadas.
Agent Triggers Setting Updated Os gatilhos do Super Agent foram atualizados.
Agent Schedules Setting Updated O agendamento do Super Agent foi atualizado.

Eventos rastreados pelo log Outros

Evento Descrição
Emoji Created, Deleted, or Updated Um emoji personalizado foi criado, excluído ou atualizado.

Acesse seus logs de auditoria

Os logs de auditoria são gerados nas configurações do seu Workspace do ClickUp e também podem ser usados com a API do ClickUp.

Para acessar os logs de auditoria pelo ClickUp:

  1. No canto superior esquerdo, clique no avatar do seu Workspace e selecione Configurações.
  2. Na barra lateral Todas as configurações, clique em Logs de auditoria.
  3. Clique na aba Usuário, Tarefa, Campos ou Hierarquia para selecionar um log. Você também pode selecionar a aba Agentes ou Outros.

Pesquise seus logs de auditoria

Na página Logs de auditoria das configurações do seu Espaço de trabalho, você pode pesquisar os dois logs usando os seguintes filtros:

Data

A data em que o evento ocorreu. Para pesquisar por data:

  1. Selecione a aba Usuário ou Tarefa.
  2. Abaixo das abas, selecione o menu suspenso Data.
  3. No seletor de datas, escolha uma ou as duas opções:
    • Data inicial: quando o evento começou.
    • Data final: quando o evento terminou.

Usuário

O usuário que realizou a ação. Para pesquisar por usuário:

  1. Selecione a aba Usuário ou Tarefa.
  2. Abaixo das abas, selecione o menu suspenso Usuário.
  3. No seletor de pessoas, escolha um usuário.

Status

O status da ação concluída. Por exemplo, sucesso ou erro. Para visualizar:

  1. Selecione a aba Usuário ou Tarefa.
  2. Abaixo das abas, selecione o menu suspenso Status.
  3. No menu suspenso, selecione um ou mais dos seguintes status:
    • Sucesso
    • Falha

Permitir que administradores visualizem logs de auditoria

Os proprietários podem permitir que administradores visualizem logs de auditoria. Membros e convidados não podem visualizar logs de auditoria.

Para permitir que administradores visualizem os logs:

  1. No canto superior esquerdo, clique no avatar do seu Espaço de trabalho e selecione Configurações.
  2. Na barra lateral Todas as configurações, clique em Segurança e permissões.
  3. Crie uma permissão personalizada que herde a função de administrador.
  4. Role a página até a seção Ações do Espaço de trabalho.
  5. Na coluna da nova função, clique no botão Visualizar logs de auditoria para ativá-lo.