> ## 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.

# GitHub-Aktion schützen

> Zeichnen Sie private Dateifingerabdrücke aus GitHub-Workflows auf und verifizieren Sie die ursprünglichen Artefakt-Bytes.

Die Protect-Aktion hasht ausgewählte Dateien lokal und erstellt einen signierten Fingerabdruck
Datensätze mit einem Verbraucherkonto. Dateiinhalte werden nicht hochgeladen. Die Signatur
bindet einen Fingerabdruck an einen Datensatz; es begründet keine Urheberschaft, Urheberrechtseigentum,
oder ob eine Beschreibung wahr ist.

## Bevor Sie beginnen

Verwenden Sie ein autorisiertes Consumer-Bearer-Token von Ihrem Truthlocks Verify-Konto. Ein
Geschäfts-API-Schlüssel ist nicht mit diesem Token austauschbar. Speichern Sie das Token in einem
GitHub-Repository-Geheimnis namens `TRUTHLOCK_TOKEN`. Nicht an Unbefugte weitergeben
Pull-Requests oder drucken Sie es in Protokollen aus.

Die Aktion installiert die angeheftete `@truthlocks/protect@1.1.1` CLI mit Node.js 22.
Beginnen Sie mit einem manuell ausgelösten Workflow und einem gekennzeichneten Testartefakt.

## Schnellstart

```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)"
```

Ersetzen Sie `artifacts/report.pdf` durch eine vorhandene Datei in Ihrem ausgecheckten Repository.
Für Release-Workflows erstellen Sie das Artefakt, bevor Sie diese Aktion ausführen. Pinnen Sie eine überprüfte
vollständiger Commit-SHA für Produktions-Workflows.

## Eingaben

| Eingabe | Erforderlich | Standard | Bedeutung |
| - | - | - | - |
| `token` | Ja | — | Autorisierter Consumer-Bearer-Token. |
| `files` | Eine von Dateien/Verzeichnis | — | Leerzeichengetrennte Muster oder ein JSON-Array für Pfade, die Leerzeichen enthalten. |
| `directory` | Eine von Dateien/Verzeichnis | — | Dateien innerhalb des Arbeitsbereichs rekursiv auswählen. |
| `category` | Nein | `code` | Inhaltsklassifizierung. |
| `visibility` | Nein | `private` | `private` oder explizit `public`. |
| `algorithm` | Nein | `managed` | Die Verbrauchersignierung wird verwaltet; andere Werte werden abgelehnt. |
| `title-prefix` | Nein | Leer | Text, der jedem Dateititel vorangestellt wird. |

Unterstützte Kategorien sind `code`, `research`, `design`, `media`, `dataset`,
`ai-output`, `writing`, `digital-art` und `other`. Die Verzeichnisauswahl schließt aus
`.git`, `node_modules` und Symlinks. Eingaben müssen innerhalb des Arbeitsbereichs bleiben.
Nicht übereinstimmende Muster und eine leere Auswahl schlagen fehl.

## Ausgaben und Verifizierung

| Ausgabe | Bedeutung |
| - | - |
| `attestation-ids` | Kommagetrennte IDs für die erstellten Datensätze. |
| `protection-count` | Anzahl der erfolgreich verarbeiteten Dateien. |
| `badge-url` | URL des öffentlichen Datensatz-Badges; leer für private Datensätze. |

Das Prägen eines Datensatzes verifiziert nicht dessen Signatur. Mit derselben Originaldatei,
verwenden Sie die CLI, um einen aktuellen Verbraucherdatensatz zu verifizieren:

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

Ersetzen Sie die ID und den Dateipfad. Die CLI rekonstruiert den definierten Personal-Record-v2
signierte Nutzlast aus dem Dateihash. Es wird nur dann erfolgreich beendet, wenn der Verifizierer
gibt `VALID` mit `signature_verified: true` zurück. Geänderte Bytes schlagen die Verifizierung fehl.
Eine reine ID-Anfrage ist `INCOMPLETE`; sie kann keine gültige Signatur herstellen.

Private Datensätze sind vom öffentlichen Verbraucherportfolio ausgeschlossen und haben keine
öffentliche Zertifikats-/Badge-Seiten. Veröffentlichen Sie deren IDs nicht und gehen Sie nicht von der Sichtbarkeit aus
Flag blendet alle Verifizierungsmetadaten vor jemandem aus, der bereits eine ID kennt.

## Teilweise Fehler und Wiederholungsversuche

Jede Datei erstellt einen separaten Remote-Datensatz. Die Aktion stoppt beim ersten fehlgeschlagenen
CLI-Aufruf; frühere Datensätze können bereits existieren. Überprüfen Sie diese Ergebnisse, bevor Sie den Vorgang erneut ausführen
einen Batch, da eine Wiederholung zusätzliche Datensätze erstellen kann. Es gibt keine Alles-oder-Nichts-
Batch-Transaktion oder automatische Mutationswiederholung.

## Verwandt

* [Protect CLI: gespeicherte Belege und Arbeitsbereichsverifizierung](https://docs.truthlocks.com/de/guides/protect-cli.md)
* [Inhaltsschutz](https://docs.truthlocks.com/de/guides/content-protection.md)


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