GSASL(1) دستورات کاربر GSASL(1) نام (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: راهنمای عمومی استفاده از نرم‌افزارهای گنو: حق نشر (COPYRIGHT) حق نشر © 2026 Simon Josefsson. مجوز GPLv3+: گنو GPL نسخه ۳ یا بالاتر . این نرم‌افزار آزاد است: شما مجاز به تغییر و بازتوزیع آن هستید. هیچ‌گونه ضمانتی وجود ندارد، تا حدی که قانون اجازه می‌دهد. همچنین ببینید (SEE ALSO) مستندات کامل برای gsasl به صورت یک راهنمای Texinfo نگهداری می‌شود. اگر برنامه‌های info و gsasl به‌درستی روی سیستم شما نصب شده باشند، اجرای دستور info gsasl باید دسترسی شما به راهنمای کامل را فراهم کند. GNU SASL 2.2.4 June 2026 GSASL(1)