Por qué tu registro de Git no es una prueba, y cómo hacerlo a prueba de manipulaciones
Hazte una pregunta concreta: si un abogado, un auditor o el letrado de un troll de patentes te pidiera demostrar que un commit concreto existió en una fecha determinada, ¿qué le entregarías exactamente?
¿Una captura de pantalla de git log? ¿Una exportación de tu actividad de GitHub? Ambas se descartan con facilidad. Si quieres una prueba real de que el historial de Git no ha sido manipulado con Bitcoin, la respuesta no es una mejor exportación, sino una marca de tiempo que nadie, ni siquiera tú, pueda retrodatar o alterar. Esta guía explica los mecanismos por los que tu registro falla como evidencia y, después, los pasos exactos para hacerlo a prueba de manipulaciones, con la GitHub App haciendo el trabajo durante la noche.
Por qué tu registro de Git no es a prueba de manipulaciones (y qué significa para el cumplimiento)
Git usa direccionamiento por contenido, lo que lleva a la gente a pensar erróneamente que el historial es inmutable. No lo es. Cada hash de commit es un hash del árbol, el padre, el mensaje y los metadatos, pero la cadena de esos hashes vive en un repositorio de un servidor que no controlas. Tres cosas destruyen su valor probatorio:
- El historial es reescribible por diseño.
git rebase,git commit --amendy un force-push reemplazan los commits por hashes nuevos. Los objetos antiguos permanecen hasta la recolección de basura y después desaparecen. Un mantenedor con permisos de push puede reescribir meses de historial en un minuto. - Las fechas las declara el propio autor. Las marcas de tiempo de autor y committer son solo metadatos que puedes establecer. Cualquier registro interno que anote la hora es tan fiable como la máquina que lo escribió.
- El registro vive en la infraestructura de otro. Tu organización de GitHub, tu base de datos de CI, tu wiki interna: todo es editable y todo está bajo tu control. En una auditoría legal, eso los convierte en evidencia “de parte” y fácil de impugnar.
Ese último punto importa más de lo que los desarrolladores esperan. Un registro que podrías haber cambiado es un registro que la otra parte argumentará que cambiaste. La solución no es registrar más, sino externalizar la prueba a un sistema cuyo historial ninguna parte pueda reescribir.
Esa es la idea del estado del arte criptográfico: tomas las huellas que Git ya produce (los hashes de commit), las agrupas, vuelves a hacer un hash del lote en un árbol de Merkle y anclas la raíz en la blockchain de Bitcoin mediante el protocolo OpenTimestamps. Alguien puede reescribir tu repositorio, pero no puede reescribir un bloque de Bitcoin.
Timestamp GIT automatiza toda esta cadena: sin herramientas de CLI, sin comandos de OpenTimestamps, sin cambios en el flujo de trabajo de los desarrolladores. Para más contexto, consulta cómo demostrar el estado del arte de una idea de software sin patente y si una marca de tiempo en blockchain es evidencia legalmente válida.
Requisitos previos: qué necesitas antes de anclar tu primer commit
- Un repositorio de GitHub (público o privado) en el que tengas derechos de administrador, para poder instalar la GitHub App de Timestamp GIT.
- Una cuenta de Timestamp GIT: gratuita para repositorios de código abierto/públicos, Pro Agency (49 $/mes) para repositorios privados y Enterprise ZK (199 $/mes) para el modo GitHub Actions.
- Un repositorio de destino para las pruebas. Puede ser una rama del mismo repositorio o un repositorio sombra independiente. El modelo de permisos de GitHub exige al menos acceso de solo lectura al repositorio de origen (no existe un ámbito de “solo hash de commit”), además de lectura y escritura en el destino.
- Para el modo Enterprise ZK: un flujo de trabajo de GitHub Actions y una clave de API. Aquí solo se requiere acceso de lectura y escritura al repositorio de destino; el repositorio de origen no necesita ningún acceso de lectura.
- Para el autoalojamiento: Docker y Docker Compose, además de una licencia de demostración por tiempo limitado de la página de licencias de Docker.
No se instala nada en las máquinas de los desarrolladores.
Paso a paso: haz que tu historial de Git sea a prueba de manipulaciones con Timestamp GIT
Paso 1: instala la GitHub App y conecta el repositorio
Instala la GitHub App de Timestamp GIT en tu organización y selecciona los repositorios que quieres monitorizar. Concede acceso de solo lectura a los repositorios de origen y de lectura y escritura al destino (rama o repositorio sombra). La app registra webhooks y detecta los commits nuevos automáticamente: tu equipo no tiene que hacer nada por cada commit.
En el modo Standard, la app solo lee el hash del commit HEAD de cada repositorio monitorizado. Nunca lee el árbol de trabajo, los diffs ni el contenido de los archivos.
Paso 2: (opcional) cambia al modo Enterprise ZK
Si incluso que un hash de commit salga de tu red es demasiado, el modo Enterprise ZK sustituye la ruta del webhook por una breve GitHub Action que se ejecuta en tus propios runners. Solo envía el hash: el servicio nunca obtiene acceso de lectura al repositorio de origen.
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}.
Esa es toda la superficie: un hash, una petición autenticada.
Paso 3: deja que el worker cron nocturno haga el anclaje
Aquí no haces nada. Cada noche, un worker:
- Agrupa todos los hashes de commit pendientes de la cola en memoria.
- Construye un manifiesto
.txtpor repositorio. - Construye un árbol de Merkle nativo sobre el lote.
- Crea pruebas de OpenTimestamps usando los calendarios públicos de OTS.
- Ancla la raíz de Merkle en la blockchain de Bitcoin.
El agrupamiento es la clave: mil commits en cien repositorios cuestan un solo anclaje.
Paso 4: recoge los recibos .ots y los manifiestos
Tras la confirmación de Bitcoin, los archivos de manifiesto y de recibo .ots se envían de vuelta a tu rama de marcas de tiempo dedicada o al repositorio sombra. La confirmación de Bitcoin suele tardar unas 3 horas, así que las pruebas llegan unas horas después de la ejecución nocturna, no al instante. Ajusta tus expectativas en consecuencia, sobre todo si se lo vas a mostrar a cumplimiento.
Paso 5: inserta una insignia de verificación
Coge el fragmento de la página de tu repositorio conectado (/connected/{user}/{repo}), que muestra una vista previa en vivo de Shields.io:
[](https://timestampgit.dev/status/acme/payments-service)
Quien haga clic llegará al panel de estado público. Los repositorios privados añaden a la URL un HMAC cifrado, específico de cada instancia, para que solo los visores autorizados vean los datos.
Paso 6: (alternativa) autoalójalo con Docker Compose
Para entornos aislados o de máximo control, el mismo pipeline se ejecuta como imagen de Docker. Una configuración rápida de Docker Compose tiene este aspecto:
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
La app está disponible en http://localhost:8080. En el primer arranque, un asistente de configuración te guía para conectar tu GitHub App y configurar la instancia. Coloca tu licencia de demostración de la página de licencias de Docker cuando se te solicite.
Cómo confirmar que funcionó: verificación y auditoría
Cuatro comprobaciones, en orden creciente de rigor:
1. El panel de estado. Visita /status/{user}/{repo} para ver la longevidad de las pruebas, la fecha del anclaje más antiguo, la regularidad diaria y los datos del bloque y la transacción de Bitcoin de cada lote. Un mapa de calor tipo calendario deja los huecos a la vista, algo útil cuando un auditor pregunta “¿fue esto continuo?”.
2. La página de verificación. /verification/{user}/{repo}/{date} te guía paso a paso por la cadena de Merkle multinivel. Todo el cálculo ocurre localmente en tu navegador: conocimiento cero, y nadie ve lo que verificas. Esta es la página que abrir en una reunión cuando alguien cuestione la marca de tiempo.
3. Exportaciones de auditoría. Obtén registros estructurados para cumplimiento:
# 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. Verificación independiente. Como la prueba depende solo de SHA-256 y de los datos de los bloques de Bitcoin, cualquiera puede verificar un recibo .ots contra la blockchain con las herramientas estándar de verificación de OpenTimestamps, sin conexión y sin Timestamp GIT. Esa es la garantía de independencia del proveedor: si la empresa desaparece mañana, tus pruebas siguen verificándose.
Solución de problemas habituales
- La app está instalada pero no se monitoriza nada. Revisa los permisos: solo lectura en el origen, lectura y escritura en el destino. El modo Enterprise ZK es la excepción: solo necesita lectura y escritura en el destino y ningún acceso de lectura al origen.
- Las pruebas “faltan” tras un push. No faltan. La confirmación de Bitcoin tarda varias horas y los archivos de prueba se escriben después. Consulta la página de estado para ver los anclajes pendientes antes de abrir un bug.
- La insignia devuelve 404 en un repositorio privado. La URL incluye un HMAC cifrado específico de tu instancia de servidor. Copia el enlace desde
/api/badgeLink/{user}/{repo}en lugar de construirlo a mano. - El contenedor autoalojado arranca pero el asistente falla. Confirma que
./dataestá montado correctamente y tiene permisos de escritura, y luego revisadocker compose logs -f timestampgit. La mayoría de los fallos del primer arranque son un problema de permisos o de volumen, no de la app.
Preguntas frecuentes
¿Puedo seguir reescribiendo el historial de Git después de usar Timestamp GIT? Sí: puedes hacer rebase, amend o force-push en local. Pero los hashes de commit anclados en Bitcoin siguen siendo inmutables. Cualquier manipulación de los commits originales se hace evidente, porque los hashes anclados en Bitcoin no coincidirán con el historial alterado.
¿Timestamp GIT tiene acceso a mi código fuente? No. En el modo Standard, la GitHub App solo lee el hash del commit HEAD. En el modo Enterprise ZK, una GitHub Action solo envía el hash del commit a la API. Tu código fuente nunca sale de tu entorno.
¿Qué pasa si Timestamp GIT cierra el negocio?
Tus pruebas son independientes del proveedor. Los archivos de recibo .ots junto con los datos de la blockchain de Bitcoin permiten a cualquiera verificar la marca de tiempo sin conexión con las herramientas estándar de OpenTimestamps, sin depender de Timestamp GIT.
¿Cuánto tarda un commit en anclarse?
Los commits se agrupan cada noche. Una vez anclado el lote, la confirmación de Bitcoin suele tardar unas 3 horas, y los archivos de prueba se escriben unas horas después. Encontrarás los recibos .ots en la rama de marcas de tiempo de tu repositorio.
Conclusión
Tu registro de Git es un registro operativo, no una prueba. Está en infraestructura que controlas, contiene fechas que puedes establecer y puede reescribirlo cualquiera con permisos de push, que es exactamente por lo que los auditores lo descartan. Anclar los hashes de commit en Bitcoin convierte ese registro en algo fuera de tu control y fuera de tu capacidad de alterarlo.
Timestamp GIT lo hace sin pedir a tus desarrolladores que aprendan un protocolo: instala la GitHub App una vez, deja que el worker nocturno haga el anclaje, inserta la insignia y guarda los recibos .ots y las exportaciones de auditoría para el día en que de verdad los necesites.
Siguiente paso: instala la app hoy en tu repositorio más crítico para el negocio. El anclaje más antiguo que tendrás nunca es el que creas esta noche.
Entradas relacionadas
- Automatiza la protección de la propiedad intelectual del código de tu startup: guía para fundadores
- ¿Es una marca de tiempo en blockchain evidencia legalmente válida?
- Timestamp GIT frente a la CLI de OpenTimestamps: ¿cuál encaja con tu equipo?