.\" -*- 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 "CA.PL 1ssl" .TH CA.PL 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)" CA.pl \- رابطی کاربرپسندتر برای برنامه‌های گواهی OpenSSL .SH "خلاصه دستور (SYNOPSIS)" .IX Header "SYNOPSIS" \&\fBCA.pl\fR \&\fB\-?\fR | \&\fB\-h\fR | \&\fB\-help\fR .PP \&\fBCA.pl\fR \&\fB\-newcert\fR | \&\fB\-newreq\fR | \&\fB\-newreq\-nodes\fR | \&\fB\-xsign\fR | \&\fB\-sign\fR | \&\fB\-signCA\fR | \&\fB\-signcert\fR | \&\fB\-crl\fR | \&\fB\-newca\fR [\fB\-extra\-\fR\f(BIcmd\fR \fIparameter\fR] .PP \&\fBCA.pl\fR \fB\-pkcs12\fR [\fIcertname\fR] .PP \&\fBCA.pl\fR \fB\-verify\fR \fIcertfile\fR ... .PP \&\fBCA.pl\fR \fB\-revoke\fR \fIcertfile\fR [\fIreason\fR] .SH "توضیحات (DESCRIPTION)" .IX Header "DESCRIPTION" اسکریپت \fBCA.pl\fR یک اسکریپت پرل (Perl) است که آرگومان‌های خط فرمان مربوطه را برای برخی از عملیات‌های متداول گواهی به دستور \fBopenssl\fR\|(1) ارسال می‌کند. هدف آن ساده‌سازی فرایند ایجاد و مدیریت گواهی با استفاده از چند گزینهٔ ساده است. .PP این اسکریپت به عنوان یک رابط کاربری ساده (front end) برای برنامهٔ \fBopenssl\fR\|(1) جهت استفادهٔ افراد مبتدی طراحی شده است. رفتار آن همیشه دقیقاً همان چیزی نیست که انتظار می‌رود. برای کنترل بیشتر بر رفتار دستورهای گواهی، دستور \fBopenssl\fR\|(1) را به‌طور مستقیم اجرا کنید. .PP بیشتر نام‌های فایل ذکرشده در زیر را می‌توان با ویرایش اسکریپت \&\fBCA.pl\fR تغییر داد. .PP در برخی از محیط‌ها ممکن است اجرای مستقیم اسکریپت \fBCA.pl\fR امکان‌پذیر نباشد (برای نمونه در Win32) و مکان پیش‌فرض فایل پیکربندی نادرست باشد. در این حالت می‌توان از دستور زیر استفاده کرد: .PP .Vb 1 \& perl \-S CA.pl .Ve .PP و متغیر محیطی \fBOPENSSL_CONF\fR را می‌توان طوری تنظیم کرد که به مسیر درست فایل پیکربندی اشاره کند. .SH "گزینه‌ها (OPTIONS)" .IX Header "OPTIONS" .IP "\fB\-?\fR, \fB\-h\fR, \fB\-help\fR" 4 .IX Item "-?, -h, -help" پیام راهنمای نحوهٔ استفاده از دستور را چاپ می‌کند. .IP \fB\-newcert\fR 4 .IX Item "-newcert" یک گواهی خودامضاشده (self-signed) جدید ایجاد می‌کند. کلید خصوصی در فایل \&\fInewkey.pem\fR و درخواست در فایل \fInewreq.pem\fR نوشته می‌شود. این گزینه \fBopenssl\-req\fR\|(1) را فراخوانی می‌کند. .IP \fB\-newreq\fR 4 .IX Item "-newreq" یک درخواست گواهی جدید ایجاد می‌کند. کلید خصوصی در فایل \&\fInewkey.pem\fR و درخواست در فایل \fInewreq.pem\fR نوشته می‌شود. این گزینه در پشت‌صحنه \fBopenssl\-req\fR\|(1) را اجرا می‌کند. .IP \fB\-newreq\-nodes\fR 4 .IX Item "-newreq-nodes" مانند گزینهٔ \fB\-newreq\fR است، با این تفاوت که کلید خصوصی رمزگذاری نخواهد شد. از \fBopenssl\-req\fR\|(1) استفاده می‌کند. .IP \fB\-newca\fR 4 .IX Item "-newca" یک سلسله‌مراتب CA (مرجع صدور گواهی) جدید برای استفاده با برنامهٔ \fBca\fR (یا گزینه‌های \fB\-signcert\fR و \fB\-xsign\fR) ایجاد می‌کند. از کاربر خواسته می‌شود نام فایل گواهی‌های CA (که باید شامل کلید خصوصی نیز باشد) را وارد کند یا با فشردن کلید ENTER، جزئیات CA از کاربر پرسیده خواهد شد. فایل‌ها و پوشه‌های مربوطه در پوشه‌ای به نام \fIdemoCA\fR در پوشهٔ جاری ایجاد می‌شوند. از \fBopenssl\-req\fR\|(1) و \fBopenssl\-ca\fR\|(1) استفاده می‌کند. .Sp اگر پوشهٔ \fIdemoCA\fR از قبل وجود داشته باشد، دستور \fB\-newca\fR روی آن بازنویسی نمی‌کند و هیچ کاری انجام نخواهد داد. این حالت ممکن است زمانی رخ دهد که فراخوانی قبلی گزینهٔ \fB\-newca\fR به‌صورت غیرعادی پایان یافته باشد. برای دستیابی به رفتار درست، در صورت وجود این پوشه، آن را حذف کنید. .IP \fB\-pkcs12\fR 4 .IX Item "-pkcs12" یک فایل PKCS#12 حاوی گواهی کاربر، کلید خصوصی و گواهی CA ایجاد می‌کند. انتظار دارد گواهی کاربر و کلید خصوصی در فایل \fInewcert.pem\fR و گواهی CA در فایل \fIdemoCA/cacert.pem\fR قرار داشته باشند و فایلی با نام \fInewcert.p12\fR ایجاد می‌کند. بنابراین این دستور را می‌توان پس از گزینهٔ \&\fB\-sign\fR فراخوانی کرد. فایل PKCS#12 را می‌توان مستقیماً وارد یک مرورگر کرد. اگر آرگومان دیگری در خط فرمان مشخص شده باشد، به عنوان «نام ملموس» (friendly name) برای گواهی استفاده خواهد شد (که معمولاً در کادر فهرست مرورگر نمایش داده می‌شود)، در غیر این صورت از نام "My Certificate" استفاده می‌شود. انجام کار را به \fBopenssl\-pkcs12\fR\|(1) محول می‌کند. .IP "\fB\-sign\fR, \fB\-xsign\fR" 4 .IX Item "-sign, -xsign" دستور \fBopenssl\-ca\fR\|(1) را برای امضای یک درخواست گواهی فراخوانی می‌کند. انتظار دارد درخواست در فایل \fInewreq.pem\fR قرار داشته باشد. گواهی جدید در فایل \fInewcert.pem\fR نوشته می‌شود، مگر در مورد گزینهٔ \fB\-xsign\fR که در آن خروجی در خروجی استاندارد نوشته خواهد شد. .IP \fB\-signCA\fR 4 .IX Item "-signCA" این گزینه همانند گزینهٔ \fB\-sign\fR است، به جز اینکه از بخش \fBv3_ca\fR در فایل پیکربندی استفاده می‌کند و بنابراین درخواست امضاشده را به یک گواهی معتبر CA تبدیل می‌نماید. این قابلیت هنگام ایجاد یک CA میانی (intermediate CA) از یک CA ریشه (root CA) مفید است. پارامترهای اضافی به \fBopenssl\-ca\fR\|(1) منتقل می‌شوند. .IP \fB\-signcert\fR 4 .IX Item "-signcert" این گزینه همانند \fB\-sign\fR است، با این تفاوت که انتظار دارد یک گواهی خودامضاشده در فایل \fInewreq.pem\fR موجود باشد. پارامترهای اضافی به \fBopenssl\-x509\fR\|(1) و \fBopenssl\-ca\fR\|(1) منتقل می‌شوند. .IP \fB\-crl\fR 4 .IX Item "-crl" یک فهرست ابطال گواهی (CRL) تولید می‌کند. \fBopenssl\-ca\fR\|(1) را اجرا می‌کند. .IP "\fB\-revoke\fR \fIcertfile\fR [\fIreason\fR]" 4 .IX Item "-revoke certfile [reason]" گواهی موجود در \fBcertfile\fR مشخص‌شده را ابطال می‌کند. یک علت اختیاری نیز می‌تواند مشخص شود که باید یکی از این موارد باشد: \fBunspecified\fR، \&\fBkeyCompromise\fR، \fBCACompromise\fR، \fBaffiliationChanged\fR، \fBsuperseded\fR، \&\fBcessationOfOperation\fR، \fBcertificateHold\fR یا \fBremoveFromCRL\fR. از \fBopenssl\-ca\fR\|(1) بهره می‌گیرد. .IP \fB\-verify\fR 4 .IX Item "-verify" گواهی‌ها را در برابر گواهی CA مربوط به \fIdemoCA\fR اعتبارسنجی می‌کند. اگر هیچ گواهی‌ای در خط فرمان مشخص نشده باشد، تلاش می‌کند فایل \&\fInewcert.pem\fR را اعتبارسنجی کند. این گزینه \fBopenssl\-verify\fR\|(1) را فراخوانی می‌کند. .IP "\fB\-extra\-\fR\f(BIcmd\fR \fIparameter\fR" 4 .IX Item "-extra-cmd parameter" به ازای هر گزینهٔ \fBextra\-\fR\f(BIcmd\fR، در صورتی که آن زیردستور فراخوانی شود، \fIparameter\fR به زیردستور \fBopenssl\fR\|(1) با نام همسان با \fIcmd\fR ارسال می‌گردد. برای نمونه، اگر \fBopenssl\-req\fR\|(1) فراخوانی شود، مقدار \fIparameter\fR داده‌شده با \&\fB\-extra\-req\fR به آن ارسال خواهد شد. برای پارامترهای چندکلمه‌ای، می‌توانید گزینه را تکرار کنید یا \fIparameter\fRها را درون گیومه بگذارید تا از دید شل شما مانند یک کلمه به نظر برسد. برای اطلاعات بیشتر به مستندات هر دستور مراجعه کنید. .SH "مثال‌ها (EXAMPLES)" .IX Header "EXAMPLES" ایجاد یک سلسله‌مراتب CA: .PP .Vb 1 \& CA.pl \-newca .Ve .PP مثال کامل ایجاد گواهی: ایجاد یک CA، ایجاد یک درخواست، امضای درخواست و در نهایت ایجاد یک فایل PKCS#12 حاوی آن. .PP .Vb 4 \& CA.pl \-newca \& CA.pl \-newreq \& CA.pl \-sign \& CA.pl \-pkcs12 "My Test Certificate" .Ve .SH "محیط (ENVIRONMENT)" .IX Header "ENVIRONMENT" متغیر محیطی \fBOPENSSL\fR ممکن است برای مشخص کردن نام برنامهٔ OpenSSL استفاده شود. این مقدار می‌تواند یک مسیر کامل یا یک مسیر نسبی باشد. .PP متغیر محیطی \fBOPENSSL_CONFIG\fR می‌تواند برای تعیین یک گزینه و مقدار پیکربندی برای دستورهای \fBreq\fR و \fBca\fR که توسط این اسکریپت فراخوانی می‌شوند به کار رود. مقدار آن باید شامل گزینه و مسیر فایل باشد، مانند: \&\f(CW\*(C`\-config /path/to/conf\-file\*(C'\fR. .SH "همچنین ببینید (SEE ALSO)" .IX Header "SEE ALSO" \&\fBopenssl\fR\|(1), \&\fBopenssl\-x509\fR\|(1), \&\fBopenssl\-ca\fR\|(1), \&\fBopenssl\-req\fR\|(1), \&\fBopenssl\-pkcs12\fR\|(1), \&\fBconfig\fR\|(5) .SH "حق نشر (COPYRIGHT)" .IX Header "COPYRIGHT" حق نشر ۲۰۰۰\-۲۰۲۶ نویسندگان پروژه OpenSSL. تمامی حقوق محفوظ است. .PP تحت مجوز آپاچی نسخه ۲.۰ («مجوز») منتشر شده است. شما نمی‌توانید از این فایل مگر در انطباق با این مجوز استفاده کنید. می‌توانید نسخه‌ای از مجوز را در فایل LICENSE توزیع مبدا یا در نشانی زیر دریافت کنید: .