نام (NAME)

sstpc - کلاینت پروتکل تونل‌سازی سوکت امن (SSTP)

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

sstpc [<sstp-options>] <hostname> [ppp-options] ...

توضیحات (DESCRIPTION)

دستور sstpc سمت کلاینت یک شبکه خصوصی مجازی (VPN) را با استفاده از پروتکل تونل‌سازی سوکت امن (SSTP) برقرار می‌کند. هنگامی که PPTP و L2TP کار نمی‌کنند، می‌توانید از این برنامه برای اتصال به VPN مبتنی بر SSTP کارفرما استفاده کنید.

به‌طور پیش‌فرض، sstpc تماس SSTP را با کارساز SSTP برقرار کرده و سپس یک نمونه از pppd را برای مدیریت انتقال داده‌ها آغاز می‌کند. با این حال، sstpc می‌تواند به عنوان یک مدیر اتصال درون pppd نیز اجرا شود.

گزینه‌ها (OPTIONS)

نخستین آرگومان غیرگزینه‌ای در خط فرمان sstpc باید نام میزبان یا نشانی IP کارساز SSTP باشد.

تمام گزینه‌های طولانی (که با «--» آغاز می‌شوند) به عنوان گزینه‌های sstpc تفسیر می‌شوند و در صورت استفاده از گزینه ناشناخته یک خطای مهلک رخ می‌دهد.

تمام آرگومان‌های خط فرمان که با «-» آغاز نمی‌شوند، به عنوان گزینه‌های ppp تفسیر شده و به همان صورت به pppd پاس داده می‌شوند، مگر آنکه --nolaunchpppd داده شده باشد.

--ca-cert: گواهی CA مورد استفاده برای اعتبارسنجی کارساز را مشخص می‌کند.
--ca-dir: دایرکتوری حاوی گواهی‌های CA را مشخص می‌کند. اگر مقداری مشخص نشود، از دایرکتوری سراسری سیستم استفاده می‌شود.
--cert-warn: نادیده گرفتن هشدارهای مربوط به گواهی مانند نام عمومی (common name) به جای قطع اتصال.
--host: هنگام اتصال به نشانی IP، پارامتر host نام میزبان را برای http، پراکسی و tls-ext فراهم می‌کند.
--ipparam: سوکت بازگشتی (callback socket) را مشخص می‌کند که pppd تلاش خواهد کرد به منظور انتقال کلیدهای مذاکره‌شدهٔ MPPE به sstpc به آن متصل شود. کلیدهای MPPE برای احراز هویت در برابر کارساز در لایه SSL الزامی هستند. اگر هیچ MPPEای مذاکره نشود می‌توانند صفر باشند. این نام بر اساس /tmp/sstpc-<ipparam> ساخته می‌شود.
--nolaunchpppd: برنامه pppd را اجرا نمی‌کند بلکه از stdin به عنوان اتصال شبکه استفاده می‌کند. از این فلگ هنگام به‌کارگیری sstpc به عنوان فرآیند اتصال pppd با استفاده از گزینه pty استفاده کنید. بخش «مثال‌ها» را ببینید.
--password: مشخص کردن گذرواژه از طریق خط فرمان به جای تنظیم آن در فایل پیکربندی برای pppd در مسیر /etc/ppp/peers.
--proxy: اتصال به کارساز SSTP از طریق یک پراکسی در شبکه شما. ساختار نگارش به صورت http://[<user>:<pass>@]<domain>:port است.
--priv-user: کاربر تفکیک دسترسی را برای اجرای sstpc مشخص می‌کند.
--priv-group: گروه تفکیک دسترسی را برای اجرای sstpc مشخص می‌کند.
--priv-dir: دایرکتوری تفکیک دسترسی را برای زندان chroot جهت اجرای sstpc مشخص می‌کند.
--user: مشخص کردن نام کاربری برای احراز هویت در کارساز SSTP به جای تنظیم آن در فایل پیکربندی برای pppd در مسیر /etc/ppp/peers.
--save-server-route: این گزینه به صورت خودکار یک مسیر به کارساز SSTP را اضافه و حذف می‌کند.
--uuid: یک UUID برای اتصال مشخص می‌کند تا عیب‌یابی سمت کارساز ساده‌تر شود.
--tls-ext: افزونه نام میزبان TLS را فعال می‌کند.

عیب‌یابی (Troubleshooting)

گزینه‌های زیر برای کمک به عیب‌یابی sstpc در دسترس هستند:

--log-level <level>: تنظیم سطح دیباگ برای عیب‌یابی فرآیند sstpc. مقدار سطح می‌تواند عددی بین 0 تا 4 باشد.
--log-syslog: ثبت گزارش پیام‌ها در syslog (پیش‌فرض).
--log-stderr: ثبت پیام‌ها در خروجی خطا (stderr).
--log-stdout: ثبت پیام‌ها در خروجی استاندارد (stdout).
--log-fileno: درج نام فایل و شماره خط در پیام‌های لاگ.
--log-filter: فیلتر کردن لاگ‌ها بر اساس مجموعه‌ای خاص از فایل‌ها، به عنوان مثال: sstp-packet,sstp-state
--log-ident: مشخص کردن شناسه‌ای که هنگام نوشتن لاگ‌ها در مثلاً syslog استفاده خواهد شد.

مثال‌ها (EXAMPLES)

اتصال به سرویس RAS ویندوز مایکروسافت با استفاده از پروتکل SSTP

اسکریپت‌های نقطه مقابل (peer) را در /etc/ppp/peers راه‌اندازی کنید؛ می‌توانید با شبیه‌سازی یکی از اسکریپت‌های موجود در دایرکتوری اسناد خود، یعنی /usr/share/doc/sstp-client یا /usr/local/share/doc/sstp-client شروع کنید. محتوای کلی این فایل نزدیک به موارد زیر خواهد بود:

# 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

توجه داشته باشید که فایل chap-secrets مورد استفاده توسط pppd باید شامل یک مدخل برای domain\\username باشد. برای مثال sstp-test، کاربر eivnaes مدخل معادلی در فایل /etc/ppp/chap-secrets خواهد داشت:

# Secrets for authentication using CHAP
# client        server  secret          IP addresses
eivnaes         *       xxxxxx          *

شروع sstp-test با استفاده از اسکریپت pon:: sudo pon sstp-test
فراخوانی sstpc با استفاده از دستور call:: sstpc --ipparam sstp-test sstp-test.yourdomain.com call sstp-test-nopty
اسکریپت sstp-test-nopty یک اسکریپت pppd است که باید در /etc/ppp/peers ایجاد کنید، و می‌توانید آن را از مثال sstp-test بالا شبیه‌سازی کنید؛ اما باید عبارت pty را در پیکربندی peers حذف کنید.

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

pppd(8)

نویسنده (AUTHOR)

این صفحه راهنما توسط Eivind Naess <enaess@yahoo.com> نوشته شده است.