نام (NAME)

makecert - ساخت گواهی‌های X.509 برای مقاصد آزمایشی

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

makecert [options] certificate

توضیحات (DESCRIPTION)

ایجاد یک گواهی X.509 با استفاده از اطلاعات ارائه‌شده. این ابزار برای آزمایش امضاهای Authenticode، و فناوری‌های SSL و S/MIME مفید است.

پارامترها (PARAMETERS)

-# num: مشخص کردن شماره سریال گواهی.
-n dn: مشخص کردن نام متمایز موضوع (Subject DN).
-in dn: مشخص کردن نام متمایز صادرکننده (Issuer DN).
-r: ایجاد یک گواهی خودامضا (Self-Signed) که گواهی ریشه (Root) نیز نامیده می‌شود.
-iv pvkfile: مشخص کردن فایل کلید خصوصی (.PVK) برای صادرکننده. کلید خصوصی در فایل مشخص‌شده برای امضای گواهی جدید استفاده خواهد شد.
-ic certfile: استخراج نام صادرکننده از فایل گواهی مشخص‌شده؛ بدین معنا که نام موضوع در گواهی مشخص‌شده به نام صادرکننده در گواهی جدید تبدیل می‌شود.
-in name: استفاده از نام صادرکننده از پارامتر مشخص‌شده.
-ik container: مشخص کردن نام ظرف کلید برای صادرکننده.
-iky [signature | exchange | #]: مشخص کردن شماره کلید برای استفاده در ارائه‌دهنده (هنگام استفاده با -ik).
-ip provider: مشخص کردن ارائه‌دهنده رمزنگاری برای صادرکننده.
-ir [localmachine | currentuser]: تعیین اینکه ارائه‌دهنده برای صادرکننده ظروف کلید کاربر یا ماشین را جستجو کند.
-iy number: مشخص کردن نوع ارائه‌دهنده برای صادرکننده.
-sv pkvfile: مشخص کردن فایل کلید خصوصی (.PVK) برای موضوع. بخش عمومی کلید در گواهی ایجادشده درج خواهد شد. در صورت عدم وجود، فایل مشخص‌شده با یک جفت‌کلید جدید ایجاد می‌شود (پیش‌فرض جفت‌کلید RSA با ۱۰۲۴ بیت).
-sk container: مشخص کردن نام ظرف کلید برای موضوع.
-sky [signature | exchange | #]: مشخص کردن شماره کلید برای استفاده در ارائه‌دهنده (هنگام استفاده با -sk).
-sp provider: مشخص کردن ارائه‌دهنده رمزنگاری برای موضوع.
-sr [localmachine | currentuser]: تعیین اینکه ارائه‌دهنده برای موضوع ظروف کلید کاربر یا ماشین را جستجو کند.
-sy number: مشخص کردن نوع ارائه‌دهنده برای موضوع.
-a hash: انتخاب الگوریتم درهم‌سازی. تنها الگوریتم‌های MD5 و SHA1 پشتیبانی می‌شوند.
-b date: تاریخ آغاز اعتبار گواهی (notBefore).
-e date: تاریخ پایان اعتبار گواهی (notAfter).
-m number: مشخص کردن دوره اعتبار گواهی به ماه. این مقدار به تاریخ آغاز اعتبار (که می‌توان با -b تعیین کرد یا به‌طور پیش‌فرض تاریخ/زمان کنونی است) اضافه می‌شود.
-cy [authority|end]: محدودیت‌های پایه (Basic Constraints). انتخاب گواهی مرجع (Authority) یا نهاد نهایی (End-Entity). تنها گواهی‌های Authority می‌توانند برای امضای سایر گواهی‌ها به کار روند (-ic). گواهی End-Entity می‌تواند توسط کلاینت‌ها (مانند Authenticode و S/MIME) یا سرورها (مانند SSL) استفاده شود.
-h number: افزودن محدودیت طول مسیر به زنجیره گواهی. این گزینه فقط برای گواهی‌هایی کاربرد دارد که BasicConstraint آن‌ها روی Authority تنظیم شده باشد (-cy authority). این مورد برای محدود کردن زنجیره گواهی‌هایی استفاده می‌شود که می‌توانند تحت این مرجع صادر شوند.
-alt filename: افزودن افزونه subjectAltName به گواهی. هر خط از 'filename' به عنوان یک مدخل DNS در افزونه اضافه خواهد شد. این گزینه زمانی مفید است که می‌خواهید یک گواهی SSL واحد ایجاد کنید تا روی چندین میزبان که دامنه مشترک ندارند کار کند (یعنی CN=*.domain.com پاسخگو نیست).
-eku oid[,oid]: افزودن OID برای کاربرد پیشرفته کلید (Extended Key Usage) به گواهی.
-p12 pkcs12file password: ایجاد یک فایل PKCS#12 جدید شامل هر دو گواهی (موضوع و احتمالاً صادرکننده) و کلید خصوصی. فایل PKCS#12 با گذرواژه مشخص‌شده محافظت می‌شود. این گزینه منحصراً مربوط به mono است.
-?: راهنما (نمایش این پیام راهنما)
-!: راهنمای پیشرفته (برای گزینه‌های پیشرفته)

مثال‌ها (EXAMPLES)

ایجاد یک گواهی آزمایشی SSL (یعنی غیرقابل‌اعتماد) پس از دانستن نام میزبان آسان است. دستور زیر یک گواهی آزمایشی برای یک سرور SSL ایجاد می‌کند:

$ hostname 
pollux
$ makecert -r -eku 1.3.6.1.5.5.7.3.1 -n "CN=pollux" -sv pollux.pvk pollux.cer
Success

به طور خاص در مثال بالا، پارامترهای استفاده‌شده برای ساخت این گواهی آزمایشی عبارت بودند از:

-r: ایجاد یک گواهی خودامضا (یعنی بدون سلسله‌مراتب).
-eku 1.3.6.1.5.5.7.3.1: اختیاری (زیرا متأسفانه اغلب کلاینت‌ها به آن نیاز ندارند). این گزینه نشان می‌دهد که گواهی شما برای احراز هویت سمت سرور در نظر گرفته شده است.
-n: نام متداول (CN) = نام میزبان. این مورد توسط کلاینت SSL بررسی می‌شود و باید با میزبان متصل مطابقت داشته باشد (در غیر این صورت یک هشدار یا خطا دریافت خواهید کرد).
-sv private.key: فایل کلید خصوصی. اگر فایل مشخص‌شده وجود نداشته باشد، کلید (جفت‌کلید RSA با ۱۰۲۴ بیت) به طور خودکار تولید خواهد شد.
pollux.cer: گواهی SSL که باید برای میزبان شما ایجاد شود.

محدودیت‌های شناخته‌شده (KNOWN RESTRICTIONS)

در مقایسه با نسخه ویندوز، برخی گزینه‌ها پشتیبانی نمی‌شوند (-$, -d, -l, -nscp, -is, -sc, -ss). همچنین فایل‌های PVK دارای گذرواژه پشتیبانی نمی‌شوند.

نویسنده (AUTHOR)

نوشته‌شده توسط Sebastien Pouliot

حق نشر (COPYRIGHT)

فهرست‌های پستی (MAILING LISTS)

برای جزئیات بیشتر به http://lists.ximian.com/mailman/listinfo/mono-devel-list مراجعه کنید.

وب‌گاه (WEB SITE)

برای جزئیات بیشتر به http://www.mono-project.com مراجعه کنید

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

signcode(1)