Sellado de tiempo automático de commits de Git sin ninguna CLI
La mayoría de los equipos que quieren prueba de anterioridad criptográfica nunca la consiguen, y el motivo casi nunca es técnico. Es operativo. Un hábito de sellado de tiempo solo funciona si una persona se acuerda de ejecutar la herramienta en el commit correcto, en el momento correcto, y de guardar el recibo en algún lugar donde el auditor lo encuentre dieciocho meses después. Bajo la presión de los plazos, ese hábito es lo primero que muere.
Este artículo trata de eliminar el hábito por completo. No de “cómo ejecutar un comando de sellado de tiempo más a menudo”, sino de cómo hacer que cada commit de un repositorio monitorizado se ancle automáticamente a la blockchain de Bitcoin, cada noche, sin que nadie de tu equipo escriba un solo comando. Si estás evaluando si merece la pena aprender el protocolo en bruto frente a usar una GitHub App gestionada, cubrimos ese dilema por separado en OpenTimestamps vs Timestamp GIT: Manual Proofs or GitHub App?. Aquí asumimos que ya has decidido que quieres la automatización.
La trampa del sellado de tiempo manual (y por qué quieres salir de ella)
Imagina cómo se desarrolla en la práctica el sellado de tiempo manual:
- Alguien termina una rama de funcionalidad y se acuerda —normalmente a posteriori— de que ese commit debería llevar sello de tiempo.
- Ejecuta una herramienta, espera y recibe un archivo de recibo.
- El recibo se renombra, se suelta en una carpeta
proofs/, se hace commit, o peor aún, se envía por correo a un manager. - Nadie hace esto para los siguientes cuarenta commits porque el sprint se puso ajetreado.
La CLI en bruto de OpenTimestamps existe y es la forma difícil de hacer esto: es un camino orientado a expertos en el que tú te encargas del batching, de los archivos de prueba, de la interacción con el calendario y del sistema de archivo. Funciona. También depende de que una persona sea disciplinada para siempre, y no deja ninguna traza de auditoría que explique por qué el commit 4f9c1ab tiene una prueba y el commit 8d2e0f3 no.
El modo de fallo de cumplimiento es peor que el inconveniente. Un registro de anterioridad con huecos es un registro que un abogado puede desmontar. Si una contraparte pregunta “demuestra cómo era tu base de código el 14 de marzo” y tu respuesta es una hoja de cálculo más la memoria de un desarrollador, ya has perdido el planteamiento. Los procesos manuales también son difíciles de auditar: no hay un artefacto consistente, ni una cadencia regular, ni forma de que un revisor de cumplimiento confirme la cobertura sin pedir a los ingenieros que reconstruyan su propia historia.
La promesa de la automatización es distinta en naturaleza, no en grado: instala una vez y, desde ese momento, cada commit de un repositorio monitorizado se huella y se ancla cada noche. Sin CLI que aprender, sin recibos que archivar a mano, nada instalado en las máquinas de los desarrolladores. El registro de pruebas pasa a ser una propiedad del repositorio en lugar de una propiedad de la diligencia de alguien.
Configuración única: instala la GitHub App y olvídate
El camino principal es la GitHub App. La instalas en un repositorio o en toda la organización, y la configuración es genuinamente única: sin scripts por repositorio, sin paso de incorporación de desarrolladores.
Modo estándar (GitHub App). La App lee automáticamente el hash del commit HEAD de cada repositorio monitorizado. El modelo de permisos de GitHub no ofrece un ámbito de “solo hash de commit”, así que la App requiere al menos acceso de solo lectura al repositorio de origen. También necesita acceso de lectura y escritura al repositorio destino, porque ahí es donde se escriben las pruebas: una rama dedicada de timestamps, ya sea en el mismo repositorio que el origen o en un repositorio sombra separado.
Modo Enterprise ZK. Una GitHub Action de 12 líneas se ejecuta en tu propia infraestructura y envía solo el hash del commit a la API de Timestamp GIT. En este modo el servicio no necesita ningún acceso de lectura al repositorio de origen —solo acceso de lectura y escritura al repositorio destino para la entrega de pruebas— y tú instalas la Action en tu workflow. Elige este modo cuando el acceso de lectura al código fuente sea inviable por motivos de política, o cuando tu revisión de seguridad exija que los hashes se originen dentro de tu perímetro. Elige el modo estándar cuando quieras el mínimo absoluto de piezas móviles.
| Estándar (GitHub App) | Enterprise ZK (GitHub Action) | |
|---|---|---|
| Acceso al repo de origen | Solo lectura | Ninguno |
| Acceso al repo destino | Lectura y escritura | Lectura y escritura |
| Dónde se originan los hashes | La App | Tu runner de CI |
| Esfuerzo de configuración | Instalar la App | Instalar la App + añadir la Action |
En ambos modos, no se instala nada en las máquinas de los desarrolladores. Los ingenieros siguen haciendo commits exactamente como hoy, y todo el pipeline se ejecuta del lado del servidor. El servicio nunca ve, copia ni almacena tu código fuente: solo maneja hashes de commits.
Si necesitas ejecutar todo dentro de tu propia red, Timestamp GIT también está disponible como imagen Docker autoalojada. 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 aplicación está disponible en http://localhost:8080 tras el arranque, y un asistente de configuración de primer inicio te guía para conectar tu GitHub App y configurar la instancia. Puedes solicitar una licencia de demostración por tiempo limitado para evaluación desde la página de licencia de Docker. Profundizamos en el despliegue en Self-Host Git Timestamping With Docker Compose.
El pipeline automatizado: del commit al anclaje en Bitcoin
Una vez instalada la App, esto es lo que ocurre sin ti:
- Detección de commits. O bien la GitHub App recoge los nuevos commits mediante webhooks, o bien tu GitHub Action envía los hashes de commits a la API. Solo viajan hashes.
- Cola de hashes. Los hashes de commits llegan a un almacén clave-valor en memoria, esperando el lote nocturno.
- Worker cron de medianoche. Cada noche, un worker agrupa todos los hashes pendientes, escribe un archivo de texto manifiesto por repositorio, construye un árbol de Merkle de forma nativa, crea pruebas OpenTimestamps usando los calendarios públicos de OTS y ancla la raíz de Merkle en la blockchain de Bitcoin.
- Entrega de pruebas. El manifiesto y los archivos de recibo
.otsse envían de vuelta a tu repositorio —una rama dedicada de timestamps o un repositorio sombra— para que las pruebas vivan junto al código que describen.
Una nota práctica sobre los tiempos: la confirmación de Bitcoin tarda varias horas, normalmente alrededor de tres. Así que un commit hecho el martes acaba con una prueba finalizada el miércoles por la mañana, no el martes por la noche. Ese es el coste de anclar en un libro mayor público e inmutable, y es un coste que merece la pena pagar.
No tienes que fiarte de nada de esto. Cada repositorio monitorizado recibe un panel de estado público que muestra la longevidad de las pruebas, la fecha de anclaje más temprana, la regularidad diaria, los datos del bloque y la transacción de Bitcoin detrás de cada anclaje, y un mapa de calor de calendario que puedes revisar a simple vista en busca de huecos. La misma página ofrece certificados de auditoría en CSV y PDF descargables. La verificación en sí ocurre en /verification/{user}/{repo}/{date}, que recorre la cadena de Merkle multinivel paso a paso, y todo ese cálculo ocurre localmente en el navegador, así que nadie ve lo que verificas.
Para los README, hay insignias embebibles que muestran públicamente el estado de verificación, y cualquiera puede seguir el enlace de la insignia para verificar el sello de tiempo en el sitio o descargar el informe PDF.
Para conectar el estado a tus propios paneles, la API pública es deliberadamente aburrida:
# Last anchored Bitcoin block info
curl -s https://timestampgit.dev/api/statusLast/acme/payments-api
# Total committed/stamped commit count
curl -s https://timestampgit.dev/api/statusCount/acme/payments-api
# Combined summary (what the Shields.io badge consumes)
curl -s https://timestampgit.dev/api/statusSummary/acme/payments-api
Y cuando cumplimiento pida artefactos, no hagas clics por una interfaz a las 5 de la tarde de un viernes:
# Full audit ledger as CSV
curl -sL -o audit-acme-payments-api.csv \
https://timestampgit.dev/api/audit/acme/payments-api
# PDF certificate for a specific day
curl -sL -o certificate-2026-11-14.pdf \
https://timestampgit.dev/api/report/acme/payments-api/2026-11-14
Las URLs de las insignias y el markdown listo para pegar vienen de /api/badgeLink/{user}/{repo} (autenticado). Para repositorios privados, las URLs de estado llevan un HMAC cifrado específico de la instancia de tu servidor, así que solo los usuarios autorizados pueden leerlas.
Monitorización y gestión de fallos: mantener la automatización honesta
La automatización que no vigilas es automatización que no sabes si funciona. Hay tres cosas sobre las que merece la pena crear un hábito.
Vigila los huecos, no los errores. Si una ejecución nocturna falla, el sistema reintenta, y los hashes pendientes permanecen en la cola en memoria en lugar de perderse. Pero la profundidad de la cola y los reintentos son internos; el mapa de calor de calendario de la página de estado es lo que realmente puedes leer. Un día que falta se ve de inmediato como un hueco en la cuadrícula.
Haz polling y alerta. Un pequeño trabajo programado que compare el último payload de estado con la instantánea de ayer detectará un pipeline atascado antes que un auditor:
import json, pathlib, requests
REPO = "acme/payments-api"
URL = f"https://timestampgit.dev/api/statusSummary/{REPO}"
snapshot = pathlib.Path("last-status.json")
r = requests.get(URL, timeout=30)
r.raise_for_status()
current = r.json()
previous = json.loads(snapshot.read_text()) if snapshot.exists() else None
if previous == current:
print("WARNING: status unchanged since last poll - check the repo status page")
else:
print("new anchor data:", json.dumps(current))
snapshot.write_text(json.dumps(current, indent=2))
Ejecútalo cada hora en CI, o a diario justo después de la ventana del cron, y dirige la advertencia a algún lugar donde los humanos miren.
Planifica las auditorías en torno al retraso de confirmación. Como el anclaje en Bitcoin tarda unas horas después de que se ejecute el worker cron, “sella con fecha y hora todo lo del lanzamiento de anoche, necesito el certificado en diez minutos” no es una petición que nadie pueda satisfacer. Da a cumplimiento una regla simple: las pruebas del día N están finalizadas para el día N+1.
La parte tranquilizadora de la gestión de fallos es lo que ocurre si el servicio no está disponible por completo. La verificación no nos necesita. El archivo de recibo .ots se puede comprobar sin conexión contra la blockchain de Bitcoin usando herramientas estándar de verificación de OpenTimestamps, porque la prueba depende solo de SHA-256 y de los datos de bloques de Bitcoin: sin tecnología propietaria, sin dependencia de proveedor. Aunque el proveedor desaparezca, la prueba se mantiene.
Buenas prácticas para el sellado de tiempo sin intervención
- Haz commits pronto y a menudo. Cada commit se huella automáticamente, así que un historial de commits denso produce un registro de anterioridad denso. Aplastar un mes de trabajo en un solo commit la noche antes de presentar una patente te da un anclaje en lugar de doscientos.
- Elige el modo que encaje con tu postura de seguridad. Si el acceso de lectura al repo de origen está descartado, usa el modo Enterprise ZK: solo los hashes de commits salen de tu infraestructura, enviados por la GitHub Action.
- Exporta los libros de auditoría y los certificados de forma programada. Los archivos de cumplimiento no deberían depender de que alguien recuerde un enlace de descarga. Llama a
/api/audit/{user}/{repo}mensualmente y a/api/report/{user}/{repo}/{date}para las fechas clave, y guarda los resultados donde vivan tus artefactos legales. - Pon la insignia en tu README. Más allá de la señal que envía a los clientes, una insignia de verificación en vivo es un disuasivo barato contra las afirmaciones de “lo desarrollamos de forma independiente”.
- Mantén las pruebas en su propia rama o repo sombra. Los commits diarios de pruebas que llegan a una rama dedicada de timestamps mantienen legible tu historial principal a la vez que mantienen la evidencia adjunta al mismo repositorio.
- Deja el proceso por escrito. Para un auditor, documenta quién instaló la GitHub App, qué repositorios están monitorizados y dónde vive la rama de timestamps. Las matemáticas son verificables; la cadena de custodia todavía necesita un párrafo.
Preguntas frecuentes
¿Tengo que instalar algún software en las máquinas de los desarrolladores?
No. Timestamp GIT es un servicio gestionado que se ejecuta por completo del lado del servidor mediante una GitHub App. Los desarrolladores solo hacen commits como de costumbre; no se requieren herramientas CLI ni instalaciones locales.
¿Cuánto tarda un commit en recibir sello de tiempo?
Los commits se agrupan cada noche y se anclan en Bitcoin. La confirmación de Bitcoin suele tardar unas 3 horas, así que las pruebas suelen estar disponibles unas horas después de que se ejecute el cron nocturno.
¿Puedo verificar las pruebas sin el servicio?
Sí. Recibes un archivo de recibo .ots inmutable que se puede verificar sin conexión usando herramientas estándar de OpenTimestamps contra la blockchain de Bitcoin. La prueba es independiente del proveedor y se basa solo en SHA-256 y en los datos de bloques de Bitcoin.
¿Y si uso un repositorio privado?
La GitHub App funciona con repositorios privados. Las URLs de estado para repos privados incluyen un HMAC cifrado específico de la instancia de tu servidor, así que solo los usuarios autorizados pueden ver el estado.
Conclusión
Todo el valor de un registro de anterioridad radica en que exista cuando lo necesitas, lo que significa que no puede depender de que una persona recuerde un comando. Instala la GitHub App una vez, y cada commit de los repositorios monitorizados se encola, se agrupa a medianoche, se le calcula la raíz de Merkle y se ancla en Bitcoin, con las pruebas enviadas de vuelta a una rama que tú controlas, un panel de estado que puedes consultar y exportaciones CSV y PDF para los auditores.
Si el motivo por el que no has sellado con fecha y hora tu código es que siempre parecía una tarea engorrosa, ese motivo acaba de desaparecer. Empieza en timestampgit.dev: conecta un repositorio, deja que se ejecute el primer lote nocturno y mira el mapa de calor de calendario a la mañana siguiente.
Entradas relacionadas
- OpenTimestamps vs Timestamp GIT: Manual Proofs or GitHub App?
- Self-Host Git Timestamping With Docker Compose
- Cryptographic Prior Art: The Startup Shield Against Patent Trolls