.TH CHARON\-CMD 8 "2013-06-21" "6.1.0" "strongSwan"
.SH "نام (NAME)"
charon\-cmd \- کلاینت سادهٔ IKE (کلاینت IPsec VPN)
.SH "خلاصه دستور (SYNOPSIS)"
.B charon\-cmd
.B \-\-host
.I hostname
.B \-\-identity
.I identity
.B [ options ]
.PP
.SH "توضیحات (DESCRIPTION)"
.B charon\-cmd
برنامه‌ای برای برپایی اتصالات IPsec VPN با استفاده از پروتکل تبادل کلید اینترنتی (IKE) در نسخه‌های ۱ و ۲ است. این برنامه از چندین سناریوی مختلف کاربران راه دور (road-warrior) پشتیبانی می‌کند.
.PP
همانند دیمن IKE یعنی
.BR charon ،
دستور
.B charon\-cmd
باید به عنوان
.B root
(یا به‌طور دقیق‌تر، به عنوان کاربری با قابلیت
.BR CAP_NET_ADMIN )
اجرا شود.
.PP
از بین گزینه‌های زیر دست‌کم
.I \-\-host
و
.I \-\-identity
الزامی هستند. بسته به
.I profile
احراز هویت انتخاب‌شده، اطلاعات کاربری نیز باید با گزینه‌های مربوط به خود ارائه شوند.
.PP
بسیاری از گزینه‌های پیکربندی مختص
.B charon
در
.I strongswan.conf
برای
.B charon\-cmd
نیز اعمال می‌شوند. برای نمونه، جهت پیکربندی گزارش‌گیری سفارشی در
.B stdout
می‌توان از قطعه‌کد زیر استفاده کرد:
.PP
.EX
	charon-cmd {
		filelog {
			stdout {
				default = 1
				ike = 2
				cfg = 2
			}
		}
	}
.EE
.PP
.SH "گزینه‌ها (OPTIONS)"
.TP
.B "\-\-help"
اطلاعات نحوهٔ استفاده و خلاصهٔ کوتاهی از گزینه‌های موجود را چاپ می‌کند.
.TP
.B "\-\-version"
نسخهٔ strongSwan را چاپ می‌کند.
.TP
.BI "\-\-debug " level
سطح پیش‌فرض گزارش‌گیری را تعیین می‌کند (پیش‌فرض 1 است).
.I level
عددی بین -1 و 4 است. برای گزینه‌هایی که امکان پیکربندی دقیق‌تر خروجی گزارش‌گیری را فراهم می‌کنند به
.I strongswan.conf
مراجعه کنید.
.TP
.BI "\-\-host " hostname
نام DNS یا آدرس IP برای اتصال.
.TP
.BI "\-\-identity " identity
هویتی که کلاینت برای تبادل IKE استفاده می‌کند.
.TP
.BI "\-\-eap\-identity " identity
هویتی که کلاینت برای احراز هویت EAP استفاده می‌کند.
.TP
.BI "\-\-xauth\-username " username
نام کاربری که کلاینت برای احراز هویت XAuth استفاده می‌کند.
.TP
.BI "\-\-remote\-identity " identity
هویت سرور مورد انتظار؛ مقدار پیش‌فرض آن
.IR hostname
است.
.TP
.BI "\-\-cert " path
گواهی معتبر، برای احراز هویت یا اعتبارسنجی زنجیرهٔ اعتماد. برای ارائهٔ بیش از یک گواهی می‌توان از چندین گزینهٔ
.B \-\-cert
استفاده کرد.
.TP
.BI "\-\-rsa " path
کلید خصوصی RSA برای استفاده در احراز هویت (در صورت نیاز به رمز عبور، هنگام اجرا درخواست خواهد شد). برای انواع دیگر کلیدها از \fI\-\-priv\fR استفاده کنید.
.TP
.BI "\-\-priv " path
کلید خصوصی برای استفاده در احراز هویت (در صورت نیاز به رمز عبور، هنگام اجرا درخواست خواهد شد).
.TP
.BI "\-\-p12 " path
فایل PKCS#12 حاوی کلید خصوصی و گواهی‌ها برای استفاده در احراز هویت و اعتبارسنجی زنجیرهٔ اعتماد (در صورت نیاز به رمز عبور، هنگام اجرا درخواست خواهد شد).
.TP
.RI "\fB\-\-agent\fR[=" socket ]
استفاده از SSH agent برای احراز هویت. اگر
.I socket
مشخص نشود، از متغیر محیطی
.B SSH_AUTH_SOCK
خوانده می‌شود.
.TP
.BI "\-\-local\-ts " subnet
انتخاب‌گر ترافیک (traffic selector) اضافی پیشنهادی برای سمت محلی ما؛ آدرس IP مجازی درخواست‌شده همیشه پیشنهاد خواهد شد.
.TP
.BI "\-\-remote\-ts " subnet
انتخاب‌گر ترافیک پیشنهادی برای سمت دوردست (remote)، مقدار پیش‌فرض 0.0.0.0/0 است.
.TP
.BI "\-\-ike\-proposal " proposal
پیشنهاد IKE برای ارائه به جای مقدار پیش‌فرض. در IKEv1، یک پیشنهاد منفرد شامل یک الگوریتم رمزنگاری، یک الگوریتم یکپارچگی/PRF و یک گروه DH است. IKEv2 می‌تواند چندین الگوریتم از یک نوع را پیشنهاد دهد. برای تعیین چندین پیشنهاد، این گزینه را تکرار کنید.
.TP
.BI "\-\-esp\-proposal " proposal
پیشنهاد ESP برای ارائه به جای مقدار پیش‌فرض. در IKEv1، یک پیشنهاد منفرد شامل یک الگوریتم رمزنگاری، یک الگوریتم یکپارچگی و یک گروه DH اختیاری برای کلیدگذاری مجدد پنهان‌داری پیش‌رو کامل (PFS) است. IKEv2 می‌تواند چندین الگوریتم از یک نوع را پیشنهاد دهد. برای تعیین چندین پیشنهاد، این گزینه را تکرار کنید.
.TP
.BI "\-\-ah\-proposal " proposal
پیشنهاد AH برای ارائه به جای ESP. در IKEv1، یک پیشنهاد منفرد شامل یک الگوریتم یکپارچگی و یک گروه DH اختیاری برای کلیدگذاری مجدد پنهان‌داری پیش‌رو کامل (PFS) است. IKEv2 می‌تواند چندین الگوریتم از یک نوع را پیشنهاد دهد. برای تعیین چندین پیشنهاد، این گزینه را تکرار کنید.
.TP
.BI "\-\-profile " name
نمایهٔ احراز هویت مورد استفاده؛ فهرست نمایه‌های پشتیبانی‌شده را می‌توان در بخش‌های
.B نمایه‌های احراز هویت (Authentication Profiles)
زیر یافت. اگر یک کلید خصوصی ارائه شده باشد پیش‌فرض
.B ikev2\-pub
و در غیر این صورت
.B ikev2\-eap
خواهد بود.
.PP
.SS "نمایه‌های احراز هویت IKEv2 (IKEv2 Authentication Profiles)"
.TP
.B "ikev2\-pub"
پروتکل IKEv2 با احراز هویت کلاینت و سرور مبتنی بر کلید عمومی.
.TP
.B "ikev2\-eap"
پروتکل IKEv2 با احراز هویت کلاینت مبتنی بر EAP و احراز هویت سرور مبتنی بر کلید عمومی.
.TP
.B "ikev2\-pub\-eap"
پروتکل IKEv2 با احراز هویت کلاینت مبتنی بر کلید عمومی و EAP (استاندارد RFC 4739) و احراز هویت سرور مبتنی بر کلید عمومی.
.PP
.SS "نمایه‌های احراز هویت IKEv1 (IKEv1 Authentication Profiles)"
نمایه‌های احراز هویت زیر یا از «حالت اصلی» (Main Mode) یا از «حالت تهاجمی» (Aggressive Mode) استفاده می‌کنند؛ حالت دوم با پسوند \fB\-am\fR مشخص می‌شود.
.TP
.BR "ikev1\-pub" ", " "ikev1\-pub\-am"
پروتکل IKEv1 با احراز هویت کلاینت و سرور مبتنی بر کلید عمومی.
.TP
.BR "ikev1\-xauth" ", " "ikev1\-xauth\-am"
پروتکل IKEv1 با احراز هویت کلاینت و سرور مبتنی بر کلید عمومی، و به دنبال آن احراز هویت کلاینت با XAuth.
.TP
.BR "ikev1\-xauth\-psk" ", " "ikev1\-xauth\-psk\-am"
پروتکل IKEv1 با احراز هویت کلاینت و سرور مبتنی بر کلید از پیش اشتراک‌گذاشته‌شده (PSK)، و به دنبال آن احراز هویت کلاینت با XAuth (ناامن!).
.TP
.BR "ikev1\-hybrid" ", " "ikev1\-hybrid\-am"
پروتکل IKEv1 تنها با احراز هویت سرور مبتنی بر کلید عمومی، و به دنبال آن احراز هویت کلاینت با XAuth.
.PP
.SH "همچنین ببینید (SEE ALSO)"
\fBstrongswan.conf\fR(5), \fBipsec\fR(8)