عام¶

بعض تطبيقات التوقيع تُجمّع بيانات المُدخل فقط ولا تُجري معالجة إضافية قبل التحقق منها (تتوقع أن يكون المُدخل ملخصًا)، بينما تضغط أخرى البيانات، عادةً بإنتاج ملخص داخليًا، وتوقع النتيجة، التي تُتحقق منها بعد ذلك مقابل توقيع معطى. بعضها يدعم كلا وضعي التشغيل في نفس الوقت. يُتوقع من المُستدعي معرفة كيف يجب أن تتصرف الخوارزمية المُختارة وتحت أي ظروف.

على سبيل المثال، يمكن توقع أن تطبيق RSA يتوقع فقط ملخصًا كمُدخل، بينما يمكن توقع أن ED25519 يعالج المُدخل بتجزئة، أي إنتاج الملخص داخليًا، وبينما يمكن توقع أن RSA-SHA256 يتعامل مع أي من وضعي التشغيل، اعتمادًا على ما إذا كانت العملية قد هُيئت باستخدام EVP_PKEY_verify_init_ex2() أو باستخدام EVP_PKEY_verify_message_init().

بالمثل، يتوقع تنفيذ RSA عادةً ضبط تفاصيل إضافية، مثل خوارزمية خلاصة الرسالة التي يُفترض معالجة الإدخال بها، بالإضافة إلى وضع الحشو (padding) (انظر EVP_PKEY_CTX_set_signature_md(3) و EVP_PKEY_CTX_set_rsa_padding(3) وغيرها من الوظائف المماثلة)، بينما يحتوي تنفيذ RSA-SHA256 عادةً على هذه التفاصيل محددة مسبقاً وغير قابلة للتغيير.

لا يمكن استخدام الدوال الموصوفة هنا لدمج خوارزميات منفصلة. على وجه الخصوص، لا يمكن استخدام EVP_PKEY_CTX_set_signature_md(3) ولا معامل OSSL_PARAM "digest" (OSSL_SIGNATURE_PARAM_DIGEST) لدمج خوارزمية توقيع مع خوارزمية تجزئة لمعالجة المدخلات. بعبارة أخرى، لا يمكن تحديد سياق ctx محمّل مسبقًا بمفتاح RSA، أو خوارزمية algo جلبت "RSA" ومحاولة تحديد SHA256 بشكل منفصل للحصول على وظيفة RSA-SHA256. إذا كان دمج الخوارزميات بهذه الطريقة مرغوبًا، يُرجى استخدام EVP_DigestVerifyInit(3) والدوال المرتبطة، أو EVP_VerifyInit(3) والدوال المرتبطة.

إجراء عمليات تحقق متعددة¶

عند التهيئة باستخدام EVP_PKEY_verify_init_ex() أو EVP_PKEY_verify_init_ex2()، يمكن استدعاء EVP_PKEY_verify() أكثر من مرة على نفس السياق لإجراء عدة عمليات لمرة واحدة باستخدام نفس المُعاملات.

عند التهيئة باستخدام EVP_PKEY_verify_message_init()، لا يمكن استدعاء EVP_PKEY_verify() عدة مرات.

حول EVP_PKEY_CTX_set_signature()¶

تتطلب بعض خوارزميات التوقيع (مثل LMS) تحديد بيانات التحقق من التوقيع قبل التحقق من الرسالة. وتسمح خوارزميات أخرى بتحديد التوقيع متأخرًا. للسماح بأي من الطريقتين (والتي قد تعتمد على تدفق الإدخال للتطبيق)، يجب تحديد التوقيع المراد التحقق منه باستخدام هذه الدالة عند استخدام EVP_PKEY_verify_message_update() و EVP_PKEY_verify_message_final() لإجراء التحقق.

RSA مع حشوة PKCS#1 لـ SHA256¶

تحقق من التوقيع باستخدام حشو PKCS#1 ومستخلص SHA256 كمدخل:

 #include <openssl/evp.h>
 #include <openssl/rsa.h>
 EVP_PKEY_CTX *ctx;
 unsigned char *md, *sig;
 size_t mdlen, siglen;
 EVP_PKEY *verify_key;
 /*
  * NB: assumes verify_key, sig, siglen md and mdlen are already set up
  * and that verify_key is an RSA public key
  */
 ctx = EVP_PKEY_CTX_new(verify_key, NULL /* no engine */);
 if (ctx == NULL)
     /* Error occurred */
 if (EVP_PKEY_verify_init(ctx) <= 0)
     /* Error */
 if (EVP_PKEY_CTX_set_rsa_padding(ctx, RSA_PKCS1_PADDING) <= 0)
     /* Error */
 if (EVP_PKEY_CTX_set_signature_md(ctx, EVP_sha256()) <= 0)
     /* Error */
 /* Perform operation */
 ret = EVP_PKEY_verify(ctx, sig, siglen, md, mdlen);
 /*
  * ret == 1 indicates success, 0 verify failure and < 0 for some
  * other error.
  */

RSA-SHA256 مع ملخص محسوب مسبقًا¶

تحقق من مستخلص باستخدام RSA-SHA256 باستخدام دوال اللقطة الواحدة. يُلاحظ أن RSA-SHA256 يُفترض أن يكون تنفيذًا لـ "sha256WithRSAEncryption"، حيث يكون الحشو محددًا مسبقًا كـ RSA_PKCS1_PADDING، ويُفترض أن المستخلص المدخل قد حُسب باستخدام SHA256.

 #include <openssl/evp.h>
 #include <openssl/rsa.h>
 EVP_PKEY_CTX *ctx;
 /* md is a SHA-256 digest in this example. */
 unsigned char *md, *sig;
 size_t mdlen = 32, siglen;
 EVP_PKEY *signing_key;
 /*
  * NB: assumes verify_key, sig, siglen, md and mdlen are already set up
  * and that verify_key is an RSA public key
  */
 ctx = EVP_PKEY_CTX_new(signing_key, NULL /* no engine */);
 alg = EVP_SIGNATURE_fetch(NULL, "RSA-SHA256", NULL);
 if (ctx == NULL)
     /* Error occurred */
 if (EVP_PKEY_verify_init_ex2(ctx, alg, NULL) <= 0)
     /* Error */
 /* Determine buffer length */
 if (EVP_PKEY_verify(ctx, sig, siglen, md, mdlen) <= 0)
     /* Error or signature doesn't verify */
 /* Perform operation */
 ret = EVP_PKEY_verify(ctx, sig, siglen, md, mdlen);
 /*
  * ret == 1 indicates success, 0 verify failure and < 0 for some
  * other error.
  */

RSA-SHA256، طلقة واحدة¶

تحقق من مستند باستخدام RSA-SHA256 باستخدام دوال اللقطة الواحدة. يُلاحظ أن RSA-SHA256 يُفترض أن يكون تنفيذًا لـ "sha256WithRSAEncryption"، حيث يكون الحشو محددًا مسبقًا كـ RSA_PKCS1_PADDING.

 #include <openssl/evp.h>
 #include <openssl/rsa.h>
 EVP_PKEY_CTX *ctx;
 /* in the input in this example. */
 unsigned char *in, *sig;
 /* inlen is the length of the input in this example. */
 size_t inlen, siglen;
 EVP_PKEY *signing_key;
 EVP_SIGNATURE *alg;
 /*
  * NB: assumes signing_key, in and inlen are set up before
  * the next step. signing_key must be an RSA private key,
  * in must point to data to be digested and signed, and
  * inlen must be the size of the data in bytes.
  */
 ctx = EVP_PKEY_CTX_new(signing_key, NULL /* no engine */);
 alg = EVP_SIGNATURE_fetch(NULL, "RSA-SHA256", NULL);
 if (ctx == NULL || alg == NULL)
     /* Error occurred */
 if (EVP_PKEY_verify_message_init(ctx, alg, NULL) <= 0)
     /* Error */
 /* Perform operation */
 ret = EVP_PKEY_verify(ctx, sig, siglen, in, inlen);
 /*
  * ret == 1 indicates success, 0 verify failure and < 0 for some
  * other error.
  */

RSA-SHA256، باستخدام التحديث والنهاية¶

هذا مماثل للمثال السابق، لكن مع السماح بوظيفية شبيهة بالدفق.

 #include <openssl/evp.h>
 #include <openssl/rsa.h>
 EVP_PKEY_CTX *ctx;
 /* in is the input in this example. */
 unsigned char *in, *sig;
 /* inlen is the length of the input in this example. */
 size_t inlen, siglen;
 EVP_PKEY *signing_key;
 EVP_SIGNATURE *alg;
 /*
  * NB: assumes signing_key, in and inlen are set up before
  * the next step. signing_key must be an RSA private key,
  * in must point to data to be digested and signed, and
  * inlen must be the size of the data in bytes.
  */
 ctx = EVP_PKEY_CTX_new(signing_key, NULL /* no engine */);
 alg = EVP_SIGNATURE_fetch(NULL, "RSA-SHA256", NULL);
 if (ctx == NULL || alg == NULL)
     /* Error occurred */
 if (EVP_PKEY_verify_message_init(ctx, alg, NULL) <= 0)
     /* Error */
 /* We have the signature, specify it early */
 EVP_PKEY_CTX_set_signature(ctx, sig, siglen);
 /* Perform operation */
 while (inlen > 0) {
     if (EVP_PKEY_verify_message_update(ctx, in, inlen)) <= 0)
         /* Error */
     if (inlen > 256) {
         inlen -= 256;
         in += 256;
     } else {
         inlen = 0;
     }
 }
 ret = EVP_PKEY_verify_message_final(ctx);
 /*
  * ret == 1 indicates success, 0 verify failure and < 0 for some
  * other error.
  */