.if !'po4a'hide' .TH basic_sasl_auth 8
.
.SH "نام (NAME)"
basic_sasl_auth \- احراز هویت پایه‌ای با استفاده از SASL (به‌ویژه روش احراز هویت cyrus-sasl)
.PP
نسخه 1.0
.
.SH "خلاصه دستور (SYNOPSIS)"
.if !'po4a'hide' .B basic_sasl_auth
.
.SH "توضیحات (DESCRIPTION)"
.B basic_sasl_auth
یک برنامه کمکی باینری نصب‌شده برای Squid است. SASL قابل‌پیکربندی است (تا حدی شبیه به PAM).
هر سرویسی که از طریق SASL احراز هویت می‌شود، خود را با یک نام برنامه شناسایی می‌کند.
هر برنامه می‌تواند به‌طور مستقل توسط مدیر SASL پیکربندی شود.
.
.SH "پیکربندی (CONFIGURATION)"
برای پیکربندی روش احراز هویت مورد استفاده، پرونده
.B basic_sasl_auth.conf
می‌تواند در مکان مناسب قرار گیرد، معمولاً
.B /usr/lib/sasl.
.PP
پایگاه داده احراز هویت با استفاده از پارامتر
.B pwcheck_method
تعریف می‌شود.
تنها سازوکار احراز هویت
.B PLAIN
استفاده می‌شود.
.PP
مثال‌ها:
.
.if !'po4a'hide' .B pwcheck_method:sasldb
استفاده از sasldb \- حالت پیش‌فرض در صورت عدم نصب پرونده پیکربندی.
.if !'po4a'hide' .B pwcheck_method:pam
 \- استفاده از پایگاه داده احراز هویت PAM
.if !'po4a'hide' .B pwcheck_method:passwd
 \- استفاده از روش سنتی
.B /etc/passwd
.if !'po4a'hide' .B pwcheck_method:shadow
 \- استفاده از روش کمی کمتر سنتی /etc/shadow
.PP
روش‌های دیگر ممکن است توسط پیاده‌سازی cyrus-sasl شما پشتیبانی شوند \-
برای اطلاعات بیشتر به مستندات cyrus-sasl خود مراجعه کنید.
.PP
به‌طور معمول یک کاربر عادی نمی‌تواند به پایگاه داده احراز هویت (
.B /etc/sasldb
،
.B /etc/shadow
،
.B PAM
)
دسترسی داشته باشد. باید از setuid/setgid
و یک کاربر/گروه مناسب بر روی فایل اجرایی استفاده کنید تا به
احراز هویت‌کننده اجازه دسترسی به پایگاه داده گذرواژه مربوطه داده شود. اگر
دسترسی به پایگاه داده مجاز نباشد، احراز هویت‌کننده
معمولاً با خطای «\-1, generic error» شکست خواهد خورد.
.PP
.if !'po4a'hide' .RS
.if !'po4a'hide' .P
.if !'po4a'hide' .B chown root.mail basic_sasl_auth
.if !'po4a'hide' .br
.if !'po4a'hide' .B chmod ug+s basic_sasl_auth
.if !'po4a'hide' .RE
.PP
نام برنامه
.B basic_sasl_auth
در صورت انتخاب
.B pwcheck_method:pam
برای نام سرویس PAM نیز استفاده خواهد شد. همچنین یک نمونه پرونده پیکربندی PAM با نام
.B basic_sasl_auth.pam
گنجانده شده است.
.
.SH "نویسنده (AUTHOR)"
این برنامه توسط
.if !'po4a'hide' .I Ian Castle <ian.castle@coldcomfortfarm.net>
نوشته شده است.
.PP
این راهنما توسط
.if !'po4a'hide' .I Ian Castle <ian.castle@coldcomfortfarm.net>
.if !'po4a'hide' .I Amos Jeffries <amosjeffries@squid-cache.org>
نوشته شده است.
.
.SH "حق نشر (COPYRIGHT)"
.PP
 * Copyright (C) 1996-2026 The Squid Software Foundation and contributors
 *
 * Squid software is distributed under GPLv2+ license and includes
 * contributions from numerous individuals and organizations.
 * Please see the COPYING and CONTRIBUTORS files for details.
.PP
حق نشر این برنامه و مستندات آن متعلق به نویسندگان نام‌برده‌شده در بالا است.
.PP
تحت مجوز عمومی همگانی گنو (GNU GPL) نسخه ۲ یا بالاتر (GPLv2+) توزیع شده است.
.
.SH "پرسش‌ها (QUESTIONS)"
پرسش‌ها درباره نحوه استفاده از این برنامه را می‌توانید به
.I فهرست پستی کاربران اسکوئید
.if !'po4a'hide' <squid-users@lists.squid-cache.org>
ارسال کنید.
.
.SH "گزارش باگ‌ها (REPORTING BUGS)"
گزارش‌های باگ باید به زبان انگلیسی ارسال شوند.
برای مشاهده جزئیات مواردی که باید در گزارش باگ خود بگنجانید،
https://wiki.squid-cache.org/SquidFaq/BugReporting
را ببینید.
.PP
گزارش باگ‌ها یا اصلاحیه‌های باگ را با استفاده از
https://bugs.squid-cache.org
ارسال کنید.
.PP
باگ‌های امنیتی جدی را به
.I باگ‌های اسکوئید <squid-bugs@lists.squid-cache.org>
گزارش دهید.
.PP
ایده‌ها برای بهبودهای جدید را به
.I فهرست پستی توسعه‌دهندگان اسکوئید
.if !'po4a'hide' <squid-dev@lists.squid-cache.org>
ارسال نمایید.
.
.SH "همچنین ببینید (SEE ALSO)"
.if !'po4a'hide' .BR squid "(8), "
.if !'po4a'hide' .BR SASL "(3), "
.if !'po4a'hide' .BR PAM "(7), "
.if !'po4a'hide' .BR passwd "(1), "
.if !'po4a'hide' .BR shadow "(5), "
.if !'po4a'hide' .BR chown "(1), "
.if !'po4a'hide' .BR chmod "(1), "
.if !'po4a'hide' .BR GPL "(7), "
.br
ویکی پرسش‌های متداول اسکوئید (Squid FAQ wiki)
.if !'po4a'hide' https://wiki.squid-cache.org/SquidFaq
.br
راهنمای پیکربندی اسکوئید (Squid Configuration Manual)
.if !'po4a'hide' http://www.squid-cache.org/Doc/config