.if !'po4a'hide' .TH basic_getpwnam_auth 8
.
.SH "نام (NAME)"
basic_getpwnam_auth \- ابزار کمکی احراز هویت کاربران محلی برای اسکوئید (Squid)
.
.SH "خلاصه دستور (SYNOPSIS)"
.if !'po4a'hide' .B basic_getpwnam_auth
.
.SH "توضیحات (DESCRIPTION)"
دستور
.B basic_getpwnam_auth
به اسکوئید (Squid) اجازه می‌دهد تا حساب‌های کاربری محلی را برای اعتبارسنجی نام کاربری و گذرواژه در احراز هویت پایه‌ای HTTP احراز هویت کند.
.PP
این ابزار از توابع
.B getpwnam()
و
.B getspnam()
برای احراز هویت استفاده می‌کند.
.PP
این ابزار نسبت به ماژول NCSA دارای مزایای زیر است:
.if !'po4a'hide' .TP 5
\- امکان احراز هویت تمامی کاربران محلی شناخته‌شده
.
.if !'po4a'hide' .TP
\- امکان احراز هویت از طریق nsswitch.conf
.
.if !'po4a'hide' .TP
\- توانایی مدیریت درخواست‌های (+)NIS
.
.if !'po4a'hide' .TP
\- توانایی مدیریت درخواست‌های LDAP
.
.if !'po4a'hide' .TP
\- توانایی مدیریت درخواست‌های PAM
.
.SH "پیکربندی (CONFIGURATION)"
.if !'po4a'hide' .RS
.if !'po4a'hide' .B auth_param basic program /path/to/basic_getpwnam_auth
.if !'po4a'hide' .br
.if !'po4a'hide' .B auth_param basic children concurrency=1
.if !'po4a'hide' .RE
.PP
هنگامی که این برنامه برای احراز هویت در برابر پایگاه‌های داده محلی گذرواژه shadow در یونیکس استفاده می‌شود، باید با دسترسی ریشه (root) اجرا شود؛ در غیر این صورت مجوزهای کافی برای دستیابی به پایگاه داده گذرواژه کاربران را نخواهد داشت. چنین استفاده‌ای از این برنامه توصیه نمی‌شود، اما اگر الزامی است، برنامه را
.B setuid
.B root
کنید:
.if !'po4a'hide' .RS
.if !'po4a'hide' .B chown root basic_getpwnam_auth
.if !'po4a'hide' .br
.if !'po4a'hide' .B chmod u+s basic_getpwnam_auth
.if !'po4a'hide' .RE
.PP
لطفاً توجه داشته باشید که در چنین پیکربندی‌هایی اکیداً توصیه می‌شود برنامه به پوشه‌ای منتقل شود که کاربران عادی به آن دسترسی نداشته باشند، زیرا این حالت عملیاتی به هر کاربر محلی امکان می‌دهد تا گذرواژه‌های سایر کاربران را با حمله جستجوی فراگیر (brute\-force) حدس بزند. همچنین توجه داشته باشید که این برنامه به‌طور کامل بازبینی نشده است و نویسنده هیچ مسئولیتی در قبال مشکلات امنیتی ناشی از چنین نصب‌هایی بر عهده نمی‌گیرد.
.
.SH "نویسنده (AUTHOR)"
این برنامه توسط افراد زیر نوشته شده است:
.if !'po4a'hide' .I Erik Hofman <erik.hofman@a1.nl>
.if !'po4a'hide' .I Robin Elfrink <robin@a1.nl>
.if !'po4a'hide' .I Giancarlo Razzolini <linux-fan@onda.com.br>
.PP
بر اساس کد اصلی از:
.if !'po4a'hide' .I Jon Thackray <jrmt@uk.gdscorp.com>.
.PP
این راهنما توسط فرد زیر نوشته شده است:
.if !'po4a'hide' .I Amos Jeffries <amosjeffries@squid-cache.org>
.
.SH "حق نشر (COPYRIGHT)"
.PP
 * Copyright (C) 1996-2026 The Squid Software Foundation and contributors
 *
 * نرم‌افزار اسکوئید تحت مجوز +GPLv2 توزیع می‌شود و شامل
 * مشارکت‌های افراد و سازمان‌های متعددی است.
 * لطفاً برای جزئیات پرونده‌های COPYING و CONTRIBUTORS را ببینید.
.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 <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 basic_pam_auth "(8), "
.if !'po4a'hide' .BR basic_ncsa_auth "(8), "
.if !'po4a'hide' .BR basic_ldap_auth "(8), "
.if !'po4a'hide' .BR basic_nis_auth "(8), "
.if !'po4a'hide' .BR chown "(1), "
.if !'po4a'hide' .BR chmod "(1), "
.if !'po4a'hide' .BR nsswitch.conf "(5), "
.if !'po4a'hide' .BR getpwnam "(3), "
.if !'po4a'hide' .BR getspnam "(3), "
.if !'po4a'hide' .BR GPL "(7), "
.br
ویکی سؤالات متداول اسکوئید (Squid FAQ):
.if !'po4a'hide' https://wiki.squid-cache.org/SquidFaq
.br
راهنمای پیکربندی اسکوئید:
.if !'po4a'hide' http://www.squid-cache.org/Doc/config