العودة إلى التحديثات
New releaseAug 6, 2026

cosign v3.1.3

توقيع الكود والشفافية للحاويات والملفات الثنائية

مشاركة

Cosign logo

cosign

توقيع حاويات OCI (وغيرها من المخرجات) باستخدام Sigstore!

Go Report Card e2e-tests CII Best Practices OpenSSF Scorecard

يهدف Cosign إلى جعل التوقيعات بنية تحتية غير مرئية.

يدعم Cosign:

  • "التوقيع بدون مفاتيح" باستخدام سلطة شهادات Fulcio العامة الخيرية التابعة لـ Sigstore وسجل الشفافية Rekor (الافتراضي)
  • التوقيع باستخدام العتاد وKMS
  • التوقيع باستخدام زوج مفاتيح خاص/عام مشفّر مُولَّد بواسطة cosign
  • توقيع الحاويات والتحقق منها وتخزينها في سجل OCI.
  • إحضار البنية التحتية للمفاتيح العامة الخاصة بك (BYO PKI)

معلومات

يُطوَّر Cosign كجزء من مشروع sigstore. نستخدم أيضًا قناة Slack! انقر هنا للحصول على رابط الدعوة.

التثبيت

للتثبيت عبر Homebrew وArch وNix وGitHub Action وKubernetes، راجع وثائق التثبيت.

لتنزيلات Linux وmacOS وWindows الثنائية، راجع أصول إصدار GitHub.

🚨 إذا كنت تقوم بتنزيل إصدارات cosign من حاوية GCS الخاصة بنا - يُرجى الاطلاع على مزيد من المعلومات حول إشعار الإيقاف بتاريخ 31 يوليو 2023 🚨

تثبيت المطورين

إذا كان لديك Go 1.22+، يمكنك إعداد بيئة تطوير:

$ git clone https://github.com/sigstore/cosign
$ cd cosign
$ go install ./cmd/cosign
$ $(go env GOPATH)/bin/cosign

المساهمة

إذا كنت مهتمًا بالمساهمة في cosign، فيرجى قراءة وثائق المساهمة.

سيركز تطوير Cosign المستقبلي على الإصدار الرئيسي التالي الذي سيكون مبنيًا على sigstore-go. سيركز المشرفون على تطوير الميزات داخل sigstore-go. نقدّر المساهمات في sigstore-go، لا سيما تلك المتعلقة بالمفاتيح الخاصة بك والتوقيع. يرجى الاطلاع على متتبع المشكلات للعثور على مشكلات مناسبة للمبتدئين.

Cosign 2.x هو إصدار مستقر وسيستمر في تلقي تحديثات الميزات الدورية وإصلاحات الأخطاء. من المرجح أن تتم مراجعة طلبات السحب (PRs) الصغيرة في النطاق والحجم بسرعة.

لن يتم قبول طلبات السحب التي تعدّل واجهة برمجة التطبيقات (API) بشكل كبير أو تكسرها. قد يتم قبول طلبات السحب الكبيرة في الحجم ولكنها لا تُدخل تغييرات كاسرة، لكنها ستُعتبر ذات أولوية أقل من طلبات السحب في sigstore-go.

Dockerfile

إليك كيفية تثبيت واستخدام cosign داخل Dockerfile عبر صورة ghcr.io/sigstore/cosign/cosign:

FROM ghcr.io/sigstore/cosign/cosign:v2.4.1 as cosign-bin

# Source: https://github.com/chainguard-images/images/tree/main/images/static
FROM cgr.dev/chainguard/static:latest
COPY --from=cosign-bin /ko-app/cosign /usr/local/bin/cosign
ENTRYPOINT [ "cosign" ]

البدء السريع

يوضح هذا كيفية:

  • توقيع صورة حاوية باستخدام طريقة "التوقيع بلا مفتاح" الافتراضية القائمة على الهوية (راجع الوثائق لمزيد من المعلومات)
  • التحقق من صورة الحاوية
  • استكشاف تدفقات أوسع لتوقيع/التحقق من الكائنات الثنائية (blobs) بلا مفتاح في Sigstore Cosign Quickstart

توقيع حاوية وتخزين التوقيع في السجل (registry)

لاحظ أنه يجب عليك دائمًا توقيع الصور بناءً على بصمتها (digest) (@sha256:...) بدلاً من الوسم (tag) (:latest) لأنه بخلاف ذلك قد توقّع شيئًا لم تكن تنوي توقيعه!

 cosign sign $IMAGE

Generating ephemeral keys...
Retrieving signed certificate...

	Note that there may be personally identifiable information associated with this signed artifact.
	This may include the email address associated with the account with which you authenticate.
	This information will be used for signing this artifact and will be stored in public transparency logs and cannot be removed later.

By typing 'y', you attest that you grant (or have permission to grant) and agree to have this information stored permanently in transparency logs.
Are you sure you would like to continue? [y/N] y
Your browser will now be opened to:
https://oauth2.sigstore.dev/auth/auth?access_type=online&client_id=sigstore&code_challenge=OrXitVKUZm2lEWHVt1oQWR4HZvn0rSlKhLcltglYxCY&code_challenge_method=S256&nonce=2KvOWeTFxYfxyzHtssvlIXmY6Jk&redirect_uri=http%3A%2F%2Flocalhost%3A57102%2Fauth%2Fcallback&response_type=code&scope=openid+email&state=2KvOWfbQJ1caqScgjwibzK2qJmb
Successfully verified SCT...
tlog entry created with index: 12086900
Pushing signature to: $IMAGE

سيطلب منك Cosign المصادقة عبر OIDC، حيث ستسجّل الدخول باستخدام عنوان بريدك الإلكتروني. تحت الغطاء، سيطلب cosign شهادة توقيع رمز من سلطة شهادات Fulcio. سيتطابق موضوع الشهادة مع عنوان البريد الإلكتروني الذي سجّلت الدخول به. سيقوم Cosign بعد ذلك بتخزين التوقيع والشهادة في سجل الشفافية Rekor، ورفع التوقيع إلى سجل OCI إلى جانب الصورة التي توقّعها.

التحقق من حاوية

للتحقق من الصورة، ستحتاج إلى تمرير موضوع الشهادة المتوقع ومُصدِر الشهادة عبر العلامتين --certificate-identity و--certificate-oidc-issuer:

cosign verify $IMAGE --certificate-identity=$IDENTITY --certificate-oidc-issuer=$OIDC_ISSUER

يمكنك أيضًا تمرير تعبير نمطي (regex) لعلامتي هوية الشهادة ومُصدرها، --certificate-identity-regexp و--certificate-oidc-issuer-regexp.

التحقق من حاوية مقابل مفتاح عام

يُرجع هذا الأمر القيمة 0 إذا تم العثور على توقيع واحد على الأقل بتنسيق cosign للصورة يطابق المفتاح العام. راجع الاستخدام التفصيلي أدناه للحصول على معلومات وتحذيرات بشأن تنسيقات التوقيع الأخرى.

تُطبع أي حمولات صالحة إلى stdout، بتنسيق json. لاحظ أن هذه الحمولات الموقّعة تتضمن بصمة الصورة الحاوية (digest)، وهي الطريقة التي يمكننا بها التأكد من أن هذه التوقيعات "المنفصلة" تغطي الصورة الصحيحة.

$ cosign verify --key cosign.pub $IMAGE_URI:1h
The following checks were performed on these signatures:
  - The cosign claims were validated
  - The signatures were verified against the specified public key
{"Critical":{"Identity":{"docker-reference":""},"Image":{"Docker-manifest-digest":"sha256:87ef60f558bad79beea6425a3b28989f01dd417164150ab3baab98dcbf04def8"},"Type":"cosign container image signature"},"Optional":null}

التحقق من حاوية في بيئة معزولة عن الشبكة

ملاحظة: تتطلب معظم سير عمل التحقق طلب مفاتيح الخدمة بشكل دوري من مستودع TUF. للتحقق المعزول عن الشبكة من التوقيعات باستخدام نسخة المصلحة العامة، ستحتاج إلى استرداد ملف الجذر الموثوق من مستودع TUF الإنتاجي. سيتغير محتوى هذا الملف دون إشعار. وبعدم استخدامك لـ TUF، ستحتاج إلى بناء آليتك الخاصة للحفاظ على نسختك المعزولة عن الشبكة من هذا الملف محدّثة.

يستطيع Cosign إجراء تحقق دون اتصال بالكامل عبر التحقق من حزمة Sigstore، والتي يرفقها cosign sign بالصورة في السجل. تحتوي الحزمة على مواد التحقق المنتجة أثناء التوقيع، مثل الشهادة، ومدخل سجل الشفافية مع إثبات إدراجه، وأي طابع زمني RFC 3161. باستخدام هذه المواد ونسخة محلية من الجذر الموثوق، لا يحتاج التحقق إلى أي وصول إلى الشبكة.

للتحقق من صورة في بيئة معزولة عن الشبكة، يجب أن تكون الصورة والتوقيعات متاحة محليًا على نظام الملفات.

يمكن حفظ صورة محليًا باستخدام cosign save (ملاحظة، يجب تنفيذ هذه الخطوة مع اتصال بالشبكة):

الفئات