EVP_SEALINIT(3ssl)

الاسم
EVP_SealInit, EVP_SealUpdate, EVP_SealFinal - تعمية المغلف EVP

موجز
 #include <openssl/evp.h>

 int EVP_SealInit(EVP_CIPHER_CTX *ctx, const EVP_CIPHER *type,
                  unsigned char **ek, int *ekl, unsigned char *iv,
                  EVP_PKEY **pubk, int npubk);
 int EVP_SealUpdate(EVP_CIPHER_CTX *ctx, unsigned char *out,
                    int *outl, unsigned char *in, int inl);
 int EVP_SealFinal(EVP_CIPHER_CTX *ctx, unsigned char *out, int *outl);

الوصف
إجراءات المغلف EVP هي واجهة عالية المستوى لتعمية المغلف. تُولّد مفتاحًا عشوائيًا و IV (إذا لزم الأمر) ثم تُغلفه باستخدام تعمية المفتاح العام. يمكن بعد ذلك تعمية البيانات باستخدام هذا المفتاح.

EVP_SealInit() تُهيئ سياق المُعمِّي ctx للتعمية باستخدام المُعمِّي type مع مفتاح سري عشوائي و IV. يُزوَّد type عادةً بدالة مثل EVP_aes_256_cbc(). يُعمَّى المفتاح السري باستخدام مفتاح عام واحد أو أكثر، وهذا يسمح بفك تعمية نفس البيانات المعماة باستخدام أي من المفاتيح الخاصة المقابلة. ek هو مصفوفة من المخازن المؤقتة حيث يُكتب المفتاح السري المُعمَّى بالمفتاح العام، يجب أن يحتوي كل مخزن مؤقت على مساحة كافية للمفتاح المُعمَّى المقابل: أي أن ek[i] يجب أن يحتوي على مساحة لعدد بايتات EVP_PKEY_get_size(pubk[i]). يُكتب الحجم الفعلي لكل مفتاح سري مُعمَّى إلى المصفوفة ekl. pubk هو مصفوفة من npubk مفتاحًا عامًا.

المعامل iv هو مخزن مؤقت يُكتب فيه IV المُولَّد. يجب أن يحتوي على مساحة كافية لـ IV الخاص بالمُعمِّي المقابل، كما يُحدد بواسطة (على سبيل المثال) EVP_CIPHER_get_iv_length(type).

إذا كان المُعمِّي لا يتطلب IV، فإن المعامل iv يُتجاهل ويمكن أن يكون NULL.

EVP_SealUpdate() و EVP_SealFinal() لهما نفس الخصائص تمامًا مثل إجراءات EVP_EncryptUpdate() و EVP_EncryptFinal()، كما هو موثق في صفحة الدليل EVP_EncryptInit(3).

القيم المُرجعة
EVP_SealInit() تُرجع 0 عند الخطأ أو npubk إذا نجحت.

EVP_SealUpdate() و EVP_SealFinal() تُرجعان 1 للنجاح و 0 للفشل.

ملاحظات
نظرًا لتوليد مفتاح سري عشوائي، يجب بذر مولد الأعداد العشوائية عند استدعاء EVP_SealInit(). إذا فشل البذر الآلي أو إعادة البذر لـ CSPRNG الخاص بـ OpenSSL بسبب ظروف خارجية (انظر RAND(7))، فستفشل العملية.

يجب أن يكون المفتاح العام RSA لأنه خوارزمية المفتاح العام الوحيدة في OpenSSL التي تدعم نقل المفتاح.

تعمية المغلف هي الطريقة المعتادة لاستخدام تعمية المفتاح العام على كميات كبيرة من البيانات، وذلك لأن تعمية المفتاح العام بطيئة ولكن التعمية المتناظرة سريعة. لذا تُستخدم التعمية المتناظرة للتعمية الكبيرة ويُستخدم المفتاح المتناظر العشوائي الصغير المنقول باستخدام تعمية المفتاح العام.

من الممكن استدعاء EVP_SealInit() مرتين بنفس طريقة EVP_EncryptInit(). يجب أن يكون الاستدعاء الأول مع تعيين npubk إلى 0 و (بعد تعيين أي معاملات للمُعمِّي) يجب استدعاؤها مرة أخرى مع تعيين type إلى NULL.

انظر أيضًا
evp(7), RAND_bytes(3), EVP_EncryptInit(3), EVP_OpenInit(3), RAND(7)

حقوق النسخ
حقوق النشر 2000-2021 لمؤلفي مشروع OpenSSL. جميع الحقوق محفوظة.

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

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

هذه الترجمة هي وثيقة مجانية؛ راجع رخصة جنو العامة الإصدار 3 (https://www.gnu.org/licenses/gpl-3.0.html) أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات.

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