.de URL
\\$2 \(laURL: \\$1 \(ra\\$3
..
.if \n[.g] .mso www.tmac
.TH winpr-makecert 1 2017-01-11 "3.31.1" "FreeRDP"
.SH "نام (NAME)"
winpr-makecert \- ابزاری برای ایجاد گواهی‌های X.509
.SH "خلاصه دستور (SYNOPSIS)"
.B winpr-makecert
[\fB-rdp\fP]
[\fB-silent\fP]
[\fB-live\fP]
[\fB-format\fP { \fIcrt\fP | \fIpem\fP | \fIpfx\fP }]
[\fB-p\fP password]
[\fB-n\fP common_name]
[\fB-y\fP years]
[\fB-m\fP months]
[\fB-len\fP length]
[\fB-#\fP serial]
[\fB-a\fP { \fImd5\fP | \fIsha1\fP | \fIsha256\fP | \fIs384\fP | \fIsha512\fP }]
[\fB-path\fP outputpath] 
[outputname]
.SH "توضیحات (DESCRIPTION)"
دستور
.B winpr-makecert
ابزاری برای تولید گواهی‌های X.509 است که بر اساس دستور MakeCert در Windows الگوبرداری شده است. هدف winpr-makecert سازگاری در خط فرمان با MakeCert است، هرچند که هنوز همه گزینه‌ها پشتیبانی یا پیاده‌سازی نشده‌اند.

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

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

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

* طول کلید ۲۰۴۸ بیت
.br
* الگوریتم هش sha256
.br
* استفاده از نام میزبان شناسایی‌شده به‌عنوان common name
.br
* استفاده از برچسب زمان (timestamp) به‌عنوان شماره سریال
.br
* دوره اعتبار یک‌ساله
.br
* ذخیره در دایرکتوری کاری فعلی با قالب crt
.SH "گزینه‌ها (OPTIONS)"
.IP "-rdp"
پارامتر صوری (Dummy). می‌تواند برای تولید سریع یک گواهی با ویژگی‌های پیش‌فرض بدون نیاز به تعیین پارامترهای دیگر استفاده شود.
.IP "-silent"
گواهی تولیدشده را در stdout چاپ نمی‌کند.
.IP "-f format"
از سه قالب پشتیبانی می‌شود: crt، pem و pfx.
.br
قالب
\fIcrt\fP
کلید و گواهی را در فایل‌های جداگانه با پسوندهای .key و .crt ذخیره می‌کند.
.br
قالب
\fIpem\fP
کلید و گواهی را در یک فایل واحد با پسوند pem ذخیره می‌کند.
.br
و قالب
\fIpfx\fP
کلید و گواهی را در یک فایل pkcs12 با پسوند .pfx ذخیره می‌کند.
.IP "-p password"
گذرواژه‌ای که در صورت استفاده از قالب pfx به‌کار می‌رود.
.IP "-live"
کلید/گواهی را روی دیسک نمی‌نویسد. هنگام استفاده در خط فرمان، این گزینه را می‌توان حالتی «صوری» در نظر گرفت.
.IP "-n common_name"
نام عمومی (common name) مورد استفاده در گواهی.
.IP "-m months"
دوره اعتبار بر حسب ماه (ضریبی از ۳۱ روز، نه ماه‌های تقویمی).
.IP "-y years"
دوره اعتبار بر حسب سال (۳۶۵ روز، سال‌های کبیسه محاسبه نمی‌شوند). اگر هر دو مقدار ماه‌ها و سال‌ها مشخص شوند، مقادیر با یکدیگر جمع می‌شوند.
.IP "-len length"
طول کلید مورد استفاده بر حسب بیت.
.IP "-a { \fImd5\fP | \fIsha1\fP | \fIsha256\fP | \fIs384\fP | \fIsha512\fP }"
الگوریتم هش مورد استفاده.
.IP "-# serial"
شماره سریال مورد استفاده برای گواهی.
.IP "-path"
دایرکتوری که گواهی باید در آن ایجاد شود.
.IP "outputname"
نام پایه فایل(های) ایجادشده. پسوند متناسب با قالب مشخص‌شده به این نام افزوده خواهد شد.
.SH "مثال‌ها (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 به‌عنوان الگوریتم هش استفاده خواهد کرد. گواهی شماره سریال ۲۲ دارد و به مدت ۱۲ سال (۱۴۴ ماه) معتبر است.
.SH "وضعیت خروج (EXIT STATUS)"
.TP
.B 0
اجرای موفقیت‌آمیز برنامه.
.TP
.B 1
در غیر این صورت.

.SH "همچنین ببینید (SEE ALSO)"

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

.SH "نویسندگان (AUTHORS)"
FreeRDP <team@freerdp.com>