.\" -*- mode: troff; coding: utf-8 -*- .\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>. .ie n \{\ . ds C` "" . ds C' "" 'br\} .el\{\ . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" 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'. .de IX .. .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 .\" .\" Required to disable full justification in groff 1.23.0. .if n .ds AD l .\" ======================================================================== .\" .IX Title "OPENSSL-SMIME 1ssl" .TH OPENSSL-SMIME 1ssl 2026-08-25 3.6.4 OpenSSL .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "نام (NAME)" openssl\-smime \- دستور S/MIME برای مدیریت، رمزگذاری، رمزگشایی، امضا و اعتبارسنجی پیام‌ها .SH "خلاصه دستور (SYNOPSIS)" .IX Header "SYNOPSIS" \&\fBopenssl\fR \fBsmime\fR [\fB\-help\fR] [\fB\-encrypt\fR] [\fB\-decrypt\fR] [\fB\-sign\fR] [\fB\-resign\fR] [\fB\-verify\fR] [\fB\-pk7out\fR] [\fB\-binary\fR] [\fB\-crlfeol\fR] [\fB\-\fR\f(BIcipher\fR] [\fB\-in\fR \fIfile\fR] [\fB\-certfile\fR \fIfile\fR] [\fB\-signer\fR \fIfile\fR] [\fB\-nointern\fR] [\fB\-noverify\fR] [\fB\-nochain\fR] [\fB\-nosigs\fR] [\fB\-nocerts\fR] [\fB\-noattr\fR] [\fB\-nodetach\fR] [\fB\-nosmimecap\fR] [\fB\-recip\fR \fI file\fR] [\fB\-inform\fR \fBDER\fR|\fBPEM\fR|\fBSMIME\fR] [\fB\-outform\fR \fBDER\fR|\fBPEM\fR|\fBSMIME\fR] [\fB\-keyform\fR \fBDER\fR|\fBPEM\fR|\fBP12\fR|\fBENGINE\fR] [\fB\-passin\fR \fIarg\fR] [\fB\-inkey\fR \fIfilename\fR|\fIuri\fR] [\fB\-out\fR \fIfile\fR] [\fB\-content\fR \fIfile\fR] [\fB\-to\fR \fIaddr\fR] [\fB\-from\fR \fIad\fR] [\fB\-subject\fR \fIs\fR] [\fB\-text\fR] [\fB\-indef\fR] [\fB\-noindef\fR] [\fB\-stream\fR] [\fB\-md\fR \fIdigest\fR] [\fB\-CAfile\fR \fIfile\fR] [\fB\-no\-CAfile\fR] [\fB\-CApath\fR \fIdir\fR] [\fB\-no\-CApath\fR] [\fB\-CAstore\fR \fIuri\fR] [\fB\-no\-CAstore\fR] [\fB\-engine\fR \fIid\fR] [\fB\-rand\fR \fIfiles\fR] [\fB\-writerand\fR \fIfile\fR] [\fB\-allow_proxy_certs\fR] [\fB\-attime\fR \fItimestamp\fR] [\fB\-no_check_time\fR] [\fB\-check_ss_sig\fR] [\fB\-crl_check\fR] [\fB\-crl_check_all\fR] [\fB\-explicit_policy\fR] [\fB\-extended_crl\fR] [\fB\-ignore_critical\fR] [\fB\-inhibit_any\fR] [\fB\-inhibit_map\fR] [\fB\-partial_chain\fR] [\fB\-policy\fR \fIarg\fR] [\fB\-policy_check\fR] [\fB\-policy_print\fR] [\fB\-purpose\fR \fIpurpose\fR] [\fB\-suiteB_128\fR] [\fB\-suiteB_128_only\fR] [\fB\-suiteB_192\fR] [\fB\-trusted_first\fR] [\fB\-no_alt_chains\fR] [\fB\-use_deltas\fR] [\fB\-auth_level\fR \fInum\fR] [\fB\-verify_depth\fR \fInum\fR] [\fB\-verify_email\fR \fIemail\fR] [\fB\-verify_hostname\fR \fIhostname\fR] [\fB\-verify_ip\fR \fIip\fR] [\fB\-verify_name\fR \fIname\fR] [\fB\-x509_strict\fR] [\fB\-issuer_checks\fR] [\fB\-provider\fR \fIname\fR] [\fB\-provider\-path\fR \fIpath\fR] [\fB\-provparam\fR \fI[name:]key=value\fR] [\fB\-propquery\fR \fIpropq\fR] [\fB\-config\fR \fIconfigfile\fR] \&\fIrecipcert\fR ... .SH "توضیحات (DESCRIPTION)" .IX Header "DESCRIPTION" این دستور S/MIME را بر اساس RFC 2311 (سال ۱۹۹۸) بدون پشتیبانی از CMS مدیریت می‌کند. این دستور می‌تواند پیام‌های S/MIME 2.0 را رمزگذاری، رمزگشایی، امضا و اعتبارسنجی کند. برای پیام‌های جدیدتر از ابزار CMS در OpenSSL استفاده کنید. .SH "گزینه‌ها (OPTIONS)" .IX Header "OPTIONS" شش گزینه عملیاتی وجود دارند که نوع عملیات قابل اجرا را تعیین می‌کنند: \&\fB\-encrypt\fR، \fB\-decrypt\fR، \fB\-sign\fR، \fB\-resign\fR، \fB\-verify\fR و \fB\-pk7out\fR. این گزینه‌ها مانعة‌الجمع هستند. مفهوم سایر گزینه‌ها بر اساس نوع عملیات متفاوت خواهد بود. .IP \fB\-help\fR 4 .IX Item "-help" نمایش پیام راهنمای نحوه استفاده. .IP \fB\-encrypt\fR 4 .IX Item "-encrypt" رمزگذاری ایمیل برای گواهی‌های گیرنده مشخص‌شده. فایل ورودی همان پیامی است که باید رمزگذاری شود. فایل خروجی، ایمیل رمزگذاری‌شده در قالب MIME است. .Sp توجه داشته باشید که هیچ بررسی ابطالی برای گواهی گیرنده انجام نمی‌شود؛ بنابراین اگر آن کلید افشا شده باشد، ممکن است دیگران بتوانند متن را رمزگشایی کنند. .IP \fB\-decrypt\fR 4 .IX Item "-decrypt" رمزگشایی ایمیل با استفاده از گواهی و کلید خصوصی ارائه‌شده. برای فایل ورودی انتظار یک پیام ایمیل رمزگذاری‌شده در قالب MIME را دارد. ایمیل رمزگشایی‌شده در فایل خروجی نوشته می‌شود. .IP \fB\-sign\fR 4 .IX Item "-sign" امضای ایمیل با استفاده از گواهی و کلید خصوصی ارائه‌شده. فایل ورودی همان پیامی است که باید امضا شود. پیام امضاشده در قالب MIME در فایل خروجی نوشته می‌شود. .IP \fB\-resign\fR 4 .IX Item "-resign" امضای مجدد پیام: دریافت یک پیام موجود و اعمال یک یا چند امضاکننده جدید روی آن. .IP \fB\-verify\fR 4 .IX Item "-verify" اعتبارسنجی ایمیل امضاشده. در ورودی انتظار یک پیام ایمیل امضاشده را دارد و داده‌های امضاشده را در خروجی می‌نویسد. هر دو نوع امضای متن‌واضح (clear text) و مات (opaque) پشتیبانی می‌شوند. .IP \fB\-pk7out\fR 4 .IX Item "-pk7out" یک پیام ورودی را دریافت کرده و یک ساختار PKCS#7 با کدگذاری PEM در خروجی می‌نویسد. .IP "\fB\-in\fR \fIfilename\fR" 4 .IX Item "-in filename" پیام ورودی که باید رمزگذاری یا امضا شود، یا پیام MIME که باید رمزگشایی یا اعتبارسنجی گردد. .IP "\fB\-out\fR \fIfilename\fR" 4 .IX Item "-out filename" متن پیامی که رمزگشایی یا اعتبارسنجی شده است، یا پیام خروجی در قالب MIME که امضا یا اعتبارسنجی شده است. .IP "\fB\-inform\fR \fBDER\fR|\fBPEM\fR|\fBSMIME\fR" 4 .IX Item "-inform DER|PEM|SMIME" قالب ورودی ساختار PKCS#7 (یا S/MIME) در صورتی که ساختاری در حال خوانده شدن باشد؛ پیش‌فرض \fBSMIME\fR است. برای جزئیات بیشتر به \fBopenssl\-format\-options\fR\|(1) مراجعه کنید. .IP "\fB\-outform\fR \fBDER\fR|\fBPEM\fR|\fBSMIME\fR" 4 .IX Item "-outform DER|PEM|SMIME" قالب خروجی ساختار PKCS#7 (یا S/MIME) در صورتی که ساختاری در حال نوشته شدن باشد؛ پیش‌فرض \fBSMIME\fR است. برای جزئیات بیشتر به \fBopenssl\-format\-options\fR\|(1) مراجعه کنید. .IP "\fB\-keyform\fR \fBDER\fR|\fBPEM\fR|\fBP12\fR|\fBENGINE\fR" 4 .IX Item "-keyform DER|PEM|P12|ENGINE" قالب کلید؛ به صورت پیش‌فرض مشخص نشده است. برای جزئیات بیشتر به \fBopenssl\-format\-options\fR\|(1) مراجعه کنید. .IP "\fB\-stream\fR, \fB\-indef\fR" 4 .IX Item "-stream, -indef" گزینه‌های \fB\-stream\fR و \fB\-indef\fR معادل یکدیگرند و جریان ورودی/خروجی (streaming I/O) را برای عملیات کدگذاری فعال می‌کنند. این قابلیت امکان پردازش داده‌ها در یک دور را بدون نیاز به نگه‌داشتن کل محتوا در حافظه فراهم کرده و از فایل‌های بسیار بزرگ پشتیبانی می‌کند. جریان‌سازی داده‌ها برای امضای S/MIME با داده‌های جداشده (detached) در صورتی که قالب خروجی \fBSMIME\fR باشد به صورت خودکار فعال است، اما در حال حاضر برای سایر عملیات به طور پیش‌فرض غیرفعال است. .IP \fB\-noindef\fR 4 .IX Item "-noindef" غیرفعال کردن جریان I/O در جاهایی که یک کدگذاری ساخت‌یافته با طول نامعین تولید می‌کند. این گزینه در حال حاضر هیچ تاثیری ندارد. در آینده جریان‌سازی به طور پیش‌فرض در تمام عملیات مربوطه فعال خواهد بود و این گزینه آن را غیرفعال خواهد کرد. .IP "\fB\-content\fR \fIfilename\fR" 4 .IX Item "-content filename" فایلی حاوی محتوای جداشده (detached content) را مشخص می‌کند که فقط با دستور \fB\-verify\fR کاربرد دارد. این گزینه تنها زمانی قابل استفاده است که ساختار PKCS#7 از نوع امضای جداشده استفاده کند و محتوا درون ساختار گنجانده نشده باشد. اگر قالب ورودی S/MIME باشد و از نوع محتوای MIME به صورت multipart/signed استفاده کند، این گزینه هرگونه محتوایی را بازنویسی خواهد کرد. .IP \fB\-text\fR 4 .IX Item "-text" این گزینه در صورت رمزگذاری یا امضا، هدرهای MIME متن ساده (text/plain) را به پیام ارائه‌شده اضافه می‌کند. در صورت رمزگشایی یا اعتبارسنجی، هدرهای متنی را حذف می‌کند: اگر پیام رمزگشایی‌شده یا اعتبارسنجی‌شده از نوع MIME به صورت text/plain نباشد، خطایی رخ می‌دهد. .IP "\fB\-md\fR \fIdigest\fR" 4 .IX Item "-md digest" الگوریتم خلاصه پیام (digest) مورد استفاده هنگام امضا یا امضای مجدد. در صورت عدم تعیین، از الگوریتم خلاصه پیش‌فرض کلید امضاکننده استفاده خواهد شد (معمولاً SHA1). .IP \fB\-\fR\f(BIcipher\fR 4 .IX Item "-cipher" الگوریتم رمزگذاری مورد استفاده. به عنوان مثال، DES (۵۶ بیتی) \- \fB\-des\fR، الگوریتم Triple DES (۱۶۸ بیتی) \- \fB\-des3\fR، یا AES (۲۵۶ بیتی) \- \fB\-aes256\fR. هر نام الگوریتم استاندارد دیگری نیز (همان‌طور که توسط تابع \fBEVP_get_cipherbyname()\fR استفاده می‌شود) می‌تواند با افزودن یک خط تیره در ابتدا، به کار رود؛ مانند \fB\-aes\-128\-cbc\fR. برای مشاهده فهرست رمزهای پشتیبانی‌شده توسط نسخه OpenSSL خود به \fBopenssl\-enc\fR\|(1) مراجعه کنید. .Sp در صورت عدم تعیین، AES\-256\-CBC به عنوان پیش‌فرض استفاده می‌شود. این گزینه فقط با \fB\-encrypt\fR به کار می‌رود. .IP \fB\-nointern\fR 4 .IX Item "-nointern" هنگام اعتبارسنجی یک پیام، به طور معمول گواهی‌های موجود در پیام (در صورت وجود) برای یافتن گواهی امضاکننده جستجو می‌شوند. با این گزینه، تنها گواهی‌های مشخص‌شده در گزینه \fB\-certfile\fR مورد استفاده قرار می‌گیرند. با این وجود، گواهی‌های ارائه‌شده همچنان می‌توانند به عنوان CAهای غیرقابل‌اعتماد استفاده شوند. .IP \fB\-noverify\fR 4 .IX Item "-noverify" گواهی امضاکننده یک پیام امضاشده اعتبارسنجی نمی‌شود. .IP \fB\-nochain\fR 4 .IX Item "-nochain" اعتبارسنجی زنجیره گواهی‌های امضاکنندگان را انجام نمی‌دهد؛ به این معنی که از گواهی‌های موجود در پیام امضاشده به عنوان CAهای غیرقابل‌اعتماد استفاده نمی‌کند. .IP \fB\-nosigs\fR 4 .IX Item "-nosigs" برای اعتبارسنجی امضاهای روی پیام تلاشی نمی‌شود. .IP \fB\-nocerts\fR 4 .IX Item "-nocerts" هنگام امضای یک پیام، گواهی امضاکننده معمولاً درون پیام گنجانده می‌شود. با فعال بودن این گزینه، گواهی حذف می‌گردد. این کار حجم پیام امضاشده را کاهش می‌دهد، اما اعتبارسنج باید یک نسخه از گواهی امضاکننده را به صورت محلی در دسترس داشته باشد (به عنوان مثال از طریق گزینه \fB\-certfile\fR ارسال شود). .IP \fB\-noattr\fR 4 .IX Item "-noattr" به طور معمول هنگام امضای یک پیام، مجموعه‌ای از ویژگی‌ها شامل زمان امضا و الگوریتم‌های متقارن پشتیبانی‌شده در پیام گنجانده می‌شوند. با این گزینه، این ویژگی‌ها اضافه نمی‌شوند. .IP \fB\-nodetach\fR 4 .IX Item "-nodetach" هنگام امضای یک پیام از امضای مات (opaque) استفاده می‌کند. این حالت در برابر تغییرات ناشی از بازپخش‌کننده‌های ایمیل (mail relays) مقاوم‌تر است، اما توسط برنامه‌های ایمیلی که از S/MIME پشتیبانی نمی‌کنند قابل خواندن نیست. بدون این گزینه، از امضای متن‌واضح با نوع MIME به صورت multipart/signed استفاده می‌شود. .IP \fB\-nosmimecap\fR 4 .IX Item "-nosmimecap" هنگام امضای یک پیام، ویژگی \fBSMIMECapabilities\fR را نگنجانید. .IP \fB\-binary\fR 4 .IX Item "-binary" به طور معمول پیام ورودی به قالب استاندارد (canonical) تبدیل می‌شود که عملاً استفاده از CR و LF به عنوان پایان خط است (طبق الزامات مشخصات S/MIME). با این گزینه، هیچ تبدیلی صورت نمی‌گیرد. این قابلیت هنگام کار با داده‌های باینری که ممکن است در قالب MIME نباشند کاربرد دارد. .IP \fB\-crlfeol\fR 4 .IX Item "-crlfeol" به طور معمول فایل خروجی از یک نویسه \fBLF\fR به عنوان پایان خط استفاده می‌کند. با این گزینه، به جای آن از \fBCRLF\fR استفاده می‌شود. .IP "\fB\-certfile\fR \fIfile\fR" 4 .IX Item "-certfile file" امکان مشخص کردن گواهی‌های اضافی را فراهم می‌کند. هنگام امضا، این گواهی‌ها همراه پیام گنجانده می‌شوند. هنگام اعتبارسنجی، این فایل برای یافتن گواهی‌های امضاکننده جستجو شده و برای ساخت زنجیره استفاده خواهد شد. .Sp ورودی می‌تواند در قالب PEM، DER یا PKCS#12 باشد. .IP "\fB\-signer\fR \fIfile\fR" 4 .IX Item "-signer file" گواهی امضاکننده هنگام امضا یا امضای مجدد یک پیام؛ در صورتی که به بیش از یک امضاکننده نیاز باشد، این گزینه می‌تواند چندین بار استفاده شود. اگر پیامی در حال اعتبارسنجی باشد، در صورت موفقیت اعتبارسنجی گواهی‌های امضاکنندگان در این فایل نوشته خواهند شد. .IP "\fB\-recip\fR \fIfile\fR" 4 .IX Item "-recip file" گواهی گیرنده هنگام رمزگشایی پیام. این گواهی باید با یکی از گیرندگان پیام تطابق داشته باشد، در غیر این صورت خطا رخ می‌دهد. .IP "\fB\-inkey\fR \fIfilename\fR|\fIuri\fR" 4 .IX Item "-inkey filename|uri" کلید خصوصی مورد استفاده هنگام امضا یا رمزگشایی. این کلید باید با گواهی مربوطه همخوانی داشته باشد. اگر این گزینه مشخص نشود، کلید خصوصی باید در فایل گواهی تعیین‌شده با گزینه \fB\-recip\fR یا \fB\-signer\fR گنجانده شده باشد. هنگام امضا، این گزینه می‌تواند چندین بار برای تعیین کلیدهای متوالی به کار رود. .IP "\fB\-passin\fR \fIarg\fR" 4 .IX Item "-passin arg" منبع گذرواژه کلید خصوصی. برای اطلاعات بیشتر درباره قالب \fIarg\fR به \fBopenssl\-passphrase\-options\fR\|(1) مراجعه کنید. .IP "\fB\-to\fR, \fB\-from\fR, \fB\-subject\fR" 4 .IX Item "-to, -from, -subject" هدرهای مرتبط ایمیل. این هدرها در خارج از بخش امضاشده پیام قرار می‌گیرند، بنابراین می‌توان آن‌ها را به صورت دستی اضافه کرد. در صورت امضا، بسیاری از کلاینت‌های ایمیل S/MIME بررسی می‌کنند که نشانی ایمیل گواهی امضاکننده با نشانی مشخص‌شده در هدر From: تطابق داشته باشد. .IP "\fB\-allow_proxy_certs\fR, \fB\-attime\fR, \fB\-no_check_time\fR, \fB\-check_ss_sig\fR, \fB\-crl_check\fR, \fB\-crl_check_all\fR, \fB\-explicit_policy\fR, \fB\-extended_crl\fR, \fB\-ignore_critical\fR, \fB\-inhibit_any\fR, \fB\-inhibit_map\fR, \fB\-no_alt_chains\fR, \fB\-partial_chain\fR, \fB\-policy\fR, \fB\-policy_check\fR, \fB\-policy_print\fR, \fB\-purpose\fR, \fB\-suiteB_128\fR, \fB\-suiteB_128_only\fR, \fB\-suiteB_192\fR, \fB\-trusted_first\fR, \fB\-use_deltas\fR, \fB\-auth_level\fR, \fB\-verify_depth\fR, \fB\-verify_email\fR, \fB\-verify_hostname\fR, \fB\-verify_ip\fR, \fB\-verify_name\fR, \fB\-x509_strict\fR \fB\-issuer_checks\fR" 4 .IX Item "-allow_proxy_certs, -attime, -no_check_time, -check_ss_sig, -crl_check, -crl_check_all, -explicit_policy, -extended_crl, -ignore_critical, -inhibit_any, -inhibit_map, -no_alt_chains, -partial_chain, -policy, -policy_check, -policy_print, -purpose, -suiteB_128, -suiteB_128_only, -suiteB_192, -trusted_first, -use_deltas, -auth_level, -verify_depth, -verify_email, -verify_hostname, -verify_ip, -verify_name, -x509_strict -issuer_checks" تنظیم گزینه‌های گوناگون برای اعتبارسنجی زنجیره گواهی. برای جزئیات بیشتر به بخش «گزینه‌های اعتبارسنجی» در \fBopenssl\-verification\-options\fR\|(1) مراجعه کنید. .Sp هرگونه خطای اعتبارسنجی موجب خروج دستور خواهد شد. .IP "\fB\-CAfile\fR \fIfile\fR, \fB\-no\-CAfile\fR, \fB\-CApath\fR \fIdir\fR, \fB\-no\-CApath\fR, \fB\-CAstore\fR \fIuri\fR, \fB\-no\-CAstore\fR" 4 .IX Item "-CAfile file, -no-CAfile, -CApath dir, -no-CApath, -CAstore uri, -no-CAstore" برای جزئیات بیشتر به بخش «گزینه‌های گواهی معتمد» در \fBopenssl\-verification\-options\fR\|(1) مراجعه کنید. .IP "\fB\-engine\fR \fIid\fR" 4 .IX Item "-engine id" به بخش «گزینه‌های موتور» در \fBopenssl\fR\|(1) مراجعه کنید. این گزینه منسوخ شده است. .IP "\fB\-rand\fR \fIfiles\fR, \fB\-writerand\fR \fIfile\fR" 4 .IX Item "-rand files, -writerand file" برای جزئیات بیشتر به بخش «گزینه‌های وضعیت تصادفی» در \fBopenssl\fR\|(1) مراجعه کنید. .IP "\fB\-provider\fR \fIname\fR" 4 .IX Item "-provider name" .PD 0 .IP "\fB\-provider\-path\fR \fIpath\fR" 4 .IX Item "-provider-path path" .IP "\fB\-provparam\fR \fI[name:]key=value\fR" 4 .IX Item "-provparam [name:]key=value" .IP "\fB\-propquery\fR \fIpropq\fR" 4 .IX Item "-propquery propq" .PD به بخش «گزینه‌های ارائه‌دهنده» در \fBopenssl\fR\|(1)، \fBprovider\fR\|(7) و \fBproperty\fR\|(7) مراجعه کنید. .IP "\fB\-config\fR \fIconfigfile\fR" 4 .IX Item "-config configfile" به بخش «گزینه پیکربندی» در \fBopenssl\fR\|(1) مراجعه کنید. .IP "\fIrecipcert\fR ..." 4 .IX Item "recipcert ..." یک یا چند گواهی از گیرندگان پیام، که هنگام رمزگذاری یک پیام استفاده می‌شود. .SH "نکات (NOTES)" .IX Header "NOTES" پیام MIME باید بدون هیچ خط خالی میان هدرها و خروجی ارسال شود. برخی از برنامه‌های ایمیل به طور خودکار یک خط خالی اضافه می‌کنند. انتقال مستقیم ایمیل از طریق لوله‌کشی (pipe) به sendmail یکی از روش‌های دستیابی به قالب صحیح است. .PP پیام ارائه‌شده برای امضا یا رمزگذاری باید شامل هدرهای لازم MIME باشد، در غیر این صورت بسیاری از کلاینت‌های S/MIME آن را به درستی نمایش نخواهند داد (یا اصلاً نمایش نمی‌دهند). می‌توانید از گزینه \fB\-text\fR برای افزودن خودکار هدرهای متن ساده استفاده کنید. .PP یک پیام «امضاشده و رمزگذاری‌شده» پیامی است که در آن یک پیام امضاشده، متعاقباً رمزگذاری می‌شود. این حالت را می‌توان با رمزگذاری پیامی که قبلاً امضا شده است تولید کرد؛ به بخش مثال‌ها مراجعه کنید. .PP این نسخه از برنامه فقط اجازه یک امضاکننده در هر پیام را می‌دهد، اما چندین امضاکننده را روی پیام‌های دریافتی اعتبارسنجی خواهد کرد. برخی از کلاینت‌های S/MIME در صورتی که پیام شامل چندین امضاکننده باشد دچار مشکل می‌شوند. امکان امضای پیام‌ها به صورت «موازی» از طریق امضای پیامی که قبلاً امضا شده است وجود دارد. .PP گزینه‌های \fB\-encrypt\fR و \fB\-decrypt\fR بازتابی از کاربردهای رایج در کلاینت‌های S/MIME هستند. از نظر فنی دقیق، این گزینه‌ها داده‌های محصورشده (enveloped data) در PKCS#7 را پردازش می‌کنند؛ داده‌های رمزگذاری‌شده PKCS#7 برای اهداف دیگری استفاده می‌شوند. .PP گزینه \fB\-resign\fR هنگام افزودن امضاکننده جدید، از خلاصه پیام موجود استفاده می‌کند. این بدان معنی است که ویژگی‌ها باید حداقل در یکی از امضاکنندگان موجود با همان خلاصه پیام وجود داشته باشند، در غیر این صورت این عملیات ناموفق خواهد بود. .PP گزینه‌های \fB\-stream\fR و \fB\-indef\fR پشتیبانی از جریان ورودی/خروجی (streaming I/O) را فعال می‌کنند. در نتیجه، کدگذاری به روش BER با استفاده از کدگذاری ساخت‌یافته با طول نامعین انجام می‌شود و دیگر DER نخواهد بود. قابلیت جریان‌سازی برای عملیات \fB\-encrypt\fR و همچنین عملیات \fB\-sign\fR در صورتی که محتوا جدا نشده باشد پشتیبانی می‌شود. .PP جریان‌سازی همیشه برای عملیات \fB\-sign\fR همراه با داده‌های جداشده استفاده می‌شود، اما از آن‌جا که محتوا دیگر بخشی از ساختار PKCS#7 نیست، کدگذاری به صورت DER باقی می‌ماند. .SH "کدهای خروج (EXIT CODES)" .IX Header "EXIT CODES" .IP 0 4 عملیات با موفقیت کامل انجام شد. .IP 1 4 .IX Item "1" خطایی هنگام تجزیه گزینه‌های دستور رخ داد. .IP 2 4 .IX Item "2" یکی از فایل‌های ورودی قابل خواندن نبود. .IP 3 4 .IX Item "3" خطایی هنگام ایجاد فایل PKCS#7 یا خواندن پیام MIME رخ داد. .IP 4 4 .IX Item "4" خطایی هنگام رمزگشایی یا اعتبارسنجی پیام رخ داد. .IP 5 4 .IX Item "5" پیام به درستی اعتبارسنجی شد، اما هنگام نوشتن گواهی‌های امضاکنندگان خطایی رخ داد. .SH "مثال‌ها (EXAMPLES)" .IX Header "EXAMPLES" ایجاد یک پیام امضاشده با متن‌واضح: .PP .Vb 2 \& openssl smime \-sign \-in message.txt \-text \-out mail.msg \e \& \-signer mycert.pem .Ve .PP ایجاد یک پیام امضاشده مات (opaque): .PP .Vb 2 \& openssl smime \-sign \-in message.txt \-text \-out mail.msg \-nodetach \e \& \-signer mycert.pem .Ve .PP ایجاد یک پیام امضاشده به همراه چند گواهی اضافی و خواندن کلید خصوصی از فایلی دیگر: .PP .Vb 2 \& openssl smime \-sign \-in in.txt \-text \-out mail.msg \e \& \-signer mycert.pem \-inkey mykey.pem \-certfile mycerts.pem .Ve .PP ایجاد یک پیام امضاشده با دو امضاکننده: .PP .Vb 2 \& openssl smime \-sign \-in message.txt \-text \-out mail.msg \e \& \-signer mycert.pem \-signer othercert.pem .Ve .PP ارسال مستقیم یک پیام امضاشده در یونیکس به sendmail به همراه هدرها: .PP .Vb 3 \& openssl smime \-sign \-in in.txt \-text \-signer mycert.pem \e \& \-from steve@openssl.org \-to someone@somewhere \e \& \-subject "Signed message" | sendmail someone@somewhere .Ve .PP اعتبارسنجی یک پیام و استخراج گواهی امضاکننده در صورت موفقیت‌آمیز بودن: .PP .Vb 1 \& openssl smime \-verify \-in mail.msg \-signer user.pem \-out signedtext.txt .Ve .PP ارسال ایمیل رمزگذاری‌شده با استفاده از Triple DES: .PP .Vb 3 \& openssl smime \-encrypt \-in in.txt \-out mail.msg \-from steve@openssl.org \e \& \-to someone@somewhere \-subject "Encrypted message" \e \& \-des3 user.pem .Ve .PP امضا و سپس رمزگذاری ایمیل: .PP .Vb 4 \& openssl smime \-sign \-in ml.txt \-signer my.pem \-text \e \& | openssl smime \-encrypt \-out mail.msg \e \& \-from steve@openssl.org \-to someone@somewhere \e \& \-subject "Signed and Encrypted message" \-des3 user.pem .Ve .PP نکته: دستور رمزگذاری شامل گزینه \fB\-text\fR نیست زیرا پیامی که رمزگذاری می‌شود از قبل دارای هدرهای MIME است. .PP رمزگشایی ایمیل: .PP .Vb 1 \& openssl smime \-decrypt \-in mail.msg \-recip mycert.pem \-inkey key.pem .Ve .PP خروجی حاصل از امضای فرم در نت‌اسکیپ (Netscape) یک ساختار PKCS#7 با قالب امضای جداشده (detached) است. شما می‌توانید با شکستن خطوط ساختار کدگذاری‌شده با Base64 و قرار دادن آن میان خطوط زیر، از این برنامه برای اعتبارسنجی امضا استفاده کنید: .PP .Vb 2 \& \-\-\-\-\-BEGIN PKCS7\-\-\-\-\- \& \-\-\-\-\-END PKCS7\-\-\-\-\- .Ve .PP و اجرای دستور: .PP .Vb 1 \& openssl smime \-verify \-inform PEM \-in signature.pem \-content content.txt .Ve .PP یا می‌توانید امضا را از Base64 رمزگشایی کرده و از این دستور استفاده کنید: .PP .Vb 1 \& openssl smime \-verify \-inform DER \-in signature.der \-content content.txt .Ve .PP ایجاد یک پیام رمزگذاری‌شده با استفاده از الگوریتم Camellia ۱۲۸ بیتی: .PP .Vb 1 \& openssl smime \-encrypt \-in plain.txt \-camellia128 \-out mail.msg cert.pem .Ve .PP افزودن یک امضاکننده به پیامی موجود: .PP .Vb 1 \& openssl smime \-resign \-in mail.msg \-signer newsign.pem \-out mail2.msg .Ve .SH "باگ‌ها (BUGS)" .IX Header "BUGS" تجزیه‌گر MIME چندان هوشمند نیست: به نظر می‌رسد بیشتر پیام‌هایی را که به آن داده شده مدیریت می‌کند، اما ممکن است در مواجهه با برخی دیگر دچار مشکل شود. .PP کد در حال حاضر فقط گواهی امضاکننده را در یک فایل می‌نویسد: اگر امضاکننده گواهی رمزگذاری جداگانه‌ای داشته باشد، باید به صورت دستی استخراج شود. باید نوعی روش اکتشافی (heuristic) وجود داشته باشد که گواهی رمزگذاری صحیح را تعیین کند. .PP در حالت ایده‌آل باید پایگاه‌داده‌ای از گواهی‌ها برای هر نشانی ایمیل نگهداری شود. .PP کد در حال حاضر به الگوریتم‌های رمزگذاری متقارن مجاز که در صفت امضاشده SMIMECapabilities ارائه شده‌اند توجهی نمی‌کند. این بدان معناست که کاربر باید الگوریتم رمزگذاری صحیح را به صورت دستی وارد نماید. باید فهرست رمزهای مجاز در یک پایگاه‌داده ذخیره شود و فقط از آن‌ها استفاده گردد. .PP هیچ‌گونه بررسی ابطالی روی گواهی امضاکننده انجام نمی‌شود. .PP کد فعلی فقط می‌تواند پیام‌های S/MIME نسخه ۲ را مدیریت کند؛ ساختارهای پیچیده‌تر S/MIME نسخه ۳ ممکن است باعث خطاهای تجزیه شوند. .SH "همچنین ببینید (SEE ALSO)" .IX Header "SEE ALSO" \&\fBossl_store\-file\fR\|(7) .SH "تاریخچه (HISTORY)" .IX Header "HISTORY" رمز پیش‌فرض رمزگذاری در OpenSSL 3.5 از 3DES به AES\-256 تغییر یافت. .PP امکان استفاده از چندین گزینه \fB\-signer\fR و دستور \fB\-resign\fR برای نخستین بار در OpenSSL 1.0.0 اضافه شدند. .PP گزینه \-no_alt_chains در OpenSSL 1.1.0 اضافه شد. .PP گزینه \fB\-engine\fR در OpenSSL 3.0 منسوخ شد. .SH "حق نشر (COPYRIGHT)" .IX Header "COPYRIGHT" حق نشر ۲۰۰۰-۲۰۲۶ متعلق به نویسندگان پروژه OpenSSL است. کلیه حقوق محفوظ است. .PP تحت مجوز آپاچی، نسخه ۲.۰ ("مجوز") ارائه شده است. شما نمی‌توانید از این فایل استفاده کنید مگر در انطباق با این مجوز. می‌توانید نسخه‌ای از مجوز را در فایل LICENSE در توزیع مبدأ یا در نشانی زیر بیابید: