Timestamp GIT

← Todos los artículos

2026-11-20

Configura la protección de IP con una sola instalación de la GitHub App

Configura la protección de IP con una sola instalación de la GitHub App
timestamp git blockchain proof

Configura la protección de propiedad intelectual con una sola instalación de la GitHub App

No necesitas un presupuesto legal, una cadena de herramientas CLI ni cambiar la forma en que tu equipo escribe código para obtener una prueba criptográfica de que tu repositorio existía en un momento específico. Solo necesitas una instalación.

Esta guía recorre toda la configuración de una github app para la protección de propiedad intelectual: instala la GitHub App de Timestamp GIT, elige tus repositorios, deja que la automatización nocturna agrupe los hashes de tus commits y los ancle en Bitcoin, y luego confirma que la prueba es real. Cada paso a continuación es un clic, una configuración o un breve archivo de configuración. Ningún desarrollador de tu equipo escribe un comando nuevo, y ningún código fuente sale nunca de tu organización de GitHub.

Lo que obtienes al final: un recibo .ots inmutable por día, una página de estado pública respaldada por datos de bloques de Bitcoin, un badge en tu README y un certificado en CSV o PDF de auditoría que puedes entregar a un abogado o a un auditor.

Por qué una GitHub App es la vía más rápida a la protección de PI

La forma difícil de hacer esto es anclar los commits manualmente — ejecutando las herramientas de OpenTimestamps a mano y siguiendo las confirmaciones de Bitcoin para cada lote. Funciona, pero es propenso a errores, depende de que una persona se acuerde de hacerlo y se derrumba en el momento en que tienes cinco desarrolladores y cien commits al día.

La forma gestionada es una única instalación de la GitHub App. Timestamp GIT se apoya sobre las mismas primitivas criptográficas, pero oculta el protocolo detrás de la automatización:

  • Instala una vez. Sin CLI, sin herramientas locales, nada que instalar en las máquinas de los desarrolladores.
  • Detección automática. Cada nuevo commit en un repositorio monitorizado se detecta mediante webhooks.
  • Anclaje nocturno. Los hashes se agrupan a medianoche, se les aplica un árbol de Merkle y se anclan en Bitcoin a través de OpenTimestamps.
  • Entrega de vuelta a ti. Los manifiestos y los recibos .ots llegan a una rama dedicada o a un repositorio sombra separado.
  • Conocimiento cero. Solo se procesan los hashes de los commits. Tu código fuente nunca se lee, se copia ni se almacena.

Si quieres el contexto estratégico sobre por qué esto importa legalmente antes de empezar a hacer clic, lee Prove Prior Art Before You File: A Founder’s Guide. Este artículo se centra en la configuración.

Requisitos previos: qué necesitas antes de empezar

  • Una cuenta de GitHub con derechos de administrador sobre el repositorio — o la organización — que quieres proteger. No puedes instalar una GitHub App en un repositorio sobre el que solo tienes acceso de escritura.
  • Una cuenta de Timestamp GIT. El nivel Open Source es gratuito para repositorios públicos; los repositorios privados requieren un plan de pago.
  • Un modelo mental básico de Git. Deberías saber que un commit tiene un hash SHA-1 o SHA-256. Ese es el alcance de los conocimientos criptográficos necesarios.
  • Una decisión sobre dónde viven las pruebas. En el mismo repositorio en una rama dedicada, o en un repositorio sombra separado. Un repositorio sombra mantiene limpio tu repositorio principal, pero requiere un repositorio de destino al que puedas conceder acceso de escritura.
  • Opcional: Docker. Solo si planeas autoalojarlo más adelante — se trata en una sección posterior.

Paso 1: Instala la GitHub App de Timestamp GIT

  1. Ve a timestampgit.dev e inicia sesión con GitHub.
  2. Haz clic en Install GitHub App.
  3. Elige All repositories o Only select repositories, y luego selecciona los repositorios que quieres monitorizar.
  4. Revisa los permisos que GitHub te muestra. En el modo estándar, la app necesita:
    • Acceso de solo lectura a tus repositorios de origen — GitHub no ofrece acceso solo a los hashes de los commits, así que el acceso de lectura es el mínimo.
    • Acceso de lectura y escritura a un repositorio de destino donde se escriben las pruebas.
  5. Confirma. Llegas al panel con tus repositorios conectados listados.

Puedes revisar y cambiar la selección de repositorios en cualquier momento desde la página de configuración de la GitHub App; la app no requiere una reinstalación para detectar repositorios añadidos recientemente.

Paso 2: Configura los ajustes de tu repositorio

Selecciona el repositorio que acabas de conectar. Aquí importan dos decisiones:

¿A dónde van las pruebas? A una rama dedicada timestamps en el mismo repositorio, o a un repositorio sombra separado. Si vas a poner marca de tiempo a un repositorio que planeas abrir como código abierto más adelante, un repositorio sombra mantiene el historial de pruebas fuera del árbol público hasta que quieras que sea visible.

¿Cuándo se ejecuta el anclaje? Cada noche a medianoche es el valor predeterminado y la configuración recomendada — agrupar muchos commits en un solo árbol de Merkle es lo que hace que las pruebas diarias sean económicas y consistentes. Dejar el calendario como está casi siempre es la decisión correcta.

Luego copia el código de inserción de tu badge. Abre la página del repositorio conectado (/connected/{user}/{repo}) para ver una vista previa en vivo del badge de verificación de Shields.io y el Markdown exacto que debes pegar.

Una nota sobre privacidad: las URL de estado de los repositorios privados llevan un HMAC cifrado específico de la instancia de tu servidor, así que solo los usuarios autorizados pueden leer el estado de un repositorio privado. No elimines ese parámetro cuando copies una URL.

Guarda los ajustes. Los hashes de los commits empiezan a fluir a la cola de inmediato.

Paso 3: Deja que la automatización se ejecute

Aquí no hay nada que hacer excepto subir código. Entre bastidores:

  1. Detección de commits — la GitHub App ve los nuevos commits mediante webhooks.
  2. Cola de hashes — los hashes de los commits se acumulan en un almacén clave-valor en memoria para su agrupación.
  3. Trabajador cron de medianoche — un trabajador agrupa todos los hashes pendientes, escribe un archivo de manifiesto de texto por repositorio, construye un árbol de Merkle de forma nativa, genera pruebas de OpenTimestamps contra los calendarios públicos de OTS y ancla la raíz de Merkle en Bitcoin.
  4. Entrega de pruebas — el manifiesto y los archivos de recibo .ots se envían de vuelta a tu rama de timestamps o al repositorio sombra.

Reserva tiempo para la ventana de confirmación de Bitcoin. El lote se envía a medianoche, pero la inclusión en un bloque normalmente tarda alrededor de tres horas. En la práctica, las pruebas de un commit subido hoy están disponibles mañana por la mañana.

De nuevo sobre el punto de conocimiento cero, porque es lo que preguntan los auditores: el servicio solo maneja hashes de commits. Tu diff, tus archivos, tus secretos — nada de eso se transmite.

Paso 4: Añade el badge de verificación a tu README

Pega el fragmento de la página del repositorio conectado en tu README. Se parece más o menos a esto — usa la URL exacta que te da la app, no el marcador de posición:

<!-- Copy the real snippet from timestampgit.dev/connected/{user}/{repo} -->
[![Bitcoin-timestamped](BADGE_URL_FROM_TIMESTAMPGIT)](https://timestampgit.dev/status/your-user/your-repo)

Cualquiera que haga clic llega a la página de estado pública y puede volver a verificar la marca de tiempo desde el archivo .ots por sí mismo. Esa vía de verificación pública y accesible con un clic es lo que convierte una afirmación de propiedad en una evidencia que un tercero aceptará.

Cómo confirmar que funcionó

Dale una noche y luego revisa tres cosas.

1. La página de estado del repositorio. Abre /status/{user}/{repo}. Deberías ver la longevidad de las pruebas, la fecha del anclaje más antiguo, la regularidad diaria, los datos del bloque y la transacción de Bitcoin de cada anclaje, y un mapa de calor de calendario. Un hueco en el mapa de calor significa un día sin commits — no un fallo.

2. La API, si la quieres en un panel.

# Last anchored Bitcoin block
curl https://timestampgit.dev/api/statusLast/your-user/your-repo

# Total stamped commit count
curl https://timestampgit.dev/api/statusCount/your-user/your-repo

# Full audit ledger as CSV
curl -O https://timestampgit.dev/api/audit/your-user/your-repo

3. Un certificado PDF para una fecha específica. Descárgalo para cualquier día anclado:

curl -O https://timestampgit.dev/api/report/your-user/your-repo/2026-11-19

Para el recorrido completo de cómo es realmente la verificación de una cadena de Merkle paso a paso — todo calculado localmente en tu navegador — consulta How to Verify a Bitcoin Timestamp Proof for Your Code. La versión corta: el archivo .ots y el manifiesto son pruebas estándar de OpenTimestamps, verificables contra los datos de bloques de Bitcoin por cualquier herramienta compatible. Sin dependencia de proveedor, sin dependencia de que sigamos en el negocio.

Opcional: autoaloja con Docker para entornos aislados

Para un control máximo — entornos regulados, redes aisladas o equipos que quieren el servicio en su propia infraestructura — Timestamp GIT se distribuye como una imagen de Docker bajo una licencia de autoalojamiento.

Una configuración rápida de Docker Compose se ve así:

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. En el primer inicio, un asistente de configuración te guía para conectar tu GitHub App y configurar la instancia.

Para evaluarlo, solicita una licencia de demostración por tiempo limitado desde la página de licencia de Docker con tu nombre, empresa, correo electrónico y número de teléfono opcional; recibes un archivo de licencia para descargar. El autoalojamiento significa gestionar tu propia GitHub App y tu infraestructura, pero las garantías de conocimiento cero son idénticas.

Solución de problemas comunes de configuración

  • La instalación falla o los permisos parecen incorrectos. Necesitas derechos de administrador sobre el repositorio o la organización, y en el modo estándar también se debe conceder a la app acceso al repositorio de destino donde se escriben las pruebas. Un repositorio de destino ausente es la causa más común de “conectado pero no pasa nada”.
  • No hay pruebas después de 24 horas. Confirma que el repositorio está recibiendo commits realmente y que la app no fue pausada desde el lado de GitHub. Revisa la página de estado en busca de errores antes de presentar una incidencia — un repositorio inactivo no produce ningún manifiesto, lo cual es el comportamiento esperado.
  • El badge se muestra como una imagen rota. Vuelve a copiar la URL del badge desde la página del repositorio conectado. Para los repositorios privados, la URL debe incluir el HMAC cifrado; una URL recortada fallará.
  • El anclaje llega tarde. Los tiempos de bloque de Bitcoin varían. Una confirmación retrasada se ancla igualmente — una vez que el bloque existe, la prueba es inmutable. No hay que volver a ejecutar nada.
  • Las pruebas aparecen en un lugar inesperado. Comprueba si el repositorio está configurado para una rama en el mismo repositorio o para un repositorio sombra; cambiar de modo no reescribe las pruebas históricas.

Preguntas frecuentes

¿Necesito cambiar mi flujo de trabajo de Git para usar Timestamp GIT? No. Una vez instalada la GitHub App, detecta automáticamente los nuevos commits y los ancla cada noche. Los desarrolladores siguen usando Git como de costumbre — sin comandos ni herramientas nuevas que aprender.

¿Qué permisos de GitHub requiere Timestamp GIT? En el modo estándar, la app necesita acceso de solo lectura a tus repositorios de origen (para leer los hashes de los commits) y acceso de lectura y escritura a un repositorio de destino donde se almacenan las pruebas. El modo Enterprise ZK lo invierte con una GitHub Action que envía solo el hash del commit desde tu propia infraestructura, de modo que el servicio no necesita ningún acceso de lectura al repositorio de origen.

¿Cuánto tarda un commit en recibir una marca de tiempo en Bitcoin? Los hashes de los commits se agrupan y se anclan una vez al día a medianoche. Después de que el lote se envía a la cadena de bloques de Bitcoin a través de OpenTimestamps, la confirmación suele tardar alrededor de 3 horas — así que las pruebas normalmente están disponibles a la mañana siguiente.

¿Puedo verificar la prueba de marca de tiempo de forma independiente sin Timestamp GIT? Sí. El archivo de recibo .ots y el manifiesto son pruebas estándar de OpenTimestamps. Puedes verificarlos usando cualquier herramienta compatible con OpenTimestamps contra la cadena de bloques de Bitcoin, lo que garantiza la independencia del proveedor.

La instalación es todo el proyecto

Una instalación de la GitHub App, una selección de repositorio, una página de ajustes. Después de eso, la protección de PI se convierte en una propiedad de fondo de tu repositorio en lugar de una tarea trimestral: cada hash de commit agrupado cada noche, cada lote con raíz de Merkle en un bloque de Bitcoin, cada prueba escrita de vuelta a una rama que controlas y verificable por cualquiera con el archivo .ots.

Ese es todo el coste de adopción. Si has estado posponiendo la protección de arte previo porque parecía un proceso legal con un impuesto de ingeniería adjunto, empieza con el nivel Open Source gratuito en un repositorio público hoy y observa cómo llega la primera prueba mañana por la mañana — empieza aquí. Para los equipos que primero evalúan el panorama de herramientas, Best Tools to Timestamp Source Code for Auditors compara las opciones.

Entradas relacionadas

EU label: AI-generated content