.if !'po4a'hide' .TH ext_ldap_group_acl 8 "30 January 2005" . .SH "نام (NAME)" ext_ldap_group_acl \- برنامه کمکی Squid برای احراز مجوز گروهی خارجی با LDAP .PP نسخه 2.18 . .SH "خلاصه دستور (SYNOPSIS)" .if !'po4a'hide' .B ext_ldap_group_acl .if !'po4a'hide' .B \-b base\-DN .if !'po4a'hide' .B \-f filter .if !'po4a'hide' .B "[" options .if !'po4a'hide' .B "] [" server .if !'po4a'hide' .B "[ ':' " port .if !'po4a'hide' .B "] |" URI .if !'po4a'hide' .B "] ..." . .SH "توضیحات (DESCRIPTION)" .B ext_ldap_group_acl به Squid اجازه می‌دهد برای احراز مجوز کاربران از طریق گروه‌های LDAP به یک دایرکتوری LDAP متصل شود. گزینه‌های LDAP به عنوان پارامتر در خط فرمان مشخص می‌شوند، در حالی که نام(های) کاربری و گروه(های) مورد بررسی در دایرکتوری LDAP در خطوط بعدی ورودی برنامه کمکی، هر جفت نام کاربری/گروه در یک خط و با فاصله از هم مشخص می‌شوند. .PP همان‌طور که توسط ساختار .B external_acl_type در Squid انتظار می‌رود، پس از تعیین یک نام کاربری و گروه به دنبال یک خط جدید، این برنامه کمکی در خط بعد عبارت .B OK یا .B ERR را خروجی می‌دهد تا مشخص کند آیا کاربر عضو گروه مشخص‌شده است یا خیر. .PP برنامه با جستجو از طریق یک فیلتر جستجو بر اساس نام کاربری و گروه درخواستی کار می‌کند و اگر تطابقی یافت شود، مشخص می‌گردد که کاربر به گروه تعلق دارد. . .SH "گزینه‌ها (OPTIONS)" .if !'po4a'hide' .TP 12 .if !'po4a'hide' .BI "\-a " never|always|search|find زمان ارجاع‌زدایی از نام‌های مستعار. پیش‌فرض 'never' است. .IP .BI never عدم ارجاع‌زدایی از نام‌های مستعار (پیش‌فرض)، .BI always ارجاع‌زدایی همیشگی از نام‌های مستعار، فقط در حین .BR search یا فقط برای .B find شیء پایه . .if !'po4a'hide' .TP .if !'po4a'hide' .BI "\-b " "basedn " .B الزامی. مشخص‌کننده DN پایه که گروه‌ها در زیر آن قرار دارند. . .if !'po4a'hide' .TP .if !'po4a'hide' .BI "\-B " "basedn " مشخص‌کننده DN پایه که کاربران در زیر آن قرار دارند (در صورت تفاوت). . .if !'po4a'hide' .TP .if !'po4a'hide' .BI \-c " connect_timeout" تعیین مهلت زمانی اتصال به کارسازهای LDAP (نیازمند کتابخانه‌های Netscape LDAP API). . .if !'po4a'hide' .TP .if !'po4a'hide' .BI \-d حالت اشکال‌زدایی که در آن هر مرحله انجام‌شده با جزئیات گزارش می‌شود. برای فهمیدن اینکه در صورت مغایرت نتیجه با انتظار چه مشکلی پیش آمده مفید است. . .if !'po4a'hide' .TP .if !'po4a'hide' .BI "\-D " "binddn " "\-w " password مشخص کردن DN و گذرواژه برای اتصال در حین انجام جستجوها. در صورتی که دایرکتوری LDAP اجازه جستجوهای ناشناس را ندهد، الزامی است. .IP از آنجا که گذرواژه باید به‌صورت متن ساده در پیکربندی Squid شما درج شود و در خط فرمان به برنامه کمکی ارسال خواهد شد، اکیداً توصیه می‌شود از حسابی با حداقل امتیازات استفاده کنید. این کار آسیب احتمالی در صورت دستیابی کسی به نسخه‌ای از پرونده پیکربندی Squid یا استخراج گذرواژه از فهرست فرآیندها را محدود می‌کند. . .if !'po4a'hide' .TP .if !'po4a'hide' .BI "\-D " "binddn " "\-W " "secretfile " مشخص کردن DN و نام پرونده حاوی گذرواژه برای اتصال در حین انجام جستجوها. .IP نگارشی با ناامنی کمتر نسبت به جفت پارامتر قبلی با دو مزیت: گذرواژه در فهرست فرآیندها ظاهر نمی‌شود و در صورت دسترسی فردی به پرونده پیکربندی squid بدون دسترسی به secretfile، گذرواژه لو نمی‌رود. . .if !'po4a'hide' .TP .if !'po4a'hide' .BI "\-E " certpath فعال‌سازی LDAP روی SSL (نیازمند کتابخانه‌های Netscape LDAP API). . .if !'po4a'hide' .TP .if !'po4a'hide' .BI "\-f " filter فیلتر جستجوی LDAP مورد استفاده برای جستجوی دایرکتوری LDAP جهت هرگونه عضویت گروهی منطبق. .BR در فیلتر عبارت .B %u با نام کاربری (یا DN در صورت استفاده از گزینه‌های .B \-F یا .B \-u ) و .B %g با نام گروه درخواستی جایگزین خواهد شد. . .if !'po4a'hide' .TP .if !'po4a'hide' .BI "\-F " filter فیلتر جستجوی LDAP مورد استفاده برای جستجوی دایرکتوری LDAP جهت یافتن کاربران منطبق. .BR در فیلتر عبارت .B %s با نام کاربری جایگزین خواهد شد. اگر قرار است نویسه .B % به‌صورت تحت‌اللفظی در فیلتر گنجانده شود، از .B %% استفاده کنید. . .if !'po4a'hide' .TP .if !'po4a'hide' .B "\-g" مشخص می‌کند نخستین آرگومان پرس‌وجو ارسالی توسط Squid به برنامه کمکی، یک پسوند برای basedn است و موقتاً برای این پرس‌وجو در ابتدای basedn سراسری اضافه خواهد شد. . .if !'po4a'hide' .TP .if !'po4a'hide' .BI \-h " ldapserver" مشخص کردن کارساز LDAP برای اتصال. . .if !'po4a'hide' .TP .if !'po4a'hide' .BI \-H " ldapuri" مشخص کردن کارساز LDAP برای اتصال از طریق URI مربوط به LDAP (نیازمند کتابخانه‌های OpenLDAP). . .if !'po4a'hide' .TP .if !'po4a'hide' .BI \-K حذف بخش Kerberos Realm از نام‌های کاربری (جداشده با @). . .if !'po4a'hide' .TP .if !'po4a'hide' .BI \-p " ldapport" مشخص کردن درگاه TCP جایگزین که کارساز LDAP روی آن شنود می‌کند، در صورتی که غیر از درگاه پیش‌فرض LDAP یعنی 389 باشد. . .if !'po4a'hide' .TP .if !'po4a'hide' .BI \-P استفاده از اتصال پایدار LDAP. به‌طور معمول اتصال LDAP تنها در حین اعتبارسنجی عضویت گروهی کاربر باز است تا منابع در سرور LDAP حفظ شوند. این گزینه باعث می‌شود اتصال LDAP باز نگه داشته شود و امکان استفاده مجدد از آن برای اعتبارسنجی‌های بعدی کاربر فراهم گردد. برای محیط‌های بزرگ توصیه می‌شود. . .if !'po4a'hide' .TP .if !'po4a'hide' .BI \-R عدم دنبال کردن ارجاعات (referrals). . .if !'po4a'hide' .TP .if !'po4a'hide' .BI "-s " base|one|sub محدوده جستجو. پیش‌فرض .B sub است. .IP .B base فقط شیء پایه، .IP .B one یک سطح زیر شیء پایه یا .IP .BR sub زیردرخت زیر شیء پایه . .if !'po4a'hide' .TP .if !'po4a'hide' .BI \-S حذف بخش نام دامنه NT از نام‌های کاربری (جداشده با / یا \\). . .if !'po4a'hide' .TP .if !'po4a'hide' .BI \-t " search_timeout" تعیین محدودیت زمانی برای عملیات جستجوی LDAP. . .if !'po4a'hide' .TP .if !'po4a'hide' .BI "\-u " attr ویژگی LDAP مورد استفاده برای ساخت DN کاربر از نام کاربری و base dn بدون نیاز به جستجو برای کاربر. حداکثر ۱۶ بار تکرار .B %s پشتیبانی می‌شود. . .if !'po4a'hide' .TP .if !'po4a'hide' .BI \-v " 2|3" نگارش پروتکل LDAP. در صورت عدم تعیین، مقدار پیش‌فرض .B 3 است. . .if !'po4a'hide' .TP .if !'po4a'hide' .BI \-Z استفاده از رمزنگاری TLS. . .SH "پیکربندی (CONFIGURATION)" این برنامه کمکی در نظر گرفته شده است تا به عنوان یک برنامه کمکی .B external_acl_type در .B squid.conf استفاده شود. . .if !'po4a'hide' .RS .if !'po4a'hide' .B external_acl_type ldap_group %LOGIN /path/to/ext_ldap_group_acl ... .if !'po4a'hide' .br .if !'po4a'hide' .B acl group1 external ldap_group Group1 .if !'po4a'hide' .br .if !'po4a'hide' .B acl group2 external ldap_group Group2 .if !'po4a'hide' .RE . .PP .B "نکته:" هنگام ساخت فیلترهای جستجو توصیه می‌شود ابتدا فیلتر را با استفاده از .B ldapsearch آزمایش کنید تا قبل از اقدام به استفاده از .B ext_ldap_group_acl مطمئن شوید فیلتر با آنچه انتظار دارید مطابقت دارد. . .SH "نویسنده (AUTHOR)" این برنامه توسط افراد زیر نوشته شده است: .if !'po4a'hide' .I Flavio Pescuma .if !'po4a'hide' .I Henrik Nordstrom .PP بر اساس کارهای پیشین در .B squid_ldap_auth توسط .if !'po4a'hide' .I Glen Newton .PP این راهنما توسط فرد زیر نوشته شده است: .if !'po4a'hide' .I Henrik Nordstrom . .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)" پرسش‌ها درباره استفاده از این برنامه را می‌توان به فهرست پستی کاربران اسکویید ارسال کرد: .if !'po4a'hide' .PP یا اگر پرسش بیشتر به LDAP مربوط است تا Squid، با فهرست یا دوستان متخصص LDAP خود تماس بگیرید. . .SH "گزارش باگ‌ها (REPORTING BUGS)" گزارش‌های باگ باید به زبان انگلیسی ارسال شوند. برای اطلاع از جزئیات آنچه باید در گزارش باگ خود بگنجانید به مراجعه کنید. .PP گزارش باگ‌ها یا رفع اشکالات با استفاده از .PP گزارش باگ‌های امنیتی جدی به .I Squid Bugs .PP گزارش ایده‌ها برای بهبودهای جدید به فهرست پستی توسعه‌دهندگان اسکویید: .if !'po4a'hide' . .SH "همچنین ببینید (SEE ALSO)" .if !'po4a'hide' .BR squid "(8), " .if !'po4a'hide' .BR basic_ldap_auth "(8), " .if !'po4a'hide' .BR ldapsearch "(1), " .if !'po4a'hide' .BR GPL "(7), " .br مستندات LDAP مورد علاقه شما .br .BR RFC2254 " - The String Representation of LDAP Search Filters," .br ویکی سوالات متداول اسکویید: .if !'po4a'hide' .br راهنمای پیکربندی اسکویید: .if !'po4a'hide'