نام (NAME)

openssl-spkac - پردازش ساختارهای SPKAC

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

openssl spkac [-help] [-in filename] [-out filename] [-digest digest] [-key filename|uri] [-keyform DER|PEM|P12|ENGINE] [-passin arg] [-challenge string] [-pubkey] [-spkac spkacname] [-spksect section] [-noout] [-verify] [-engine id] [-provider name] [-provider-path path] [-provparam [name:]key=value] [-propquery propq]

توضیحات (DESCRIPTION)

این دستور فایل‌های کلید عمومی و چالش امضاشده نت‌اسکیپ (SPKAC) را پردازش می‌کند. این ابزار می‌تواند محتویات آن‌ها را چاپ کند، امضا را اعتبارسنجی نماید و با استفاده از یک کلید خصوصی ارائه‌شده، ساختارهای SPKAC اختصاصی تولید کند.

گزینه‌ها (OPTIONS)

-help: نمایش یک پیام راهنمای نحوه استفاده.
-in filename: نام فایل ورودی را برای خواندن مشخص می‌کند؛ در صورت مشخص نشدن این گزینه، از ورودی استاندارد خوانده می‌شود. در صورت استفاده از گزینه -key نادیده گرفته می‌شود.
-out filename: نام فایل خروجی را برای نوشتن مشخص می‌کند؛ به‌طور پیش‌فرض در خروجی استاندارد نوشته می‌شود.
-digest digest: از digest مشخص‌شده برای امضای فایل SPKAC ایجادشده استفاده می‌کند. الگوریتم خلاصه پیش‌فرض MD5 است.
-key filename|uri: یک فایل SPKAC با استفاده از کلید خصوصی مشخص‌شده توسط filename یا uri ایجاد می‌کند. در صورت وجود گزینه‌های -in، -noout، -spksect و -verify، نادیده گرفته می‌شوند.
-keyform DER|PEM|P12|ENGINE: قالب کلید؛ به‌طور پیش‌فرض مشخص نشده است. برای جزئیات بیشتر به openssl-format-options(1) مراجعه کنید.
-passin arg: منبع گذرواژه فایل ورودی. برای اطلاعات بیشتر درباره قالب arg به openssl-passphrase-options(1) مراجعه کنید.
-challenge string: در صورت ایجاد یک SPKAC، رشته چالش (challenge) را مشخص می‌کند.
-spkac spkacname: نام متغیری را که حاوی SPKAC است به یک نام جایگزین تغییر می‌دهد. مقدار پیش‌فرض "SPKAC" است. این گزینه هم روی فایل‌های تولیدشده و هم روی فایل‌های ورودی SPKAC اثر می‌گذارد.
-spksect section: نام بخشی (section) را که حاوی SPKAC است به یک نام جایگزین تغییر می‌دهد. مقدار پیش‌فرض، بخش پیش‌فرض است.
-noout: از نمایش نسخه متنی SPKAC در خروجی جلوگیری می‌کند (در صورت ایجاد یک SPKAC استفاده نمی‌شود).
-pubkey: کلید عمومی یک SPKAC را در خروجی چاپ می‌کند (در صورت ایجاد یک SPKAC استفاده نمی‌شود).
-verify: امضای دیجیتال موجود در SPKAC ارائه‌شده را اعتبارسنجی می‌کند.
-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) مراجعه کنید.

مثال‌ها (EXAMPLES)

چاپ محتویات یک SPKAC:

openssl spkac -in spkac.cnf

اعتبارسنجی امضای یک SPKAC:

openssl spkac -in spkac.cnf -noout -verify

ایجاد یک SPKAC با استفاده از رشته چالش "hello":

openssl spkac -key key.pem -challenge hello -out spkac.cnf

نمونه‌ای از یک SPKAC (خطوط طولانی برای خوانایی شکسته شده‌اند):

SPKAC=MIG5MGUwXDANBgkqhkiG9w0BAQEFAANLADBIAkEA\
1cCoq2Wa3Ixs47uI7FPVwHVIPDx5yso105Y6zpozam135a\
8R0CpoRvkkigIyXfcCjiVi5oWk+6FfPaD03uPFoQIDAQAB\
FgVoZWxsbzANBgkqhkiG9w0BAQQFAANBAFpQtY/FojdwkJ\
h1bEIYuc2EeM2KHTWPEepWYeawvHD0gQ3DngSC75YCWnnD\
dq+NQ3F+X4deMx9AaEglZtULwV4=

نکات (NOTES)

یک SPKAC ایجادشده با مؤلفه‌های DN مناسبِ اضافه‌شده، می‌تواند به openssl-ca(1) ارائه شود.

ساختارهای SPKAC معمولاً توسط Netscape هنگام ارسال فرم حاوی تگ KEYGEN به‌عنوان بخشی از فرایند ثبت‌نام گواهی تولید می‌شوند.

رشته چالش یک روش ابتدایی برای اثبات مالکیت کلید خصوصی فراهم می‌کند. با بررسی امضای SPKAC و یک رشته چالش تصادفی، این اطمینان حاصل می‌شود که کاربر کلید خصوصی متناظر با کلید عمومی در حال صدور گواهی را در اختیار دارد. این موضوع در برخی کاربردها اهمیت دارد. بدون این سازوکار، این امکان وجود دارد که یک SPKAC قبلی در یک «حمله بازپخش» (replay attack) مورد استفاده مجدد قرار گیرد.

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

openssl(1), openssl-ca(1)

تاریخچه (HISTORY)

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

گزینه -digest در OpenSSL 3.0 افزوده شد.

حق نشر (COPYRIGHT)

حق نشر 2000-2021 نویسندگان پروژه OpenSSL. کلیه حقوق محفوظ است.

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