Ir para o conteúdo principal
ShieldID

Activity Ledger

Cada consulta. Cada clique. Registrado.

O Activity Ledger é um registro somente de adição de tudo o que acontece em torno de uma verificação: quem fez login, quem abriu um link, o que o mecanismo decidiu, quem exportou o quê. Entradas podem ser adicionadas, nunca editadas ou excluídas. Nem por você, nem por nós.

Experimente o ledger de exemploReferência da API

O ledger descrito aqui é o registro de governança que já sustenta o Trust Ledger hoje e está sendo implantado para as contas da API do ShieldID. Tudo o que ainda não é registrado nas verificações de identidade está marcado como Em breve nesta página.

Por que isso importa

Uma verificação sem registro é apenas uma opinião.

Usar um serviço de identidade traz um risco próprio: alguém precisa responder por quem viu o documento do solicitante e o que foi feito com ele. O ledger é como você responde.

Para você

Comprove o que aconteceu, em ordem, com o resultado. Quando uma decisão for questionada meses depois, o ledger é a evidência, e ele dura mais que as imagens dos documentos.

Para o seu responsável de conformidade

Responda a uma solicitação de privacidade ou a uma auditoria com uma exportação filtrada em vez de uma semana de e-mails. Cada exportação é, ela mesma, uma entrada.

Para os seus solicitantes

Cada visualização e download de um documento armazenado deixa uma entrada, de modo que "quem viu meu dossiê?" tenha uma resposta que a empresa possa dar. Eventos por imagem para fotos de documentos e uma visualização de autoatendimento para solicitantes chegarão em breve.

O que ele registra

O vocabulário de eventos, completo.

Toda entrada usa um destes nomes, para que um filtro sempre signifique a mesma coisa. Os nomes são exibidos como aparecem no ledger.

Login e acesso

Toda forma de entrar na conta e todo olhar por trás da cortina.

LOGIN_2FA_CHALLENGED
Um login chega à etapa de dois fatores.
LOGIN_SUCCESS
Um login é concluído.
FORENSIC_DETAIL_ACCESSED
Alguém abre as evidências de rede e dispositivo por trás de uma entrada. É preciso um motivo por escrito, e a própria solicitação é registrada.

Solicitações de verificação

A jornada do solicitante, do link ao consentimento.

SIGN_LINK_OPENED
O solicitante abre o link da sua verificação.
EULA_ACCEPTED
O solicitante aceita os termos antes de continuar.
TASK_CREATED / TASK_SENT
Uma solicitação de verificação é criada e enviada, por uma pessoa ou por uma chave de API.
TASK_VIEWED / TASK_VOIDED
Uma solicitação é buscada ou cancelada pela API.

Registros e exportações

Tudo o que sai da conta deixa um rastro.

DOCUMENT_VIEWED
Um documento armazenado é aberto no portal.
DOCUMENT_DOWNLOADED
Um documento é baixado, no portal ou pela API.
DOCUMENT_EMAILED
Um documento é enviado por e-mail a um destinatário.
AUDIT_EXPORTED
Uma trilha de auditoria é recuperada pela API. Ler o registro também é registrado.

Conta e API

Configurações e credenciais, com o autor associado.

SETTING_CHANGED
Uma configuração da conta é alterada pela API.
SESSION_CREATED / SESSION_REVOKED
Uma sessão de API é aberta ou revogada.
ACCOUNT_MAILING_ADDRESS_UPDATED / BILLING_ADDRESS_UPDATED
Os dados da conta são alterados.

Linha do tempo da solicitação (por solicitação, junto ao ledger)

Cada solicitação também tem sua própria linha do tempo. É um registro de trabalho, não o ledger somente de adição, por isso o nomeamos separadamente.

BIOMETRIC_VERIFIED / BIOMETRIC_FAILED
O mecanismo de verificação informa que a verificação de identidade foi aprovada ou reprovada, indicando qual verificação falhou.
RETENTION_PURGE / RETENTION_PURGE_FAILED
A varredura de retenção exclui os documentos armazenados de uma solicitação ao fim do seu prazo, ou não consegue fazê-lo.
GDPR_ERASURE
As informações pessoais são ocultadas em atendimento a uma solicitação de direito ao apagamento.

A caminho

Em breve

Os eventos que fecham o ciclo especificamente para a verificação de identidade. Nós os listamos para que você possa nos cobrar por eles.

ID_IMAGE_VIEWED / ID_IMAGE_DOWNLOADED
Cada vez que uma imagem de documento de identidade ou selfie é aberta ou baixada, e por quem.
DECISION_RECORDED
A aceitação ou recusa que sua equipe registra em uma verificação, com o motivo.
API_KEY_CREATED / API_KEY_REVOKED
Eventos do ciclo de vida das chaves como entradas do ledger. Hoje eles são armazenados junto com a chave, não como entradas.
VERIFICATION_VERIFIED / VERIFICATION_FAILED
Resultados de verificação como entradas do ledger somente de adição para contas da API do ShieldID. Hoje eles são gravados na linha do tempo da solicitação.
IMAGE_PURGED
Um comprovante para cada eliminação automática de imagens de documentos de identidade.
Applicant view
Uma página de autoatendimento em que a pessoa verificada vê quem acessou sua verificação.
CSV export
Uma exportação filtrada para auditores, em planilha. A exportação em JSON existe hoje.

Anatomia de uma entrada

Quatorze campos, sempre. Depois, a evidência, sob solicitação.

Uma entrada diz quem, o quê, sobre o quê, com qual resultado, em linguagem simples e em formato legível por máquina. As evidências de rede e dispositivo ficam ao lado, atrás de uma solicitação registrada.

A entrada

Tipo de autor
Pessoa, signatário, sistema, administrador ou chave de API. As ações de uma chave de API levam o id da própria chave, de modo que um script e uma pessoa nunca sejam confundidos.
Rótulo do autor
O nome ou e-mail como eram na época, não uma consulta em tempo real que muda quando as pessoas saem.
Ação
O nome do evento, do vocabulário fixo acima.
Categoria e gravidade
Autenticação, documento, assinatura, tarefa, conta, segurança ou sistema; de informativo a crítico.
Alvo
Sobre o que a ação foi realizada: uma verificação, um documento, uma pessoa, uma configuração.
Resumo
Uma frase em linguagem humana, escrita no momento da ação.
Resultado
Sucesso, falha ou negado. Uma ação recusada é registrada com a mesma ênfase que uma bem-sucedida.
Metadados
Detalhes estruturados: rótulo da chave de API, ambiente (sandbox ou produção), id da requisição e mais.
Carimbo de data e hora
Horário do servidor, em ordem, nunca editável.

A evidência, por trás de uma requisição registrada

Endereço IP e escopo
Público, NAT de nível de operadora, privado, loopback ou desconhecido, para que quem revisa saiba o quanto confiar nele.
Operador de rede
DNS reverso, registrante, ASN e se o endereço pertence a um provedor de hospedagem.
Localização
País, região, cidade e código postal, com o raio de precisão e se os dados estavam desatualizados.
Dispositivo
Uma lista curta de sinais, como fuso horário, tamanho da tela, plataforma e idiomas, reduzida a uma impressão digital SHA-256 estável. Nenhum despejo bruto do navegador.
Endereço informado
O que o próprio navegador informou, marcado como não verificado.

As evidências são enriquecidas depois que a resposta é enviada, nunca no caminho crítico do solicitante, e ficam marcadas como não enriquecidas até chegarem.

Evidência de adulteração

Não o chamamos de blockchain, porque não é um. É uma tabela que o banco de dados se recusa a deixar qualquer pessoa editar.

Palavras simples sobre o que protege o registro, para que seu auditor possa conferir nossas afirmações com o nosso comportamento.

  • Somente adição, garantido pelo banco de dados

    Um gatilho na tabela de governança gera um erro em qualquer atualização ou exclusão. O código da aplicação, os administradores e nós mesmos estamos sujeitos a ele.

  • Uma exceção restrita e registrada

    Quando uma conta é excluída, suas entradas são desvinculadas da conta em vez de apagadas, e somente se todas as outras colunas forem idênticas byte a byte. Nada é truncado.

  • As gravações passam por uma função protegida

    As entradas são gravadas por uma função do banco de dados com privilégios definidos, depois de um incidente real em que a segurança em nível de linha engolia gravações silenciosamente. A correção é o motivo de a função existir.

  • Ler a evidência é um evento

    Os detalhes de rede e dispositivo não podem ser lidos sem um motivo por escrito de pelo menos doze caracteres, registrado em nome de quem leu como FORENSIC_DETAIL_ACCESSED.

  • Eliminar imagens não afeta o registro

    As imagens de documentos de identidade são eliminadas após um curto prazo. As entradas do ledger são um registro separado, sem vínculo com as imagens, então excluir uma imagem nunca remove a entrada que descreve o que aconteceu com ela.

Busca e filtros

Pesquise como em um banco de dados, porque ele é um.

Todo filtro é validado no servidor e restrito à sua conta. As listas de filtros mostram apenas valores que realmente ocorrem, então você nunca busca por nada.

Autor
Uma pessoa, ou uma chave de API pelo seu id. Isole tudo o que uma integração fez.
Alvo
Uma verificação, um documento ou uma pessoa. Tudo o que aconteceu com o dossiê deste solicitante.
Ação
Qualquer nome de evento do vocabulário.
Categoria, severidade, resultado
Somente eventos de segurança, somente falhas, somente ações negadas.
Intervalo de datas
De e até, com precisão de segundos.
Texto livre
Em resumos, rótulos de autor, rótulos de alvo e ações. Deliberadamente nunca nos metadados brutos.

A exportação hoje é em JSON: a trilha completa de uma verificação pela API, limitada a quinhentas linhas, com cada consulta registrada como AUDIT_EXPORTED. A exportação em CSV para clientes chegará em breve.

Experimente

Um ledger de exemplo, fictício e pesquisável.

Filtre, expanda uma linha, abra a evidência. Os nomes e eventos abaixo são inventados para a demonstração; o conjunto de campos e o comportamento são reais.

Activity Ledger

Dados de exemplo

18 entradas exibidas.

  • 2026-09-16 · 13:41:22

    LOGIN_2FA_CHALLENGED

    Wren Halloway · Login no portal

    Success

  • 2026-09-16 · 13:41:58

    LOGIN_SUCCESS

    Wren Halloway · Login no portal

    Success

  • 2026-09-16 · 14:02:10

    SESSION_CREATED

    Widget de onboarding (produção) · Sessão de API 4a81

    Success

  • 2026-09-16 · 14:02:11

    TASK_CREATED

    Widget de onboarding (produção) · Verificação de Ottoline Marchetti-Fife

    Success

  • 2026-09-16 · 14:19:47

    SIGN_LINK_OPENED

    Ottoline Marchetti-Fife · Link de verificação 7c19

    Success

  • 2026-09-16 · 14:20:12

    EULA_ACCEPTED

    Ottoline Marchetti-Fife · Consentimento de verificação

    Success

  • 2026-09-16 · 14:22:35

    BIOMETRIC_VERIFIED

    Mecanismo de verificação · Verificação de Ottoline Marchetti-Fife

    Success

  • 2026-09-16 · 14:22:39

    TASK_VIEWED

    Widget de onboarding (produção) · Verificação de Ottoline Marchetti-Fife

    Success

  • 2026-09-16 · 15:07:03

    DOCUMENT_VIEWED

    Desmond Quillfeather · Resultado de Ottoline Marchetti-Fife

    Success

  • 2026-09-16 · 15:08:44

    DOCUMENT_DOWNLOADED

    Desmond Quillfeather · Resultado de Ottoline Marchetti-Fife

    Success

  • 2026-09-15 · 11:52:18

    SIGN_LINK_OPENED

    Barnaby Thistlewood · Link de verificação 3e77

    Success

  • 2026-09-15 · 11:55:02

    BIOMETRIC_FAILED

    Mecanismo de verificação · Verificação de Barnaby Thistlewood

    Failure

  • 2026-09-15 · 16:30:55

    FORENSIC_DETAIL_ACCESSED

    Perpetua Nakashima · Evento evt-0012

    Success

  • 2026-09-15 · 09:14:31

    SESSION_CREATED

    Ines Valcourt-Brie · Chave de API: Billing sync (sandbox)

    Success

  • 2026-09-14 · 17:45:09

    SESSION_REVOKED

    Ines Valcourt-Brie · Chave de API: Legacy import (production)

    Success

  • 2026-09-14 · 10:22:47

    SETTING_CHANGED

    Clementine Ashgrove · Período de retenção

    Success

  • 2026-09-14 · 10:31:12

    AUDIT_EXPORTED

    Clementine Ashgrove · Exportação do Registro de Atividades, de 1 de agosto a 14 de setembro

    Success

  • 2026-09-14 · 03:00:04

    RETENTION_PURGE

    Varredura de retenção · 41 verificações além do período de retenção

    Success

Perguntas

Respostas diretas sobre o registro.

Veja com seus próprios dados

Execute uma verificação no sandbox. Depois leia o que ela gravou.

A forma mais rápida de entender o ledger é criar uma entrada nele. Sessões no sandbox nunca são cobradas.

Comece grátis no sandboxAgende uma demonstração