Timestamp GIT

← Todos los artículos

2026-11-07

Automatiza el sellado de tiempo de commits de Git con una GitHub App

Automatiza el sellado de tiempo de commits de Git con una GitHub App
timestamp git blockchain proof

Automatiza el sellado de tiempo de los commits de Git con una GitHub App

Has decidido que tus commits merecen una prueba criptográfica de existencia. Bien. Ahora la única pregunta que importa a nivel operativo es esta: ¿esa prueba ocurre cuando te acuerdas, o sucede cada noche tanto si alguien se acuerda como si no?

La primera versión de cualquier proceso de sellado de tiempo es manual. Alguien del equipo escribe un script, lo ejecuta antes de un release, guarda un archivo en algún sitio y se siente razonablemente protegido. Seis semanas después, esa persona está de vacaciones, el script está en un portátil que se reinstaló, y la rama de release nunca se selló. Peor aún, nadie se da cuenta, porque un repositorio con cobertura parcial de sellos de tiempo se ve exactamente igual que uno con cobertura total hasta que un auditor pregunta por una fecha concreta.

Este artículo trata sobre el camino de la automatización: una instalación, sin ritual por commit, sin herramientas en las máquinas de los desarrolladores. Cubriremos la configuración inicial, qué ocurre realmente entre un git push y un bloque de Bitcoin, cómo monitorizar ese pipeline y dónde puede fallar silenciosamente la automatización.

La trampa del sellado de tiempo manual (y por qué gana la automatización)

El sellado de tiempo manual tiene un modo de fallo predecible: escala con la disciplina, y la disciplina no escala entre equipos, repositorios y zonas horarias.

En concreto, el enfoque manual implica ejecutar un paso de CLI o un script a medida para cada commit que te importa — o peor, ensamblar a mano los datos subyacentes de la transacción de Bitcoin. Esa es la forma difícil, y se rompe en tres puntos:

  • Es por commit. Cien commits a la semana se convierten en cien oportunidades de saltarse el paso.
  • Depende del entorno. El script vive en la máquina de alguien, no en la historia del repositorio. Los nuevos empleados no lo tienen; CI no lo tiene por defecto.
  • No es verificable como política. Cumplimiento no puede saber si falta un sello de tiempo porque ese día no ocurrió nada o porque alguien se olvidó.

Para los desarrolladores, el requisito es simple: nada cambia en mi flujo de trabajo. Para cumplimiento, el requisito es igual de simple: cada commit en cada repositorio monitorizado está cubierto, y puedo demostrarlo.

Ese es el argumento a favor de una GitHub App como superficie de automatización en lugar de una CLI. La GitHub App de Timestamp GIT se instala una vez a nivel de organización y luego vigila cada commit en los repositorios que selecciones y los ancla a Bitcoin cada noche — mucho después de que todo el mundo se haya ido a casa.

Configuración única: instala la GitHub App y olvídate

La configuración es una sola pasada, hecha por un administrador en lugar de cada desarrollador.

  1. Instala la App en tu organización de GitHub o cuenta personal.
  2. Selecciona los repositorios a monitorizar. No hay archivo de configuración por repositorio, ni cambios en CI, ni instalación en la máquina del desarrollador.
  3. Concede permisos. El sistema de permisos de GitHub no ofrece un ámbito de “solo hash de commit”, así que la App necesita acceso de solo lectura a tus repositorios de código fuente y acceso de lectura y escritura al repositorio destino donde se escriben las pruebas. Ese destino de lectura y escritura es o bien una rama timestamps dedicada en el mismo repositorio o un repositorio sombra separado — tú decides.
  4. Listo. A partir de aquí, la detección se ejecuta mediante webhooks de GitHub y no se requiere nada más de tu equipo.

Si quieres el modelo de aislamiento más estricto, el modo Enterprise ZK sustituye la detección por webhooks por una GitHub Action de 12 líneas que se ejecuta en tu propia infraestructura. Esa Action envía solo el hash del commit a la API de Timestamp GIT. En este modo, el servicio no requiere ningún acceso de lectura a tus repositorios de código fuente — solo acceso de lectura y escritura al repositorio destino que recibe las pruebas. Eso sí, necesitas instalar la Action.

Autoalojamiento en un entorno aislado o de alta seguridad

Para el máximo control, Timestamp GIT se distribuye como imagen de Docker bajo una licencia 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

Levántalo y sigue los logs:

docker compose pull
docker compose up -d
docker compose logs -f timestampgit

La aplicación está disponible en http://localhost:8080 una vez que arranca. En el primer inicio, un asistente de configuración te guía para conectar tu GitHub App y configurar la instancia. La evaluación se ejecuta con una licencia de demostración por tiempo limitado, solicitada a través de la página de licencia de Docker con tu nombre, empresa, correo electrónico y, opcionalmente, un número de teléfono.

Dentro del pipeline automatizado: del commit al anclaje en Bitcoin

Una vez instalado, el pipeline no tiene nada de especial por diseño. Ese es el punto — debería ser aburrido.

1. Detección de commits. La GitHub App captura los nuevos commits mediante webhooks. En el modo Enterprise ZK, tu GitHub Action envía los hashes a la API en su lugar. En cualquier caso, solo se mueven hashes de commits.

2. Cola de hashes. Los hashes llegan a un almacén clave-valor en memoria y esperan al siguiente lote. Esto es deliberado: agrupar cientos de commits en un solo anclaje de Bitcoin es lo que hace que todo el asunto sea lo bastante barato como para ejecutarlo en cada repositorio que tengas.

3. Worker cron de medianoche. Cada noche un worker agrupa todos los hashes pendientes, escribe un archivo manifiesto por repositorio (.txt), construye un árbol de Merkle de forma nativa, crea pruebas de OpenTimestamps contra los calendarios públicos de OTS y ancla la raíz de Merkle en la blockchain de Bitcoin.

4. Entrega de pruebas. El manifiesto y los archivos de recibo .ots se envían de vuelta a tu repositorio — a una rama timestamps dedicada o a un repositorio sombra. La confirmación de Bitcoin suele tardar unas 3 horas, así que la escritura de pruebas normalmente se completa unas horas después de que empiece el lote.

La llamada a la API que hace el modo ZK tiene este aspecto (el segmento {hash} es el valor HMAC de la URL firmada, no un hash de commit):

curl -X POST \
  "https://timestampgit.dev/api/timestamp/acme/payments-api/proofs/<hmac>/<commit-sha>/<commit-id>"

Fíjate en lo que no hay en ese payload: ni diff, ni contenido de archivos, ni nombre de rama, ni identidad del autor más allá de lo que implica un ID de commit. La seguridad de conocimiento cero aquí no es una frase de marketing — el servicio nunca ve, copia ni almacena tu código fuente, solo el hash de Git.

Y fíjate en lo que no se requiere de tus desarrolladores: ningún comando, ningún hook, ningún flag. Hacen push como siempre. La prueba aparece a la mañana siguiente.

Monitorización y gestión de fallos: mantén tus pruebas fiables

La automatización que no puedes observar es solo esperanza con pasos extra. Hay tres niveles de visibilidad, y deberías usar todos ellos.

Paneles de estado públicos

Cada repositorio monitorizado tiene una página de estado en https://timestampgit.dev/status/{user}/{repo} que muestra la longevidad de las pruebas (hasta dónde se remonta la cobertura), la fecha del anclaje más antiguo, la regularidad diaria, los datos del bloque y la transacción de Bitcoin, y un mapa de calor de calendario. El mapa de calor es la forma más rápida de detectar un hueco: un solo día faltante destaca de inmediato.

Insignias para el README

Coge el widget embebible de https://timestampgit.dev/connected/{user}/{repo}, que te da una vista previa en vivo de Shields.io además de Markdown listo para copiar y pegar. La insignia enlaza a una página de verificación pública que cualquiera puede consultar — útil cuando quieres que un cliente o auditor confirme la cobertura sin crear una cuenta.

# Returns badge URLs and ready-to-paste markdown snippets
curl https://timestampgit.dev/api/badgeLink/acme/payments-api

Los repositorios privados también están cubiertos: sus URLs llevan un HMAC cifrado, específico de la instancia del servidor, de modo que solo los usuarios autorizados pueden leer el estado.

Monitorización programática y exportaciones de auditoría

Los endpoints públicos de estado están diseñados para que tu propia herramienta los consulte:

# Last anchored Bitcoin block info (JSON)
curl https://timestampgit.dev/api/statusLast/acme/payments-api

# Total committed / stamped commit count (JSON)
curl https://timestampgit.dev/api/statusCount/acme/payments-api

# Combined summary used by Shields.io
curl https://timestampgit.dev/api/statusSummary/acme/payments-api

Para informes de cumplimiento, descarga el libro de auditoría completo en CSV con GET /api/audit/{user}/{repo} y los certificados PDF por día con GET /api/report/{user}/{repo}/{date}.

Cuando falla una ejecución

Si una ejecución nocturna se retrasa o falla, los hashes pendientes permanecen en cola y pasan al siguiente lote — los commits no se pierden. En la práctica, el síntoma de un problema es un tramo plano en el mapa de calor de estado en lugar de datos perdidos. Vigílalo en dos sitios: docker compose logs -f timestampgit para instancias autoalojadas, y el panel para el SaaS.

Buenas prácticas para el sellado de tiempo automatizado de commits

La automatización elimina el coste por commit, así que el valor por defecto correcto cambia: la cobertura debe ser amplia, no seleccionada.

  • Monitoriza cada repositorio que contenga propiedad intelectual. Elegir a mano los repositorios “importantes” es una decisión manual disfrazada de automatización — y el repositorio que te saltas siempre resulta ser el que importa. El coste marginal de otro repositorio es un hash nocturno en un lote existente.
  • Usa el modo Enterprise ZK para bases de código sensibles. Si tu política dice que los propios hashes de commit no deben pasar por un tercero, la ruta de la GitHub Action mantiene todo excepto el hash dentro de tu perímetro. Para entornos totalmente aislados, la licencia autoalojada de Docker cubre lo mismo.
  • Exporta los libros de auditoría de forma programada. Un CSV en la misma carpeta que tus documentos legales es mejor que un inicio de sesión en un panel que olvidarás durante una disputa.
  • Haz commits pronto y a menudo en las ramas monitorizadas. Muchos commits pequeños te dan un rastro de pruebas más denso con fechas más defendibles que un único squash grande en el momento del release.
  • Evita reescribir el historial en ramas de las que dependes como prueba de autoría previa. Un force-push crea hashes nuevos; los antiguos siguen anclados, pero la correspondencia entre “este código” y “esta prueba” se vuelve más difícil de explicar a un abogado. Si debes reescribir, etiqueta primero el estado previo a la reescritura.
  • Mantén la rama de pruebas separada de tus ramas de código fuente. La rama timestamps o el repositorio sombra es salida generada — tratarla como de solo lectura evita fusiones accidentales en main.

Una frontera que conviene tener en cuenta: el agrupamiento por lotes más unas 3 horas de confirmación de Bitcoin significa que un commit hecho a las 17:00 no es demostrable a las 17:05. Si necesitas la prueba hoy, planifica en torno a la ventana nocturna en lugar de esperar liquidación instantánea.

Preguntas frecuentes

¿Los desarrolladores necesitan ejecutar algún comando o instalar herramientas para sellar los commits?

No. Una vez instalada la GitHub App, cada commit en un repositorio monitorizado se detecta automáticamente y se ancla a Bitcoin cada noche. Los desarrolladores siguen usando Git como siempre — sin CLI, sin pasos manuales.

¿Cuánto tiempo después de un commit está disponible la prueba de sellado de tiempo?

Los commits se agrupan y se anclan una vez por noche. Después de enviar el lote, la confirmación de Bitcoin suele tardar unas 3 horas, así que las pruebas normalmente están disponibles a la mañana siguiente.

¿Puedo verificar el sello de tiempo sin depender de Timestamp GIT?

Sí. Los archivos de recibo .ots y las pruebas de Merkle son independientes del proveedor — SHA-256 más datos de bloques de Bitcoin, sin formato propietario. Puedes descargarlos y comprobarlos contra la blockchain de Bitcoin con las herramientas estándar de OpenTimestamps, o usar la página de verificación en el navegador, que hace todos los cálculos localmente en tu navegador. Merece la pena leer por separado sobre esa verificación local: consulta Cómo verificar una prueba de sello de tiempo de Bitcoin en tu navegador.

¿Y si mi repositorio es privado o contiene código sensible?

Timestamp GIT nunca lee ni almacena tu código fuente — solo se procesan hashes de commits. Para un aislamiento más estricto, el modo Enterprise ZK tiene una GitHub Action que envía solo hashes desde tu propia infraestructura, o puedes autoalojarlo con Docker. Si estás sopesando las ventajas y desventajas frente a otros enfoques, Alternativas a Timestamp GIT: qué comparar primero cubre las dimensiones de comparación.

¿Y si uso varias organizaciones de GitHub?

Instala la App en cada organización y monitoriza los repositorios que necesites. Tu panel agrega todos los repositorios monitorizados en un solo lugar.

Conclusión

El valor de un sello de tiempo es inversamente proporcional a la atención que requiere. Una prueba que generas manualmente es una prueba que existe para los commits que recordaste — lo que, en una auditoría, se lee como un proceso inconsistente en lugar de uno protegido.

Instalar la GitHub App requiere una sola sesión de administrador. Después de eso, cada commit en un repositorio monitorizado se hashea, se agrupa, se le calcula la raíz de Merkle y se ancla en Bitcoin mientras duermes, con insignias para credibilidad pública, libros CSV para cumplimiento y recibos .ots que sobreviven a cualquier proveedor. Los desarrolladores no cambian nada.

¿Listo para dejar de hacerlo a mano? Instala la GitHub App para tu organización — gratis para repositorios públicos, con niveles Pro Agency y Enterprise ZK para repositorios privados y flujos de trabajo de solo hash.

Entradas relacionadas

EU label: AI-generated content