الاسم¶

PKCS7_decrypt - يعمي المحتوى من بنية PKCS#7 envelopedData

موجز¶

 #include <openssl/pkcs7.h>
 int PKCS7_decrypt(PKCS7 *p7, EVP_PKEY *pkey, X509 *cert, BIO *data, int flags);

الوصف¶

PKCS7_decrypt() يستخرج ويعمي المحتوى من بنية PKCS#7 envelopedData. pkey هو المفتاح الخاص للمستلم، cert هو شهادة المستلم، data هو BIO لكتابة المحتوى إليه، وflags هو مجموعة اختيارية من الأعلام.

ملاحظات¶

على الرغم من أن شهادة المستلم ليست ضرورية لتعمية البيانات، إلا أنها ضرورية لتحديد المستلم المناسب (من بين عدة مستلمين محتملين) في بنية PKCS#7.

عند استخدام بروتوكول نقل المفاتيح RSA PKCS#1 v1.5، ستستخدم الدالة EVP_PKEY_decrypt() المُستدعاة آلية رفض ضمنية. تُعيد هذه الدالة دائمًا نتيجة فك تشفير RSA للمفتاح المتناظر لتجنب هجوم مارفن. هذه النتيجة حتمية، وقد تتطابق مع التعمية المتناظر المُستخدم لتعمية المحتوى. في حال عدم توفير الشهادة، سيتم استخدام آخر معلومات مُستلم (RecipientInfo) التي أنتجت المفتاح ويبدو صالحًا. قد يؤدي ذلك إلى الحصول على محتوى غير صالح عند فك التعمية.

يمكن تمرير العلامات التالية في معامل flags.

إذا وُضع العلم PKCS7_TEXT، فتُحذف رؤوس MIME من النوع text/plain من المحتوى. إذا لم يكن المحتوى من النوع text/plain، فتُرجع رسالة خطأ.

القيم المُرجعة¶

PKCS7_decrypt() تُرجع إما 1 للنجاح أو 0 للفشل. يمكن الحصول على الخطأ من ERR_get_error(3)

العلل¶

يجب تمرير المفتاح الصحيح للمستلم والشهادة الصحيحة إلى PKCS7_decrypt(). سيكون من الأفضل لو استطاعت البحث عن المفتاح والشهادة الصحيحين من قاعدة بيانات.

انظر أيضًا¶

ERR_get_error(3), PKCS7_encrypt(3), EVP_PKEY_decrypt(3)

حقوق النسخ¶

حقوق النشر 2002-2026 لمؤلفي مشروع OpenSSL. جميع الحقوق محفوظة.

مرخص بموجب رخصة Apache 2.0 (المشار إليها فيما يلي بـ ”الرخصة“). لا يجوز لك استخدام هذا الملف إلا وفقًا لشروط الرخصة. يمكنك الحصول على نسخة منها في الملف LICENSE الموجود في حزمة التوزيع المصدرية أو على الرابط <https://www.openssl.org/source/license.html>.

ترجمة¶

تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي <zayed.alsaidi@gmail.com>

هذه الترجمة هي وثيقة مجانية؛ راجع رخصة جنو العامة الإصدار 3 أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: kde-l10n-ar@kde.org.