نام (NAME)

openssl-rsa - دستور پردازش کلیدهای RSA

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

openssl rsa [-help] [-inform DER|PEM|P12|ENGINE] [-outform DER|PEM] [-in filename|uri] [-passin arg] [-out filename] [-passout arg] [-aes128] [-aes192] [-aes256] [-aria128] [-aria192] [-aria256] [-camellia128] [-camellia192] [-camellia256] [-des] [-des3] [-idea] [-text] [-noout] [-modulus] [-traditional] [-check] [-pubin] [-pubout] [-RSAPublicKey_in] [-RSAPublicKey_out] [-pvk-strong] [-pvk-weak] [-pvk-none] [-engine id] [-provider name] [-provider-path path] [-provparam [name:]key=value] [-propquery propq]

توضیحات (DESCRIPTION)

این دستور کلیدهای RSA را پردازش می‌کند. این کلیدها می‌توانند میان قالب‌های مختلف تبدیل شده و اجزای آن‌ها در خروجی چاپ شوند.

گزینه‌ها (OPTIONS)

-help: پیام راهنمای نحوهٔ استفاده از دستور را نمایش می‌دهد.
-inform DER|PEM|P12|ENGINE: قالب ورودی کلید؛ به‌طور پیش‌فرض مشخص نشده است. برای جزئیات بیشتر به openssl-format-options(1) مراجعه کنید.
-outform DER|PEM: قالب خروجی کلید؛ مقدار پیش‌فرض PEM است. برای جزئیات بیشتر به openssl-format-options(1) مراجعه کنید.
-traditional: هنگام نوشتن یک کلید خصوصی، به جای قالب PKCS#8 از قالب سنتی PKCS#1 استفاده می‌کند.
-in filename|uri: ورودی را برای خواندن کلید مشخص می‌کند، یا در صورت تعیین نشدن این گزینه، از ورودی استاندارد استفاده می‌شود. اگر کلید رمزگذاری شده باشد، عبارت عبور درخواست خواهد شد.
-passin arg, -passout arg: منبع گذرواژه برای فایل ورودی و خروجی. برای اطلاعات بیشتر دربارهٔ قالب arg به openssl-passphrase-options(1) مراجعه کنید.
-out filename: نام فایل خروجی را برای نوشتن کلید مشخص می‌کند، یا در صورت تعیین نشدن، از خروجی استاندارد استفاده می‌شود. اگر هر یک از گزینه‌های رمزگذاری تنظیم شده باشند، عبارت عبور درخواست خواهد شد. نام فایل خروجی نباید با نام فایل ورودی یکسان باشد.
-aes128, -aes192, -aes256, -aria128, -aria192, -aria256, -camellia128, -camellia192, -camellia256, -des, -des3, -idea: این گزینه‌ها کلید خصوصی را قبل از ارسال به خروجی با سایفر مشخص‌شده رمزگذاری می‌کنند. در این حالت یک عبارت عبور درخواست می‌شود. اگر هیچ‌یک از این گزینه‌ها مشخص نشود، کلید به صورت متن ساده (plain text) نوشته می‌شود. این بدان معناست که از این دستور می‌توان برای حذف عبارت عبور از یک کلید با تعیین نکردن هیچ گزینهٔ رمزگذاری، یا افزودن و تغییر عبارت عبور با مشخص کردن آن‌ها استفاده کرد. این گزینه‌ها فقط با فایل‌های خروجی با قالب PEM قابل استفاده هستند.
-text: علاوه بر نسخهٔ کدگذاری‌شده، اجزای گوناگون کلید عمومی یا خصوصی را به‌صورت متن ساده چاپ می‌کند.
-noout: این گزینه از چاپ نسخهٔ کدگذاری‌شدهٔ کلید در خروجی جلوگیری می‌کند.
-modulus: این گزینه مقدار مدولوس (modulus) کلید را چاپ می‌کند.
-check: این گزینه سازگاری و صحت یک کلید خصوصی RSA را بررسی می‌کند.
-pubin: به‌طور پیش‌فرض یک کلید خصوصی از ورودی خوانده می‌شود. با این گزینه، در عوض یک کلید عمومی خوانده خواهد شد. اگر ورودی فاقد کلید عمومی باشد اما حاوی کلید خصوصی باشد، بخش عمومی آن استفاده می‌شود.
-pubout: به‌طور پیش‌فرض یک کلید خصوصی در خروجی نوشته می‌شود؛ با این گزینه در عوض یک کلید عمومی در خروجی قرار خواهد گرفت. اگر ورودی یک کلید عمومی باشد، این گزینه به‌طور خودکار تنظیم می‌شود.
-RSAPublicKey_in, -RSAPublicKey_out: مانند -pubin و -pubout است، با این تفاوت که در عوض از قالب RSAPublicKey استفاده می‌شود.
-pvk-strong: سطح کدگذاری PVK از نوع 'Strong' را فعال می‌کند (پیش‌فرض).
-pvk-weak: سطح کدگذاری PVK از نوع 'Weak' را فعال می‌کند.
-pvk-none: کدگذاری PVK را اعمال نمی‌کند.
-engine id: بخش «Engine Options» در openssl(1) را ببینید. این گزینه منسوخ شده است.
-provider name
-provider-path path
-provparam [name:]key=value
-propquery propq: به «Provider Options» در openssl(1)، provider(7) و property(7) مراجعه کنید.

نکات (NOTES)

دستور openssl-pkey(1) قادر به انجام تمامی عملیاتی است که این دستور انجام می‌دهد، و همچنین از انواع دیگر کلیدهای عمومی نیز پشتیبانی می‌کند.

مثال‌ها (EXAMPLES)

مستندات دستور openssl-pkey(1) شامل مثال‌هایی معادل موارد ذکرشده در اینجا است.

برای حذف عبارت عبور از روی یک کلید خصوصی RSA:

openssl rsa -in key.pem -out keyout.pem

برای رمزگذاری یک کلید خصوصی با استفاده از Triple DES:

openssl rsa -in key.pem -des3 -out keyout.pem

برای تبدیل یک کلید خصوصی از قالب PEM به DER:

openssl rsa -in key.pem -outform DER -out keyout.der

برای چاپ اجزای یک کلید خصوصی در خروجی استاندارد:

openssl rsa -in key.pem -text -noout

برای ارسال صرفاً بخش عمومی یک کلید خصوصی به خروجی:

openssl rsa -in key.pem -pubout -out pubkey.pem

ارسال بخش عمومی یک کلید خصوصی به خروجی در قالب RSAPublicKey:

openssl rsa -in key.pem -RSAPublicKey_out -out pubkey.pem

اشکالات (BUGS)

باید گزینه‌ای وجود داشته باشد که فایل‌های .key را به‌طور خودکار و بدون نیاز به ویرایش دستی آن‌ها مدیریت کند.

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

openssl(1), openssl-pkey(1), openssl-pkcs8(1), openssl-dsa(1), openssl-genrsa(1), openssl-gendsa(1)

تاریخچه (HISTORY)

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

حق نشر (COPYRIGHT)

حق نشر ۲۰۰۰-۲۰۲۳ نویسندگان پروژه OpenSSL. تمامی حقوق محفوظ است.

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