نام (NAME)

openssl-ecparam - دستکاری و تولید پارامترهای EC (خم بیضوی)

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

openssl ecparam [-help] [-inform DER|PEM] [-outform DER|PEM] [-in filename] [-out filename] [-noout] [-text] [-check] [-check_named] [-name arg] [-list_curves] [-conv_form arg] [-param_enc arg] [-no_seed] [-genkey] [-engine id] [-rand files] [-writerand file] [-provider name] [-provider-path path] [-provparam [name:]key=value] [-propquery propq]

توضیحات (DESCRIPTION)

این دستور برای دستکاری یا تولید فایل‌های پارامتر EC (خم بیضوی) به کار می‌رود.

اوپن‌اس‌اس‌ال در حال حاضر قادر به تولید گروه‌های جدید نیست و از این رو این دستور تنها می‌تواند پارامترهای EC را از خم‌های شناخته‌شده (نام‌گذاری‌شده) ایجاد کند.

گزینه‌ها (OPTIONS)

-help: پیام راهنمای نحوهٔ استفاده از دستور را نمایش می‌دهد.
-inform DER|PEM: قالب ورودی پارامترهای EC؛ به‌طور پیش‌فرض تعیین نشده است. برای جزئیات بیشتر به openssl-format-options(1) مراجعه کنید.
-outform DER|PEM: قالب خروجی پارامترهای EC؛ مقدار پیش‌فرض PEM است. برای جزئیات بیشتر به openssl-format-options(1) مراجعه کنید.
پارامترها همان‌طور که در RFC 3279 از IETF مشخص شده، به عنوان EcpkParameters کدگذاری می‌شوند.
-in filename: فایل ورودی را برای خواندن پارامترها مشخص می‌کند، یا در صورت تعیین نشدن این گزینه، از ورودی استاندارد استفاده می‌شود.
-out filename: نام فایل خروجی را برای نوشتن پارامترها مشخص می‌کند. در صورت عدم حضور این گزینه از خروجی استاندارد استفاده می‌شود. نام فایل خروجی می‌تواند با نام فایل ورودی یکسان باشد که منجر به جایگزینی محتوای فایل خواهد شد. توجه داشته باشید که ورودی/خروجی فایل به‌صورت اتمیک (atomic) نیست. فایل خروجی ابتدا کوتاه‌سازی (truncate) شده و سپس نوشته می‌شود.
-noout: این گزینه از چاپ نسخهٔ کدگذاری‌شدهٔ پارامترها در خروجی جلوگیری می‌کند.
-text: این گزینه پارامترهای EC را در قالبی خوانا برای انسان چاپ می‌کند.
-check: پارامترهای خم بیضوی را اعتبارسنجی می‌کند.
-check_named: پارامترهای نام خم بیضوی را با بررسی مطابقت پارامترهای خم با هر یک از خم‌های توکار (built-in) اعتبارسنجی می‌کند.
-name arg: از پارامترهای EC با «نام کوتاه» مشخص‌شده استفاده می‌کند. برای دریافت فهرستی از تمام پارامترهای EC پیاده‌سازی‌شدهٔ فعلی از -list_curves استفاده کنید.
-list_curves: فهرستی از تمام نام‌های پارامترهای EC پیاده‌سازی‌شدهٔ کنونی را چاپ کرده و خارج می‌شود.
-conv_form arg: چگونگی تبدیل نقاط روی خم بیضوی به رشته‌های هشت‌بیتی (octet strings) را مشخص می‌کند. مقادیر ممکن عبارتند از: compressed، uncompressed (مقدار پیش‌فرض) و hybrid. برای اطلاعات بیشتر درباره قالب‌های تبدیل نقطه لطفاً استاندارد X9.62 را مطالعه کنید. نکته: به‌دلیل مسائل مربوط به حق اختراع (پتنت)، گزینهٔ compressed به‌طور پیش‌فرض برای خم‌های دودویی غیرفعال است و می‌تواند با تعریف ماکروی پیش‌پردازندهٔ OPENSSL_EC_BIN_PT_COMP در زمان کامپایل فعال شود.
-param_enc arg: نحوهٔ کدگذاری پارامترهای خم بیضوی را مشخص می‌کند. مقادیر ممکن عبارتند از: named_curve، یعنی پارامترهای ec توسط یک OID مشخص می‌شوند، یا explicit که در آن پارامترهای ec به‌طور صریح ارائه می‌شوند (برای تعریف ساختارهای پارامترهای EC به RFC 3279 مراجعه کنید). مقدار پیش‌فرض named_curve است. نکته: گزینهٔ جایگزین implicitlyCA، همان‌طور که در RFC 3279 مشخص شده، در حال حاضر در OpenSSL پیاده‌سازی نشده است.
-no_seed: این گزینه از گنجانده شدن «seed» برای تولید پارامتر در ساختار ECParameters جلوگیری می‌کند (به RFC 3279 مراجعه کنید).
-genkey: این گزینه با استفاده از پارامترهای مشخص‌شده یک کلید خصوصی EC تولید می‌کند.
-engine id: بخش «Engine Options» در openssl(1) را ببینید. این گزینه منسوخ شده است.
-rand files, -writerand file: برای جزئیات بیشتر به «Random State Options» در openssl(1) مراجعه کنید.
-provider name
-provider-path path
-provparam [name:]key=value
-propquery propq: به «Provider Options» در openssl(1)، provider(7) و property(7) مراجعه کنید.

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

مثال‌ها (EXAMPLES)

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

برای ایجاد پارامترهای EC با گروه 'prime192v1':

openssl ecparam -out ec_param.pem -name prime192v1

برای ایجاد پارامترهای EC با پارامترهای صریح (explicit):

openssl ecparam -out ec_param.pem -name prime192v1 -param_enc explicit

برای اعتبارسنجی پارامترهای EC داده‌شده:

openssl ecparam -in ec_param.pem -check

برای ایجاد پارامترهای EC و یک کلید خصوصی:

openssl ecparam -out ec_key.pem -name prime192v1 -genkey

برای تغییر کدگذاری نقاط به حالت 'compressed' (فشرده):

openssl ecparam -in ec_in.pem -out ec_out.pem -conv_form compressed

برای چاپ پارامترهای EC در خروجی استاندارد:

openssl ecparam -in ec_param.pem -noout -text

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

openssl(1), openssl-pkeyparam(1), openssl-genpkey(1), openssl-ec(1), openssl-dsaparam(1)

تاریخچه (HISTORY)

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

گزینهٔ -C در OpenSSL 3.0 حذف گردید.

حق نشر (COPYRIGHT)

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

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