.if !'po4a'hide' .TH basic_pam_auth 8 "5 Sep 2003"
.
.SH "نام (NAME)"
basic_pam_auth \- دستیار احراز هویت پایه PAM برای Squid
.
.SH "خلاصه دستور (SYNOPSIS)"
.if !'po4a'hide' .B "basic_pam_auth [\-n \""
service name
.if !'po4a'hide' .B "\"] [\-t "
TTL
.if !'po4a'hide' .B "] [\-o] [\-1]"
.
.SH "توضیحات (DESCRIPTION)"
برنامه
.B basic_pam_auth
به Squid امکان می‌دهد تا تقریباً به هر پایگاه‌دادهٔ PAM موجود متصل شود تا نام کاربری و گذرواژه را در احراز هویت پایه HTTP (احراز هویت Basic) اعتبارسنجی کند.
.
.SH "گزینه‌ها (OPTIONS)"
.if !'po4a'hide' .TP 12
.if !'po4a'hide' .B "\-s " "service\-name"
نام سرویس PAM مورد استفاده توسط Squid را مشخص می‌کند، مقدار پیش‌فرض
.B squid
است.
.
.if !'po4a'hide' .TP
.if !'po4a'hide' .B "\-t " TTL
اتصال‌های ماندگار PAM را فعال می‌کند که در آن اتصال به پایگاه‌داده PAM باز نگه داشته شده و برای ورودهای جدید مجدداً استفاده می‌شود. شناسه TTL مشخص می‌کند که اتصال چه مدت (به ثانیه) باز خواهد ماند. مقدار پیش‌فرض باز نگه نداشتن اتصال‌های PAM است. لطفاً توجه داشته باشید که استفاده از اتصال‌های ماندگار PAM تا حدودی خارج از مشخصات استاندارد PAM است و ممکن است با تمام پیکربندی‌های PAM کار نکند.
.
.if !'po4a'hide' .TP
.if !'po4a'hide' .B \-o
عملیات گروه مدیریت حساب کاربری PAM (مانند انقضای حساب و غیره) را انجام ندهد.
.
.SH "پیکربندی (CONFIGURATION)"
این برنامه نیازمند آن است که یک سرویس PAM در
.BR /etc/pam.conf
یا
.BR /etc/pam.d/squid
پیکربندی شده باشد.
.PP
نام سرویس پیش‌فرض
.B squid
است، و این برنامه از گروه‌های مدیریتی
.B auth
و
.B account
برای بررسی صحت گذرواژه و اعتبار حساب کاربری استفاده می‌کند.
.PP
برای مشاهده جزئیات نحوه پیکربندی سرویس‌های PAM، به مستندات PAM سیستم خود مراجعه کنید. این راهنما جزئیات پیکربندی PAM را پوشش نمی‌دهد.
.
.SH "نکات (NOTES)"
.
هنگامی که این برنامه برای احراز هویت در پایگاه‌داده‌های محلی گذرواژه shadow در یونیکس (UNIX) استفاده می‌شود، باید به عنوان کاربر ریشه (root) اجرا گردد؛ در غیر این صورت، مجوزهای کافی برای دسترسی به پایگاه‌داده گذرواژه کاربران را نخواهد داشت. چنین استفاده‌ای از این برنامه توصیه نمی‌شود، اما اگر انجام آن برای شما کاملاً ضروری است، برنامه را به‌صورت setuid root تنظیم کنید:
.if !'po4a'hide' .RS
.if !'po4a'hide' .P
.if !'po4a'hide' .B chown root basic_pam_auth
.if !'po4a'hide' .br
.if !'po4a'hide' .B chmod u+s basic_pam_auth
.if !'po4a'hide' .RE
.PP
لطفاً توجه داشته باشید که در چنین پیکربندی‌هایی همچنین اکیداً توصیه می‌شود که برنامه به دایرکتوری منتقل شود که کاربران عادی نتوانند به آن دسترسی داشته باشند، زیرا این حالت عملکرد به هر کاربر محلی امکان می‌دهد تا گذرواژه‌های سایر کاربران را با حمله جستجوی فراگیر (brute-force) کشف کند. همچنین توجه داشته باشید که این برنامه به طور کامل مورد ارزیابی امنیتی قرار نگرفته است و مسئولیتی متوجه نویسنده در قبال مسائل امنیتی ناشی از چنین نصب‌هایی نخواهد بود.
.
.SH "نویسنده (AUTHOR)"
این برنامه و مستندات آن توسط
.if !'po4a'hide' .I Henrik Nordstrom <hno@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
برنامه
.B basic_pam_auth
Squid و این راهنما دارای حق نشر ۱۹۹۹، ۲۰۰۲، ۲۰۰۳ توسط
.if !'po4a'hide' .I Henrik Nordstrom <hno@squid-cache.org>
است.
.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 pam "(3), "
.if !'po4a'hide' .BR pam.conf "(5), "
.if !'po4a'hide' .BR chown "(1), "
.if !'po4a'hide' .BR chmod "(1), "
.if !'po4a'hide' .BR GPL "(7), "
.br
راهنمای مدیران سیستم PAM (PAM Systems Administrator Guide)
.br
ویکی پرسش‌های متداول اسکوئید (The Squid FAQ wiki)
.if !'po4a'hide' https://wiki.squid-cache.org/SquidFaq
.br
راهنمای پیکربندی اسکوئید (The Squid Configuration Manual)
.if !'po4a'hide' http://www.squid-cache.org/Doc/config