نام (NAME)

winpr-makecert - ابزاری برای ایجاد گواهی‌های X.509

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

winpr-makecert [-rdp] [-silent] [-live] [-format { crt | pem | pfx }] [-p password] [-n common_name] [-y years] [-m months] [-len length] [-# serial] [-a { md5 | sha1 | sha256 | s384 | sha512 }] [-path outputpath] [outputname]

توضیحات (DESCRIPTION)

دستور winpr-makecert ابزاری برای تولید گواهی‌های X.509 است که بر اساس دستور MakeCert در Windows الگوبرداری شده است. هدف winpr-makecert سازگاری در خط فرمان با MakeCert است، هرچند که هنوز همه گزینه‌ها پشتیبانی یا پیاده‌سازی نشده‌اند.

قابلیت‌های پیاده‌سازی‌نشده در اینجا توضیح داده نشده‌اند. این موارد در راهنمای winpr-makecert با عنوان «Unsupported» مشخص شده‌اند.

برخلاف همتای ویندوزی خود، winpr-makecert همواره یک گواهی ایجاد کرده و ذخیره می‌کند، مگر اینکه گزینه -live مشخص شده باشد. اگر outputname تنظیم نشده باشد، تلاش می‌شود نام میزبان (host name) رایانه‌ای که دستور روی آن اجرا می‌شود شناسایی و استفاده شود.
هشدار: اگر فایل از قبل وجود داشته باشد، بدون پرسش بازنویسی خواهد شد.

بدون گزینه‌های اضافی، گواهی‌های تولیدشده دارای ویژگی‌های زیر خواهند بود:

* طول کلید ۲۰۴۸ بیت
* الگوریتم هش sha256
* استفاده از نام میزبان شناسایی‌شده به‌عنوان common name
* استفاده از برچسب زمان (timestamp) به‌عنوان شماره سریال
* دوره اعتبار یک‌ساله
* ذخیره در دایرکتوری کاری فعلی با قالب crt

گزینه‌ها (OPTIONS)

-rdp

پارامتر صوری (Dummy). می‌تواند برای تولید سریع یک گواهی با ویژگی‌های پیش‌فرض بدون نیاز به تعیین پارامترهای دیگر استفاده شود.

-silent

گواهی تولیدشده را در stdout چاپ نمی‌کند.

-f format

از سه قالب پشتیبانی می‌شود: crt، pem و pfx.
قالب crt کلید و گواهی را در فایل‌های جداگانه با پسوندهای .key و .crt ذخیره می‌کند.
قالب pem کلید و گواهی را در یک فایل واحد با پسوند pem ذخیره می‌کند.
و قالب pfx کلید و گواهی را در یک فایل pkcs12 با پسوند .pfx ذخیره می‌کند.

-p password

گذرواژه‌ای که در صورت استفاده از قالب pfx به‌کار می‌رود.

-live

کلید/گواهی را روی دیسک نمی‌نویسد. هنگام استفاده در خط فرمان، این گزینه را می‌توان حالتی «صوری» در نظر گرفت.

-n common_name

نام عمومی (common name) مورد استفاده در گواهی.

-m months

دوره اعتبار بر حسب ماه (ضریبی از ۳۱ روز، نه ماه‌های تقویمی).

-y years

دوره اعتبار بر حسب سال (۳۶۵ روز، سال‌های کبیسه محاسبه نمی‌شوند). اگر هر دو مقدار ماه‌ها و سال‌ها مشخص شوند، مقادیر با یکدیگر جمع می‌شوند.

-len length

طول کلید مورد استفاده بر حسب بیت.

-a { md5 | sha1 | sha256 | s384 | sha512 }

الگوریتم هش مورد استفاده.

-# serial

شماره سریال مورد استفاده برای گواهی.

-path

دایرکتوری که گواهی باید در آن ایجاد شود.

outputname

نام پایه فایل(های) ایجادشده. پسوند متناسب با قالب مشخص‌شده به این نام افزوده خواهد شد.

مثال‌ها (EXAMPLES)

winpr-makecert -rdp

گواهی‌ای با مشخصات پیش‌فرض ایجاد می‌کند که در دایرکتوری کاری فعلی با قالب crt و با نامی مشابه نام میزبان ذخیره می‌شود. اگر نام میزبان freerdp باشد، فایل‌های ایجادشده freerdp.key و freerdp.crt نام خواهند داشت.

winpr-makecert -len 4096 -a sha384 -path /tmp -# 22 -m 144 -y 1 -format crt mycert

دستور بالا فایل /tmp/mycert.pem را شامل یک کلید و یک گواهی با طول ۴۰۹۶ ایجاد می‌کند. این دستور از sha384 به‌عنوان الگوریتم هش استفاده خواهد کرد. گواهی شماره سریال ۲۲ دارد و به مدت ۱۲ سال (۱۴۴ ماه) معتبر است.

وضعیت خروج (EXIT STATUS)

0

اجرای موفقیت‌آمیز برنامه.

1

در غیر این صورت.

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

صفحه راهنمای MakeCert ⟨URL: https://msdn.microsoft.com/library/windows/desktop/aa386968.aspx ⟩

نویسندگان (AUTHORS)

FreeRDP <team@freerdp.com>