.\" -*- 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-FIPSINSTALL 1ssl" .TH OPENSSL-FIPSINSTALL 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\-fipsinstall \- انجام نصب پیکربندی FIPS .SH "خلاصه دستور (SYNOPSIS)" .IX Header "SYNOPSIS" \&\fBopenssl fipsinstall\fR [\fB\-help\fR] [\fB\-in\fR \fIconfigfilename\fR] [\fB\-out\fR \fIconfigfilename\fR] [\fB\-module\fR \fImodulefilename\fR] [\fB\-provider_name\fR \fIprovidername\fR] [\fB\-section_name\fR \fIsectionname\fR] [\fB\-verify\fR] [\fB\-mac_name\fR \fImacname\fR] [\fB\-macopt\fR \fInm\fR:\fIv\fR] [\fB\-noout\fR] [\fB\-quiet\fR] [\fB\-pedantic\fR] [\fB\-no_conditional_errors\fR] [\fB\-no_security_checks\fR] [\fB\-hmac_key_check\fR] [\fB\-kmac_key_check\fR] [\fB\-ems_check\fR] [\fB\-no_drbg_truncated_digests\fR] [\fB\-signature_digest_check\fR] [\fB\-hkdf_digest_check\fR] [\fB\-tls13_kdf_digest_check\fR] [\fB\-tls1_prf_digest_check\fR] [\fB\-sshkdf_digest_check\fR] [\fB\-sskdf_digest_check\fR] [\fB\-x963kdf_digest_check\fR] [\fB\-dsa_sign_disabled\fR] [\fB\-no_pbkdf2_lower_bound_check\fR] [\fB\-no_short_mac\fR] [\fB\-tdes_encrypt_disabled\fR] [\fB\-rsa_pkcs15_padding_disabled\fR] [\fB\-rsa_pss_saltlen_check\fR] [\fB\-rsa_sign_x931_disabled\fR] [\fB\-hkdf_key_check\fR] [\fB\-kbkdf_key_check\fR] [\fB\-tls13_kdf_key_check\fR] [\fB\-tls1_prf_key_check\fR] [\fB\-sshkdf_key_check\fR] [\fB\-sskdf_key_check\fR] [\fB\-x963kdf_key_check\fR] [\fB\-x942kdf_key_check\fR] [\fB\-ecdh_cofactor_check\fR] [\fB\-self_test_onload\fR] [\fB\-self_test_oninstall\fR] [\fB\-corrupt_desc\fR \fIselftest_description\fR] [\fB\-corrupt_type\fR \fIselftest_type\fR] [\fB\-config\fR \fIparent_config\fR] .SH "توضیحات (DESCRIPTION)" .IX Header "DESCRIPTION" این دستور برای تولید یک فایل پیکربندی ماژول FIPS استفاده می‌شود. این فایل پیکربندی می‌تواند هر بار که یک ماژول FIPS بارگذاری می‌شود، به منظور ارسال داده‌ها به خودآزمایی‌های ماژول FIPS مورد استفاده قرار گیرد. ماژول FIPS همواره MAC خود را تأیید می‌کند، اما به‌طور اختیاری تنها لازم است KATها (خودآزمایی‌های با پاسخ معلوم) را یک‌بار در زمان نصب اجرا کند. .PP فایل پیکربندی تولیدشده شامل موارد زیر است: .IP "\- یک MAC از فایل ماژول FIPS." 4 .IX Item "- A MAC of the FIPS module file." .PD 0 .IP "\- یک نشانگر وضعیت آزمایش." 4 .IX Item "- A test status indicator." .PD این نشان می‌دهد که آیا خودآزمایی‌های با پاسخ معلوم (KATها) با موفقیت اجرا شده‌اند یا خیر. .IP "\- یک MAC از نشانگر وضعیت." 4 .IX Item "- A MAC of the status indicator." .PD 0 .IP "\- یک کنترل برای خطاهای خودآزمایی مشروط." 4 .IX Item "- A control for conditional self tests errors." .PD به‌طور پیش‌فرض، اگر یک آزمایش پیوسته (مثلاً آزمایش جفت‌کلید) ناموفق باشد، ماژول FIPS وارد وضعیت خطا می‌شود و پس از این نقطه، هیچ سرویس یا الگوریتم رمزنگاری قابل دسترسی نخواهد بود. مقدار پیش‌فرض \*(Aq1\*(Aq باعث می‌شود ماژول FIPS وارد وضعیت خطا شود. اگر مقدار \*(Aq0\*(Aq باشد، ماژول وارد وضعیت خطا نخواهد شد. صرف‌نظر از اینکه وضعیت خطا وارد شود یا خیر، عملیات فعلی (مثلاً تولید کلید) با خطا مواجه خواهد شد. در صورتی که ماژول وارد وضعیت خطا نشود، کاربر مسئول تکرار عملیات است. .IP "\- یک کنترل برای مشخص کردن انجام بررسی‌های امنیتی زمان اجرا." 4 .IX Item "- A control to indicate whether run-time security checks are done." این نشان می‌دهد که آیا بررسی‌های زمان اجرا مربوط به اعمال پارامترهای امنیتی مانند حداقل استحکام امنیتی کلیدها و نام‌های منحنی تأییدشده استفاده می‌شوند یا خیر. مقدار پیش‌فرض \*(Aq1\*(Aq بررسی‌ها را انجام می‌دهد. اگر مقدار \*(Aq0\*(Aq باشد، بررسی‌ها انجام نمی‌شوند و انطباق با FIPS باید با رویه‌های مستندشده در خط‌مشی امنیتی مربوطه انجام گیرد. .PP این فایل در \fBfips_config\fR\|(5) توضیح داده شده است. .SH "گزینه‌ها (OPTIONS)" .IX Header "OPTIONS" .IP \fB\-help\fR 4 .IX Item "-help" چاپ یک پیام راهنمای نحوه استفاده. .IP "\fB\-module\fR \fIfilename\fR" 4 .IX Item "-module filename" نام فایل ماژول FIPS برای انجام بررسی یکپارچگی روی آن. مسیر ارائه‌شده در نام فایل برای بارگذاری ماژول در زمان فعال‌سازی آن استفاده می‌شود، و این مقدار بر متغیر محیطی \fBOPENSSL_MODULES\fR برتری دارد. .IP "\fB\-out\fR \fIconfigfilename\fR" 4 .IX Item "-out configfilename" نام فایل برای نوشتن داده‌های پیکربندی در خروجی؛ پیش‌فرض خروجی استاندارد است. .IP "\fB\-in\fR \fIconfigfilename\fR" 4 .IX Item "-in configfilename" نام فایل ورودی برای بارگذاری داده‌های پیکربندی از آن. در صورت مشخص شدن گزینه \fB\-verify\fR باید استفاده شود. .IP \fB\-verify\fR 4 .IX Item "-verify" تأیید اینکه فایل پیکربندی ورودی حاوی اطلاعات صحیح است. .IP "\fB\-provider_name\fR \fIprovidername\fR" 4 .IX Item "-provider_name providername" نام ارائه‌دهنده در داخل فایل پیکربندی. مقدار پیش‌فرض \f(CW\*(C`fips\*(C'\fR است. .IP "\fB\-section_name\fR \fIsectionname\fR" 4 .IX Item "-section_name sectionname" نام بخش در داخل فایل پیکربندی. مقدار پیش‌فرض \f(CW\*(C`fips_sect\*(C'\fR است. .IP "\fB\-mac_name\fR \fIname\fR" 4 .IX Item "-mac_name name" نام یک الگوریتم MAC پشتیبانی‌شده را که مورد استفاده قرار خواهد گرفت مشخص می‌کند. سازوکارهای MAC موجود به گزینه‌های استفاده‌شده هنگام ساخت OpenSSL بستگی دارد. برای مشاهده فهرست MACهای پشتیبانی‌شده، از دستور \&\f(CW\*(C`openssl list \-mac\-algorithms\*(C'\fR استفاده کنید. مقدار پیش‌فرض \fBHMAC\fR است. .IP "\fB\-macopt\fR \fInm\fR:\fIv\fR" 4 .IX Item "-macopt nm:v" گزینه‌ها را به الگوریتم MAC ارسال می‌کند. فهرست کاملی از کنترل‌ها را می‌توان در مستندات پیاده‌سازی EVP_MAC یافت. رشته‌های کنترلی متداول مورداستفاده برای این دستور عبارتند از: .RS 4 .IP \fBkey\fR:\fIstring\fR 4 .IX Item "key:string" کلید MAC را به صورت یک رشته حرفی‌عددی مشخص می‌کند (تنها زمانی استفاده شود که کلید فقط شامل نویسه‌های قابل‌چاپ باشد). طول رشته باید با محدودیت‌های الگوریتم MAC مطابقت داشته باشد. برای هر الگوریتم MAC باید یک کلید مشخص شود. اگر کلیدی ارائه نشود، مقدار پیش‌فرضی که در هنگام پیکربندی OpenSSL تعیین شده بود استفاده می‌شود. .IP \fBhexkey\fR:\fIstring\fR 4 .IX Item "hexkey:string" کلید MAC را در قالب هگزادسیمال مشخص می‌کند (دو رقم هگزادسیمال به ازای هر بایت). طول کلید باید با محدودیت‌های الگوریتم MAC مطابقت داشته باشد. برای هر الگوریتم MAC باید یک کلید مشخص شود. اگر کلیدی ارائه نشود، مقدار پیش‌فرضی که در هنگام پیکربندی OpenSSL تعیین شده بود استفاده می‌شود. .IP \fBdigest\fR:\fIstring\fR 4 .IX Item "digest:string" توسط HMAC به عنوان یک رشته حرفی‌عددی استفاده می‌شود (تنها زمانی استفاده شود که کلید فقط شامل نویسه‌های قابل‌چاپ باشد). طول رشته باید با محدودیت‌های الگوریتم MAC مطابقت داشته باشد. برای مشاهده فهرست دایجست‌های پشتیبانی‌شده، از دستور \&\f(CW\*(C`openssl list \-digest\-commands\*(C'\fR استفاده کنید. دایجست پیش‌فرض SHA\-256 است. .RE .RS 4 .RE .IP \fB\-noout\fR 4 .IX Item "-noout" غیرفعال کردن ثبت گزارش‌های خودآزمایی‌ها. .IP \fB\-pedantic\fR 4 .IX Item "-pedantic" پیکربندی ماژول به گونه‌ای که به‌جای سازگاری رو به عقب، کاملاً و با دقت منطبق بر FIPS باشد. این گزینه خطاهای مشروط، بررسی‌های امنیتی و غیره را فعال می‌کند. توجه داشته باشید که هر گزینهٔ پیکربندی قبلی بازنویسی خواهد شد و هر گزینهٔ پیکربندی بعدی که با انطباق FIPS مغایرت داشته باشد، منجر به خطا می‌شود. .IP \fB\-no_conditional_errors\fR 4 .IX Item "-no_conditional_errors" ماژول را طوری پیکربندی می‌کند که در صورت شکست یک خودآزمایی مشروط، همان‌طور که در بالا توضیح داده شد وارد وضعیت خطا نشود. .IP \fB\-no_security_checks\fR 4 .IX Item "-no_security_checks" ماژول را طوری پیکربندی می‌کند که بررسی‌های امنیتی زمان اجرا را همان‌طور که در بالا شرح داده شد انجام ندهد. .Sp فعال کردن گزینهٔ پیکربندی "no\-fips\-securitychecks" راه دیگری برای غیرفعال کردن این بررسی در زمان کامپایل فراهم می‌کند. .IP \fB\-ems_check\fR 4 .IX Item "-ems_check" ماژول را طوری پیکربندی می‌کند که هنگام استفاده از الگوریتم TLS1_PRF KDF، بررسی زمان اجرای Extended Master Secret (EMS) فعال شود. این بررسی به‌طور پیش‌فرض غیرفعال است. برای اطلاعات مربوط به EMS به RFC 7627 مراجعه کنید. .IP \fB\-no_short_mac\fR 4 .IX Item "-no_short_mac" ماژول را طوری پیکربندی می‌کند که خروجی‌های کوتاه MAC را مجاز نداند. برای جزئیات به SP 800\-185 8.4.2 و FIPS 140\-3 ID C.D مراجعه کنید. .IP \fB\-hmac_key_check\fR 4 .IX Item "-hmac_key_check" ماژول را طوری پیکربندی می‌کند که هنگام استفاده از HMAC، اندازه کلیدهای کوچک را مجاز نداند. برای جزئیات به SP 800\-131Ar2 مراجعه کنید. .IP \fB\-kmac_key_check\fR 4 .IX Item "-kmac_key_check" ماژول را طوری پیکربندی می‌کند که هنگام استفاده از KMAC، اندازه کلیدهای کوچک را مجاز نداند. برای جزئیات به SP 800\-131Ar2 مراجعه کنید. .IP \fB\-no_drbg_truncated_digests\fR 4 .IX Item "-no_drbg_truncated_digests" ماژول را طوری پیکربندی می‌کند که اجازه استفاده از دایجست‌های کوتاه‌شده را همراه با Hash DRBG و HMAC DRBG ندهد. برای جزئیات به FIPS 140\-3 IG D.R مراجعه کنید. .IP \fB\-signature_digest_check\fR 4 .IX Item "-signature_digest_check" ماژول را طوری پیکربندی می‌کند که الگوریتم‌های امضا را ملزم به استفاده از دایجست‌هایی کند که صراحتاً توسط استانداردهای مختلف مجاز شمرده شده‌اند. .IP \fB\-hkdf_digest_check\fR 4 .IX Item "-hkdf_digest_check" این گزینه منسوخ شده است. .IP \fB\-tls13_kdf_digest_check\fR 4 .IX Item "-tls13_kdf_digest_check" ماژول را طوری پیکربندی می‌کند که هنگام اشتقاق کلید توسط TLS13 KDF، بررسی زمان اجرای دایجست فعال شود. برای جزئیات به RFC 8446 مراجعه کنید. .IP \fB\-tls1_prf_digest_check\fR 4 .IX Item "-tls1_prf_digest_check" ماژول را طوری پیکربندی می‌کند که هنگام اشتقاق کلید توسط TLS_PRF، بررسی زمان اجرای دایجست فعال شود. برای جزئیات به NIST SP 800\-135r1 مراجعه کنید. .IP \fB\-sshkdf_digest_check\fR 4 .IX Item "-sshkdf_digest_check" ماژول را طوری پیکربندی می‌کند که هنگام اشتقاق کلید توسط SSHKDF، بررسی زمان اجرای دایجست فعال شود. برای جزئیات به NIST SP 800\-135r1 مراجعه کنید. .IP \fB\-sskdf_digest_check\fR 4 .IX Item "-sskdf_digest_check" این گزینه منسوخ شده است. .IP \fB\-x963kdf_digest_check\fR 4 .IX Item "-x963kdf_digest_check" ماژول را طوری پیکربندی می‌کند که هنگام اشتقاق کلید توسط X963KDF، بررسی زمان اجرای دایجست فعال شود. برای جزئیات به NIST SP 800\-131Ar2 مراجعه کنید. .IP \fB\-dsa_sign_disabled\fR 4 .IX Item "-dsa_sign_disabled" ماژول را طوری پیکربندی می‌کند که امضای DSA مجاز نباشد (تأیید امضای DSA همچنان مجاز است). برای جزئیات به FIPS 140\-3 IG C.K مراجعه کنید. .IP \fB\-tdes_encrypt_disabled\fR 4 .IX Item "-tdes_encrypt_disabled" ماژول را طوری پیکربندی می‌کند که رمزگذاری Triple\-DES را مجاز نداند. رمزگشایی Triple\-DES برای اهداف سازگاری قدیمی همچنان مجاز است. برای جزئیات به SP800\-131Ar2 مراجعه کنید. .IP \fB\-rsa_pkcs15_padding_disabled\fR 4 .IX Item "-rsa_pkcs15_padding_disabled" ماژول را طوری پیکربندی می‌کند که استفاده از لایه‌گذاری نسخه 1.5 PKCS#1 همراه با RSA برای انتقال کلید و توافق کلید مجاز نباشد. برای جزئیات به ویرایش دوم NIST SP 800\-131A مراجعه کنید. .IP \fB\-rsa_pss_saltlen_check\fR 4 .IX Item "-rsa_pss_saltlen_check" ماژول را طوری پیکربندی می‌کند که هنگام تولید یا تأیید امضای RSA\-PSS، بررسی زمان اجرای طول سالت فعال شود. برای جزئیات به FIPS 186\-5 5.4 (g) مراجعه کنید. .IP \fB\-rsa_sign_x931_disabled\fR 4 .IX Item "-rsa_sign_x931_disabled" ماژول را طوری پیکربندی می‌کند که هنگام امضا با RSA، استفاده از لایه‌گذاری X9.31 مجاز نباشد. برای جزئیات به FIPS 140\-3 IG C.K مراجعه کنید. .IP \fB\-hkdf_key_check\fR 4 .IX Item "-hkdf_key_check" ماژول را طوری پیکربندی می‌کند که هنگام اشتقاق کلید توسط HKDF، بررسی زمان اجرای کوتاهی کلید اشتقاق فعال شود. برای جزئیات به NIST SP 800\-131Ar2 مراجعه کنید. .IP \fB\-kbkdf_key_check\fR 4 .IX Item "-kbkdf_key_check" ماژول را طوری پیکربندی می‌کند که هنگام اشتقاق کلید توسط KBKDF، بررسی زمان اجرای کوتاهی کلید اشتقاق فعال شود. برای جزئیات به NIST SP 800\-131Ar2 مراجعه کنید. .IP \fB\-tls13_kdf_key_check\fR 4 .IX Item "-tls13_kdf_key_check" ماژول را طوری پیکربندی می‌کند که هنگام اشتقاق کلید توسط TLS13 KDF، بررسی زمان اجرای کوتاهی کلید اشتقاق فعال شود. برای جزئیات به NIST SP 800\-131Ar2 مراجعه کنید. .IP \fB\-tls1_prf_key_check\fR 4 .IX Item "-tls1_prf_key_check" ماژول را طوری پیکربندی می‌کند که هنگام اشتقاق کلید توسط TLS_PRF، بررسی زمان اجرای کوتاهی کلید اشتقاق فعال شود. برای جزئیات به NIST SP 800\-131Ar2 مراجعه کنید. .IP \fB\-sshkdf_key_check\fR 4 .IX Item "-sshkdf_key_check" ماژول را طوری پیکربندی می‌کند که هنگام اشتقاق کلید توسط SSHKDF، بررسی زمان اجرای کوتاهی کلید اشتقاق فعال شود. برای جزئیات به NIST SP 800\-131Ar2 مراجعه کنید. .IP \fB\-sskdf_key_check\fR 4 .IX Item "-sskdf_key_check" ماژول را طوری پیکربندی می‌کند که هنگام اشتقاق کلید توسط SSKDF، بررسی زمان اجرای کوتاهی کلید اشتقاق فعال شود. برای جزئیات به NIST SP 800\-131Ar2 مراجعه کنید. .IP \fB\-x963kdf_key_check\fR 4 .IX Item "-x963kdf_key_check" ماژول را طوری پیکربندی می‌کند که هنگام اشتقاق کلید توسط X963KDF، بررسی زمان اجرای کوتاهی کلید اشتقاق فعال شود. برای جزئیات به NIST SP 800\-131Ar2 مراجعه کنید. .IP \fB\-x942kdf_key_check\fR 4 .IX Item "-x942kdf_key_check" ماژول را طوری پیکربندی می‌کند که هنگام اشتقاق کلید توسط X942KDF، بررسی زمان اجرای کوتاهی کلید اشتقاق فعال شود. برای جزئیات به NIST SP 800\-131Ar2 مراجعه کنید. .IP \fB\-no_pbkdf2_lower_bound_check\fR 4 .IX Item "-no_pbkdf2_lower_bound_check" ماژول را طوری پیکربندی می‌کند که بررسی حد پایین زمان اجرا را برای PBKDF2 انجام ندهد. برای جزئیات به NIST SP 800\-132 مراجعه کنید. .IP \fB\-ecdh_cofactor_check\fR 4 .IX Item "-ecdh_cofactor_check" ماژول را طوری پیکربندی می‌کند که بررسی زمان اجرای استفادهٔ ECDH از مقدار کوفاکتور منحنی‌های بیضوی هنگام اشتقاق کلید فعال شود. این گزینه فقط بر منحنی‌های \*(AqB\*(Aq و \*(AqK\*(Aq تأثیر می‌گذارد. برای جزئیات به بخش 5.7.1.2 از SP 800\-56A r3 مراجعه کنید. .IP \fB\-self_test_onload\fR 4 .IX Item "-self_test_onload" دو فیلد مربوط به «test status indicator» و «MAC status indicator» در فایل پیکربندی خروجی نوشته نمی‌شوند. بدون این فیلدها، خودآزمایی‌های KAT هر بار که ماژول بارگذاری می‌شود اجرا خواهند شد. این گزینه می‌تواند برای کامپایل متقابل (cross compiling) استفاده شود، زیرا خودآزمایی‌ها باید حداقل یک‌بار روی هر ماشین مقصد اجرا شوند. هنگامی که خودآزمایی‌ها روی ماشین مقصد اجرا شدند، کاربر احتمالاً می‌تواند آن ۲ فیلد را با استفاده از سازوکار دیگری به پیکربندی اضافه کند. این گزینه برای هر ارائه‌دهندهٔ OpenSSL FIPS 140\-2 (نسخه OpenSSL 3.0.X) به‌طور پیش‌فرض 0 است، و برای ارائه‌دهندهٔ OpenSSL FIPS 140\-3 کاربردی ندارد، زیرا دیگر مجاز نیست. .IP \fB\-self_test_oninstall\fR 4 .IX Item "-self_test_oninstall" برعکس گزینهٔ \fB\-self_test_onload\fR. دو فیلد مربوط به «test status indicator» و «MAC status indicator» در فایل پیکربندی خروجی نوشته می‌شوند. این فیلد برای ارائه‌دهندهٔ OpenSSL FIPS 140\-3 کاربردی ندارد، زیرا دیگر مجاز نیست. .IP \fB\-quiet\fR 4 .IX Item "-quiet" عدم نمایش پیام‌های موفقیت/شکست (pass/fail). این گزینه متضمن \fB\-noout\fR است. .IP "\fB\-corrupt_desc\fR \fIselftest_description\fR, \fB\-corrupt_type\fR \fIselftest_type\fR" 4 .IX Item "-corrupt_desc selftest_description, -corrupt_type selftest_type" گزینه‌های تخریب می‌توانند برای آزمایش شکست یک یا چند خودآزمایی بر اساس نام استفاده شوند. از هر یک از این دو گزینه یا هر دو می‌توان برای انتخاب آزمایش‌ها جهت تخریب استفاده کرد. برای مقادیری که می‌توانند استفاده شوند، به مدخل‌های مربوط به \fBst\-desc\fR و \fBst\-type\fR در \fBOSSL_PROVIDER\-FIPS\fR\|(7) مراجعه کنید. .IP "\fB\-config\fR \fIparent_config\fR" 4 .IX Item "-config parent_config" بررسی اینکه آیا یک ارائه‌دهندهٔ FIPS می‌تواند از فایل پیکربندی مشخص‌شده بارگذاری شود یا خیر. فراخوانی پیشین این برنامه باید داده‌های پیکربندی اضافی را که توسط فایل پیکربندی پایهٔ \f(CW\*(C`parent_config\*(C'\fR فراخوانی می‌شوند تولید کرده باشد. برای اطلاعات بیشتر در مورد نحوه راه‌اندازی یک بخش ارائه‌دهنده، به \fBconfig\fR\|(5) مراجعه کنید. در صورت استفاده از \*(Aq\-config\*(Aq، تمام گزینه‌های دیگر نادیده گرفته می‌شوند. .SH "نکات (NOTES)" .IX Header "NOTES" نتایج خودآزمایی‌ها به‌طور پیش‌فرض ثبت می‌شوند، مگر اینکه گزینه‌های \fB\-quiet\fR و \fB\-noout\fR مشخص نشده باشند، یا اینکه یکی از گزینه‌های \fB\-corrupt_desc\fR یا \&\fB\-corrupt_type\fR استفاده شده باشد. اگر فایل پیکربندی پایه طوری تنظیم شده باشد که ماژول fips را به‌طور خودکار بارگذاری کند، ماژول fips پیش از آنکه برنامهٔ fipsinstall فرصتی برای راه‌اندازی کال‌بک خودآزمایی خود داشته باشد، بارگذاری شده و خودآزمایی می‌شود. در نتیجه، خروجی خودآزمایی و گزینه‌های \fB\-corrupt_desc\fR و \fB\-corrupt_type\fR نادیده گرفته خواهند شد. برای استفادهٔ عادی، فایل پیکربندی پایه هنگام تولید فایل پیکربندی fips باید از ارائه‌دهندهٔ پیش‌فرض استفاده کند. .PP گزینهٔ \fB\-self_test_oninstall\fR اضافه شد و گزینهٔ \&\fB\-self_test_onload\fR در OpenSSL 3.1 به عنوان پیش‌فرض قرار گرفت. .PP این دستور و تمامی گزینه‌های باقی‌مانده در OpenSSL 3.0 اضافه شدند. .SH "مثال‌ها (EXAMPLES)" .IX Header "EXAMPLES" محاسبهٔ mac ماژول FIPS با نام \fIfips.so\fR، اجرای خودآزمایی FIPS برای ماژول، و ذخیرهٔ فایل پیکربندی \fIfips.cnf\fR: .PP .Vb 1 \& openssl fipsinstall \-module ./fips.so \-out fips.cnf \-provider_name fips .Ve .PP تأیید اینکه فایل پیکربندی \fIfips.cnf\fR حاوی اطلاعات صحیح است: .PP .Vb 1 \& openssl fipsinstall \-module ./fips.so \-in fips.cnf \-provider_name fips \-verify .Ve .PP تخریب هرگونه خودآزمایی که دارای شرح \f(CW\*(C`SHA1\*(C'\fR باشد: .PP .Vb 2 \& openssl fipsinstall \-module ./fips.so \-out fips.cnf \-provider_name fips \e \& \-corrupt_desc \*(AqSHA1\*(Aq .Ve .PP اعتبارسنجی امکان بارگذاری ماژول fips از یک فایل پیکربندی پایه: .PP .Vb 3 \& export OPENSSL_CONF_INCLUDE= \& export OPENSSL_MODULES= \& openssl fipsinstall \-config\*(Aq \*(Aqdefault.cnf\*(Aq .Ve .SH "همچنین ببینید (SEE ALSO)" .IX Header "SEE ALSO" \&\fBconfig\fR\|(5), \&\fBfips_config\fR\|(5), \&\fBOSSL_PROVIDER\-FIPS\fR\|(7), \&\fBEVP_MAC\fR\|(3) .SH "تاریخچه (HISTORY)" .IX Header "HISTORY" برنامهٔ \fBopenssl\-fipsinstall\fR در OpenSSL 3.0 اضافه شد. .PP گزینه‌های زیر در OpenSSL 3.1 اضافه شدند: .PP \&\fB\-ems_check\fR, \&\fB\-self_test_oninstall\fR .PP گزینه‌های زیر در OpenSSL 3.2 اضافه شدند: .PP \&\fB\-pedantic\fR, \&\fB\-no_drbg_truncated_digests\fR .PP گزینه‌های زیر در OpenSSL 3.4 اضافه شدند: .PP \&\fB\-hmac_key_check\fR, \&\fB\-kmac_key_check\fR, \&\fB\-signature_digest_check\fR, \&\fB\-hkdf_digest_check\fR, \&\fB\-tls13_kdf_digest_check\fR, \&\fB\-tls1_prf_digest_check\fR, \&\fB\-sshkdf_digest_check\fR, \&\fB\-sskdf_digest_check\fR, \&\fB\-x963kdf_digest_check\fR, \&\fB\-dsa_sign_disabled\fR, \&\fB\-no_pbkdf2_lower_bound_check\fR, \&\fB\-no_short_mac\fR, \&\fB\-tdes_encrypt_disabled\fR, \&\fB\-rsa_pkcs15_padding_disabled\fR, \&\fB\-rsa_pss_saltlen_check\fR, \&\fB\-rsa_sign_x931_disabled\fR, \&\fB\-hkdf_key_check\fR, \&\fB\-kbkdf_key_check\fR, \&\fB\-tls13_kdf_key_check\fR, \&\fB\-tls1_prf_key_check\fR, \&\fB\-sshkdf_key_check\fR, \&\fB\-sskdf_key_check\fR, \&\fB\-x963kdf_key_check\fR, \&\fB\-x942kdf_key_check\fR, \&\fB\-ecdh_cofactor_check\fR .SH "حق نشر (COPYRIGHT)" .IX Header "COPYRIGHT" حق نشر 2019\-2025 متعلق به The OpenSSL Project Authors است. کلیه حقوق محفوظ است. .PP تحت مجوز آپاچی نسخه 2.0 («مجوز») منتشر شده است. شما نمی‌توانید از این فایل استفاده کنید مگر در انطباق با این مجوز. می‌توانید یک نسخه از آن را در فایل LICENSE در توزیع مبدأ یا در دریافت نمایید.