.\" -*- 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 "FIPS_CONFIG 5ssl" .TH FIPS_CONFIG 5ssl 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)" fips_config \- پیکربندی FIPS در OpenSSL .SH "توضیحات (DESCRIPTION)" .IX Header "DESCRIPTION" یک فایل پیکربندی جداگانه با استفاده از نحو \fBconfig\fR\|(5) در OpenSSL، برای نگهداری اطلاعات مربوط به ماژول FIPS استفاده می‌شود. این اطلاعات شامل خلاصه (digest) فایل کتابخانه مشترک و وضعیت خودآزمایی‌ها است. این داده‌ها به طور خودکار توسط خود ماژول برای دو هدف به کار می‌روند: .IP "\- اجرای آزمون‌های پاسخ مشخص (KATs) خودآزمایی هنگام راه‌اندازی FIPS." 4 .IX Item "- Run the startup FIPS self-test known answer tests (KATS)." این کار معمولاً یک بار در زمان نصب انجام می‌شود، اما می‌تواند طوری تنظیم شود که با هر بار استفاده از ماژول نیز اجرا گردد. .IP "\- تأیید جمع‌کنترلی (checksum) ماژول." 4 .IX Item "- Verify the module's checksum." این کار هر بار که ماژول استفاده می‌شود انجام می‌گیرد. .PP این فایل توسط برنامه \fBopenssl\-fipsinstall\fR\|(1) تولید می‌شود و به صورت داخلی توسط ماژول FIPS در طول مقداردهی اولیه آن مورد استفاده قرار می‌گیرد. .PP گزینه‌های زیر پشتیبانی می‌شوند. همه آن‌ها باید در بخشی ظاهر شوند که نام آن توسط گزینه \fBfips\fR در بخش \fBproviders\fR مشخص شده است، همان‌طور که در «Provider Configuration Module» در \fBconfig\fR\|(5) شرح داده شده است. .IP \fBactivate\fR 4 .IX Item "activate" اگر وجود داشته باشد، ماژول فعال می‌شود. مقدار اختصاص‌یافته به این نام اهمیتی ندارد. .IP \fBconditional\-errors\fR 4 .IX Item "conditional-errors" ماژول FIPS در صورت شکست هر یک از خودآزمایی‌ها معمولاً وارد یک حالت خطای داخلی می‌شود. پس از فعال شدن این حالت خطا، از این نقطه به بعد هیچ سرویس یا الگوریتم رمزنگاری قابل دسترسی نخواهد بود. آزمون‌های پیوسته زیرمجموعه‌ای از خودآزمایی‌ها هستند (برای مثال، آزمون جفت کلید در طول تولید کلید، یا آزمون خروجی CRNG). تنظیم این مقدار روی \f(CW0\fR اجازه می‌دهد در صورت شکست هر آزمون پیوسته، حالت خطا برانگیخته نشود. مقدار پیش‌فرض \f(CW1\fR حالت خطا را برمی‌انگیزد. صرف‌نظر از مقدار، عملیاتی (مانند تولید کلید) که آزمون پیوسته را فراخوانی کرده است در صورت شکست آزمون پیوسته خود یک کد خطا برمی‌گرداند. سپس در صورتی که حالت خطا برانگیخته نشده باشد، می‌توان عملیات را مجدداً تکرار کرد. .IP \fBmodule\-mac\fR 4 .IX Item "module-mac" مقدار MAC محاسبه‌شده برای فایل ارائه‌دهنده (provider) FIPS. .IP \fBinstall\-version\fR 4 .IX Item "install-version" شماره نسخه برای فرآیند نصب FIPS. باید ۱ باشد. .IP \fBinstall\-status\fR 4 .IX Item "install-status" این فیلد منسوخ شده است و دیگر استفاده نمی‌شود. .IP \fBinstall\-mac\fR 4 .IX Item "install-mac" این فیلد منسوخ شده است و دیگر استفاده نمی‌شود. .SS "گزینه‌های نشانگر FIPS (FIPS indicator options)" .IX Subsection "FIPS indicator options" گزینه‌های پیکربندی FIPS زیر مشخص می‌کنند که آیا بررسی‌های زمان اجرا مربوط به اعمال پارامترهای امنیتی FIPS مانند حداقل استحکام امنیتی کلیدها و نام‌های منحنی مجاز استفاده می‌شوند یا خیر. مقدار \*(Aq1\*(Aq بررسی‌ها را انجام می‌دهد، در غیر این صورت اگر مقدار \*(Aq0\*(Aq باشد، بررسی‌ها انجام نمی‌شوند و انطباق با FIPS باید از طریق رویه‌های مستندشده در خط‌مشی امنیتی (Security Policy) مربوطه صورت گیرد. .PP برای اطلاعات بیشتر در مورد این گزینه‌ها، به بخش «OPTIONS» در \fBopenssl\-fipsinstall\fR\|(1) مراجعه کنید. .IP \fBsecurity\-checks\fR 4 .IX Item "security-checks" به «OPTIONS» در \fBopenssl\-fipsinstall\fR\|(1) گزینه \fB\-no_security_checks\fR مراجعه کنید. .IP \fBtls1\-prf\-ems\-check\fR 4 .IX Item "tls1-prf-ems-check" به «OPTIONS» در \fBopenssl\-fipsinstall\fR\|(1) گزینه \fB\-ems_check\fR مراجعه کنید. .IP \fBno\-short\-mac\fR 4 .IX Item "no-short-mac" به «OPTIONS» در \fBopenssl\-fipsinstall\fR\|(1) گزینه \fB\-no_short_mac\fR مراجعه کنید. .IP \fBdrbg\-no\-trunc\-md\fR 4 .IX Item "drbg-no-trunc-md" به «OPTIONS» در \fBopenssl\-fipsinstall\fR\|(1) گزینه \fB\-no_drbg_truncated_digests\fR مراجعه کنید. .IP \fBsignature\-digest\-check\fR 4 .IX Item "signature-digest-check" به «OPTIONS» در \fBopenssl\-fipsinstall\fR\|(1) گزینه \fB\-signature_digest_check\fR مراجعه کنید. .IP \fBhkdf\-digest\-check\fR 4 .IX Item "hkdf-digest-check" این گزینه منسوخ شده است. .IP \fBtls13\-kdf\-digest\-check\fR 4 .IX Item "tls13-kdf-digest-check" به «OPTIONS» در \fBopenssl\-fipsinstall\fR\|(1) گزینه \fB\-tls13_kdf_digest_check\fR مراجعه کنید. .IP \fBtls1\-prf\-digest\-check\fR 4 .IX Item "tls1-prf-digest-check" به «OPTIONS» در \fBopenssl\-fipsinstall\fR\|(1) گزینه \fB\-tls1_prf_digest_check\fR مراجعه کنید. .IP \fBsshkdf\-digest\-check\fR 4 .IX Item "sshkdf-digest-check" به «OPTIONS» در \fBopenssl\-fipsinstall\fR\|(1) گزینه \fB\-sshkdf_digest_check\fR مراجعه کنید. .IP \fBsskdf\-digest\-check\fR 4 .IX Item "sskdf-digest-check" این گزینه منسوخ شده است. .IP \fBx963kdf\-digest\-check\fR 4 .IX Item "x963kdf-digest-check" به «OPTIONS» در \fBopenssl\-fipsinstall\fR\|(1) گزینه \fB\-x963kdf_digest_check\fR مراجعه کنید. .IP \fBdsa\-sign\-disabled\fR 4 .IX Item "dsa-sign-disabled" به «OPTIONS» در \fBopenssl\-fipsinstall\fR\|(1) گزینه \fB\-dsa_sign_disabled\fR مراجعه کنید. .IP \fBtdes\-encrypt\-disabled\fR 4 .IX Item "tdes-encrypt-disabled" به «OPTIONS» در \fBopenssl\-fipsinstall\fR\|(1) گزینه \fB\-tdes_encrypt_disabled\fR مراجعه کنید. .IP \fBrsa\-pkcs15\-pad\-disabled\fR 4 .IX Item "rsa-pkcs15-pad-disabled" به «OPTIONS» در \fBopenssl\-fipsinstall\fR\|(1) گزینه \fB\-rsa_pkcs15_pad_disabled\fR مراجعه کنید. .IP \fBrsa\-pss\-saltlen\-check\fR 4 .IX Item "rsa-pss-saltlen-check" به «OPTIONS» در \fBopenssl\-fipsinstall\fR\|(1) گزینه \fB\-rsa_pss_saltlen_check\fR مراجعه کنید. .IP \fBrsa\-sign\-x931\-pad\-disabled\fR 4 .IX Item "rsa-sign-x931-pad-disabled" به «OPTIONS» در \fBopenssl\-fipsinstall\fR\|(1) گزینه \fB\-rsa_sign_x931_disabled\fR مراجعه کنید. .IP \fBhkdf\-key\-check\fR 4 .IX Item "hkdf-key-check" به «OPTIONS» در \fBopenssl\-fipsinstall\fR\|(1) گزینه \fB\-hkdf_key_check\fR مراجعه کنید. .IP \fBkbkdf\-key\-check\fR 4 .IX Item "kbkdf-key-check" به «OPTIONS» در \fBopenssl\-fipsinstall\fR\|(1) گزینه \fB\-kbkdf_key_check\fR مراجعه کنید. .IP \fBtls13\-kdf\-key\-check\fR 4 .IX Item "tls13-kdf-key-check" به «OPTIONS» در \fBopenssl\-fipsinstall\fR\|(1) گزینه \fB\-tls13_kdf_key_check\fR مراجعه کنید. .IP \fBtls1\-prf\-key\-check\fR 4 .IX Item "tls1-prf-key-check" به «OPTIONS» در \fBopenssl\-fipsinstall\fR\|(1) گزینه \fB\-tls1_prf_key_check\fR مراجعه کنید. .IP \fBsshkdf\-key\-check\fR 4 .IX Item "sshkdf-key-check" به «OPTIONS» در \fBopenssl\-fipsinstall\fR\|(1) گزینه \fB\-sshkdf_key_check\fR مراجعه کنید. .IP \fBsskdf\-key\-check\fR 4 .IX Item "sskdf-key-check" به «OPTIONS» در \fBopenssl\-fipsinstall\fR\|(1) گزینه \fB\-sskdf_key_check\fR مراجعه کنید. .IP \fBx963kdf\-key\-check\fR 4 .IX Item "x963kdf-key-check" به «OPTIONS» در \fBopenssl\-fipsinstall\fR\|(1) گزینه \fB\-x963kdf_key_check\fR مراجعه کنید. .IP \fBx942kdf\-key\-check\fR 4 .IX Item "x942kdf-key-check" به «OPTIONS» در \fBopenssl\-fipsinstall\fR\|(1) گزینه \fB\-x942kdf_key_check\fR مراجعه کنید. .IP \fBpbkdf2\-lower\-bound\-check\fR 4 .IX Item "pbkdf2-lower-bound-check" به «OPTIONS» در \fBopenssl\-fipsinstall\fR\|(1) گزینه \fB\-no_pbkdf2_lower_bound_check\fR مراجعه کنید. .IP \fBecdh\-cofactor\-check\fR 4 .IX Item "ecdh-cofactor-check" به «OPTIONS» در \fBopenssl\-fipsinstall\fR\|(1) گزینه \fB\-ecdh_cofactor_check\fR مراجعه کنید. .IP \fBhmac\-key\-check\fR 4 .IX Item "hmac-key-check" به «OPTIONS» در \fBopenssl\-fipsinstall\fR\|(1) گزینه \fB\-hmac_key_check\fR مراجعه کنید. .IP \fBkmac\-key\-check\fR 4 .IX Item "kmac-key-check" به «OPTIONS» در \fBopenssl\-fipsinstall\fR\|(1) گزینه \fB\-kmac_key_check\fR مراجعه کنید. .PP برای مثال: .PP .Vb 8 \& [fips_sect] \& activate = 1 \& install\-version = 1 \& conditional\-errors = 1 \& security\-checks = 1 \& module\-mac = 41:D0:FA:C2:5D:41:75:CD:7D:C3:90:55:6F:A4:DC \& install\-mac = FE:10:13:5A:D3:B4:C7:82:1B:1E:17:4C:AC:84:0C \& install\-status = INSTALL_SELF_TEST_KATS_RUN .Ve .SH "نکات (NOTES)" .IX Header "NOTES" هنگام استفاده از ارائه‌دهنده FIPS، توصیه می‌شود گزینه \&\fBconfig_diagnostics\fR فعال باشد تا از استفاده تصادفی از الگوریتم‌های تأییدنشده توسط FIPS به دلیل پیکربندی ناقص یا اشتباه جلوگیری شود. به \&\fBconfig\fR\|(5) مراجعه کنید. .SH "همچنین ببینید (SEE ALSO)" .IX Header "SEE ALSO" \&\fBconfig\fR\|(5) \&\fBopenssl\-fipsinstall\fR\|(1) .SH "تاریخچه (HISTORY)" .IX Header "HISTORY" این قابلیت در OpenSSL 3.0 اضافه شد. .SH "حق نشر (COPYRIGHT)" .IX Header "COPYRIGHT" حق نشر ۲۰۱۹-۲۰۲۵ نویسندگان پروژه OpenSSL. کلیه حقوق محفوظ است. .PP تحت مجوز آپاچی نسخه ۲.۰ (Apache License 2.0) منتشر شده است. شما نمی‌توانید از این فایل استفاده کنید مگر با رعایت مجوز. می‌توانید یک نسخه از مجوز را در فایل LICENSE در توزیع منبع یا در دریافت کنید.