.\" -*- coding: UTF-8 -*- .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .\" -*- mode: troff; coding: utf-8 -*- .\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45) .\" .\" Standard preamble: .\" ======================================================================== .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .ie n \{\ . ds C` "" . ds C' "" 'br\} .el\{\ . ds C` . ds C' 'br\} .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .de IX .. .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .if n .ds AD l .\" .\" Required to disable full justification in groff 1.23.0. .\" ======================================================================== .\" .IX Title "CMS_ADD1_SIGNER 3ssl" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH CMS_ADD1_SIGNER 3ssl "7 أبريل 2026" 3.6.2 OpenSSL .if n .ad l .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .nh .SH الاسم CMS_add1_signer, CMS_SignerInfo_sign \- إضافة موقع إلى بنية بيانات موقعة CMS_ContentInfo .SH موجز .IX Header موجز .Vb 1 \& #include \& \& CMS_SignerInfo *CMS_add1_signer(CMS_ContentInfo *cms, X509 *signcert, \& EVP_PKEY *pkey, const EVP_MD *md, \& unsigned int flags); \& \& int CMS_SignerInfo_sign(CMS_SignerInfo *si); .Ve .SH الوصف .IX Header الوصف \&\fBCMS_add1_signer()\fP تُضيف موقعًا بشهادة \fBsigncert\fP ومفتاح خاص \fBpkey\fP باستخدام ملخص رسالة \fBmd\fP إلى بنية CMS_ContentInfo SignedData \fBcms\fP. .PP يجب الحصول على بنية CMS_ContentInfo من استدعاء أولي لـ \&\fBCMS_sign()\fP مع تعيين العلم \fBCMS_PARTIAL\fP أو في حالة إعادة توقيع بنية CMS_ContentInfo SignedData صالحة. .PP إذا كانت معلمة \fBmd\fP هي \fBNULL\fP فسيُستخدم الملخص المبدئي لخوارزمية المفتاح العام. .PP ما لم يُعيّن العلم \fBCMS_REUSE_DIGEST\fP، فإن بنية CMS_ContentInfo المُرجعة ليست كاملة ويجب إنهاؤها إما بالتدفق (إن أمكن) أو باستدعاء \fBCMS_final()\fP. .PP دالة \fBCMS_SignerInfo_sign()\fP تُوقع بنية CMS_SignerInfo بشكل صريح، واستخدامها الرئيس يكون عندما يُعيّن كلا العلمين \fBCMS_REUSE_DIGEST\fP و \fBCMS_PARTIAL\fP. .SH ملاحظات .IX Header ملاحظات الغرض الرئيس من \fBCMS_add1_signer()\fP هو توفير تحكم أدق في بنية بيانات CMS الموقعة حيث لا تكون المبدئيات الافتراضية لدالة \fBCMS_sign()\fP الأبسط مناسبة. على سبيل المثال إذا كان هناك حاجة لموقّعين متعددين أو خوارزميات ملخص غير مبدئية. يمكن أيضًا إضافة سمات جديدة باستخدام بنية CMS_SignerInfo المُرجعة ودوال أداة سمات CMS أو دوال طلب الإيصال الموقع CMS. .PP يمكن تمرير أي من العلامات التالية (مجتمعة بعلامة OR) في معامل \fBflags\fP. .PP إذا عُيّن \fBCMS_REUSE_DIGEST\fP فسيُبذل جهد لنسخ قيمة ملخص المحتوى من بنية CMS_ContentInfo: لإضافة موقع إلى بنية موجودة. يحدث خطأ إذا تعذر العثور على قيمة ملخص مطابقة لنسخها. ستكون بنية CMS_ContentInfo المُرجعة صالحة ومنتهية عند تعيين هذا العلم. .PP إذا عُيّن \fBCMS_PARTIAL\fP بالإضافة إلى \fBCMS_REUSE_DIGEST\fP فلن تُنهى بنية CMS_SignerInfo لذا يمكن إضافة سمات إضافية. في هذه الحالة، يلزم استدعاء صريح لـ \fBCMS_SignerInfo_sign()\fP لإنهائها. .PP إذا ضُبط \fBCMS_NOCERTS\fP فلن تُضمن شهادة الموقع في بنية CMS_ContentInfo، ومع ذلك يجب توفير شهادة الموقع في معامل \fBsigncert\fP. يمكن لهذا تقليل حجم التوقيع إذا كان من الممكن الحصول على شهادة الموقع بوسائل أخرى: مثل رسالة موقعة سابقا. .PP يتضمن هيكل SignedData عدة CMS signedAttributes بما في ذلك وقت التوقيع، ونوع محتوى CMS وقائمة الشفرات المدعومة في سمة SMIMECapabilities. إذا ضُبط \fBCMS_NOATTR\fP فلن تُستخدم أي signedAttributes على الإطلاق. إذا ضُبط \fBCMS_NOSMIMECAP\fP فستُحذف SMIMECapabilities. إذا ضُبط \fBCMS_NO_SIGNING_TIME\fP فسيُحذف وقت التوقيع. .PP سيقوم OpenSSL مبدئيًا بتحديد شهادات التوقيع باستخدام اسم المصدر والرقم التسلسلي. إذا جرى ضبط \fBCMS_USE_KEYID\fP فسيستخدم قيمة معرف مفتاح الموضوع بدلاً من ذلك. سيحدث خطأ إذا كانت شهادة التوقيع لا تحتوي على امتداد معرف مفتاح الموضوع. .PP إذا وجدت سمة SMIMECapabilities، فإنها تشير إلى دعم الخوارزميات التالية حسب ترتيب الأفضلية: AES بـ 256 بت، وGost R3411\-94، وGost 28147\-89، وAES بـ 192 بت، وAES بـ 128 بت، وDES الثلاثي، وRC2 بـ 128 بت، وRC2 بـ 64 بت، وDES، وRC2 بـ 40 بت. إذا لم تتوفر أي من هذه الخوارزميات فلن تُضمّن: على سبيل المثال لن تُضمّن خوارزميات GOST إذا لم يُحمّل محرك GOST. .PP \&\fBCMS_add1_signer()\fP تُرجع مؤشرًا داخليًا إلى بنية CMS_SignerInfo المُضافة حديثًا، يمكن استخدامه لتعيين سمات إضافية قبل إنهائها. .SH "القيم المُرجعة" .IX Header "القيم المُرجعة" \&\fBCMS_add1_signer()\fP تُرجع مؤشرًا داخليًا إلى بنية CMS_SignerInfo المُضافة حديثًا أو NULL إذا حدث خطأ. .PP \&\fBCMS_SignerInfo_sign()\fP تُرجع 1 عند النجاح، 0 عند الفشل. .SH "انظر أيضًا" .IX Header "انظر أيضًا" \&\fBERR_get_error\fP\|(3), \fBCMS_sign\fP\|(3), \&\fBCMS_final\fP\|(3), .SH "حقوق النسخ" .IX Header "حقوق النسخ" حقوق النشر 2014\-2016 لمؤلفي مشروع OpenSSL. جميع الحقوق محفوظة. .PP مرخص بموجب رخصة Apache 2.0 (المشار إليها فيما يلي بـ ”الرخصة“). لا يجوز لك استخدام هذا الملف إلا وفقًا لشروط الرخصة. يمكنك الحصول على نسخة منها في الملف LICENSE الموجود في حزمة التوزيع المصدرية أو على الرابط . .PP .SH ترجمة تُرجمت هذه الصفحة من الدليل بواسطة زايد السعيدي . .PP هذه الترجمة هي وثيقة مجانية؛ راجع .UR https://www.gnu.org/licenses/gpl-3.0.html رخصة جنو العامة الإصدار 3 .UE أو ما بعده للاطلاع على شروط حقوق النشر. لا توجد أي ضمانات. .PP إذا وجدت أي أخطاء في ترجمة صفحة الدليل هذه، يرجى إرسال بريد إلكتروني إلى قائمة بريد المترجمين: .MT kde-l10n-ar@kde.org .ME .