نام (NAME)

openssl-cms - دستور CMS برای مدیریت پیام‌های S/MIME و داده‌های ساخت‌یافته رمزنگاری‌شده

خلاصه دستور (SYNOPSIS)

openssl cms [-help]

گزینه‌های عمومی:

[-in filename] [-out filename] [-config configfile]

گزینه‌های عملیات:

[-encrypt] [-decrypt] [-sign] [-verify] [-resign] [-sign_receipt] [-verify_receipt receipt] [-digest digest] [-digest_create] [-digest_verify] [-compress] [-uncompress] [-EncryptedData_encrypt] [-EncryptedData_decrypt] [-data_create] [-data_out] [-cmsout]

گزینه‌های قالب فایل:

[-inform DER|PEM|SMIME] [-outform DER|PEM|SMIME] [-rctform DER|PEM|SMIME] [-stream] [-indef] [-noindef] [-binary] [-crlfeol] [-asciicrlf]

گزینه‌های کلیدها و گذرواژه:

[-pwri_password password] [-secretkey key] [-secretkeyid id] [-inkey filename|uri] [-passin arg] [-keyopt name:parameter] [-keyform DER|PEM|P12|ENGINE] [-engine id] [-provider name] [-provider-path path] [-provparam [name:]key=value] [-propquery propq] [-rand files] [-writerand file]

گزینه‌های رمزگذاری:

[-originator file] [-recip file] [recipient-cert ...] [-cipher] [-kekcipher cipher] [-wrap cipher] [-aes128-wrap] [-aes192-wrap] [-aes256-wrap] [-des3-wrap] [-debug_decrypt] [-recip_kdf kdf] [-recip_ukm ukm]

گزینه‌های امضا:

[-md digest] [-signer file] [-certfile file] [-cades] [-nodetach] [-nocerts] [-noattr] [-nosmimecap] [-no_signing_time] [-receipt_request_all] [-receipt_request_first] [-receipt_request_from emailaddress] [-receipt_request_to emailaddress]

گزینه‌های اعتبارسنجی:

[-signer file] [-content filename] [-no_content_verify] [-no_attr_verify] [-nosigs] [-noverify] [-nointern] [-cades] [-verify_retcode] [-CAfile file] [-no-CAfile] [-CApath dir] [-no-CApath] [-CAstore uri] [-no-CAstore]

گزینه‌های خروجی:

[-keyid] [-econtent_type type] [-text] [-certsout file] [-to addr] [-from addr] [-subject subj]

گزینه‌های چاپ:

[-noout] [-print] [-nameopt option] [-receipt_request_print]

گزینه‌های اعتبارسنجی:

[-allow_proxy_certs] [-attime timestamp] [-no_check_time] [-check_ss_sig] [-crl_check] [-crl_check_all] [-explicit_policy] [-extended_crl] [-ignore_critical] [-inhibit_any] [-inhibit_map] [-partial_chain] [-policy arg] [-policy_check] [-policy_print] [-purpose purpose] [-suiteB_128] [-suiteB_128_only] [-suiteB_192] [-trusted_first] [-no_alt_chains] [-use_deltas] [-auth_level num] [-verify_depth num] [-verify_email email] [-verify_hostname hostname] [-verify_ip ip] [-verify_name name] [-x509_strict] [-issuer_checks]

توضیحات (DESCRIPTION)

این دستور داده‌ها را در قالب CMS، مانند پیام‌های ایمیل S/MIME نسخه ۳.۱، مدیریت می‌کند. این دستور می‌تواند پیام‌ها را رمزگذاری، رمزگشایی، امضا، اعتبارسنجی، فشرده‌سازی، از فشرده‌سازی خارج و چاپ نماید.

گزینه‌ها (OPTIONS)

تعدادی گزینه عملیاتی وجود دارند که نوع عملیات مورد نظر را تعیین می‌کنند: encrypt، decrypt، sign، verify، resign، sign_receipt، verify_receipt، digest_create، digest_verify، compress، uncompress، EncryptedData_encrypt، EncryptedData_decrypt، data_create، data_out یا cmsout. ارتباط سایر گزینه‌ها به نوع عملیات بستگی دارد و مفهوم آن‌ها ممکن است بر اساس آن متفاوت باشد.

-help

نمایش پیام راهنمای نحوه استفاده.

نکات (NOTES)

پیام MIME باید بدون هیچ خط خالی میان هدرها و خروجی ارسال شود. برخی برنامه‌های نامه‌رسان به طور خودکار یک خط خالی اضافه می‌کنند. هدایت مستقیم نامه با پایپ به sendmail یکی از روش‌های دستیابی به قالب صحیح است.

پیام ارائه‌شده برای امضا یا رمزگذاری باید شامل هدرهای MIME ضروری باشد، در غیر این صورت بسیاری از کلاینت‌های S/MIME آن را به درستی (یا اصلاً) نمایش نخواهند داد. می‌توانید از گزینه -text برای افزودن خودکار هدرهای متن ساده استفاده کنید.

پیام «امضا و رمزگذاری‌شده» پیامی است که در آن ابتدا یک پیام امضا شده و سپس رمزگذاری می‌شود. این پیام می‌تواند با رمزگذاری پیامی که از قبل امضا شده است تولید شود: بخش مثال‌ها را ببینید.

این نسخه از برنامه تنها اجازه یک امضاکننده در هر پیام را می‌دهد، اما امضاکنندگان متعددی را در پیام‌های دریافتی تأیید می‌کند. برخی کلاینت‌های S/MIME در صورت وجود چندین امضاکننده در پیام دچار مشکل می‌شوند. می‌توان پیام‌ها را «به صورت موازی» با امضا کردن پیامی که از قبل امضا شده است، امضا کرد.

گزینه‌های -encrypt و -decrypt کاربرد متداول در کلاینت‌های S/MIME را منعکس می‌کنند. به بیان دقیق، این گزینه‌ها داده‌های محصورشده (enveloped data) در CMS را پردازش می‌کنند؛ داده‌های رمزگذاری‌شده CMS برای اهداف دیگری استفاده می‌شوند.

گزینه -resign هنگام افزودن یک امضاکننده جدید از خلاصه پیام موجود استفاده می‌کند. این بدان معناست که ویژگی‌ها باید حداقل در یک امضاکننده موجود که از همان خلاصه پیام استفاده می‌کند وجود داشته باشند، در غیر این صورت این عملیات شکست خواهد خورد.

گزینه‌های -stream و -indef پشتیبانی از ورودی/خروجی جریانی (streaming I/O) را فعال می‌کنند. در نتیجه، کدگذاری BER با استفاده از کدگذاری ساخت‌یافته با طول نامحدود خواهد بود و دیگر DER نیست. حالت جریانی برای عملیات -encrypt و در صورتی که محتوا جداشده نباشد، برای عملیات -sign پشتیبانی می‌شود.

حالت جریانی همواره برای عملیات -sign با داده‌های جداشده (detached) استفاده می‌شود، اما از آنجا که محتوا دیگر بخشی از ساختار CMS نیست، کدگذاری به صورت DER باقی می‌ماند.

اگر گزینه -decrypt بدون گواهی گیرنده استفاده شود، تلاشی برای یافتن گیرنده با آزمودن هر گیرنده احتمالی به نوبت با استفاده از کلید خصوصی ارائه‌شده صورت می‌گیرد. برای خنثی کردن حمله MMA (حمله بلیشن‌باخر به پدینگ PKCS #1 v1.5 RSA)، همه گیرندگان صرف‌نظر از موفقیت یا عدم موفقیت بررسی می‌شوند و اگر هیچ گیرنده‌ای مطابقت نداشته باشد، پیام با یک کلید تصادفی «رمزگشایی» می‌شود که معمولاً داده‌های نامفهوم خروجی می‌دهد. گزینه -debug_decrypt می‌تواند برای غیرفعال کردن محافظت در برابر حمله MMA و برگرداندن خطا در صورت یافت نشدن گیرنده استفاده شود؛ این گزینه باید با احتیاط به کار رود. برای توضیحات کامل‌تر، CMS_decrypt(3) را ببینید.

امضای الکترونیکی پایه CADES (CADES BASIC ELECTRONIC SIGNATURE - CADES-BES)

یک امضای الکترونیکی پایه CAdES (CAdES-BES)، همان‌طور که در استاندارد اروپایی ETSI EN 319 122-1 V1.1.1 تعریف شده است، شامل موارد زیر است:

• داده‌های امضاشده کاربر طبق تعریف در CMS (RFC 3852)؛
• نوع محتوای (Content-type) مقدار EncapsulatedContentInfo که در حال امضا است؛
• خلاصه پیام (Message-digest) مربوط به رشته بایت eContent درون encapContentInfo که در حال امضا است؛
• یک ویژگی ESS signingCertificate یا ESS signingCertificateV2، همان‌طور که در خدمات امنیتی پیشرفته (ESS)، RFC 2634 و RFC 5035 تعریف شده است. یک ویژگی ESS signingCertificate تنها اجازه استفاده از SHA-1 را به عنوان الگوریتم خلاصه می‌دهد. یک ویژگی ESS signingCertificateV2 امکان استفاده از هر الگوریتم خلاصه‌سازی را فراهم می‌کند.
• مقدار امضای دیجیتال محاسبه‌شده روی داده‌های کاربر و، در صورت وجود، روی ویژگی‌های امضاشده.

  توجه داشته باشید که گزینه -cades بر عملیات‌های -sign یا -verify اعمال می‌شود. با این گزینه، عملیات -verify همچنین نیازمند حضور ویژگی signingCertificate است و بررسی می‌کند که شناسه‌های داده‌شده با زنجیره اعتماد اعتبارسنجی ایجادشده در طول فرایند تأیید مطابقت داشته باشند.

کدهای خروج (EXIT CODES)

0

عملیات با موفقیت کامل انجام شد.

1

خطایی در تجزیه گزینه‌های دستور رخ داد.

2

یکی از فایل‌های ورودی قابل خواندن نبود.

3

خطایی هنگام ساخت فایل CMS یا خواندن پیام MIME رخ داد.

4

خطایی هنگام رمزگشایی یا تأیید پیام رخ داد.

5

پیام به درستی تأیید شد اما در نوشتن گواهی‌های امضاکنندگان خطایی رخ داد.

سازگاری با قالب PKCS#7 (COMPATIBILITY WITH PKCS#7 FORMAT)

دستور openssl-smime(1) تنها می‌تواند قالب قدیمی‌تر PKCS#7 را پردازش کند. openssl cms از قالب ساختار نحو پیام رمزنگاری (Cryptographic Message Syntax) پشتیبانی می‌کند. استفاده از برخی قابلیت‌ها منجر به تولید پیام‌هایی خواهد شد که توسط برنامه‌هایی که فقط از قالب قدیمی‌تر پشتیبانی می‌کنند، قابل پردازش نیستند. این موارد در زیر به تفصیل آمده است.

استفاده از گزینه -keyid همراه با -sign یا -encrypt.

گزینه -outform PEM از هدرهای متفاوتی استفاده می‌کند.

گزینه -compress.

گزینه -secretkey هنگامی که همراه با -encrypt استفاده شود.

استفاده از PSS همراه با -sign.

استفاده از کلیدهای OAEP یا کلیدهای غیر RSA همراه با -encrypt.

علاوه بر این، انواع -EncryptedData_encrypt و -data_create نمی‌توانند توسط دستور قدیمی‌تر openssl-smime(1) پردازش شوند.

مثال‌ها (EXAMPLES)

ایجاد یک پیام امضاشده به صورت متن آشکار (cleartext):

openssl cms -sign -in message.txt -text -out mail.msg \
       -signer mycert.pem

ایجاد یک پیام امضاشده مات (opaque):

openssl cms -sign -in message.txt -text -out mail.msg -nodetach \
       -signer mycert.pem

ایجاد یک پیام امضاشده، همراه با چند گواهی اضافی و خواندن کلید خصوصی از فایلی دیگر:

openssl cms -sign -in in.txt -text -out mail.msg \
       -signer mycert.pem -inkey mykey.pem -certfile mycerts.pem

ایجاد یک پیام امضاشده با دو امضاکننده و استفاده از شناسه کلید:

openssl cms -sign -in message.txt -text -out mail.msg \
       -signer mycert.pem -signer othercert.pem -keyid

ارسال مستقیم یک پیام امضاشده در یونیکس به sendmail، همراه با سرایندها:

openssl cms -sign -in in.txt -text -signer mycert.pem \
       -from steve@openssl.org -to someone@somewhere \
       -subject "Signed message" | sendmail someone@somewhere

اعتبارسنجی یک پیام و استخراج گواهی امضاکننده در صورت موفقیت:

openssl cms -verify -in mail.msg -signer user.pem -out signedtext.txt

ارسال ایمیل رمزگذاری‌شده با استفاده از Triple DES:

openssl cms -encrypt -in in.txt -from steve@openssl.org \
       -to someone@somewhere -subject "Encrypted message" \
       -des3 user.pem -out mail.msg

امضا و رمزگذاری ایمیل:

openssl cms -sign -in ml.txt -signer my.pem -text \
       | openssl cms -encrypt -out mail.msg \
       -from steve@openssl.org -to someone@somewhere \
       -subject "Signed and Encrypted message" -des3 user.pem

نکته: دستور رمزگذاری شامل گزینه -text نیست زیرا پیامی که رمزگذاری می‌شود از قبل دارای سرایندهای MIME است.

رمزگشایی یک پیام:

openssl cms -decrypt -in mail.msg -recip mycert.pem -inkey key.pem

خروجی حاصل از امضای فرم در Netscape یک ساختار PKCS#7 با قالب امضای جداشده (detached) است. می‌توانید با شکستن خطوط ساختار کدگذاری‌شده با base64 و محصور کردن آن با عبارت‌های زیر، از این برنامه برای اعتبارسنجی امضا استفاده کنید:

-----BEGIN PKCS7-----
-----END PKCS7-----

و با استفاده از دستور:

openssl cms -verify -inform PEM -in signature.pem -content content.txt

همچنین می‌توانید داده‌های امضا را از base64 رمزگشایی کرده و از این دستور استفاده نمایید:

openssl cms -verify -inform DER -in signature.der -content content.txt

ایجاد یک پیام رمزگذاری‌شده با استفاده از Camellia با کلید ۱۲۸ بیتی:

openssl cms -encrypt -in plain.txt -camellia128 -out mail.msg cert.pem

افزودن یک امضاکننده به یک پیام موجود:

openssl cms -resign -in mail.msg -signer newsign.pem -out mail2.msg

امضای یک پیام با استفاده از RSA-PSS:

openssl cms -sign -in message.txt -text -out mail.msg \
       -signer mycert.pem -keyopt rsa_padding_mode:pss

ایجاد یک پیام رمزگذاری‌شده با استفاده از RSA-OAEP:

openssl cms -encrypt -in plain.txt -out mail.msg \
       -recip cert.pem -keyopt rsa_padding_mode:oaep

استفاده از SHA256 KDF همراه با یک گواهی ECDH:

openssl cms -encrypt -in plain.txt -out mail.msg \
       -recip ecdhcert.pem -keyopt ecdh_kdf_md:sha256

چاپ داده‌های دودویی امضاشده CMS در قالبی خوانا برای انسان:

openssl cms -in signed.cms -binary -inform DER -cmsout -print

باگ‌ها (BUGS)

تجزیه‌کننده MIME چندان هوشمند نیست: به نظر می‌رسد بیشتر پیام‌های ارسال‌شده به آن را پردازش می‌کند، اما ممکن است روی برخی دیگر با خطا مواجه شود.

کد برنامه در حال حاضر تنها گواهی امضاکننده را در یک فایل می‌نویسد: اگر امضاکننده دارای یک گواهی رمزگذاری جداگانه باشد، باید آن را به صورت دستی استخراج کرد. باید سازوکاری ابتکاری وجود داشته باشد که گواهی رمزگذاری صحیح را تشخیص دهد.

در حالت ایده‌آل باید پایگاه‌داده‌ای از گواهی‌ها برای هر نشانی ایمیل نگهداری شود.

کد برنامه در حال حاضر به الگوریتم‌های رمزگذاری متقارن مجاز که در صفت امضاشده SMIMECapabilities ارائه شده‌اند توجهی نمی‌کند. این بدان معناست که کاربر باید الگوریتم رمزگذاری صحیح را به صورت دستی وارد نماید. باید فهرست رمزهای مجاز در یک پایگاه‌داده ذخیره شود و تنها از آن‌ها استفاده گردد.

هیچ‌گونه بررسی ابطالی روی گواهی امضاکننده انجام نمی‌شود.

همچنین ببینید (SEE ALSO)

ossl_store-file(7)

تاریخچه (HISTORY)

رمز پیش‌فرض رمزگذاری در OpenSSL 3.5 از 3DES به AES-256 تغییر یافت.

امکان استفاده از چندین گزینه -signer و دستور -resign برای نخستین بار در OpenSSL 1.0.0 اضافه شدند.

گزینه -keyopt در OpenSSL 1.0.2 اضافه شد.

پشتیبانی از RSA-OAEP و RSA-PSS در OpenSSL 1.0.2 اضافه شد.

امکان استفاده از کلیدهای غیر RSA همراه با -encrypt و -decrypt در OpenSSL 1.0.2 اضافه شد.

گزینه -no_alt_chains در OpenSSL 1.0.2b اضافه شد.

گزینه -nameopt در OpenSSL 3.0.0 اضافه شد.

گزینه -engine در OpenSSL 3.0 منسوخ شد.

گزینه -digest در OpenSSL 3.2 اضافه شد.

گزینه‌های -recip_kdf و -recip_ukm در OpenSSL 3.6 اضافه شدند.

حق نشر (COPYRIGHT)

حق نشر ۲۰۰۸-۲۰۲۶ متعلق به نویسندگان پروژه OpenSSL است. کلیه حقوق محفوظ است.

تحت مجوز آپاچی، نسخه ۲.۰ ("مجوز") ارائه شده است. شما نمی‌توانید از این فایل استفاده کنید مگر در انطباق با این مجوز. می‌توانید نسخه‌ای از مجوز را در فایل LICENSE در توزیع مبدأ یا در نشانی زیر بیابید: https://www.openssl.org/source/license.html