
سجل شفافية سلسلة توريد البرمجيات
Rekór - كلمة يونانية تعني "سجل"
تتمثل أهداف Rekor في توفير سجل غير قابل للتغيير ومقاوم للتلاعب للبيانات الوصفية المُنشأة داخل سلسلة توريد مشاريع البرمجيات. سيمكّن Rekor صائني البرمجيات وأنظمة البناء من تسجيل البيانات الوصفية الموقّعة في سجل غير قابل للتغيير. يمكن للأطراف الأخرى بعد ذلك الاستعلام عن تلك البيانات الوصفية لتمكينها من اتخاذ قرارات مستنيرة بشأن الثقة وعدم الإنكار لدورة حياة الكائن. لمزيد من التفاصيل، قم بزيارة موقع sigstore.
يوفر مشروع Rekor خادمًا قائمًا على واجهة برمجة تطبيقات RESTful للتحقق وسجل شفافية للتخزين. يتوفر تطبيق CLI لإنشاء الإدخالات والتحقق منها، والاستعلام عن سجل الشفافية للحصول على إثبات الإدراج، والتحقق من سلامة سجل الشفافية أو استرداد الإدخالات إما بواسطة المفتاح العام أو الأثر.
يؤدي Rekor دور شفافية التوقيع في البنية التحتية لتوقيع البرمجيات الخاصة بـ sigstore. ومع ذلك، يمكن تشغيل Rekor بمفرده وهو مصمم ليكون قابلًا للتوسع للعمل مع مخططات بيان مختلفة وأدوات PKI مختلفة.
Rekor v1 في وضع الصيانة.
نعمل بنشاط على تطوير نسخة جديدة من Rekor مصممة لتكون سهلة الصيانة وأقل تكلفة في التشغيل. بناءً على التطوير النشط في نظام Certificate Transparency البيئي، سيُدعم Rekor v2 بـ سجل قائم على البلاطات وسيستخدم نسخة حديثة من Trillian، Trillian-Tessera.
تابع تقدمه على مستودع rekor-tiles، واعرف المزيد عن Rekor v2 في الاقتراح ووثيقة التصميم. مع اقترابنا من إصدار V2، نخطط لدمج قاعدة شيفرة rekor-tiles في هذا المستودع.
Rekor متاح رسميًا بشكل عام مع إصدار 1.0.0، ويتبع قواعد semver لاستقرار واجهة برمجة التطبيقات. وهذا يعني أن أحمال العمل الإنتاجية يمكنها الاعتماد على مثيل Rekor العام، الذي يمتلك دورة استدعاء على مدار الساعة طوال أيام الأسبوع تدعمه ويقدم هدف مستوى خدمة (SLO) للتوافر بنسبة 99.5% لنقاط نهاية واجهة برمجة التطبيقات التالية:
/api/v1/log/api/v1/log/publicKey/api/v1/log/proof/api/v1/log/entries/api/v1/log/entries/retrieveللحصول على بيانات وقت التشغيل على مثيل Rekor العام، راجع https://status.sigstore.dev.
يمكن العثور على مزيد من التفاصيل حول المثيل العام على docs.sigstore.dev.
حد حجم التصديق للتحميلات إلى المثيل العام هو 100KB. إذا كنت بحاجة إلى تحميل ملفات أكبر، فيرجى تشغيل مثيلك الخاص من Rekor. يمكنك العثور على تعليمات للقيام بذلك في وثائق التثبيت.
يرجى الاطلاع على صفحة التثبيت للحصول على تفاصيل حول كيفية تثبيت rekor CLI وإعداد / تشغيل خادم rekor
للحصول على أمثلة لتحميل التوقيعات لجميع الأنواع المدعومة إلى rekor، راجع وثائق الأنواع.
بدءًا من Rekor v1.6.0، يمكن التحقق من الملفات الثنائية للإصدارات وصور الحاويات باستخدام إما GitHub Artifact Attestations (واجهة سطر أوامر gh) أو مفتاح توقيع مخرجات الإصدار الخاص بـ Sigstore (artifact.pub مع cosign).
في الأوامر أدناه، استبدل <version> (مثل v1.6.0)، و<binary> (rekor-cli أو rekor-server)، و<os> (linux أو darwin)، و<arch> (amd64 أو arm64) بإصدار الإصدار والملف الثنائي والمنصة التي تتحقق منها.
gh)تحقق من ملف ثنائي للإصدار:
curl -sSfLO "https://github.com/sigstore/rekor/releases/download/<version>/<binary>-<os>-<arch>"
gh attestation verify "<binary>-<os>-<arch>" \
--repo sigstore/rekor \
--signer-workflow sigstore/rekor/.github/workflows/release.yml
تحقق من صورة حاوية:
gh attestation verify "oci://ghcr.io/sigstore/rekor/<binary>:<version>" \
--repo sigstore/rekor \
--signer-workflow sigstore/rekor/.github/workflows/build_container.yml \
--bundle-from-oci
cosign)استرجع artifact.pub من sigstore/root-signing أو باستخدام أدوات سطر الأوامر الخاصة بـ go-tuf:
go install github.com/theupdateframework/go-tuf/v2/examples/cli/tuf-client@latest
curl -sSfLo root.json https://raw.githubusercontent.com/sigstore/root-signing/main/metadata/root_history/10.root.json
tuf-client init --url https://tuf-repo-cdn.sigstore.dev -f root.json
tuf-client get --url https://tuf-repo-cdn.sigstore.dev -t https://tuf-repo-cdn.sigstore.dev/targets artifact.pub
cp tuf_download/artifact.pub ./artifact.pub
تحقق من ملف ثنائي لإصدار:
curl -sSfLO "https://github.com/sigstore/rekor/releases/download/<version>/<binary>-<os>-<arch>"
curl -sSfLO "https://github.com/sigstore/rekor/releases/download/<version>/<binary>-<os>-<arch>.sigstore.json"
cosign verify-blob \
--key artifact.pub \
--bundle "<binary>-<os>-<arch>.sigstore.json" \
"<binary>-<os>-<arch>"
تحقق من صورة حاوية:
cosign verify \
--key artifact.pub \
-a "GIT_VERSION=<version>" \
"ghcr.io/sigstore/rekor/<binary>:<version>"
يتيح Rekor بيانات وصفية مخصصة (والتي يسميها أنواعًا)، تخصيص النوع موضح هنا.
إذا كنت مهتمًا بالتكامل مع Rekor، فلدينا محرر OpenAPI swagger
إذا اكتشفت أي مشكلات أمنية، فيرجى الرجوع إلى عملية الأمان الخاصة بـ sigstore
نرحب بمساهمات من أي شخص، ونحن مهتمون بشكل خاص بالاستماع إلى مستخدمي Rekor.
بالإضافة إلى ملف README هذا، يحتوي هذا المجلد على الوثائق الإضافية التالية: