> ## 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 Ação do GitHub

> Registre impressões digitais de arquivos privados de fluxos de trabalho do GitHub e verifique os bytes do artefato original.

A ação Proteger faz o hash dos arquivos selecionados localmente e cria uma impressão digital assinada
registros usando uma conta de consumidor. O conteúdo do arquivo não é carregado. A assinatura
vincula uma impressão digital a um registro; não estabelece autoria, propriedade de direitos autorais,
ou se uma descrição é verdadeira.

## Antes de começar

Use um token de portador de consumidor autorizado da sua conta Truthlocks Verify. Um
chave de API de negócios não é intercambiável com esse token. Armazene o token em um
Segredo do repositório GitHub chamado `TRUTHLOCK_TOKEN`. Não o exponha a não confiáveis
pull requests ou imprimi-lo em logs.

A ação instala o CLI `@truthlocks/protect@1.1.1` fixado com Node.js 22.
Comece com um fluxo de trabalho acionado manualmente e um artefato de teste rotulado.

## Início 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)"
```

Substitua `artifacts/report.pdf` por um ficheiro existente no seu repositório verificado.
Para fluxos de trabalho de lançamento, construa o artefato antes de executar esta ação. Fixe um revisado
SHA de commit completo para fluxos de trabalho de produção.

## Entradas

| Entrada | Obrigatório | Padrão | Significado |
| - | - | - | - |
| `token` | Sim | — | Token de portador de consumidor autorizado. |
| `files` | Um dos arquivos/diretório | — | Padrões separados por espaço, ou um array JSON para caminhos contendo espaços. |
| `directory` | Um dos arquivos/diretório | — | Selecionar arquivos recursivamente dentro do espaço de trabalho. |
| `category` | Não | `code` | Classificação de conteúdo. |
| `visibility` | Não | `private` | `private` ou explicitamente `public`. |
| `algorithm` | Não | `managed` | A assinatura do consumidor é gerenciada; outros valores são rejeitados. |
| `title-prefix` | Não | Vazio | Texto prefixado ao título de cada arquivo. |

As categorias suportadas são `code`, `research`, `design`, `media`, `dataset`,
`ai-output`, `writing`, `digital-art` e `other`. A seleção de diretórios exclui
`.git`, `node_modules` e symlinks. As entradas devem permanecer dentro do espaço de trabalho.
Padrões não correspondentes e uma seleção vazia falham.

## Saídas e verificação

| Saída | Significado |
| - | - |
| `attestation-ids` | IDs separados por vírgulas para os registos criados. |
| `protection-count` | Número de arquivos processados com sucesso. |
| `badge-url` | URL do selo de registro público; vazio para registros privados. |

A emissão de um registro não verifica sua assinatura. Com o mesmo arquivo original,
use a CLI para verificar um registro de consumidor atual:

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

Substitua o ID e o caminho do ficheiro. O CLI reconstrói o personal-record-v2 definido
carga útil assinada a partir do hash do arquivo. Ele só é encerrado com sucesso quando o verificador
retorna `VALID` com `signature_verified: true`. Bytes alterados falham na verificação.
Uma solicitação somente por ID é `INCOMPLETE`; ela não pode estabelecer uma assinatura válida.

Registros privados são excluídos do portfólio público do consumidor e não possuem
páginas públicas de certificados/selos. Não publique seus IDs nem presuma a visibilidade
flag oculta todos os metadados de verificação de alguém que já conhece um ID.

## Falhas parciais e novas tentativas

Cada arquivo cria um registro remoto separado. A ação para na primeira falha
Chamada CLI; registros anteriores já podem existir. Inspecione esses resultados antes de executar novamente
um lote, já que uma repetição pode criar registros adicionais. Não há tudo ou nada
transação em lote ou nova tentativa automática de mutação.

## Relacionado

* [Proteger CLI: recibos salvos e verificação de espaço de trabalho](https://docs.truthlocks.com/pt/guides/protect-cli.md)
* [Proteção de conteúdo](https://docs.truthlocks.com/pt/guides/content-protection.md)


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