.\" SH section heading
.\" SS subsection heading
.\" LP paragraph
.\" IP indented paragraph
.\" TP hanging label
.TH SSTPC 8
.\" NAME should be all caps, SECTION should be 1-8, maybe w/ subsection
.\" other parms are allowed: see man(7), man(1)
.SH "نام (NAME)"
sstpc \- کلاینت پروتکل تونل‌سازی سوکت امن (SSTP)
.SH "خلاصه دستور (SYNOPSIS)"
.B sstpc
.I "[<sstp-options>] <hostname> [ppp-options] ..."
.SH "توضیحات (DESCRIPTION)"
.LP
دستور
.B sstpc
سمت کلاینت یک شبکه خصوصی مجازی (VPN) را با استفاده از پروتکل تونل‌سازی سوکت امن (SSTP) برقرار می‌کند. هنگامی که PPTP و L2TP کار نمی‌کنند، می‌توانید از این برنامه برای اتصال به VPN مبتنی بر SSTP کارفرما استفاده کنید.
.LP
به‌طور پیش‌فرض،
\fBsstpc\fR
تماس SSTP را با کارساز SSTP برقرار کرده و سپس یک نمونه از
\fBpppd\fR
را برای مدیریت انتقال داده‌ها آغاز می‌کند. با این حال،
\fBsstpc\fR
می‌تواند به عنوان یک مدیر اتصال درون
\fBpppd\fR
نیز اجرا شود.
.SH "گزینه‌ها (OPTIONS)"
.LP
نخستین آرگومان غیرگزینه‌ای در خط فرمان
\fBsstpc\fR
باید نام میزبان یا نشانی IP کارساز SSTP باشد.
.LP
تمام گزینه‌های طولانی (که با «\-\-» آغاز می‌شوند) به عنوان گزینه‌های sstpc تفسیر می‌شوند و در صورت استفاده از گزینه ناشناخته یک خطای مهلک رخ می‌دهد.
.LP
تمام آرگومان‌های خط فرمان که با «\-» آغاز نمی‌شوند، به عنوان گزینه‌های ppp تفسیر شده و به همان صورت به
\fBpppd\fR
پاس داده می‌شوند، مگر آنکه
\fB\-\-nolaunchpppd\fR
داده شده باشد.
.TP
.B \-\-ca-cert
گواهی CA مورد استفاده برای اعتبارسنجی کارساز را مشخص می‌کند.
.TP
.B \-\-ca-dir
دایرکتوری حاوی گواهی‌های CA را مشخص می‌کند. اگر مقداری مشخص نشود، از دایرکتوری سراسری سیستم استفاده می‌شود.
.TP
.B \-\-cert-warn
نادیده گرفتن هشدارهای مربوط به گواهی مانند نام عمومی (common name) به جای قطع اتصال.
.TP
.B \-\-host
هنگام اتصال به نشانی IP، پارامتر host نام میزبان را برای http، پراکسی و tls-ext فراهم می‌کند.
.TP
.B \-\-ipparam
سوکت بازگشتی (callback socket) را مشخص می‌کند که
.B pppd
تلاش خواهد کرد به منظور انتقال کلیدهای مذاکره‌شدهٔ MPPE به
.B sstpc
به آن متصل شود. کلیدهای MPPE برای احراز هویت در برابر کارساز در لایه SSL الزامی هستند. اگر هیچ MPPEای مذاکره نشود می‌توانند صفر باشند. این نام بر اساس /tmp/sstpc-<ipparam> ساخته می‌شود.
.TP
.B \-\-nolaunchpppd
برنامه
.B pppd
را اجرا نمی‌کند بلکه از stdin به عنوان اتصال شبکه استفاده می‌کند. از این فلگ هنگام به‌کارگیری
.B sstpc
به عنوان فرآیند اتصال
.B pppd
با استفاده از گزینه
.B pty
استفاده کنید. بخش «مثال‌ها» را ببینید.
.TP
.B \-\-password
مشخص کردن گذرواژه از طریق خط فرمان به جای تنظیم آن در فایل پیکربندی برای
.B pppd
در مسیر /etc/ppp/peers.
.TP
.B \-\-proxy
اتصال به کارساز SSTP از طریق یک پراکسی در شبکه شما. ساختار نگارش به صورت http://[<user>:<pass>@]<domain>:port است.
.TP
.B \-\-priv-user
کاربر تفکیک دسترسی را برای اجرای
.B sstpc
مشخص می‌کند.
.TP
.B \-\-priv-group
گروه تفکیک دسترسی را برای اجرای
.B sstpc
مشخص می‌کند.
.TP
.B \-\-priv-dir
دایرکتوری تفکیک دسترسی را برای زندان chroot جهت اجرای
.B sstpc
مشخص می‌کند.
.TP
.B \-\-user
مشخص کردن نام کاربری برای احراز هویت در کارساز SSTP به جای تنظیم آن در فایل پیکربندی برای
.B pppd
در مسیر /etc/ppp/peers.
.TP
.B \-\-save-server-route
این گزینه به صورت خودکار یک مسیر به کارساز SSTP را اضافه و حذف می‌کند.
.TP
.B \-\-uuid
یک UUID برای اتصال مشخص می‌کند تا عیب‌یابی سمت کارساز ساده‌تر شود.
.TP
.B \-\-tls-ext
افزونه نام میزبان TLS را فعال می‌کند.
.SS "عیب‌یابی (Troubleshooting)"
گزینه‌های زیر برای کمک به عیب‌یابی
.B sstpc
در دسترس هستند:
.TP
.B \-\-log-level <level>
تنظیم سطح دیباگ برای عیب‌یابی فرآیند
.BR sstpc .
مقدار سطح می‌تواند عددی بین 0 تا 4 باشد.
.TP
.B \-\-log-syslog
ثبت گزارش پیام‌ها در syslog (پیش‌فرض).
.TP
.B \-\-log-stderr
ثبت پیام‌ها در خروجی خطا (stderr).
.TP
.B \-\-log-stdout
ثبت پیام‌ها در خروجی استاندارد (stdout).
.TP
.B \-\-log-fileno
درج نام فایل و شماره خط در پیام‌های لاگ.
.TP
.B \-\-log-filter
فیلتر کردن لاگ‌ها بر اساس مجموعه‌ای خاص از فایل‌ها، به عنوان مثال: sstp-packet,sstp-state
.TP
.B \-\-log-ident
مشخص کردن شناسه‌ای که هنگام نوشتن لاگ‌ها در مثلاً syslog استفاده خواهد شد.
.SH "مثال‌ها (EXAMPLES)"
اتصال به سرویس RAS ویندوز مایکروسافت با استفاده از پروتکل SSTP
.TP
اسکریپت‌های نقطه مقابل (peer) را در /etc/ppp/peers راه‌اندازی کنید؛ می‌توانید با شبیه‌سازی یکی از اسکریپت‌های موجود در دایرکتوری اسناد خود، یعنی /usr/share/doc/sstp-client یا /usr/local/share/doc/sstp-client شروع کنید. محتوای کلی این فایل نزدیک به موارد زیر خواهد بود:
.IP
.nf
# Example Content of /etc/ppp/peers/sstp-test
remotename  sstp-test
linkname    sstp-test
ipparam     sstp-test
pty         "sstpc \-\-ipparam sstp\-test \-\-nolaunchpppd sstp\-test.yourdomain.com"
name        eivnaes
plugin      sstp-pppd-plugin.so
sstp-sock   /var/run/sstpc/sstpc-sstp-test
usepeerdns
require-mppe
require-mschap-v2
refuse-eap
refuse-pap
refuse-chap
refuse-mschap
nobsdcomp
nodeflate
.fi
.TP
توجه داشته باشید که فایل \fBchap\-secrets\fR مورد استفاده توسط \fBpppd\fR باید شامل یک مدخل برای domain\\\\username باشد. برای مثال sstp-test، کاربر eivnaes مدخل معادلی در فایل /etc/ppp/chap-secrets خواهد داشت:
.IP
.nf
# Secrets for authentication using CHAP
# client        server  secret          IP addresses
eivnaes         *       xxxxxx          *
.fi
.TP
شروع sstp-test با استفاده از اسکریپت pon:
.B sudo pon sstp-test
.TP
فراخوانی sstpc با استفاده از دستور call:
.B sstpc \-\-ipparam sstp\-test sstp-test.yourdomain.com call sstp-test-nopty
.TP
اسکریپت sstp-test-nopty یک اسکریپت pppd است که باید در /etc/ppp/peers ایجاد کنید، و می‌توانید آن را از مثال sstp-test بالا شبیه‌سازی کنید؛ اما باید عبارت \fBpty\fR را در پیکربندی peers حذف کنید.
.SH "همچنین ببینید (SEE ALSO)"
.IR pppd (8)
.PP
.SH "نویسنده (AUTHOR)"
این صفحه راهنما توسط Eivind Naess <enaess@yahoo.com> نوشته شده است.