Por Que Seu Git Log Não É Prova — e Como Torná-lo à Prova de Adulteração
Faça a si mesmo uma pergunta concreta: se um advogado, um auditor ou o advogado de um troll de patentes pedisse que você provasse que um commit específico existiu em uma data específica, o que você realmente entregaria a eles?
Um screenshot do git log? Uma exportação da sua atividade no GitHub? Ambos são trivialmente descartados. Se você quer uma prova real de adulteração do histórico do git com Bitcoin, a resposta não é uma exportação melhor — é um carimbo de data/hora que ninguém, incluindo você, pode retroagir ou alterar. Este guia percorre a mecânica de por que seu log falha como evidência e, em seguida, os passos exatos para torná-lo à prova de adulteração, com o GitHub App fazendo o trabalho durante a noite.
Por Que Seu Git Log Não É à Prova de Adulteração (E o Que Isso Significa para Compliance)
O Git é endereçado por conteúdo, o que engana as pessoas fazendo-as pensar que o histórico é imutável. Não é. Cada hash de commit é um hash da árvore, do pai, da mensagem e dos metadados — mas a cadeia desses hashes vive em um repositório em um servidor que você não controla. Três coisas quebram o valor probatório:
- O histórico é reescrevível por design.
git rebase,git commit --amende um force-push substituirão commits por novos hashes. Objetos antigos permanecem até a coleta de lixo, e então desaparecem. Um mantenedor com direitos de push pode reescrever meses de histórico em um minuto. - As datas são auto-relatadas. Os timestamps de autor e committer são apenas metadados que você pode definir. Qualquer log interno que registre o tempo é tão confiável quanto a máquina que o escreveu.
- O log vive na infraestrutura de outra pessoa. Sua organização no GitHub, seu banco de dados de CI, seu wiki interno — tudo editável, tudo sob seu controle. Em uma auditoria legal, isso os torna evidências “em causa própria” e fáceis de contestar.
Esse último ponto importa mais do que os desenvolvedores esperam. Um registro que você poderia ter alterado é um registro que a outra parte argumentará que você alterou. A solução não é mais logging — é externalizar a prova para um sistema cujo histórico nenhuma parte isolada pode reescrever.
Essa é a ideia por trás da anterioridade criptográfica: você pega as impressões digitais que o Git já produz (hashes de commit), agrupa-as, faz o hash do lote novamente em uma árvore de Merkle e ancora a raiz na blockchain do Bitcoin por meio do protocolo OpenTimestamps. Alguém pode reescrever seu repositório, mas não pode reescrever um bloco do Bitcoin.
O Timestamp GIT automatiza toda essa cadeia — sem ferramentas de CLI, sem comandos OpenTimestamps, sem mudanças no fluxo de trabalho dos desenvolvedores. Para um contexto mais aprofundado, veja como provar anterioridade para uma ideia de software sem uma patente e se um carimbo de data/hora em blockchain é evidência legalmente válida.
Pré-requisitos: O Que Você Precisa Antes de Ancorar Seu Primeiro Commit
- Um repositório no GitHub (público ou privado) onde você tem direitos de administrador, para que possa instalar o GitHub App do Timestamp GIT.
- Uma conta no Timestamp GIT — gratuita para open source / repositórios públicos, Pro Agency ($49/mês) para repositórios privados, Enterprise ZK ($199/mês) para o modo GitHub Actions.
- Um repositório de destino para as provas. Pode ser um branch no mesmo repositório ou um repositório shadow separado. O modelo de permissões do GitHub exige pelo menos acesso somente leitura ao repositório de origem (não existe escopo “apenas hash de commit”), além de leitura e escrita no destino.
- Para o modo Enterprise ZK: um workflow do GitHub Actions e uma chave de API. Aqui só é necessário acesso de leitura e escrita ao repositório de destino — o repositório de origem não precisa de nenhum acesso de leitura.
- Para self-hosted: Docker e Docker Compose, além de uma licença de demonstração por tempo limitado da página de Licença Docker.
Nada é instalado nas máquinas dos desenvolvedores.
Passo a Passo: Torne Seu Histórico Git à Prova de Adulteração com o Timestamp GIT
Passo 1 — Instale o GitHub App e conecte o repositório
Instale o GitHub App do Timestamp GIT na sua organização e selecione os repositórios a monitorar. Conceda acesso somente leitura aos repositórios de origem e leitura e escrita ao destino (branch ou repositório shadow). O app registra webhooks e detecta novos commits automaticamente — não há nenhuma ação por commit da sua equipe.
No modo Standard, o app lê apenas o hash do commit HEAD de cada repositório monitorado. Ele nunca lê a árvore de trabalho, os diffs ou o conteúdo dos arquivos.
Passo 2 — (Opcional) Mude para o modo Enterprise ZK
Se até mesmo um hash de commit saindo da sua rede é demais, o modo Enterprise ZK substitui o caminho do webhook por uma GitHub Action curta que roda nos seus próprios runners. Ela envia apenas o hash — o serviço nunca recebe acesso de leitura ao repositório de origem.
name: Timestamp commit hash
on:
push:
jobs:
anchor:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
with:
fetch-depth: 0
- name: Push HEAD hash to Timestamp GIT
env:
TSGIT_API_KEY: ${{ secrets.TSGIT_API_KEY }}
run: |
HASH=$(git rev-parse HEAD)
# POST $HASH + repo metadata to the Timestamp GIT API.
# The workflow is generated for you by the Enterprise setup wizard
# at https://timestampgit.dev/enterprise/{phase}.
Essa é toda a superfície: um hash, uma requisição autenticada.
Passo 3 — Deixe o worker cron noturno fazer a ancoragem
Você não faz nada aqui. Todas as noites, um worker:
- Agrupa todos os hashes de commit pendentes da fila em memória.
- Constrói um manifesto
.txtpor repositório. - Constrói uma árvore de Merkle nativamente sobre o lote.
- Cria provas OpenTimestamps usando calendários OTS públicos.
- Ancora a raiz de Merkle na blockchain do Bitcoin.
O agrupamento é o ponto central — mil commits em cem repositórios custam uma única ancoragem.
Passo 4 — Colete os recibos .ots e os manifestos
Após a confirmação do Bitcoin, o manifesto e os arquivos de recibo .ots são enviados de volta ao seu branch de timestamps dedicado ou repositório shadow. A confirmação do Bitcoin normalmente leva cerca de 3 horas, então as provas chegam algumas horas após a execução noturna — não instantaneamente. Planeje suas expectativas de acordo, especialmente se você estiver demonstrando isso para compliance.
Passo 5 — Incorpore um selo de verificação
Pegue o snippet da sua página de repositório conectado (/connected/{user}/{repo}), que renderiza uma prévia ao vivo do Shields.io:
[](https://timestampgit.dev/status/acme/payments-service)
Qualquer pessoa que clicar chega ao dashboard público de status. Repositórios privados acrescentam um HMAC criptografado à URL — específico da instância — para que apenas visualizadores autorizados vejam os dados.
Passo 6 — (Alternativa) Self-host com Docker Compose
Para ambientes air-gapped ou de controle máximo, o mesmo pipeline roda como uma imagem Docker. Uma configuração Docker Compose de início rápido se parece com isto:
services:
timestampgit:
image: rue1401/timestampgit:prod
ports:
- "8080:8080"
volumes:
- ./data:/app/data
restart: unless-stopped
valkey:
image: valkey/valkey:8
restart: unless-stopped
docker compose pull
docker compose up -d
docker compose logs -f timestampgit
O app fica disponível em http://localhost:8080. Na primeira inicialização, um assistente de configuração orienta você a conectar seu GitHub App e configurar a instância. Coloque sua licença de demonstração da página de Licença Docker no lugar quando solicitado.
Como Confirmar Que Funcionou: Verificação e Trilhas de Auditoria
Quatro verificações, em ordem crescente de rigor:
1. O dashboard de status. Visite /status/{user}/{repo} para ver a longevidade das provas, a data da ancoragem mais antiga, a regularidade diária e os dados do bloco e da transação do Bitcoin por trás de cada lote. Um mapa de calor em calendário torna as lacunas óbvias — útil quando um auditor pergunta “isso foi contínuo?”
2. A página de verificação. /verification/{user}/{repo}/{date} orienta você pela cadeia de Merkle multinível passo a passo. Toda a computação acontece localmente no seu navegador: zero-knowledge, e ninguém vê o que você verifica. Esta é a página a abrir em uma reunião quando alguém questionar o carimbo de data/hora.
3. Exportações de auditoria. Obtenha registros estruturados para compliance:
# Full audit ledger as CSV
curl -O https://timestampgit.dev/api/audit/acme/payments-service
# PDF certificate for a specific anchored date
curl -OJ https://timestampgit.dev/api/report/acme/payments-service/2026-10-30
# Raw Merkle chain data for local verification
curl https://timestampgit.dev/api/verify/acme/payments-service/2026-10-30
4. Verificação independente. Como a prova depende apenas de SHA-256 e dos dados de blocos do Bitcoin, qualquer pessoa pode verificar um recibo .ots contra a blockchain com ferramentas padrão de verificação do OpenTimestamps — offline, sem o Timestamp GIT. Essa é a garantia de independência do fornecedor: se a empresa desaparecer amanhã, suas provas ainda serão verificáveis.
Solução de Problemas Comuns
- App instalado, mas nada é monitorado. Verifique novamente as permissões: somente leitura na origem, leitura e escrita no destino. O modo Enterprise ZK é a exceção — ele precisa apenas de leitura e escrita no destino e nenhum acesso de leitura à origem.
- Provas “sumidas” após um push. Elas não sumiram. A confirmação do Bitcoin leva várias horas e os arquivos de prova são gravados depois. Verifique a página de status para ancoragens pendentes antes de abrir um bug.
- O selo retorna 404 em um repositório privado. A URL inclui um HMAC criptografado específico da sua instância de servidor. Copie o link de
/api/badgeLink/{user}/{repo}em vez de construí-lo manualmente. - O contêiner self-hosted inicia, mas o assistente falha. Confirme que
./dataestá montado corretamente e é gravável, depois verifiquedocker compose logs -f timestampgit. A maioria das falhas na primeira execução é um problema de permissões ou de volume, não do app.
FAQ
Ainda posso reescrever o histórico do Git depois de usar o Timestamp GIT? Sim — você pode fazer rebase, amend ou force-push localmente. Mas os hashes de commit ancorados no Bitcoin permanecem imutáveis. Qualquer adulteração dos commits originais se torna evidente, porque os hashes ancorados no Bitcoin não corresponderão ao histórico alterado.
O Timestamp GIT tem acesso ao meu código-fonte? Não. No modo Standard, o GitHub App lê apenas o hash do commit HEAD. No modo Enterprise ZK, uma GitHub Action envia apenas o hash do commit para a API. Seu código-fonte nunca sai do seu ambiente.
O que acontece se o Timestamp GIT fechar as portas?
Suas provas são independentes do fornecedor. Os arquivos de recibo .ots mais os dados da blockchain do Bitcoin permitem que qualquer pessoa verifique o carimbo de data/hora offline usando ferramentas padrão do OpenTimestamps, sem depender do Timestamp GIT.
Quanto tempo leva para um commit ser ancorado?
Os commits são agrupados à noite. Após o lote ser ancorado, a confirmação do Bitcoin normalmente leva cerca de 3 horas, e os arquivos de prova são gravados algumas horas depois. Você encontrará os recibos .ots no branch de timestamps do seu repositório.
Conclusão
Seu Git log é um registro operacional, não uma evidência. Ele fica em infraestrutura que você controla, contém datas que você pode definir e pode ser reescrito por qualquer pessoa com direitos de push — o que é exatamente o motivo pelo qual os auditores o desconsideram. Ancorar hashes de commit no Bitcoin converte esse registro em algo fora do seu controle e fora da sua capacidade de alterar.
O Timestamp GIT faz isso sem pedir que seus desenvolvedores aprendam um protocolo: instale o GitHub App uma vez, deixe o worker noturno ancorar, incorpore o selo e guarde os recibos .ots e as exportações de auditoria para o dia em que você realmente precisar deles.
Próximo passo: instale o app no seu repositório mais crítico para o negócio hoje. A ancoragem mais antiga que você terá é a que você criar esta noite.
Posts relacionados
- Automatize a Proteção de PI para o Código da Sua Startup: Um Guia para Fundadores
- Um Carimbo de Data/Hora em Blockchain É Evidência Legalmente Válida?
- Timestamp GIT vs OpenTimestamps CLI: Qual Se Encaixa na Sua Equipe?