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

> سجل بصمات الملفات الخاصة من سير عمل GitHub وتحقق من بايتات الأثر الأصلي.

يقوم إجراء الحماية بتجزئة الملفات المحددة محليًا وإنشاء بصمة موقعة
السجلات باستخدام حساب مستهلك. لا يتم تحميل محتويات الملف. التوقيع
يربط بصمة بسجل؛ لا يثبت التأليف أو ملكية حقوق النشر،
أو ما إذا كان الوصف صحيحًا.

## قبل أن تبدأ

استخدم رمز حامل مستهلك مصرح به من حساب Truthlocks Verify الخاص بك. أ
مفتاح API للأعمال غير قابل للتبديل مع هذا الرمز المميز. قم بتخزين الرمز المميز في
سر GitHub للمستودع المسمى `TRUTHLOCK_TOKEN`. لا تعرضه لجهات غير موثوقة
طلبات السحب أو طباعتها في السجلات.

يقوم الإجراء بتثبيت واجهة سطر الأوامر `@truthlocks/protect@1.1.1` المثبتة مع Node.js 22.
ابدأ بسير عمل يتم تشغيله يدويًا ومصنف اختبار.

## بدء سريع

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

استبدل `artifacts/report.pdf` بملف موجود في مستودعك الذي تم سحبه.
لسير عمل الإصدار، قم ببناء الأداة قبل تشغيل هذا الإجراء. قم بتثبيت مراجعة
SHA الالتزام الكامل لسير عمل الإنتاج.

## المدخلات

| الإدخال | مطلوب | الافتراضي | المعنى |
| - | - | - | - |
| `token` | نعم | — | رمز حامل المستهلك المعتمد. |
| `files` | أحد الملفات/الدليل | — | أنماط مفصولة بمسافات، أو مصفوفة JSON للمسارات التي تحتوي على مسافات. |
| `directory` | أحد الملفات/الدليل | — | تحديد الملفات بشكل متكرر داخل مساحة العمل. |
| `category` | لا | `code` | تصنيف المحتوى. |
| `visibility` | لا | `private` | `private` أو صراحةً `public`. |
| `algorithm` | لا | `managed` | تتم إدارة توقيع المستهلك؛ يتم رفض القيم الأخرى. |
| `title-prefix` | لا | فارغ | نص يضاف إلى بداية عنوان كل ملف. |

الفئات المدعومة هي `code`، `research`، `design`، `media`، `dataset`،
`ai-output`، `writing`، `digital-art`، و `other`. استبعاد اختيار الدليل
`.git`، `node_modules`، والروابط الرمزية. يجب أن تبقى المدخلات داخل مساحة العمل.
تفشل الأنماط غير المتطابقة والتحديد الفارغ.

## المخرجات والتحقق

| الإخراج | المعنى |
| - | - |
| `attestation-ids` | معرفات مفصولة بفواصل للسجلات التي تم إنشاؤها. |
| `protection-count` | عدد الملفات التي تمت معالجتها بنجاح. |
| `badge-url` | عنوان URL لشارة السجل العام؛ فارغ للسجلات الخاصة. |

صك سجل لا يتحقق بحد ذاته من توقيعه. مع نفس الملف الأصلي،
استخدم CLI للتحقق من سجل المستهلك الحالي:

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

استبدل المعرف ومسار الملف. يعيد CLI بناء سجل-شخصي-v2 المحدد
حمولة موقعة من تجزئة الملف. يخرج بنجاح فقط عندما يكون المحقق
تُرجع `VALID` مع `signature_verified: true`. تفشل البايتات المتغيرة في التحقق.
طلب المعرف فقط هو `INCOMPLETE`؛ لا يمكنه إنشاء توقيع صالح.

يتم استبعاد السجلات الخاصة من محفظة المستهلك العامة وليس لديها
صفحات الشهادات/الشارات العامة. لا تنشر معرفاتهم أو تفترض الرؤية
العلامة تخفي جميع بيانات التحقق الوصفية عن شخص يعرف بالفعل معرفًا.

## الإخفاقات الجزئية وإعادة المحاولة

ينشئ كل ملف سجلًا بعيدًا منفصلاً. يتوقف الإجراء عند أول فشل
استدعاء CLI؛ قد توجد سجلات سابقة بالفعل. افحص تلك النتائج قبل إعادة التشغيل
دفعة، حيث قد يؤدي التكرار إلى إنشاء سجلات إضافية. لا يوجد كل شيء أو لا شيء
معاملة دفعة أو إعادة محاولة تغيير تلقائية.

## ذات صلة

* [Protect CLI: الإيصالات المحفوظة والتحقق من مساحة العمل](https://docs.truthlocks.com/ar/guides/protect-cli.md)
* [حماية المحتوى](https://docs.truthlocks.com/ar/guides/content-protection.md)


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