> ## Documentation Index
> Fetch the complete documentation index at: https://docs.truthlocks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Proteger acción de GitHub

> Registre las huellas digitales de archivos privados de los flujos de trabajo de GitHub y verifique los bytes del artefacto original.

La acción Proteger aplica hash a los archivos seleccionados localmente y crea una huella digital firmada
registros utilizando una cuenta de consumidor. El contenido del archivo no se carga. La firma
vincula una huella digital a un registro; no establece la autoría, la propiedad de los derechos de autor,
o si una descripción es verdadera.

## Antes de empezar

Utilice un token de portador de consumidor autorizado de su cuenta de Truthlocks Verify. Un
la clave API de negocio no es intercambiable con ese token. Almacene el token en un
Secreto del repositorio de GitHub llamado `TRUTHLOCK_TOKEN`. No lo exponga a personas no confiables
solicitudes de extracción o imprimirlas en los registros.

La acción instala la CLI `@truthlocks/protect@1.1.1` anclada con Node.js 22.
Comience con un flujo de trabajo activado manualmente y un artefacto de prueba etiquetado.

## Inicio rápido

```yaml theme={null}
# .github/workflows/protect.yml
name: Protect an artifact
on:
  workflow_dispatch:
permissions:
  contents: read
jobs:
  protect:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: truthlocks/truthlock/packages/protect-action@e9609a43a494f785984cac708cc123db17ff0310
        id: protect
        with:
          token: ${{ secrets.TRUTHLOCK_TOKEN }}
          files: '["artifacts/report.pdf"]'
          category: research
          visibility: private
          title-prefix: 'Release artifact - '
      - name: Report created record count
        env:
          RECORD_COUNT: ${{ steps.protect.outputs.protection-count }}
        run: echo "Created $RECORD_COUNT record(s)"
```

Reemplace `artifacts/report.pdf` con un archivo existente en su repositorio extraído.
Para flujos de trabajo de lanzamiento, compile el artefacto antes de ejecutar esta acción. Fije una revisión
SHA de confirmación completo para flujos de trabajo de producción.

## Entradas

| Entrada | Requerido | Predeterminado | Significado |
| - | - | - | - |
| `token` | Sí | — | Token de portador de consumidor autorizado. |
| `files` | Uno de archivos/directorio | — | Patrones separados por espacios, o un array JSON para rutas que contienen espacios. |
| `directory` | Uno de archivos/directorio | — | Selecciona archivos recursivamente dentro del espacio de trabajo. |
| `category` | No | `code` | Clasificación de contenido. |
| `visibility` | No | `private` | `private` o explícitamente `public`. |
| `algorithm` | No | `managed` | La firma del consumidor está gestionada; otros valores son rechazados. |
| `title-prefix` | No | Vacío | Texto antepuesto al título de cada archivo. |

Las categorías admitidas son `code`, `research`, `design`, `media`, `dataset`,
`ai-output`, `writing`, `digital-art` y `other`. La selección de directorio excluye
`.git`, `node_modules` y enlaces simbólicos. Las entradas deben permanecer dentro del espacio de trabajo.
Los patrones no coincidentes y una selección vacía fallan.

## Salidas y verificación

| Salida | Significado |
| - | - |
| `attestation-ids` | IDs separados por comas para los registros creados. |
| `protection-count` | Número de archivos procesados con éxito. |
| `badge-url` | URL de la insignia de registro público; vacía para registros privados. |

La acuñación de un registro no verifica por sí misma su firma. Con el mismo archivo original,
use la CLI para verificar un registro de consumidor actual:

```sh theme={null}
npx --yes --package @truthlocks/protect@1.1.1 truthlock-protect verify YOUR_ATTESTATION_UUID --personal-record --file ./artifacts/report.pdf --json
```

Reemplace la ID y la ruta del archivo. La CLI reconstruye el registro personal-v2 definido
carga útil firmada del hash del archivo. Solo sale con éxito cuando el verificador
devuelve `VALID` con `signature_verified: true`. Los bytes modificados fallan en la verificación.
Una solicitud solo por ID es `INCOMPLETE`; no puede establecer una firma válida.

Los registros privados están excluidos del portafolio público del consumidor y no tienen
páginas públicas de certificados/insignias. No publique sus ID ni asuma la visibilidad
la bandera oculta todos los metadatos de verificación de alguien que ya conoce una ID.

## Fallos parciales y reintentos

Cada archivo crea un registro remoto separado. La acción se detiene en el primer fallo
Llamada CLI; pueden existir registros anteriores. Inspeccione esos resultados antes de volver a ejecutar
un lote, ya que una repetición puede crear registros adicionales. No hay un todo o nada
transacción por lotes o reintento automático de mutación.

## Relacionado

* [Protect CLI: recibos guardados y verificación del espacio de trabajo](https://docs.truthlocks.com/es/guides/protect-cli.md)
* [Protección de contenido](https://docs.truthlocks.com/es/guides/content-protection.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.