Zum Hauptinhalt springen
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

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

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

Das Prägen eines Datensatzes verifiziert nicht dessen Signatur. Mit derselben Originaldatei, verwenden Sie die CLI, um einen aktuellen Verbraucherdatensatz zu verifizieren:
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