نام (NAME)

openssl-storeutl - دستور STORE برای واکشی و مدیریت اشیای رمزنگاری

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

openssl storeutl [-help] [-out file] [-noout] [-passin arg] [-text arg] [-r] [-certs] [-keys] [-crls] [-subject arg] [-issuer arg] [-serial arg] [-alias arg] [-fingerprint arg] [-digest] [-engine id] [-provider name] [-provider-path path] [-provparam [name:]key=value] [-propquery propq] uri

توضیحات (DESCRIPTION)

از این دستور می‌توان برای نمایش محتویات واکشی‌شده از URI داده‌شده (در صورت لزوم پس از رمزگشایی) استفاده کرد.

گزینه‌ها (OPTIONS)

-help

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

-out filename

فایل خروجی را برای نوشتن مشخص می‌کند. در صورت عدم استفاده از این گزینه، از خروجی استاندارد استفاده می‌شود. فایل خروجی می‌تواند همان فایل ورودی باشد که در این صورت محتوای فایل جایگزین خواهد شد. توجه داشته باشید که ورودی/خروجی فایل اتمیک (atomic) نیست؛ فایل خروجی ابتدا خالی و سپس در آن نوشته می‌شود.

-noout

این گزینه از چاپ داده‌های PEM در خروجی جلوگیری می‌کند.

-passin arg

منبع گذرواژه کلید. برای اطلاعات بیشتر درباره قالب arg به openssl-passphrase-options(1) مراجعه کنید.

-text

اشیای مورد نظر را به شکل متنی، مشابه با خروجی -text در openssl-x509(1)، openssl-pkey(1) و غیره، چاپ می‌کند.

-r

در صورت امکان، اشیا را به صورت بازگشتی واکشی می‌کند.

-certs

-keys

-crls

تنها گواهی‌ها، کلیدها یا CRLها را از URI داده‌شده انتخاب می‌کند. با این حال، اگر این URI مجموعه‌ای از نام‌ها (URIها) را بازگرداند، آن نام‌ها همیشه بازگردانده می‌شوند.

توجه داشته باشید که تمامی گزینه‌ها باید پیش از آرگومان uri ارائه شوند.

توجه داشته باشید که -keys منحصراً کلیدهای خصوصی را انتخاب می‌کند؛ هیچ انتخاب‌گری فقط برای کلیدهای عمومی وجود ندارد.

-subject arg

جستجو برای شیئی که نام موضوع (subject) آن برابر با arg باشد.

آرگومان باید در قالب "/type0=value0/type1=value1/type2=..." قالب‌بندی شود. کاراکترهای خاص را می‌توان با "\" (بک‌اسلش) اسکیپ کرد؛ فاصله‌های خالی حفظ می‌شوند. مقادیر خالی مجاز هستند اما در جستجو نادیده گرفته می‌شوند؛ یعنی جستجو با یک مقدار خالی همانند عدم مشخص کردن نوع مربوطه خواهد بود. ارائه یک "/" تکی منجر به یک توالی خالی از RDNها (یک NULL-DN) می‌شود. RDNهای چندمقداره را می‌توان با قرار دادن یک کاراکتر "+" به جای "/" بین گزاره‌های انتساب مقدار صفت (AVAs) که اعضای مجموعه را مشخص می‌کنند، تشکیل داد.

مثال:

"/DC=org/DC=OpenSSL/DC=users/UID=123456+CN=John Doe"

-issuer arg

-serial arg

جستجو برای شیئی با نام صادرکننده (issuer) و شماره سریال داده‌شده. این دو گزینه باید با یکدیگر استفاده شوند. آرگومان issuer باید به قالب "/type0=value0/type1=value1/type2=..." قالب‌بندی شود، کاراکترها را می‌توان با \ (بک‌اسلش) اسکیپ کرد و هیچ فاصله‌ای نادیده گرفته نمی‌شود. آرگومان serial می‌تواند به صورت یک مقدار ده‌دهی یا در صورت همراه بودن با پیشوند "0x" به صورت یک مقدار هگزادسیمال مشخص شود.

-alias arg

جستجو برای شیئی که نام مستعار (alias) داده‌شده را دارد.

-fingerprint arg

جستجو برای شیئی که دارای اثر انگشت (fingerprint) مشخص‌شده است.

-digest

خلاصه پیامی (digest) که برای محاسبه اثر انگشت ارائه‌شده با -fingerprint استفاده شده است.

-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) مراجعه کنید.

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

openssl(1)

تاریخچه (HISTORY)

این دستور در OpenSSL 1.1.1 اضافه شد.

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

حق نشر (COPYRIGHT)

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

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