Registros de Atividade
Acompanhe quem realizou uma ação, quais alterações foram feitas, quando, onde e se foi bem-sucedida, no DEUNA Admin.
Nesta página
- Investigar a atividade
- Por que usar os Registros de Atividade
- Antes de começar
- Registros de atividade
- Inspeccionar um evento
- Pesquisar e filtrar registros
- Exportar registros
- Permissões
- Proteção de dados e retenção
- Eventos disponíveis
- Exemplo: investigar uma mudança na taxa de aprovação
- Continue operando com segurança.
Os Registros de Atividade fornecem um registro pesquisável e resistente a adulterações das ações realizadas no DEUNA Admin. Utilize-os para investigar alterações, verificar o acesso e preparar evidências para auditoria, sem precisar consultar várias ferramentas.
Investigar a atividade#
No DEUNA Admin, abra Registros para acessar Histórico de alterações. Comece com a janela do incidente, refine os resultados e inspecione apenas os eventos que explicam a alteração.
01 · scope
Definir a janela
Escolha um período de até 90 dias e o comerciante que você precisa investigar.
02 · filter
Encontrar a atividade
Pesquisar por usuário e filtrar por seção, ação, gravidade ou resultado.
03 · inspect
Verificar o evento
Abrir uma linha para revisar o usuário, a fonte, o resultado e os metadados anonimizados.
04 · retain
Exportar evidências
Baixar o conjunto mínimo de registros filtrados necessários para o seu processo.
Exemplo interativoUsa dados de exemplo e não faz solicitações à API.
Segurança e auditoria
Eventos de exemplo · UTCRegistros de atividade
Rastreie quem alterou o quê, quando ocorreu e se a ação foi concluída.
| Criado | Executado por | Ação | Seção | Endereço IP | Resultado |
|---|---|---|---|---|---|
| maria@acme.com | routing.rule.updated | Roteamento | 190.12.44.18 | Sucesso | |
| diego@acme.com | connections.processor.updated | Conexões | 181.54.20.91 | Sucesso | |
| sofia@acme.com | users.role_permissions.updated | Usuários | 200.31.12.77 | Sucesso | |
| ana@acme.com | security.2fa_challenge.verified | Segurança | 201.221.8.34 | Falha |
O exemplo utiliza dados fictícios. Pesquise, altere as seções e selecione uma linha para ver como uma investigação se move da lista de atividades para um evento específico.
Por que usar os Registros de Atividade#
| Benefício | O que isso significa para sua equipe |
|---|---|
| Investigações mais rápidas | Compare uma janela de incidente com configurações, login e atividade operacional. |
| Responsabilidade | Identifique o usuário, o papel, a ação, o tempo e o resultado associados a cada evento. |
| Visibilidade de segurança | Revise a autenticação, a 2FA, a redefinição de senha, o bloqueio de conta e a atividade de acesso. |
| Suporte à conformidade | Use registros somente para escrita e exporte como evidência. Os Registros de Atividade suportam seu programa de conformidade; eles não o substituem. |
| Proteção de dados | Valores sensíveis, como números de cartão, CVV, senhas, códigos de um único uso e credenciais, são removidos ou mascarados antes do armazenamento. |
| Isolamento de tenant | Os usuários do comerciante só veem os registros do seu próprio comerciante. Os usuários da rede veem os registros dos comerciantes da sua rede, preservando a atribuição ao comerciante. |
Antes de começar#
Verifique se seu papel inclui audit_log.view, além de audit_log.export se você precisar gerar ou baixar arquivos. Você também deve saber o comerciante e o intervalo de datas aproximado associado à atividade. Usuários sem permissão de visualização não veem Registros.
Registros de atividade#
- Faça login no DEUNA Admin.
- Abra Registros.
- Escolha um período de tempo. Cada consulta pode abranger até 90 dias.
- Pesquise por usuário ou aplique filtros para refinar os resultados.
- Selecione uma linha para inspecionar os detalhes do evento.
Os registros aparecem com o evento mais recente primeiro. Novos eventos geralmente ficam disponíveis em até 5 minutos. Use Colunas para selecionar os campos visíveis e Atualizar para carregar os registros mais recentes.
| Campo | Descrição |
|---|---|
| Data de criação | Quando o evento ocorreu. A DEUNA armazena o fuso horário UTC e exibe o seu fuso horário local. |
| Executado por | Endereço de e-mail do usuário que realizou a ação. |
| Ação | Nome da ação legível, como Regra de roteamento visualizada. |
| Seção | Área de administração da DEUNA associada à ação, como Configurações, Roteamento ou Conexões. |
| IP | Endereço IP de origem da solicitação. |
Inspeccionar um evento#
Expanda um registro para ver todo o contexto. Use Detalhes para uma visualização formatada ou JSON para o evento bruto.
| Campo | Descrição |
|---|---|
merchantId | Comerciante associado ao evento. |
userId | Usuário que realizou a ação. |
actorRole | Papel atribuído ao ator no momento do evento. |
eventSeverity | Nível de impacto: LOW, MEDIUM, HIGH, ou CRITICAL. |
eventResult | Resultado: SUCCESS ou FAILURE. |
originUserAgent | Navegador ou cliente que enviou a solicitação. |
originSessionId | Sessão em que a ação ocorreu. |
metadata | Evento aprovado e sanitizado, como um identificador de recurso afetado. O conteúdo varia de acordo com o evento. |
BAIXO · rotinaLogin bem-sucedido ou visualização de uma configuração.MODERADO · moderadoAtualizar um papel ou solicitar uma exportação.ALTO · sensívelDesativar o roteamento ou atualizar credenciais.CRÍTICO · urgenteBloqueio de conta, desativar a 2FA ou falhas repetidas de autenticação.
SUCCESS significa que a ação foi concluída conforme o esperado. FAILURE significa que não foi concluída; metadata pode incluir uma razão de falha sanitizada.
Pesquisar e filtrar registros#
- Pesquisar por e-mail ou nome para encontrar atividades associadas a um usuário.
- Filtrar por data com um intervalo de até 90 dias.
- Adicionar filtro para refinar por seção, ação, gravidade, resultado ou outro campo disponível.
Comece com um intervalo de data estreito e, em seguida, adicione filtros de seção e ação. Isso cria uma linha do tempo confiável antes de ampliar a pesquisa.
Exportar registros#
- Aplique o intervalo de data e os filtros necessários.
- Selecione Exportar e confirme a solicitação.
- Abra Downloads.
- Aguarde até que o arquivo esteja pronto e, em seguida, baixe-o.
As exportações são executadas de forma assíncrona e contêm os registros que correspondem aos seus filtros quando a exportação é solicitada.
| Restrição | Valor |
|---|---|
| Intervalo de data máximo | 90 dias por exportação |
| Número máximo de registros | 10.000 por exportação |
| Exportações concorrentes | 3 por comerciante |
| Formato de arquivo | CSV UTF-8 compactado com Gzip, com separadores (;) |
| Disponibilidade do arquivo | 7 dias após a criação |
| Validade do link de download | 15 minutos |
Se o link expirar, solicite um novo de Downloads. Solicitações e downloads de exportação também são registrados como exports.requested e exports.downloaded events.
Permissões#
| Permissão | Permite |
|---|---|
audit_log.view | Visualize os logs, pesquise e filtre registros, e inspecione os detalhes dos eventos. |
audit_log.export | Solicite exportações e baixe os arquivos gerados. |
Proteção de dados e retenção#
- Registros somente para escrita: Os registros de atividade não podem ser editados ou excluídos no DEUNA Admin ou na API. A criação de um novo evento com a informação necessária garante a integridade dos dados.
- Sanitização de dados sensíveis: Dados como PAN, CVV, informações de rastreamento, senhas, códigos OTP, tokens de redefinição, chaves de API e segredos são mascarados ou removidos antes do armazenamento.
- Criptografia: Os dados são protegidos durante a transmissão com TLS 1.2 ou superior e criptografados em repouso.
- Retenção: Os registros são mantidos por 365 dias e geralmente aparecem em até cinco minutos.
Eventos disponíveis#
Os nomes dos eventos seguem <domain>.<resource>.<action>o padrão. Por exemplo, routing.rule.updated identifica o domínio de roteamento, uma regra de roteamento e uma atualização. A disponibilidade depende dos produtos e recursos da DEUNA habilitados para a conta.
Autenticação
| Evento | Descrição |
|---|---|
auth.login.verified | O login do usuário foi verificado e uma sessão foi iniciada. |
auth.logout.verified | O usuário fez logout e a sessão terminou. |
Segurança
| Evento | Descrição |
|---|---|
security.2fa_policy.updated | A política de autenticação de dois fatores do comerciante foi alterada. |
security.2fa_method.setup | O usuário configurou um método de autenticação de dois fatores. |
security.2fa_method.disabled | O método de autenticação de dois fatores do usuário foi desativado. |
security.2fa_challenge.viewed | Um desafio de autenticação de dois fatores foi apresentado. |
security.2fa_challenge.verified | O usuário submeteu o desafio. Consulte eventResult para verificar o resultado. |
security.2fa_backup_codes.generated | Novos códigos de backup para autenticação de dois fatores foram gerados. |
security.2fa_backup_codes.verified | O usuário tentou verificar com um código de backup. |
security.account.locked | A conta do usuário foi bloqueada. |
security.account.unlocked | A conta de usuário bloqueada foi desbloqueada. |
security.password.reset_requested | Foi solicitado o redefinimento da senha. |
security.password.reset_completed | O redefinimento da senha foi concluído. |
security.block.applied | A proteção contra ataques de força bruta aplicou um bloqueio de acesso. |
security.block.cleared | O bloqueio de acesso foi removido. |
security.user.overridden | Uma restrição de segurança do usuário foi manualmente desativada. |
security.user.status_updated | O status do usuário foi alterado. |
security.email.sent | Um e-mail relacionado à segurança foi enviado. |
Usuários e funções
| Evento | Descrição |
|---|---|
users.user.created | O usuário foi adicionado ao comerciante. |
users.user.updated | Os detalhes do usuário foram modificados. |
users.user.deactivated | O usuário foi desativado. |
users.role.created | Um papel (role) foi criado. |
users.role.updated | Um papel (role) foi modificado. |
users.role_permissions.updated | As permissões atribuídas a um papel (role) foram alteradas. |
Exportações
| Evento | Descrição |
|---|---|
exports.requested | O usuário solicitou a exportação do Log de Atividades. |
exports.downloaded | O usuário baixou o arquivo de exportação. |
Pedidos
| Evento | Descrição |
|---|---|
orders.captured | O pagamento de um pedido foi capturado. |
orders.refunded | O pagamento de um pedido foi reembolsado. |
orders.voided | Uma autorização de pagamento foi cancelada. |
Configuração do comerciante
| Evento | Descrição |
|---|---|
configurations.merchant_policy.created | Uma política do comerciante foi criada. |
configurations.merchant_policy.updated | Uma política do comerciante foi modificada. |
configurations.merchant_policy.deleted | Uma política do comerciante foi excluída. |
configurations.merchant_policy.viewed | Uma política do comerciante foi visualizada. |
configurations.merchant_profile.updated | O perfil do comerciante foi modificado. |
configurations.merchant_profile.viewed | O perfil do comerciante foi visualizado. |
configurations.widget_3ds.updated | A configuração do widget 3DS foi modificada. |
configurations.widget_3ds.viewed | A configuração do widget 3DS foi visualizada. |
configurations.order_config.updated | A configuração do pedido foi modificada. |
configurations.payment_config.updated | A configuração de pagamento foi modificada. |
configurations.payment_config.viewed | A configuração de pagamento foi visualizada. |
Roteamento
| Evento | Descrição |
|---|---|
routing.rule.created | Uma regra de roteamento foi criada. |
routing.rule.updated | Uma regra de roteamento foi modificada. |
routing.rule.enabled | Uma regra de roteamento foi habilitada. |
routing.rule.disabled | Uma regra de roteamento foi desabilitada. |
routing.rule.reordered | A ordem de prioridade das regras de roteamento foi alterada. |
routing.rule.viewed | Uma regra de roteamento foi visualizada. |
Conexões
| Evento | Descrição |
|---|---|
connections.processor.created | Uma conexão com o processador foi criada. |
connections.processor.updated | Uma conexão com o processador foi modificada. |
connections.processor.disabled | Uma conexão com o processador foi desabilitada. |
connections.processor.viewed | Uma conexão com o processador foi visualizada. |
Parcelas
| Evento | Descrição |
|---|---|
installments.campaign.created | Uma campanha de parcelamento foi criada. |
installments.campaign.updated | Uma campanha de parcelamento foi modificada. |
installments.campaign.viewed | Uma campanha de parcelamento foi visualizada. |
Links de pagamento
| Evento | Descrição |
|---|---|
payment_links.payment_link.created | Um link de pagamento foi criado. |
payment_links.payment_link.viewed | Um link de pagamento foi visualizado. |
payment_links.payment_link.deactivated | Um link de pagamento foi desativado. |
Gerenciamento de erros
| Evento | Descrição |
|---|---|
error_management.processor_error.created | Um mapeamento de erros do processador foi criado. |
error_management.processor_error.viewed | Um mapeamento de erros do processador foi visualizado. |
error_management.processor_error.updated | Um mapeamento de erros do processador foi modificado. |
error_management.processor_error.deleted | Um mapeamento de erros do processador foi excluído. |
Assinaturas
| Evento | Descrição |
|---|---|
subscriptions.subscription.created | Uma assinatura foi criada. |
subscriptions.subscription.updated | Uma assinatura foi modificada. |
subscriptions.subscription.viewed | Uma assinatura foi visualizada. |
subscriptions.subscription.paused | Uma assinatura foi pausada. |
subscriptions.subscription.canceled | Uma assinatura foi cancelada. |
subscriptions.subscription.reactivated | Uma assinatura pausada ou cancelada foi reativada. |
Operações em lote
| Evento | Descrição |
|---|---|
batch_operations.batch_job.created | Uma tarefa em lote foi criada. |
batch_operations.batch_job.viewed | Uma tarefa em lote foi visualizada. |
Exemplo: investigar uma mudança na taxa de aprovação#
- Defina o intervalo de datas, do dia anterior à data afetada.
- Filtro Seção por Roteamento e Conexões.
- Procure
routing.rule.updated,routing.rule.disabled,routing.rule.reordered, ouconnections.processor.disabled. - Abra cada registro relevante e confirme o ator, o horário, o endereço IP, o agente do usuário, o resultado e o recurso afetado em
metadata. - Exporte o cronograma filtrado somente quando necessário para ser compartilhado ou retido fora do DEUNA Admin.