نام (NAME)

gsasl - رابط خط فرمان کتابخانه SASL

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

gsasl [گزینه‌ها]... [میزبان [پورت]]...

توضیحات (DESCRIPTION)

احراز هویت کاربر در یک کارگزار با استفاده از لایه احراز هویت و امنیت ساده (SASL). در حال حاضر کارگزارهای IMAP و SMTP پشتیبانی می‌شوند. این برنامه یک رابط خط فرمان برای کتابخانه GNU SASL است.

-h, --help: چاپ راهنما و خروج
-V, --version: چاپ نسخه و خروج

دستورها:

-c, --client: عمل کردن در نقش کلاینت (پیش‌فرض: فعال)
-s, --server: عمل کردن در نقش کارگزار (پیش‌فرض: غیرفعال)
--client-mechanisms: نوشتن نام سازوکارهای پشتیبانی‌شده کلاینت در خروجی استاندارد (stdout) با فاصله به عنوان جداکننده (پیش‌فرض: غیرفعال)
--server-mechanisms: نوشتن نام سازوکارهای پشتیبانی‌شده کارگزار در خروجی استاندارد (stdout) با فاصله به عنوان جداکننده (پیش‌فرض: غیرفعال)
-k, --mkpasswd: مشتق‌سازی رمز عبور. مقدار --mechanism باید SCRAM-SHA-1 یا SCRAM-SHA-256 باشد. ورودی‌های اجباری شامل رمز عبور (از طریق --password یا خوانده‌شده از ترمینال) هستند و ورودی‌های اختیاری شامل تعداد تکرار (از طریق --iteration-count، پیش‌فرض ۶۵۵۳۶) و سالت (از طریق --salt یا تولید تصادفی) می‌باشند. خروجی رشته‌ای به این شکل است: "{mech}count,salt,stored-key,server-key[,salted-password]" که در آن "mech" نام سازوکار، "count" تعداد دفعات هش شدن رمز عبور، "salt" سالت ارائه‌شده یا تولیدشده با کدگذاری base64، و "stored-key" و "server-key" دو کلید مشتق‌شده سمت سرور با کدگذاری base64 هستند. در صورت تعیین --verbose، مقدار "salted-password" نیز به‌صورت رمز عبور مشتق‌شده PBKDF2 با کدگذاری hex گنجانده می‌شود (پیش‌فرض: غیرفعال).

گزینه‌های شبکه:

--connect=HOST[:PORT]: اتصال به کارگزار TCP و مذاکره روی جریان به جای stdin/stdout. مقدار PORT سرویس پروتکل یا یک عدد مشخص‌کننده پورت است که در صورت تعیین نشدن، مقدار پیش‌فرض ۱۴۳ (imap) خواهد بود. همچنین مقدار پیش‌فرض --hostname را نیز تنظیم می‌کند.

گزینه‌های عمومی:

-d, --application-data: پس از احراز هویت، داده‌ها را از stdin خوانده، از لایه امنیتی سازوکار عبور داده و با کدگذاری base64 در خروجی استاندارد چاپ کند. پیش‌فرض این است که پس از احراز هویت خاتمه یابد (پیش‌فرض: فعال).
--imap: استفاده از رویه ورود مشابه IMAP (فقط کلاینت). همچنین مقدار پیش‌فرض --service را به 'imap' تنظیم می‌کند (پیش‌فرض: غیرفعال).
--smtp: استفاده از رویه ورود مشابه SMTP (فقط کلاینت). همچنین مقدار پیش‌فرض --service را به 'smtp' تنظیم می‌کند (پیش‌فرض: غیرفعال).
-m, --mechanism=STRING: سازوکار مورد استفاده.
--no-client-first: اجازه ندادن به کلاینت برای ارسال داده در ابتدا (فقط کلاینت؛ پیش‌فرض: غیرفعال).

گزینه‌های سازوکار SASL (در صورت نیاز پرسیده می‌شوند):

-n, --anonymous-token=STRING: توکن برای احراز هویت ناشناس، معمولاً آدرس ایمیل (فقط ANONYMOUS).
-a, --authentication-id=STRING: هویت مالک اعتبارنامه.
-z, --authorization-id=STRING: هویت مورد نیاز برای درخواست سرویس.
-p, --password=STRING: رمز عبور برای احراز هویت (برای مقاصد غیرآزمایشی ناامن است).
-r, --realm=STRING: قلمرو (Realm). به‌طور پیش‌فرض برابر با نام میزبان است.
--passcode=NUMBER: رمز عبور یک‌بار مصرف برای احراز هویت (فقط SECURID).
--service=STRING: تنظیم نام سرویس درخواستی (باید یک نام سرویس مبتنی بر میزبان ثبت‌شده در GSSAPI باشد).
--hostname=STRING: تنظیم نام کارگزار دارای سرویس درخواستی.
--service-name=STRING: تنظیم نام عمومی کارگزار در صورت استفاده از کارگزار تکثیرشده (فقط DIGEST-MD5).
--enable-cram-md5-validate: اعتبارسنجی چالش و پاسخ CRAM-MD5 به‌صورت تعاملی (پیش‌فرض: غیرفعال).
--disable-cleartext-validate: غیرفعال‌سازی قلاب اعتبارسنجی متن آشکار، و اجبار کارگزار به درخواست رمز عبور (پیش‌فرض: غیرفعال).
--quality-of-protection=TYPE: نحوه محافظت از بار داده (payload) برنامه. مقدار 'qop-auth' به معنای عدم محافظت، 'qop-int' به معنای محافظت از یکپارچگی، و 'qop-conf' به معنای محافظت از یکپارچگی و محرمانگی است. در حال حاضر فقط در DIGEST-MD5 استفاده می‌شود که پیش‌فرض آن 'qop-int' است.
--iteration-count=NUMBER: مشخص کردن تعداد تکرار هش PBKDF2 (فقط SCRAM؛ پیش‌فرض: ۶۵۵۳۶).
--salt=B64DATA: مشخص کردن سالت PBKDF2 به‌صورت رشته کدگذاری‌شده base64 (فقط SCRAM).
--scram-salted-password=STRING: رمز عبور نمک‌دار SCRAM برای احراز هویت (فقط SCRAM؛ ۴۰ کاراکتر هگز برای SCRAM-SHA-1 و ۶۴ کاراکتر برای SCRAM-SHA-256).

گزینه‌های STARTTLS:

--starttls: اجبار به استفاده از STARTTLS. پیش‌فرض استفاده از STARTTLS در صورت در دسترس بودن است (پیش‌فرض: غیرفعال).
--no-starttls: غیرفعال کردن قطعی STARTTLS (پیش‌فرض: غیرفعال).
--no-cb: عدم استفاده از پیوندهای کانال (channel bindings) از TLS (پیش‌فرض: غیرفعال).
--x509-ca-file=FILE: فایل حاوی یک یا چند گواهی مرجع صدور گواهی (CA) نوع X.509 با فرمت PEM، که برای اعتبارسنجی گواهی دریافت شده از کارگزار استفاده می‌شود. اگر مشخص نشود، اعتبارسنجی از تنظیمات اعتماد سیستم استفاده می‌کند. اگر FILE رشته‌ای خالی باشد، در صورت بروز خطای اعتبارسنجی گواهی‌های کارگزار X.509 با خطا متوقف نمی‌شود.
--x509-cert-file=FILE: فایل حاوی گواهی X.509 کلاینت با فرمت PEM. همراه با --x509-key-file برای تعیین جفت گواهی/کلید استفاده می‌شود.
--x509-key-file=FILE: کلید خصوصی برای گواهی X.509 کلاینت با فرمت PEM. همراه با --x509-cert-file برای تعیین جفت گواهی/کلید استفاده می‌شود.
--priority=STRING: رشته اولویت الگوریتم‌های رمزنگاری.

سایر گزینه‌ها:

--verbose: تولید خروجی با جزئیات کامل (پیش‌فرض: غیرفعال).
--quiet: عدم تولید خروجی‌های تشخیصی (پیش‌فرض: غیرفعال).

نویسنده (AUTHOR)

نوشته شده توسط Simon Josefsson.

گزارش باگ‌ها (REPORTING BUGS)

گزارش باگ‌ها به: bug-gsasl@gnu.org
صفحه خانگی GNU SASL: https://www.gnu.org/software/gsasl
راهنمای عمومی استفاده از نرم‌افزارهای گنو: https://www.gnu.org/gethelp

حق نشر (COPYRIGHT)

حق نشر © 2026 Simon Josefsson.
مجوز GPLv3+: گنو GPL نسخه ۳ یا بالاتر https://gnu.org/licenses/gpl.html.
این نرم‌افزار آزاد است: شما مجاز به تغییر و بازتوزیع آن هستید. هیچ‌گونه ضمانتی وجود ندارد، تا حدی که قانون اجازه می‌دهد.

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

مستندات کامل برای gsasl به صورت یک راهنمای Texinfo نگهداری می‌شود. اگر برنامه‌های info و gsasl به‌درستی روی سیستم شما نصب شده باشند، اجرای دستور

: info gsasl

باید دسترسی شما به راهنمای کامل را فراهم کند.