'\" t
.\"     Title: sssd-ldap
.\"    Author: The SSSD upstream - https://github.com/SSSD/sssd
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 06/09/2026
.\"    Manual: File Formats and Conventions
.\"    Source: SSSD
.\"  Language: Persian
.\"
.TH "SSSD\-LDAP" "5" "06/09/2026" "SSSD" "File Formats and Conventions"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
sssd-ldap \- ارائه‌دهنده LDAP برای SSSD
.SH "توضیحات (DESCRIPTION)"
.PP
این صفحه راهنما پیکربندی دامنه‌های LDAP را برای
\fBsssd\fR(8)
شرح می‌دهد\&. برای اطلاعات تفصیلی درباره ساختار دستوری، به بخش
\(lqFILE FORMAT\(rq
در صفحه راهنمای
\fBsssd.conf\fR(5)
مراجعه کنید\&.
.PP
می‌توان SSSD را برای استفاده از بیش از یک دامنه LDAP پیکربندی کرد\&.
.PP
بک‌اند LDAP از ارائه‌دهنده‌های id، auth، access و chpass پشتیبانی می‌کند\&. برای احراز هویت در یک سرور LDAP، استفاده از TLS/SSL یا LDAPS الزامی است\&.
\fBsssd\fR
از احراز هویت در بستر یک کانال رمزنگاری‌نشده پشتیبانی
\fIنمی‌کند\fR\&.
حتی در صورت استفاده از سرور LDAP صرفاً به عنوان ارائه‌دهنده هویت، استفاده از یک کانال رمزنگاری‌شده اکیداً توصیه می‌شود\&. لطفاً برای اطلاعات بیشتر درباره استفاده از LDAP به عنوان ارائه‌دهنده دسترسی، به گزینه پیکربندی
\(lqldap_access_filter\(rq
مراجعه کنید\&.
.SH "گزینه‌های پیکربندی (CONFIGURATION OPTIONS)"
.PP
تمام گزینه‌های پیکربندی مشترک که برای دامنه‌های SSSD به کار می‌روند، برای دامنه‌های LDAP نیز معتبر هستند\&. برای جزئیات کامل به بخش
\(lqDOMAIN SECTIONS\(rq
در صفحه راهنمای
\fBsssd.conf\fR(5)
مراجعه کنید\&. توجه داشته باشید که ویژگی‌های نگاشت LDAP در SSSD در صفحه راهنمای
\fBsssd-ldap-attributes\fR(5)
شرح داده شده‌اند\&.
.PP
ldap_uri, ldap_backup_uri (string)
.RS 4
فهرستی از URIهای سرورهای LDAP را مشخص می‌کند که با کاما از یکدیگر جدا شده‌اند و SSSD به ترتیب اولویت به آن‌ها متصل می‌شود\&. برای اطلاعات بیشتر در خصوص جایگزینی هنگام خرابی و افزونگی سرورها، به بخش
\(lqجایگزینی هنگام خرابی (FAILOVER)\(rq
مراجعه کنید\&. اگر هیچ‌کدام از گزینه‌ها تعیین نشده باشد، شناسایی سرویس فعال می‌شود\&. برای اطلاعات بیشتر، به بخش
\(lqشناسایی سرویس (SERVICE DISCOVERY)\(rq
مراجعه کنید\&.
.sp
قالب URI باید با ساختار تعریف‌شده در RFC 2732 مطابقت داشته باشد:
.sp
ldap[s]://<host>[:port]
.sp
برای آدرس‌های صریح IPv6، شناسه <host> باید داخل کروشه [] قرار گیرد
.sp
مثال: ldap://[fc00::126:25]:389
.RE
.PP
ldap_chpass_uri, ldap_chpass_backup_uri (string)
.RS 4
فهرستی از URIهای سرورهای LDAP را مشخص می‌کند که با کاما از یکدیگر جدا شده‌اند و SSSD به ترتیب اولویت جهت تغییر گذرواژه کاربر به آن‌ها متصل می‌شود\&. برای اطلاعات بیشتر درباره جایگزینی هنگام خرابی و افزونگی سرورها، به بخش
\(lqجایگزینی هنگام خرابی (FAILOVER)\(rq
مراجعه کنید\&.
.sp
جهت فعال‌سازی شناسایی سرویس، گزینه ldap_chpass_dns_service_name باید تنظیم شود\&.
.sp
پیش‌فرض: خالی، یعنی از ldap_uri استفاده می‌شود\&.
.RE
.PP
ldap_search_base (string)
.RS 4
پایه جستجوی (base DN) پیش‌فرض برای انجام عملیات‌های کاربر در LDAP\&.
.sp
از نسخه SSSD 1\&.7\&.0 به بعد، SSSD با استفاده از ساختار زیر از پایه‌های جستجوی چندگانه پشتیبانی می‌کند:
.sp
search_base[?scope?[filter][?search_base?scope?[filter]]*]
.sp
محدوده (scope) می‌تواند یکی از مقادیر "base"، "onelevel" یا "subtree" باشد\&.
.sp
فیلتر باید یک فیلتر جستجوی معتبر LDAP باشد، همان‌طور که در http://www\&.ietf\&.org/rfc/rfc2254\&.txt مشخص شده است
.sp
مثال‌ها:
.sp
ldap_search_base = dc=example,dc=com (که معادل است با) ldap_search_base = dc=example,dc=com?subtree?
.sp
ldap_search_base = cn=host_specific,dc=example,dc=com?subtree?(host=thishost)?dc=example\&.com?subtree?
.sp
نکته: داشتن چندین پایه جستجو که به اشیایی با نام یکسان اشاره کنند (برای مثال گروه‌هایی با نام مشابه در دو پایه جستجوی متفاوت) پشتیبانی نمی‌شود\&. این موضوع باعث رفتارهای پیش‌بینی‌نشده در سیستم‌های کلاینت خواهد شد\&.
.sp
پیش‌فرض: در صورت عدم تنظیم، از مقدار ویژگی defaultNamingContext یا namingContexts از RootDSE سرور LDAP استفاده می‌شود\&. اگر defaultNamingContext وجود نداشته باشد یا مقداری خالی داشته باشد، از namingContexts استفاده می‌شود\&. برای اینکه این فرآیند به درستی کار کند، ویژگی namingContexts باید تنها یک مقدار شامل DN پایه جستجوی سرور LDAP داشته باشد\&. مقادیر چندگانه پشتیبانی نمی‌شوند\&.
.RE
.PP
ldap_read_rootdse (string)
.RS 4
نرم‌افزار SSSD برای دریافت اطلاعات مربوط به LDAP و قابلیت‌های آن، مقدار RootDSE را می‌خواند\&. این عمل به‌طور پیش‌فرض به شکل ناشناس انجام می‌شود\&. با این حال، ممکن است سرور LDAP اجازه چنین کاری را ندهد\&. در چنین مواردی می‌توان از این گزینه برای کنترل رفتار SSSD استفاده کرد\&.
.sp
مقادیر مجاز عبارتند از:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
anonymous
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
authenticated
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
never
.RE
.sp
به‌طور پیش‌فرض با انتخاب "anonymous"، نرم‌افزار SSSD تلاش می‌کند RootDSE را به صورت ناشناس بخواند\&. اگر این عملیات با شکست مواجه شود، تلاش مجدد را همراه با احراز هویت انجام می‌دهد\&.
.sp
پیش‌فرض: anonymous
.RE
.PP
ldap_schema (string)
.RS 4
نوع اسکیمای (Schema Type) مورد استفاده در سرور LDAP مقصد را مشخص می‌کند\&. بر اساس اسکیمای انتخاب‌شده، نام صفات پیش‌فرضِ دریافت‌شده از سرورها ممکن است تغییر کند\&. نحوه مدیریت برخی صفات نیز ممکن است متفاوت باشد\&.
.sp
در حال حاضر چهار نوع اسکیما پشتیبانی می‌شود:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
rfc2307
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
rfc2307bis
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
IPA
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
AD
.RE
.sp
تفاوت اصلی میان این انواع اسکیما، چگونگی ذخیره عضویت در گروه‌ها درون سرور است\&. در rfc2307، اعضای گروه بر اساس نام در صفت
\fImemberUid\fR
فهرست می‌شوند\&. در rfc2307bis و IPA، اعضای گروه با DN مشخص شده و در صفت
\fImember\fR
ذخیره می‌شوند\&. نوع اسکیمای AD، صفات را متناسب با مقادیر Active Directory 2008r2 تنظیم می‌کند\&.
.sp
پیش‌فرض: rfc2307
.RE
.PP
ldap_pwmodify_mode (string)
.RS 4
عملیاتی را که برای ویرایش گذرواژه کاربر استفاده می‌شود مشخص می‌کند\&.
.sp
در حال حاضر از دو حالت پشتیبانی می‌شود:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
exop \- عملیات توسعه‌یافته تغییر گذرواژه (RFC 3062)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
ldap_modify \- تغییر مستقیم userPassword (توصیه نمی‌شود)\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
exop_force \- تلاش برای عملیات توسعه‌یافته تغییر گذرواژه (RFC 3062) حتی در صورت نماندن ورود ارفاقی (grace login)\&. بسته به نوع و پیکربندی سرور LDAP، تغییر گذرواژه ممکن است با شکست مواجه شود زیرا اتصال احراز هویت‌شده (authenticated bind) امکان‌پذیر نیست\&.
.RE
.sp
نکته: ابتدا یک اتصال جدید برای بررسی گذرواژه فعلی با متصل شدن (bind) به‌عنوان کاربری که درخواست تغییر گذرواژه داده است برقرار می‌شود\&. در صورت موفقیت، از این اتصال برای تغییر گذرواژه استفاده می‌شود؛ بنابراین کاربر باید دسترسی نوشتن به صفت userPassword را داشته باشد\&.
.sp
پیش‌فرض: exop
.RE
.PP
ldap_default_bind_dn (string)
.RS 4
مقدار bind DN پیش‌فرض جهت استفاده برای اجرای عملیات‌های LDAP\&.
.RE
.PP
ldap_default_authtok_type (string)
.RS 4
نوع توکن احراز هویت برای bind DN پیش‌فرض\&.
.sp
دو سازوکاری که در حال حاضر پشتیبانی می‌شوند عبارتند از:
.sp
password
.sp
obfuscated_password
.sp
پیش‌فرض: password
.sp
برای اطلاعات بیشتر به صفحه راهنمای
\fBsss_obfuscate\fR(8)
مراجعه کنید\&.
.RE
.PP
ldap_default_authtok (string)
.RS 4
توکن احراز هویت مربوط به bind DN پیش‌فرض\&.
.RE
.PP
ldap_force_upper_case_realm (boolean)
.RS 4
برخی سرورهای دایرکتوری، مانند Active Directory، ممکن است بخش realm از UPN را با حروف کوچک ارسال کنند که می‌تواند باعث شکست در احراز هویت شود\&. اگر می‌خواهید از یک realm با حروف بزرگ استفاده کنید، این گزینه را روی مقداری غیر از صفر تنظیم کنید\&.
.sp
پیش‌فرض: false
.RE
.PP
ldap_enumeration_refresh_timeout (integer)
.RS 4
مشخص می‌کند که SSSD پیش از بازنشانی کش رکوردهای شمارش‌شده (enumerated) چند ثانیه باید منتظر بماند\&.
.sp
پیش‌فرض: 300
.RE
.PP
ldap_purge_cache_timeout (integer)
.RS 4
مشخص می‌کند هر چند وقت یک‌بار کش برای ورودی‌های غیرفعال (مانند گروه‌های بدون عضو و کاربرانی که هرگز وارد سیستم نشده‌اند) بررسی شود و برای صرفه‌جویی در فضا حذف شوند\&.
.sp
تنظیم این گزینه روی صفر عملیات پاک‌سازی کش را غیرفعال می‌کند\&. لطفاً توجه داشته باشید در صورت فعال بودن شمارش (enumeration)، وظیفه پاک‌سازی جهت شناسایی ورودی‌های حذف‌شده از سرور الزامی است و نمی‌توان آن را غیرفعال کرد\&. به‌طور پیش‌فرض در صورت فعال بودن enumeration، عملیات پاک‌سازی هر ۳ ساعت یک‌بار اجرا می‌شود\&.
.sp
این گزینه می‌تواند برای هر زیردامنه نیز تنظیم شود یا از طریق
\fIsubdomain_inherit\fR
به ارث برسد\&.
.sp
پیش‌فرض: 0 (غیرفعال)
.RE
.PP
ldap_group_nesting_level (integer)
.RS 4
اگر ldap_schema روی ساختاری (schema) تنظیم شده باشد که از گروه‌های تودرتو پشتیبانی می‌کند (مانند RFC2307bis)، این گزینه مشخص می‌کند SSSD تا چند سطح از تودرتویی را دنبال خواهد کرد\&. این گزینه تأثیری بر ساختار RFC2307 ندارد\&.
.sp
نکته: این گزینه سطح تضمین‌شده گروه‌های تودرتو را برای پردازش در هر جستجو مشخص می‌کند\&. با این حال، اگر جستجوهای قبلی سطوح عمیق‌تر تودرتویی را تفکیک کرده باشند، ممکن است گروه‌های تودرتوی فراتر از این حد
\fIبرگردانده شوند\fR\&.
همچنین، پرس‌وجوی مجدد در جستجوهای بعدی برای سایر گروه‌ها ممکن است مجموعه نتایج جستجوی اولیه را بزرگ‌تر کند\&.
.sp
اگر ldap_group_nesting_level روی 0 تنظیم شود، هیچ گروه تودرتویی پردازش نخواهد شد\&. با این حال، هنگام اتصال به سرور Active Directory 2008 و جدیدتر با استفاده از
\(lqid_provider=ad\(rq
لازم است علاوه بر این با تنظیم ldap_use_tokengroups روی false، استفاده از Token\-Groups غیرفعال شود تا تودرتویی گروه‌ها محدود گردد\&.
.sp
پیش‌فرض: 2
.RE
.PP
ldap_use_tokengroups
.RS 4
این گزینه استفاده از صفت Token\-Groups را هنگام اجرای initgroup برای کاربران از Active Directory Server 2008 و جدیدتر فعال یا غیرفعال می‌کند\&.
.sp
این گزینه همچنین می‌تواند برای هر زیردامنه تعیین شود یا از طریق
\fIsubdomain_inherit\fR
به ارث برسد\&.
.sp
پیش‌فرض: برای AD و IPA برابر با True، در غیر این صورت False\&.
.RE
.PP
ldap_host_search_base (string)
.RS 4
اختیاری\&. استفاده از رشته داده‌شده به‌عنوان مبنای جستجو (search base) برای اشیاء میزبان (host)\&.
.sp
برای اطلاعات بیشتر در مورد پیکربندی چند مبنای جستجو، به
\(lqldap_search_base\(rq
مراجعه کنید\&.
.sp
پیش‌فرض: مقدار
\fIldap_search_base\fR
.RE
.PP
ldap_subid_ranges_search_base (string)
.RS 4
اختیاری\&. استفاده از رشته داده‌شده به‌عنوان مبنای جستجو برای اشیاء مربوط به محدوده‌های تابع (subordinate ranges)\&.
.sp
پیش‌فرض: برای IPA برابر با مقدار
\fIcn=subids,%basedn\fR
و در غیر این صورت
\fIldap_search_base\fR\&.
.RE
.PP
ldap_service_search_base (string)
.RS 4
یک base DN اختیاری، محدوده جستجو (scope) و فیلتر LDAP برای محدود کردن جستجوهای LDAP جهت این نوع صفت\&.
.sp
نحو:
.sp
.if n \{\
.RS 4
.\}
.nf
search_base[?scope?[filter][?search_base?scope?[filter]]*]
.fi
.if n \{\
.RE
.\}
.sp
محدوده (scope) می‌تواند یکی از مقادیر "base"، "onelevel" یا "subtree" باشد\&. محدوده طبق بخش 4\&.5\&.1\&.2 از http://tools\&.ietf\&.org/html/rfc4511 عمل می‌کند\&.
.sp
فیلتر باید یک فیلتر جستجوی معتبر LDAP طبق مشخصات http://www\&.ietf\&.org/rfc/rfc2254\&.txt باشد\&.
.sp
برای دیدن مثال‌هایی از این نحو، به بخش مثال‌های
\(lqldap_search_base\(rq
مراجعه کنید\&.
.sp
پیش‌فرض: مقدار
\fIldap_search_base\fR
.sp
لطفاً توجه داشته باشید که تعیین scope یا filter برای جستجوها در سرور Active Directory که ممکن است تعداد نتایج بالایی داشته باشند و افزونه Range Retrieval را فعال کنند پشتیبانی نمی‌شود\&.
.RE
.PP
ldap_iphost_search_base (string)
.RS 4
یک base DN اختیاری، محدوده جستجو (scope) و فیلتر LDAP برای محدود کردن جستجوهای LDAP جهت این نوع صفت\&.
.sp
نحو:
.sp
.if n \{\
.RS 4
.\}
.nf
search_base[?scope?[filter][?search_base?scope?[filter]]*]
.fi
.if n \{\
.RE
.\}
.sp
محدوده (scope) می‌تواند یکی از مقادیر "base"، "onelevel" یا "subtree" باشد\&. محدوده طبق بخش 4\&.5\&.1\&.2 از http://tools\&.ietf\&.org/html/rfc4511 عمل می‌کند\&.
.sp
فیلتر باید یک فیلتر جستجوی معتبر LDAP طبق مشخصات http://www\&.ietf\&.org/rfc/rfc2254\&.txt باشد\&.
.sp
برای دیدن مثال‌هایی از این نحو، به بخش مثال‌های
\(lqldap_search_base\(rq
مراجعه کنید\&.
.sp
پیش‌فرض: مقدار
\fIldap_search_base\fR
.sp
لطفاً توجه داشته باشید که تعیین scope یا filter برای جستجوها در سرور Active Directory که ممکن است تعداد نتایج بالایی داشته باشند و افزونه Range Retrieval را فعال کنند پشتیبانی نمی‌شود\&.
.RE
.PP
ldap_ipnetwork_search_base (string)
.RS 4
یک base DN اختیاری، محدوده جستجو (scope) و فیلتر LDAP برای محدود کردن جستجوهای LDAP جهت این نوع صفت\&.
.sp
نحو:
.sp
.if n \{\
.RS 4
.\}
.nf
search_base[?scope?[filter][?search_base?scope?[filter]]*]
.fi
.if n \{\
.RE
.\}
.sp
محدوده (scope) می‌تواند یکی از مقادیر "base"، "onelevel" یا "subtree" باشد\&. محدوده طبق بخش 4\&.5\&.1\&.2 از http://tools\&.ietf\&.org/html/rfc4511 عمل می‌کند\&.
.sp
فیلتر باید یک فیلتر جستجوی معتبر LDAP طبق مشخصات http://www\&.ietf\&.org/rfc/rfc2254\&.txt باشد\&.
.sp
برای دیدن مثال‌هایی از این نحو، به بخش مثال‌های
\(lqldap_search_base\(rq
مراجعه کنید\&.
.sp
پیش‌فرض: مقدار
\fIldap_search_base\fR
.sp
لطفاً توجه داشته باشید که تعیین scope یا filter برای جستجوها در سرور Active Directory که ممکن است تعداد نتایج بالایی داشته باشند و افزونه Range Retrieval را فعال کنند پشتیبانی نمی‌شود\&.
.RE
.PP
ldap_search_timeout (integer)
.RS 4
مدت زمان مهلت (به ثانیه) را برای اجرای جستجوهای LDAP پیش از لغو آن‌ها و بازگرداندن نتایج کش‌شده (و ورود به حالت آفلاین) مشخص می‌کند\&.
.sp
نکته: این گزینه در نسخه‌های آینده SSSD ممکن است دستخوش تغییر شود\&. احتمالاً در زمانی با مجموعه‌ای از مهلت‌های زمانی برای انواع جستجوهای خاص جایگزین خواهد شد\&.
.sp
این گزینه همچنین می‌تواند برای هر زیردامنه تنظیم شود یا از طریق
\fIsubdomain_inherit\fR
به ارث برسد\&.
.sp
پیش‌فرض: 6
.RE
.PP
ldap_enumeration_search_timeout (integer)
.RS 4
مدت زمان مهلت (به ثانیه) را برای اجرای جستجوهای LDAP مربوط به شمارش کاربران و گروه‌ها پیش از لغو آن‌ها و بازگرداندن نتایج کش‌شده (و ورود به حالت آفلاین) مشخص می‌کند\&.
.sp
پیش‌فرض: 60
.RE
.PP
ldap_network_timeout (integer)
.RS 4
مدت زمان مهلت (به ثانیه) را تعیین می‌کند که پس از آن
\fBpoll\fR(2)/\fBselect\fR(2)
متعاقب یک
\fBconnect\fR(2)
در صورت نبود فعالیت بازمی‌گردد\&.
.sp
این گزینه همچنین می‌تواند برای هر زیردامنه تنظیم شود یا از طریق
\fIsubdomain_inherit\fR
به ارث برسد\&.
.sp
پیش‌فرض: 6
.RE
.PP
ldap_opt_timeout (integer)
.RS 4
یک مهلت زمانی (به ثانیه) تعیین می‌کند که پس از آن فراخوانی‌های همگام APIهای LDAP در صورت عدم دریافت پاسخ متوقف می‌شوند\&. همچنین مهلت زمانی ارتباط با KDC در هنگام اتصال SASL، مهلت زمانی عملیات اتصال LDAP، عملیات توسعه‌یافته تغییر گذرواژه و عملیات StartTLS را کنترل می‌کند\&.
.sp
این گزینه همچنین می‌تواند برای هر زیردامنه تنظیم شود یا از طریق
\fIsubdomain_inherit\fR
به ارث برسد\&.
.sp
پیش‌فرض: 8
.RE
.PP
ldap_connection_expire_timeout (integer)
.RS 4
مدت زمانی (به ثانیه) را مشخص می‌کند که طی آن اتصال به یک سرور LDAP حفظ خواهد شد\&. پس از این زمان، اتصال مجدداً برقرار می‌شود\&. در صورت استفاده همزمان با SASL/GSSAPI، مقداری که زودتر فرا برسد (این مقدار در مقابل طول عمر TGT) استفاده خواهد شد\&.
.sp
اگر اتصال تا زمان باقی‌مانده برابر با
\fIldap_opt_timeout\fR
ثانیه تا انقضا بیکار باشد (هیچ عملیاتی را به‌طور فعال اجرا نکند)، اتصال زودتر بسته خواهد شد تا تضمین شود پرس‌وجوی جدیدی نیازمند باز ماندن اتصال پس از انقضای آن نخواهد بود\&. این امر بدان معناست که در صورت برقراری شرط
\fIldap_connection_expire_timeout <= ldap_opt_timout\fR
اتصالات همواره بلافاصله بسته خواهند شد و هرگز مجدداً استفاده نخواهند شد\&.
.sp
این مهلت زمانی می‌تواند با یک مقدار تصادفی تعیین‌شده توسط
\fIldap_connection_expire_offset\fR
تمدید شود\&.
.sp
این گزینه همچنین می‌تواند برای هر زیردامنه تنظیم شود یا از طریق
\fIsubdomain_inherit\fR
به ارث برسد\&.
.sp
پیش‌فرض: 900 (15 دقیقه)
.RE
.PP
ldap_connection_expire_offset (integer)
.RS 4
افست تصادفی بین 0 و مقدار پیکربندی‌شده به
\fIldap_connection_expire_timeout\fR
اضافه می‌شود\&.
.sp
این گزینه می‌تواند به ازای هر زیردامنه نیز تنظیم شود یا از طریق
\fIsubdomain_inherit\fR
به ارث برسد\&.
.sp
پیش‌فرض: 0
.RE
.PP
ldap_connection_idle_timeout (integer)
.RS 4
مدت‌زمان انتظار (به ثانیه) را تعیین می‌کند که طی آن یک اتصال بیکار به سرور LDAP حفظ خواهد شد\&. اگر اتصال بیش از این زمان بیکار بماند، اتصال بسته خواهد شد\&.
.sp
می‌توانید با تنظیم مقدار روی 0 این زمان انتظار را غیرفعال کنید\&.
.sp
این گزینه می‌تواند به ازای هر زیردامنه نیز تنظیم شود یا از طریق
\fIsubdomain_inherit\fR
به ارث برسد\&.
.sp
پیش‌فرض: 900 (15 دقیقه)
.RE
.PP
ldap_page_size (integer)
.RS 4
تعداد رکوردهایی را که باید در یک درخواست واحد از LDAP واکشی شوند، مشخص می‌کند\&. برخی سرورهای LDAP محدودیت حداکثری برای هر درخواست اعمال می‌کنند\&.
.sp
پیش‌فرض: 1000
.RE
.PP
ldap_disable_paging (boolean)
.RS 4
کنترل صفحه‌بندی LDAP را غیرفعال می‌کند\&. این گزینه زمانی باید استفاده شود که سرور LDAP پشتیبانی از کنترل صفحه‌بندی LDAP را در RootDSE خود گزارش می‌دهد اما این ویژگی فعال نیست یا عملکرد درستی ندارد\&.
.sp
مثال: سرورهای OpenLDAP که ماژول کنترل صفحه‌بندی روی سرور نصب شده اما فعال نشده است، آن را در RootDSE گزارش می‌دهند اما قادر به استفاده از آن نیستند\&.
.sp
مثال: سرور 389 DS دارای باگی است که فقط می‌تواند از یک کنترل صفحه‌بندی در یک زمان روی یک اتصال واحد پشتیبانی کند\&. در کلاینت‌های پرمشغله، این می‌تواند منجر به رد شدن برخی درخواست‌ها شود\&.
.sp
پیش‌فرض: False
.RE
.PP
ldap_disable_range_retrieval (boolean)
.RS 4
بازیابی بازه‌ای Active Directory را غیرفعال می‌کند\&.
.sp
Active Directory تعداد اعضایی را که می‌توان در یک جستجوی واحد با استفاده از خط‌مشی MaxValRange بازیابی کرد، محدود می‌کند که به طور پیش‌فرض 1500 عضو است\&. اگر یک گروه بیش از 1500 عضو داشته باشد، پاسخ شامل یک افزونه بازه‌ایِ مخصوص AD خواهد بود\&. در صورت فعال بودن، این گزینه مانع از تجزیه افزونه بازه‌ای توسط SSSD می‌شود\&. در نتیجه، گروه‌های بزرگ به‌گونه‌ای ظاهر می‌شوند که گویی هیچ عضوی ندارند\&. این گزینه SSSD را قادر به خواندن بازه‌های بعدی نمی‌سازد\&. برای بازیابی همه اعضای یک گروه، باید مقدار MaxValRange را در Active Directory افزایش دهید\&.
.sp
پیش‌فرض: False
.RE
.PP
ldap_sasl_minssf (integer)
.RS 4
هنگام ارتباط با سرور LDAP با استفاده از SASL، حداقل سطح امنیتی لازم برای برقراری اتصال را مشخص می‌کند\&. مقادیر این گزینه توسط OpenLDAP تعریف می‌شوند\&.
.sp
پیش‌فرض: استفاده از پیش‌فرض سیستم (معمولاً در ldap\&.conf مشخص می‌شود)
.RE
.PP
ldap_sasl_maxssf (integer)
.RS 4
هنگام ارتباط با سرور LDAP با استفاده از SASL، حداکثر سطح امنیتی لازم برای برقراری اتصال را مشخص می‌کند\&. مقادیر این گزینه توسط OpenLDAP تعریف می‌شوند\&.
.sp
پیش‌فرض: استفاده از پیش‌فرض سیستم (معمولاً در ldap\&.conf مشخص می‌شود)
.RE
.PP
ldap_deref_threshold (integer)
.RS 4
تعداد اعضای گروهی را مشخص می‌کند که باید در حافظه موقت (cache) داخلی وجود نداشته باشند تا یک جستجوی ارجاع‌زدایی (dereference) فعال شود\&. اگر اعضای کمتری مفقود باشند، آن‌ها به صورت جداگانه جستجو می‌شوند\&.
.sp
می‌توانید جستجوهای dereference را با تنظیم این مقدار روی 0 به طور کامل خاموش کنید\&. لطفاً توجه داشته باشید که برخی از مسیرهای کد در SSSD، مانند ارائه‌دهنده IPA HBAC، فقط با استفاده از فراخوانی dereference پیاده‌سازی شده‌اند؛ بنابراین حتی با غیرفعال بودن صریح dereference، این بخش‌ها در صورتی که سرور پشتیبانی کند و کنترل dereference را در شیء rootDSE اعلان نماید، همچنان از dereference استفاده خواهند کرد\&.
.sp
یک جستجوی dereference ابزاری برای واکشی همه اعضای گروه در یک فراخوانی واحد LDAP است\&. سرورهای مختلف LDAP ممکن است متدهای مختلفی برای dereference پیاده‌سازی کنند\&. سرورهایی که در حال حاضر پشتیبانی می‌شوند عبارتند از 389/RHDS، OpenLDAP و Active Directory\&.
.sp
\fIنکته:\fR
اگر هر یک از پایه‌های جستجو (search bases) یک فیلتر جستجو مشخص کند، بهبود عملکرد جستجوی dereference صرف‌نظر از این تنظیم غیرفعال خواهد شد\&.
.sp
پیش‌فرض: 10
.RE
.PP
ldap_ignore_unreadable_references (bool)
.RS 4
نادیده گرفتن مدخل‌های غیرقابل خواندن LDAP که در ویژگی member گروه به آن‌ها ارجاع داده شده است\&. اگر این پارامتر روی false تنظیم شود، خطایی بازگردانده می‌شود و عملیات به جای صرفاً نادیده گرفتن مدخل غیرقابل خواندن، ناموفق خواهد بود\&.
.sp
این پارامتر ممکن است هنگام استفاده از ارائه‌دهنده AD که در آن حساب رایانه مورد استفاده sssd برای اتصال به AD بنا به دلایل امنیتی دسترسی به یک مدخل خاص یا زیردرخت LDAP ندارد، مفید باشد\&.
.sp
پیش‌فرض: False
.RE
.PP
ldap_tls_reqcert (string)
.RS 4
مشخص می‌کند چه بررسی‌هایی روی گواهی‌های سرور در یک نشست TLS در صورت وجود انجام شود\&. این گزینه می‌تواند یکی از مقادیر زیر باشد:
.sp
\fInever\fR
= کلاینت هیچ گواهی سروری را درخواست یا بررسی نخواهد کرد\&.
.sp
\fIallow\fR
= گواهی سرور درخواست می‌شود\&. اگر هیچ گواهی ارائه نشود، نشست به صورت عادی ادامه می‌یابد\&. اگر یک گواهی نامعتبر ارائه شود، نادیده گرفته شده و نشست به صورت عادی ادامه می‌یابد\&.
.sp
\fItry\fR
= گواهی سرور درخواست می‌شود\&. اگر هیچ گواهی ارائه نشود، نشست به صورت عادی ادامه می‌یابد\&. اگر یک گواهی نامعتبر ارائه شود، نشست فوراً خاتمه می‌یابد\&.
.sp
\fIdemand\fR
= گواهی سرور درخواست می‌شود\&. اگر هیچ گواهی ارائه نشود، یا یک گواهی نامعتبر ارائه گردد، نشست فوراً خاتمه می‌یابد\&.
.sp
\fIhard\fR
= مشابه
\(lqdemand\(rq
.sp
پیش‌فرض: hard
.RE
.PP
ldap_tls_cacert (string)
.RS 4
فایلی را مشخص می‌کند که شامل گواهی‌های تمام مراجع صدور گواهی (CA) است که
\fBsssd\fR
به رسمیت خواهد شناخت\&.
.sp
پیش‌فرض: استفاده از پیش‌فرض‌های OpenLDAP، معمولاً در
/etc/openldap/ldap\&.conf
.RE
.PP
ldap_tls_cacertdir (string)
.RS 4
مسیر دایرکتوری‌ای را مشخص می‌کند که شامل گواهی‌های مراجع صدور گواهی (CA) در فایل‌های مجزا و مستقل است\&. معمولاً نام فایل‌ها باید هشِ گواهی و به دنبال آن \*(Aq\&.0\*(Aq باشد\&. در صورت وجود،
\fBopenssl rehash\fR
یا
\fBc_rehash\fR
می‌توانند برای ایجاد نام‌های صحیح استفاده شوند\&.
.sp
پیش‌فرض: استفاده از پیش‌فرض‌های OpenLDAP، معمولاً در
/etc/openldap/ldap\&.conf
.RE
.PP
ldap_tls_cert (string)
.RS 4
فایلی را مشخص می‌کند که شامل گواهی برای کلید کلاینت است\&.
.sp
پیش‌فرض: تنظیم نشده
.RE
.PP
ldap_tls_key (string)
.RS 4
فایلی را مشخص می‌کند که شامل کلید کلاینت است\&.
.sp
پیش‌فرض: تنظیم نشده
.RE
.PP
ldap_tls_cipher_suite (string)
.RS 4
مجموعه رمزهای (cipher suites) قابل قبول را مشخص می‌کند\&. معمولاً این یک فهرست جداشده با دونقطه است\&. برای قالب به
\fBldap.conf\fR(5)
مراجعه کنید\&.
.sp
پیش‌فرض: استفاده از پیش‌فرض‌های OpenLDAP، معمولاً در
/etc/openldap/ldap\&.conf
.RE
.PP
ldap_id_use_start_tls (boolean)
.RS 4
مشخص می‌کند که اتصال id_provider باید برای محافظت از کانال از
tls
نیز استفاده کند\&.
مقدار \fItrue\fR
به دلایل امنیتی اکیداً توصیه می‌شود\&.
.sp
پیش‌فرض: true
.RE
.PP
ldap_id_mapping (boolean)
.RS 4
مشخص می‌کند که SSSD باید تلاش کند شناسه‌های کاربر و گروه را از ویژگی‌های ldap_user_objectsid و ldap_group_objectsid نگاشت کند، به‌جای اینکه به ldap_user_uid_number و ldap_group_gid_number تکیه کند\&.
.sp
در حال حاضر این ویژگی فقط از نگاشت objectSID در ActiveDirectory پشتیبانی می‌کند\&.
.sp
پیش‌فرض: false
.RE
.PP
ldap_min_id, ldap_max_id (integer)
.RS 4
برخلاف نگاشت شناسه‌های مبتنی بر SID که در صورت تنظیم ldap_id_mapping روی true استفاده می‌شود، محدوده شناسه مجاز برای ldap_user_uid_number و ldap_group_gid_number نامحدود است\&. در ساختاری با زیردامنه‌ها/دامنه‌های مورد اعتماد، این موضوع ممکن است منجر به تداخل شناسه‌ها شود\&. برای جلوگیری از تداخل، می‌توان ldap_min_id و ldap_max_id را تنظیم کرد تا محدوده مجاز برای شناسه‌هایی که مستقیماً از سرور خوانده می‌شوند، محدود شود\&. سپس زیردامنه‌ها می‌توانند محدوده‌های دیگری را برای نگاشت شناسه‌ها انتخاب کنند\&.
.sp
پیش‌فرض: تنظیم نشده (هر دو گزینه روی 0 تنظیم شده‌اند)
.RE
.PP
ldap_sasl_mech (string)
.RS 4
مکانیسم SASL مورد استفاده را مشخص می‌کند\&. در حال حاضر فقط GSSAPI و GSS\-SPNEGO آزمایش و پشتیبانی شده‌اند\&.
.sp
اگر بک‌اند از زیردامنه‌ها پشتیبانی کند، مقدار ldap_sasl_mech به طور خودکار به زیردامنه‌ها به ارث می‌رسد\&. اگر مقدار متفاوتی برای یک زیردامنه مورد نیاز باشد، می‌توان آن را با تنظیم صریح ldap_sasl_mech برای آن زیردامنه بازنویسی کرد\&. لطفاً برای جزئیات به TRUSTED DOMAIN SECTION در
\fBsssd.conf\fR(5)
مراجعه کنید\&.
.sp
پیش‌فرض: تنظیم نشده
.RE
.PP
ldap_sasl_authid (string)
.RS 4
شناسه مجوز SASL را برای استفاده مشخص می‌کند\&. هنگام استفاده از GSSAPI/GSS\-SPNEGO، این نشان‌دهنده پرینسیپال Kerberos است که برای احراز هویت در دایرکتوری استفاده می‌شود\&. این گزینه می‌تواند شامل پرینسیپال کامل (برای مثال host/myhost@EXAMPLE\&.COM) یا فقط نام پرینسیپال (برای مثال host/myhost) باشد\&. به‌طور پیش‌فرض، مقدار تنظیم نشده است و از پرینسیپال‌های زیر استفاده می‌شود:
.sp
.if n \{\
.RS 4
.\}
.nf
hostname@REALM
netbiosname$@REALM
host/hostname@REALM
*$@REALM
host/*@REALM
netbiosname$@*
host/*
                            
.fi
.if n \{\
.RE
.\}
.sp
اگر هیچ‌کدام از آن‌ها یافت نشد، اولین پرینسیپال در keytab برگردانده می‌شود\&.
.sp
پیش‌فرض: host/hostname@REALM
.RE
.PP
ldap_sasl_realm (string)
.RS 4
حوزه (realm) در SASL را برای استفاده مشخص می‌کند\&. در صورت عدم تعیین، این گزینه به طور پیش‌فرض روی مقدار krb5_realm تنظیم می‌شود\&. اگر ldap_sasl_authid شامل realm نیز باشد، این گزینه نادیده گرفته می‌شود\&.
.sp
پیش‌فرض: مقدار krb5_realm\&.
.RE
.PP
ldap_sasl_canonicalize (boolean)
.RS 4
اگر روی true تنظیم شود، کتابخانه LDAP برای متعارف‌سازی (canonicalize) نام میزبان در طول اتصال (bind) به SASL یک جستجوی معکوس انجام می‌دهد\&.
.sp
پیش‌فرض: false;
.RE
.PP
ldap_krb5_keytab (string)
.RS 4
فایل keytab مورد استفاده هنگام استفاده از SASL/GSSAPI/GSS\-SPNEGO را مشخص می‌کند\&.
.sp
این گزینه می‌تواند به ازای هر زیردامنه نیز تنظیم شود یا از طریق
\fIsubdomain_inherit\fR
به ارث برسد\&.
.sp
پیش‌فرض: فایل keytab سیستم، معمولاً
/etc/krb5\&.keytab
.RE
.PP
ldap_krb5_init_creds (boolean)
.RS 4
مشخص می‌کند که id_provider باید اطلاعات کاربری Kerberos (TGT) را مقداردهی اولیه کند\&. این اقدام تنها زمانی انجام می‌شود که SASL استفاده شود و مکانیسم انتخاب‌شده GSSAPI یا GSS\-SPNEGO باشد\&.
.sp
پیش‌فرض: true
.RE
.PP
ldap_krb5_ticket_lifetime (integer)
.RS 4
طول عمر TGT را به ثانیه در صورت استفاده از GSSAPI یا GSS\-SPNEGO مشخص می‌کند\&.
.sp
این گزینه می‌تواند به ازای هر زیردامنه نیز تنظیم شود یا از طریق
\fIsubdomain_inherit\fR
به ارث برسد\&.
.sp
پیش‌فرض: 86400 (24 ساعت)
.RE
.PP
krb5_server, krb5_backup_server (string)
.RS 4
فهرست جداشده با کاما از آدرس‌های IP یا نام‌های میزبان سرورهای Kerberos را مشخص می‌کند که SSSD باید به ترتیب اولویت به آن‌ها متصل شود\&. برای اطلاعات بیشتر درباره جایگزینی هنگام خرابی و افزونگی سرور، بخش
\(lqFAILOVER\(rq
را ببینید\&. یک شماره پورت اختیاری (که پیش از آن دونقطه می‌آید) می‌تواند به آدرس‌ها یا نام‌های میزبان افزوده شود\&. اگر خالی باشد، شناسایی سرویس فعال است \- برای اطلاعات بیشتر، به بخش
\(lqSERVICE DISCOVERY\(rq
مراجعه کنید\&.
.sp
هنگام استفاده از شناسایی سرویس برای سرورهای KDC یا kpasswd، ابتدا SSSD ورودی‌های DNS را جستجو می‌کند که _udp را به عنوان پروتکل مشخص کرده‌اند و اگر موردی پیدا نشد به _tcp برمی‌گردد\&.
.sp
این گزینه در نسخه‌های پیشین SSSD با نام
\(lqkrb5_kdcip\(rq
نامیده می‌شد\&. در حالی که نام قدیمی در حال حاضر شناسایی می‌شود، به کاربران توصیه می‌شود که فایل‌های پیکربندی خود را به استفاده از
\(lqkrb5_server\(rq
به‌جای آن مهاجرت دهند\&.
.RE
.PP
krb5_realm (string)
.RS 4
حوزه (REALM) کربروس (برای احراز هویت SASL/GSSAPI/GSS\-SPNEGO) را مشخص می‌کند\&.
.RE
.sp
پیش‌فرض: پیش‌فرض‌های سیستم، ببینید
/etc/krb5\&.conf
.RE
.PP
krb5_canonicalize (boolean)
.RS 4
مشخص می‌کند که آیا principal میزبان هنگام اتصال به سرور LDAP باید استانداردسازی (canonicalize) شود یا خیر\&. این ویژگی با MIT Kerberos >= 1\&.7 در دسترس است\&.
.sp
پیش‌فرض: false
.RE
.PP
krb5_use_kdcinfo (boolean)
.RS 4
مشخص می‌کند که آیا SSSD باید به کتابخانه‌های Kerberos دستور دهد از چه realm و کدام KDCهایی استفاده کنند یا خیر\&. این گزینه به‌طور پیش‌فرض فعال است؛ در صورت غیرفعال کردن آن، باید کتابخانه Kerberos را با استفاده از فایل پیکربندی
\fBkrb5.conf\fR(5)
پیکربندی کنید\&.
.sp
برای اطلاعات بیشتر در مورد پلاگین ردیاب (locator plugin)، صفحه راهنمای
\fBsssd_krb5_locator_plugin\fR(8)
را ببینید\&.
.sp
پیش‌فرض: true
.RE
.PP
ldap_pwd_policy (string)
.RS 4
سیاست ارزیابی انقضای گذرواژه در سمت کلاینت را انتخاب می‌کند\&. مقادیر زیر مجاز هستند:
.sp
\fInone\fR
\- بدون ارزیابی در سمت کلاینت\&. این گزینه نمی‌تواند سیاست‌های گذرواژه سمت سرور را غیرفعال کند\&.
.sp
\fIshadow\fR
\- استفاده از مشخصه‌های به سبک
\fBshadow\fR(5)
برای ارزیابی این‌که آیا گذرواژه منقضی شده است یا خیر\&. لطفاً گزینه «ldap_chpass_update_last_change» را نیز ببینید\&.
.sp
\fImit_kerberos\fR
\- استفاده از مشخصه‌های مورد استفاده توسط MIT Kerberos برای تعیین اینکه آیا گذرواژه منقضی شده است یا خیر\&. هنگام تغییر گذرواژه از chpass_provider=krb5 برای به‌روزرسانی این مشخصه‌ها استفاده کنید\&.
.sp
پیش‌فرض: none
.sp
\fIنکته\fR: اگر یک سیاست گذرواژه در سمت سرور پیکربندی شده باشد، همواره بر سیاست تنظیم‌شده با این گزینه اولویت دارد\&.
.RE
.PP
ldap_referrals (boolean)
.RS 4
مشخص می‌کند که آیا دنبال کردن خودکار ارجاعات (referral chasing) باید فعال باشد یا خیر\&.
.sp
لطفاً توجه داشته باشید که sssd تنها زمانی از دنبال کردن ارجاعات پشتیبانی می‌کند که با OpenLDAP نگارش 2\&.4\&.13 یا بالاتر کامپایل شده باشد\&.
.sp
دنبال کردن ارجاعات ممکن است در محیط‌هایی که به‌شدت از آن‌ها استفاده می‌کنند موجب افت کارایی شود؛ یک نمونه قابل توجه Microsoft Active Directory است\&. اگر ساختار شما واقعاً نیازی به استفاده از ارجاعات ندارد، تنظیم این گزینه روی false ممکن است بهبود چشمگیری در کارایی ایجاد کند\&. بنابراین در صورتی که ارائه‌دهنده LDAP در SSSD به همراه Microsoft Active Directory به عنوان بک‌اند استفاده می‌شود، تنظیم این گزینه روی false توصیه می‌شود\&. حتی اگر SSSD قادر باشد ارجاع را به یک AD DC دیگر دنبال کند، هیچ داده اضافی در دسترس نخواهد بود\&.
.sp
پیش‌فرض: true
.RE
.PP
ldap_dns_service_name (string)
.RS 4
نام سرویس مورد استفاده در هنگام فعال بودن شناسایی سرویس را مشخص می‌کند\&.
.sp
پیش‌فرض: ldap
.RE
.PP
ldap_chpass_dns_service_name (string)
.RS 4
نام سرویسی را مشخص می‌کند که در زمان فعال بودن شناسایی سرویس، برای یافتن سرور LDAP مجاز به تغییر گذرواژه به کار می‌رود\&.
.sp
پیش‌فرض: تنظیم‌نشده، یعنی شناسایی سرویس غیرفعال است
.RE
.PP
ldap_chpass_update_last_change (bool)
.RS 4
مشخص می‌کند که آیا مشخصه ldap_user_shadow_last_change پس از عملیات تغییر گذرواژه با تعداد روزهای سپری‌شده از مبدأ تاریخ (Epoch) به‌روزرسانی شود یا خیر\&.
.sp
در صورت استفاده از «ldap_pwd_policy = shadow» توصیه می‌شود این گزینه به‌صراحت تنظیم شود تا SSSD بداند که آیا سرور LDAP مشخصه shadowLastChange را پس از تغییر گذرواژه به‌طور خودکار به‌روزرسانی می‌کند یا SSSD باید آن را به‌روزرسانی کند\&.
.sp
پیش‌فرض: False
.RE
.PP
ldap_access_filter (string)
.RS 4
در صورت استفاده از access_provider = ldap و ldap_access_order = filter (پیش‌فرض)، این گزینه اجباری است\&. این گزینه معیار فیلتر جستجوی LDAP را مشخص می‌کند که برای اعطای دسترسی به کاربر روی این میزبان باید برقرار باشد\&. اگر access_provider = ldap و ldap_access_order = filter باشد و این گزینه تنظیم نشده باشد، منجر به رد دسترسی همه کاربران خواهد شد\&. برای تغییر این رفتار پیش‌فرض از access_provider = permit استفاده کنید\&. لطفاً توجه داشته باشید که این فیلتر فقط روی مدخل کاربر LDAP اعمال می‌شود و بنابراین فیلتر کردن بر اساس گروه‌های تو در تو ممکن است کار نکند (برای نمونه مشخصه memberOf در مدخل‌های AD فقط به والد‌های مستقیم اشاره دارد)\&. اگر فیلتر کردن بر اساس گروه‌های تو در تو مورد نیاز است، لطفاً به
\fBsssd-simple\fR(5)
مراجعه کنید\&.
.sp
مثال:
.sp
.if n \{\
.RS 4
.\}
.nf
access_provider = ldap
ldap_access_filter = (employeeType=admin)
                        
.fi
.if n \{\
.RE
.\}
.sp
این مثال بدین معناست که دسترسی به این میزبان به کاربرانی محدود می‌شود که مشخصه employeeType آن‌ها روی "admin" تنظیم شده باشد\&.
.sp
کش آفلاین برای این ویژگی محدود به این است که آیا در آخرین ورود برخط (online) کاربر مجوز دسترسی اعطا شده است یا خیر\&. اگر در آخرین ورود به آن‌ها دسترسی داده شده باشد، در حالت آفلاین نیز همچنان دسترسی خواهند داشت و برعکس\&.
.sp
پیش‌فرض: خالی
.RE
.PP
ldap_account_expire_policy (string)
.RS 4
با این گزینه می‌توان ارزیابی مشخصه‌های کنترل دسترسی در سمت کلاینت را فعال کرد\&.
.sp
لطفاً توجه داشته باشید که همواره توصیه می‌شود از کنترل دسترسی سمت سرور استفاده شود؛ یعنی سرور LDAP باید درخواست bind را حتی در صورت درست بودن گذرواژه، با یک کد خطای مناسب رد کند\&.
.sp
مقادیر زیر مجاز هستند:
.sp
\fIshadow\fR: استفاده از مقدار ldap_user_shadow_expire برای تعیین منقضی شدن حساب\&.
.sp
\fIad\fR: استفاده از مقدار فیلد ۳۲ بیتی ldap_user_ad_user_account_control و اجازه دسترسی در صورتی که بیت دوم تنظیم نشده باشد\&. اگر مشخصه وجود نداشته باشد، دسترسی اعطا می‌شود\&. زمان انقضای حساب نیز بررسی می‌شود\&.
.sp
\fIrhds\fR،
\fIipa\fR،
\fI389ds\fR: استفاده از مقدار ldap_ns_account_lock برای بررسی مجاز بودن یا نبودن دسترسی\&.
.sp
\fInds\fR: مقادیر ldap_user_nds_login_allowed_time_map، ldap_user_nds_login_disabled و ldap_user_nds_login_expiration_time برای بررسی مجاز بودن دسترسی استفاده می‌شوند\&. اگر هر دو مشخصه موجود نباشند، دسترسی اعطا می‌شود\&.
.sp
لطفاً توجه داشته باشید که گزینه پیکربندی ldap_access_order
\fIباید\fR
شامل
\(lqexpire\(rq
باشد تا گزینه ldap_account_expire_policy کار کند\&.
.sp
پیش‌فرض: خالی
.RE
.PP
ldap_access_order (string)
.RS 4
فهرستی جدا شده با کاما از گزینه‌های کنترل دسترسی\&. مقادیر مجاز عبارتند از:
.sp
\fIfilter\fR: استفاده از ldap_access_filter
.sp
\fIlockout\fR: استفاده از قفل حساب کاربری\&. در صورت تنظیم، این گزینه در صورتی که مشخصه ldap با نام \*(AqpwdAccountLockedTime\*(Aq موجود بوده و مقدار \*(Aq000001010000Z\*(Aq داشته باشد، دسترسی را رد می‌کند\&. لطفاً گزینه ldap_pwdlockout_dn را ببینید\&. لطفاً توجه داشته باشید که برای کارکرد این ویژگی باید \*(Aqaccess_provider = ldap\*(Aq تنظیم شده باشد\&.
.sp
\fI لطفاً توجه داشته باشید که این گزینه با گزینه \fR\fI\(lqppolicy\(rq\fR\fI جایگزین شده است و ممکن است در انتشار آتی حذف شود\&. \fR
.sp
\fIppolicy\fR: استفاده از قفل حساب کاربری\&. در صورت تنظیم، این گزینه در صورتی که مشخصه ldap با نام \*(AqpwdAccountLockedTime\*(Aq موجود باشد و دارای مقدار \*(Aq000001010000Z\*(Aq باشد یا هر زمانی در گذشته را نشان دهد، دسترسی را رد می‌کند\&. مقدار مشخصه \*(AqpwdAccountLockedTime\*(Aq باید با \*(AqZ\*(Aq پایان یابد که نشان‌دهنده منطقه زمانی UTC است\&. سایر مناطق زمانی در حال حاضر پشتیبانی نمی‌شوند و هنگام تلاش کاربران برای ورود به سیستم منجر به "access\-denied" خواهند شد\&. لطفاً گزینه ldap_pwdlockout_dn را ببینید\&. لطفاً توجه داشته باشید که برای کارکرد این ویژگی باید \*(Aqaccess_provider = ldap\*(Aq تنظیم شده باشد\&.
.sp
\fIexpire\fR: استفاده از ldap_account_expire_policy
.sp
\fIpwd_expire_policy_reject, pwd_expire_policy_warn, pwd_expire_policy_renew: \fR
این گزینه‌ها زمانی مفید هستند که کاربران تمایل داشته باشند از در شرف انقضا بودن گذرواژه مطلع شوند و احراز هویت بر اساس روشی غیر از گذرواژه انجام شود \- برای نمونه کلیدهای SSH\&.
.sp
تفاوت بین این گزینه‌ها در اقدامی است که در صورت انقضای گذرواژه کاربر انجام می‌شود:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
pwd_expire_policy_reject \- ورود کاربر به سیستم رد می‌شود،
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
pwd_expire_policy_warn \- کاربر همچنان قادر به ورود به سیستم است،
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
pwd_expire_policy_renew \- بلافاصله از کاربر خواسته می‌شود گذرواژه خود را تغییر دهد\&.
.RE
.sp
لطفاً توجه داشته باشید که برای کارکرد این ویژگی باید \*(Aqaccess_provider = ldap\*(Aq تنظیم شده باشد\&. همچنین \*(Aqldap_pwd_policy\*(Aq باید روی shadow یا mit_kerberos تنظیم شده باشد؛ این گزینه‌ها با سیاست‌های گذرواژه سمت سرور کار نمی‌کنند\&.
.sp
\fIauthorized_service\fR: استفاده از مشخصه authorizedService برای تعیین دسترسی
.sp
\fIhost\fR: استفاده از مشخصه host برای تعیین دسترسی
.sp
\fIrhost\fR: استفاده از مشخصه rhost برای تعیین امکان دسترسی میزبان راه دور
.sp
لطفاً توجه داشته باشید، فیلد rhost در pam توسط برنامه تنظیم می‌شود؛ بهتر است قبل از فعال کردن این گزینه کنترل دسترسی، بررسی کنید که برنامه چه مقداری به pam ارسال می‌کند
.sp
پیش‌فرض: filter
.sp
لطفاً توجه داشته باشید استفاده بیش از یک بار از یک مقدار، خطای پیکربندی محسوب می‌شود\&.
.RE
.PP
ldap_pwdlockout_dn (string)
.RS 4
این گزینه DN مدخل سیاست گذرواژه در سرور LDAP را مشخص می‌کند\&. لطفاً توجه داشته باشید که در صورت فعال بودن بررسی قفل حساب، نبود این گزینه در sssd\&.conf منجر به رد دسترسی خواهد شد زیرا مشخصه‌های ppolicy در سرور LDAP نمی‌توانند به‌درستی بررسی شوند\&.
.sp
مثال: cn=ppolicy,ou=policies,dc=example,dc=com
.sp
پیش‌فرض: cn=ppolicy,ou=policies,$ldap_search_base
.RE
.PP
ldap_deref (string)
.RS 4
نحوه ارجاع‌زدایی نام‌های مستعار (alias dereferencing) را هنگام انجام جستجو مشخص می‌کند\&. گزینه‌های زیر مجاز هستند:
.sp
\fInever\fR: نام‌های مستعار هرگز ارجاع‌زدایی نمی‌شوند\&.
.sp
\fIsearching\fR: نام‌های مستعار در زیرمجموعه‌های شیء پایه ارجاع‌زدایی می‌شوند، اما در تعیین مکان شیء پایه جستجو ارجاع‌زدایی نمی‌شوند\&.
.sp
\fIfinding\fR: نام‌های مستعار فقط هنگام تعیین مکان شیء پایه جستجو ارجاع‌زدایی می‌شوند\&.
.sp
\fIalways\fR: نام‌های مستعار هم در جستجو و هم در مکان‌یابی شیء پایه جستجو ارجاع‌زدایی می‌شوند\&.
.sp
پیش‌فرض: خالی (توسط کتابخانه‌های کلاینت LDAP به عنوان
\fInever\fR
در نظر گرفته می‌شود)
.RE
.PP
ldap_rfc2307_fallback_to_local_users (boolean)
.RS 4
امکان حفظ کاربران محلی به عنوان اعضای یک گروه LDAP را برای سرورهایی که از طرحواره RFC2307 استفاده می‌کنند، فراهم می‌سازد\&.
.sp
در برخی محیط‌ها که از طرحواره RFC2307 استفاده می‌شود، کاربران محلی با اضافه کردن نام‌هایشان به مشخصه memberUid به عضویت گروه‌های LDAP درمی‌آیند\&. با این کار یکپارچگی درونی دامنه به خطر می‌افتد، بنابراین SSSD معمولاً به محض اینکه nsswitch تلاش کند اطلاعات مربوط به کاربر را از طریق فراخوانی‌های getpw*() یا initgroups() واکشی کند، کاربران «ناپدیدشده» را از عضویت‌های گروه ذخیره‌شده در کش حذف می‌کند\&.
.sp
این گزینه به بررسی این که آیا به کاربران محلی ارجاع داده شده است یا خیر بازگشت می‌کند و آن‌ها را در کش نگه می‌دارد تا فراخوانی‌های بعدی initgroups() کاربران محلی را با گروه‌های LDAP اضافی تکمیل کنند\&.
.sp
پیش‌فرض: false
.RE
.PP
wildcard_limit (integer)
.RS 4
حد بالایی را برای تعداد مدخل‌هایی که در طول جستجوی نویسه عام (wildcard lookup) دریافت می‌شوند مشخص می‌کند\&.
.sp
در حال حاضر، تنها پاسخ‌دهنده InfoPipe از جستجوهای نویسه عام پشتیبانی می‌کند\&.
.sp
پیش‌فرض: 1000 (اغلب به اندازه یک صفحه)
.RE
.PP
ldap_library_debug_level (integer)
.RS 4
اشکال‌زدایی libldap را با سطح داده‌شده فعال می‌کند\&. پیام‌های اشکال‌زدایی libldap مستقل از debug_level عمومی نوشته خواهند شد\&.
.sp
‏OpenLDAP از یک بیت‌مپ برای فعال‌سازی اشکال‌زدایی مؤلفه‌های خاص استفاده می‌کند؛ مقدار \-1 خروجی کامل اشکال‌زدایی را فعال می‌کند\&.
.sp
پیش‌فرض: 0 (اشکال‌زدایی libldap غیرفعال است)
.RE
.PP
ldap_use_ppolicy (boolean)
.RS 4
درخواست و اتکا به کنترل‌های سیاست گذرواژه سمت سرور را فعال می‌کند\&. غیرفعال کردن این گزینه امکان تعامل با سرویس‌هایی را فراهم می‌سازد که پسوند نامعتبر ppolicy را ارسال می‌کنند\&.
.sp
پیش‌فرض: true
.RE
.PP
ldap_ppolicy_pwd_change_threshold (integer)
.RS 4
هنگامی که کنترل‌های سیاست گذرواژه سمت سرور فعال باشند و تعداد ورودهای ارفاقی (grace logins) باقی‌مانده که پس از احراز هویت توسط سرور برگردانده می‌شوند به آستانه برسد یا کمتر از آن شود، تغییر گذرواژه را اجباری می‌کند\&. توجه داشته باشید که حداقل مقدار مفید ۲ است، زیرا تغییر گذرواژه ۲ ورود ارفاقی دیگر را مصرف می‌کند: یکی برای بررسی گذرواژه فعلی و دومی برای انجام تغییر گذرواژه\&.
.sp
پیش‌فرض: 0
.RE
.SH "گزینه‌های SUDO (SUDO OPTIONS)"
.PP
دستورالعمل‌های تفصیلی برای پیکربندی sudo_provider در صفحه راهنمای
\fBsssd-sudo\fR(5)\&
آمده است.
.PP
.PP
ldap_sudo_full_refresh_interval (integer)
.RS 4
مدت زمانی به ثانیه که SSSD پیش از اجرای یک نوسازی کامل قواعد sudo (که تمام قواعد ذخیره‌شده روی سرور را دریافت می‌کند) منتظر می‌ماند\&.
.sp
مقدار باید بزرگ‌تر از
\fIldap_sudo_smart_refresh_interval \fR
باشد\&.
.sp
می‌توانید با تنظیم این گزینه روی 0، نوسازی کامل را غیرفعال کنید\&. با این حال، باید حداقل یکی از نوسازی‌های هوشمند یا کامل فعال باشد\&.
.sp
پیش‌فرض: 21600 (۶ ساعت)
.RE
.PP
ldap_sudo_smart_refresh_interval (integer)
.RS 4
مدت زمانی به ثانیه که SSSD باید پیش از اجرای یک نوسازی هوشمند قواعد sudo (که تمام قواعد دارای USN بالاتر از بیشترین مقدار USN سرور که در حال حاضر توسط SSSD شناخته شده است را دریافت می‌کند) منتظر بماند\&.
.sp
اگر مشخصه‌های USN توسط سرور پشتیبانی نشوند، مشخصه modifyTimestamp به جای آن استفاده می‌شود\&.
.sp
\fIنکته:\fR
بیشترین مقدار USN را می‌توان از طریق سه وظیفه به‌روزرسانی کرد: ۱) با نوسازی کامل و هوشمند sudo (در صورت یافتن قواعد به‌روزرسانی‌شده)، ۲) با شمارش کاربران و گروه‌ها (در صورت فعال بودن و یافتن کاربران یا گروه‌های به‌روزرسانی‌شده) و ۳) با اتصال مجدد به سرور (به‌طور پیش‌فرض هر ۱۵ دقیقه،
\fIldap_connection_expire_timeout\fR
را ببینید)\&.
.sp
می‌توانید با تنظیم این گزینه روی 0، نوسازی هوشمند را غیرفعال کنید\&. با این حال، باید حداقل یکی از نوسازی‌های هوشمند یا کامل فعال باشد\&.
.sp
پیش‌فرض: 900 (۱۵ دقیقه)
.RE
.PP
ldap_sudo_random_offset (integer)
.RS 4
انحراف تصادفی بین 0 و مقدار پیکربندی‌شده که هر بار با زمان‌بندی وظیفه دوره‌ای، به دوره‌های نوسازی هوشمند و کامل اضافه می‌شود\&. این مقدار به ثانیه است\&.
.sp
توجه داشته باشید که این انحراف تصادفی در اولین شروع SSSD نیز اعمال می‌شود که نخستین نوسازی قواعد sudo را به تاخیر می‌اندازد\&. این کار مدت زمانی را که قواعد sudo برای استفاده در دسترس نیستند طولانی‌تر می‌کند\&.
.sp
می‌توانید با تنظیم مقدار روی 0 این انحراف را غیرفعال کنید\&.
.sp
پیش‌فرض: 0 (غیرفعال)
.RE
.PP
ldap_sudo_use_host_filter (boolean)
.RS 4
اگر true باشد، SSSD تنها قواعدی را دریافت می‌کند که برای این ماشین قابل اعمال هستند (با استفاده از نشانی‌های میزبان/شبکه IPv4 یا IPv6 و نام‌های میزبان)\&.
.sp
پیش‌فرض: true
.RE
.PP
ldap_sudo_hostnames (string)
.RS 4
فهرستی جداشده با فاصله از نام‌های میزبان یا نام‌های دامنه کاملاً مشخص (FQDN) که باید برای فیلتر کردن قواعد استفاده شوند\&.
.sp
اگر این گزینه خالی باشد، SSSD تلاش می‌کند نام میزبان و نام دامنه کاملاً مشخص را به‌طور خودکار شناسایی کند\&.
.sp
اگر
\fIldap_sudo_use_host_filter\fR
برابر
\fIfalse\fR
باشد، این گزینه هیچ تاثیری ندارد\&.
.sp
پیش‌فرض: مشخص نشده است
.RE
.PP
ldap_sudo_ip (string)
.RS 4
فهرستی جداشده با فاصله از نشانی‌های میزبان/شبکه IPv4 یا IPv6 که باید برای فیلتر کردن قواعد استفاده شوند\&.
.sp
اگر این گزینه خالی باشد، SSSD تلاش می‌کند نشانی‌ها را به‌طور خودکار شناسایی کند\&.
.sp
اگر
\fIldap_sudo_use_host_filter\fR
برابر
\fIfalse\fR
باشد، این گزینه هیچ تاثیری ندارد\&.
.sp
پیش‌فرض: مشخص نشده است
.RE
.PP
ldap_sudo_include_netgroups (boolean)
.RS 4
اگر true باشد، SSSD هر قاعده‌ای را که شامل یک netgroup در مشخصه sudoHost باشد دریافت می‌کند\&.
.sp
اگر
\fIldap_sudo_use_host_filter\fR
برابر
\fIfalse\fR
باشد، این گزینه هیچ تاثیری ندارد\&.
.sp
پیش‌فرض: true
.RE
.PP
ldap_sudo_include_regexp (boolean)
.RS 4
اگر true باشد، SSSD هر قاعده‌ای را که شامل یک نویسه عام (wildcard) در مشخصه sudoHost باشد دریافت می‌کند\&.
.sp
اگر
\fIldap_sudo_use_host_filter\fR
برابر
\fIfalse\fR
باشد، این گزینه هیچ تاثیری ندارد\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBنکته\fR
.ps -1
.br
استفاده از نویسه عام (wildcard) عملیاتی است که ارزیابی آن در سمت سرور LDAP بسیار پرهزینه است!
.sp .5v
.RE
پیش‌فرض: false
.RE
.PP
این صفحه راهنما تنها نگاشت نام مشخصه‌ها را شرح می‌دهد\&. برای توضیح تفصیلی معناشناسی مشخصه‌های مربوط به sudo، به
\fBsudoers.ldap\fR(5)
مراجعه کنید\&.
.SH "گزینه‌های AUTOFS (AUTOFS OPTIONS)"
.PP
برخی از مقادیر پیش‌فرض برای پارامترهای زیر وابسته به شِمای LDAP هستند\&.
.PP
.PP
ldap_autofs_map_master_name (string)
.RS 4
نام نقشه اصلی automount در LDAP\&.
.sp
پیش‌فرض: auto\&.master
.RE
.PP
ldap_autofs_map_object_class (string)
.RS 4
کلاس شیء یک مدخل نقشه automount در LDAP\&.
.sp
پیش‌فرض: nisMap (rfc2307, autofs_provider=ad)، در غیر این صورت automountMap
.RE
.PP
ldap_autofs_map_name (string)
.RS 4
نام یک مدخل نقشه automount در LDAP\&.
.sp
پیش‌فرض: nisMapName (rfc2307, autofs_provider=ad)، در غیر این صورت automountMapName
.RE
.PP
ldap_autofs_entry_object_class (string)
.RS 4
کلاس شیء یک مدخل automount در LDAP\&. این مدخل معمولاً متناظر با یک نقطه اتصال (mount point) است\&.
.sp
پیش‌فرض: nisObject (rfc2307, autofs_provider=ad)، در غیر این صورت automount
.RE
.PP
ldap_autofs_entry_key (string)
.RS 4
کلید یک مدخل automount در LDAP\&. این مدخل معمولاً متناظر با یک نقطه اتصال است\&.
.sp
پیش‌فرض: cn (rfc2307, autofs_provider=ad)، در غیر این صورت automountKey
.RE
.PP
ldap_autofs_entry_value (string)
.RS 4
مقدار یک مدخل automount در LDAP\&. این مدخل معمولاً متناظر با یک نقطه اتصال است\&.
.sp
پیش‌فرض: nisMapEntry (rfc2307, autofs_provider=ad)، در غیر این صورت automountInformation
.RE
.PP
لطفاً توجه داشته باشید که automounter نقشه اصلی را فقط هنگام راه‌اندازی می‌خواند، بنابراین اگر هرگونه تغییر مرتبط با autofs در sssd\&.conf ایجاد شود، معمولاً لازم است پس از راه‌اندازی مجدد SSSD، دیمن automounter را نیز مجدداً راه‌اندازی کنید\&.
.SH "گزینه‌های پیشرفته (ADVANCED OPTIONS)"
.PP
این گزینه‌ها توسط دامنه‌های LDAP پشتیبانی می‌شوند، اما باید با احتیاط استفاده شوند\&. لطفاً تنها در صورتی آن‌ها را در پیکربندی خود بگنجانید که از عملکرد آن‌ها اطمینان کامل دارید\&.
.PP
ldap_netgroup_search_base (string)
.RS 4
یک DN پایه، دامنه جستجو (scope) و فیلتر LDAP اختیاری برای محدود کردن جستجوهای LDAP برای این نوع مشخصه\&.
.sp
قالب نحو:
.sp
.if n \{\
.RS 4
.\}
.nf
search_base[?scope?[filter][?search_base?scope?[filter]]*]
.fi
.if n \{\
.RE
.\}
.sp
دامنه می‌تواند یکی از موارد \(lqbase\(rq، \(lqonelevel\(rq یا \(lqsubtree\(rq باشد\&. دامنه همان‌طور که در بخش 4\&.5\&.1\&.2 از http://tools\&.ietf\&.org/html/rfc4511 مشخص شده عمل می‌کند\&.
.sp
فیلتر باید یک فیلتر جستجوی معتبر LDAP طبق مشخصات http://www\&.ietf\&.org/rfc/rfc2254\&.txt باشد\&.
.sp
برای نمونه‌هایی از این نحو، لطفاً به بخش مثال‌های
\(lqldap_search_base\(rq
مراجعه کنید\&.
.sp
پیش‌فرض: مقدار
\fIldap_search_base\fR
.sp
لطفاً توجه داشته باشید که تعیین دامنه یا فیلتر برای جستجوها در یک سرور Active Directory که ممکن است نتایج زیادی به همراه داشته باشد و قابلیت Range Retrieval را در پاسخ فعال کند، پشتیبانی نمی‌شود\&.
.RE
.PP
ldap_user_search_base (string)
.RS 4
یک DN پایه، دامنه جستجو (scope) و فیلتر LDAP اختیاری برای محدود کردن جستجوهای LDAP برای این نوع مشخصه\&.
.sp
قالب نحو:
.sp
.if n \{\
.RS 4
.\}
.nf
search_base[?scope?[filter][?search_base?scope?[filter]]*]
.fi
.if n \{\
.RE
.\}
.sp
دامنه می‌تواند یکی از موارد \(lqbase\(rq، \(lqonelevel\(rq یا \(lqsubtree\(rq باشد\&. دامنه همان‌طور که در بخش 4\&.5\&.1\&.2 از http://tools\&.ietf\&.org/html/rfc4511 مشخص شده عمل می‌کند\&.
.sp
فیلتر باید یک فیلتر جستجوی معتبر LDAP طبق مشخصات http://www\&.ietf\&.org/rfc/rfc2254\&.txt باشد\&.
.sp
برای نمونه‌هایی از این نحو، لطفاً به بخش مثال‌های
\(lqldap_search_base\(rq
مراجعه کنید\&.
.sp
پیش‌فرض: مقدار
\fIldap_search_base\fR
.sp
لطفاً توجه داشته باشید که تعیین دامنه یا فیلتر برای جستجوها در یک سرور Active Directory که ممکن است نتایج زیادی به همراه داشته باشد و قابلیت Range Retrieval را در پاسخ فعال کند، پشتیبانی نمی‌شود\&.
.RE
.PP
ldap_group_search_base (string)
.RS 4
یک DN پایه، دامنه جستجو (scope) و فیلتر LDAP اختیاری برای محدود کردن جستجوهای LDAP برای این نوع مشخصه\&.
.sp
قالب نحو:
.sp
.if n \{\
.RS 4
.\}
.nf
search_base[?scope?[filter][?search_base?scope?[filter]]*]
.fi
.if n \{\
.RE
.\}
.sp
دامنه می‌تواند یکی از موارد \(lqbase\(rq، \(lqonelevel\(rq یا \(lqsubtree\(rq باشد\&. دامنه همان‌طور که در بخش 4\&.5\&.1\&.2 از http://tools\&.ietf\&.org/html/rfc4511 مشخص شده عمل می‌کند\&.
.sp
فیلتر باید یک فیلتر جستجوی معتبر LDAP طبق مشخصات http://www\&.ietf\&.org/rfc/rfc2254\&.txt باشد\&.
.sp
برای نمونه‌هایی از این نحو، لطفاً به بخش مثال‌های
\(lqldap_search_base\(rq
مراجعه کنید\&.
.sp
پیش‌فرض: مقدار
\fIldap_search_base\fR
.sp
لطفاً توجه داشته باشید که تعیین دامنه یا فیلتر برای جستجوها در یک سرور Active Directory که ممکن است نتایج زیادی به همراه داشته باشد و قابلیت Range Retrieval را در پاسخ فعال کند، پشتیبانی نمی‌شود\&.
.RE
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBنکته\fR
.ps -1
.br
.PP
اگر گزینه
\(lqldap_use_tokengroups\(rq
فعال باشد، جستجوها در Active Directory محدود نخواهند شد و همه عضویت‌های گروه، حتی بدون نگاشت GID بازگردانده می‌شوند\&. توصیه می‌شود در صورتی که نام گروه‌ها به درستی نمایش داده نمی‌شوند، این قابلیت را غیرفعال کنید\&.
.sp .5v
.RE
.PP
ldap_sudo_search_base (string)
.RS 4
یک DN پایه، دامنه جستجو (scope) و فیلتر LDAP اختیاری برای محدود کردن جستجوهای LDAP برای این نوع مشخصه\&.
.sp
قالب نحو:
.sp
.if n \{\
.RS 4
.\}
.nf
search_base[?scope?[filter][?search_base?scope?[filter]]*]
.fi
.if n \{\
.RE
.\}
.sp
دامنه می‌تواند یکی از موارد \(lqbase\(rq، \(lqonelevel\(rq یا \(lqsubtree\(rq باشد\&. دامنه همان‌طور که در بخش 4\&.5\&.1\&.2 از http://tools\&.ietf\&.org/html/rfc4511 مشخص شده عمل می‌کند\&.
.sp
فیلتر باید یک فیلتر جستجوی معتبر LDAP طبق مشخصات http://www\&.ietf\&.org/rfc/rfc2254\&.txt باشد\&.
.sp
برای نمونه‌هایی از این نحو، لطفاً به بخش مثال‌های
\(lqldap_search_base\(rq
مراجعه کنید\&.
.sp
پیش‌فرض: مقدار
\fIldap_search_base\fR
.sp
لطفاً توجه داشته باشید که تعیین دامنه یا فیلتر برای جستجوها در یک سرور Active Directory که ممکن است نتایج زیادی به همراه داشته باشد و قابلیت Range Retrieval را در پاسخ فعال کند، پشتیبانی نمی‌شود\&.
.RE
.PP
ldap_autofs_search_base (string)
.RS 4
یک DN پایه، دامنه جستجو (scope) و فیلتر LDAP اختیاری برای محدود کردن جستجوهای LDAP برای این نوع مشخصه\&.
.sp
قالب نحو:
.sp
.if n \{\
.RS 4
.\}
.nf
search_base[?scope?[filter][?search_base?scope?[filter]]*]
.fi
.if n \{\
.RE
.\}
.sp
دامنه می‌تواند یکی از موارد \(lqbase\(rq، \(lqonelevel\(rq یا \(lqsubtree\(rq باشد\&. دامنه همان‌طور که در بخش 4\&.5\&.1\&.2 از http://tools\&.ietf\&.org/html/rfc4511 مشخص شده عمل می‌کند\&.
.sp
فیلتر باید یک فیلتر جستجوی معتبر LDAP طبق مشخصات http://www\&.ietf\&.org/rfc/rfc2254\&.txt باشد\&.
.sp
برای نمونه‌هایی از این نحو، لطفاً به بخش مثال‌های
\(lqldap_search_base\(rq
مراجعه کنید\&.
.sp
پیش‌فرض: مقدار
\fIldap_search_base\fR
.sp
لطفاً توجه داشته باشید که تعیین دامنه یا فیلتر برای جستجوها در یک سرور Active Directory که ممکن است نتایج زیادی به همراه داشته باشد و قابلیت Range Retrieval را در پاسخ فعال کند، پشتیبانی نمی‌شود\&.
.RE
.SH "جایگزینی هنگام خرابی (FAILOVER)"
.PP
قابلیت جایگزینی هنگام خرابی به بک‌اندها اجازه می‌دهد تا در صورت خرابی سرور فعلی، به‌طور خودکار به سرور دیگری سوییچ کنند\&.
.SS "سینتکس جایگزینی هنگام خرابی"
.PP
فهرست سرورها به‌صورت فهرستی جداشده با ویرگول مشخص می‌شود؛ هر تعداد فاصله در اطراف ویرگول مجاز است\&. سرورها به ترتیب اولویت فهرست می‌شوند\&. فهرست می‌تواند شامل هر تعداد سرور باشد\&.
.PP
برای هر گزینهٔ پیکربندی مجهز به قابلیت جایگزینی هنگام خرابی، دو متغیر وجود دارد:
\fIprimary\fR
و
\fIbackup\fR\&. ایده این است که سرورهای فهرست اصلی (primary) ترجیح داده می‌شوند و سرورهای پشتیبان (backup) تنها در صورتی جستجو می‌شوند که هیچ سرور اصلی‌ای در دسترس نباشد\&. اگر یک سرور پشتیبان انتخاب شود، مهلت زمانی ۳۱ ثانیه‌ای تنظیم می‌شود\&. پس از این مهلت زمانی، SSSD به‌طور دوره‌ای تلاش می‌کند تا دوباره به یکی از سرورهای اصلی متصل شود\&. در صورت موفقیت، سرور فعال فعلی (پشتیبان) جایگزین خواهد شد\&.
.SS "سازوکار جایگزینی هنگام خرابی"
.PP
سازوکار جایگزینی هنگام خرابی میان یک ماشین و یک سرویس تمایز قائل می‌شود\&. بک‌اند ابتدا تلاش می‌کند تا نام میزبان ماشین موردنظر را ارزیابی (resolve) کند؛ اگر این تلاش ناموفق باشد، ماشین آفلاین تلقی می‌شود\&. هیچ تلاش دیگری برای اتصال به این ماشین برای هر سرویس دیگری صورت نخواهد گرفت\&. اگر ارزیابی موفقیت‌آمیز باشد، بک‌اند تلاش می‌کند به سرویسی روی این ماشین متصل شود\&. اگر تلاش برای اتصال به سرویس شکست بخورد، تنها آن سرویس خاص آفلاین در نظر گرفته می‌شود و بک‌اند به‌طور خودکار به سرویس بعدی سوییچ می‌کند\&. ماشین همچنان آنلاین تلقی شده و ممکن است برای سرویس دیگری دوباره امتحان شود\&.
.PP
تلاش‌های بعدی برای اتصال به ماشین‌ها یا سرویس‌هایی که به‌عنوان آفلاین علامت‌گذاری شده‌اند، پس از یک بازه زمانی مشخص انجام می‌شود؛ این مقدار در حال حاضر روی ۳۰ ثانیه کدگذاری ثابت (hard-coded) شده است\&.
.PP
اگر ماشین دیگری برای امتحان وجود نداشته باشد، کل بک‌اند به حالت آفلاین تغییر وضعیت می‌دهد و سپس هر ۳۰ ثانیه یک بار برای اتصال مجدد تلاش می‌کند\&.
.SS "مهلت‌های زمانی و تنظیم دقیق جایگزینی هنگام خرابی"
.PP
ارزیابی یک سرور جهت اتصال می‌تواند به سادگی اجرای یک پرس‌وجوی DNS تکی باشد یا شامل چندین مرحله شود، مانند یافتن سایت (site) صحیح یا آزمودن چندین نام میزبان در صورتی که برخی از سرورهای پیکربندی‌شده در دسترس نباشند\&. سناریوهای پیچیده‌تر ممکن است مدتی طول بکشند و SSSD باید میان دادن زمان کافی برای اتمام فرایند ارزیابی و از سوی دیگر، تلاش نکردن بیش از حد طولانی پیش از رفتن به حالت آفلاین، تعادل برقرار کند\&. اگر گزارش‌های رفع اشکال در SSSD نشان می‌دهند که ارزیابی سرور پیش از برقراری ارتباط با یک سرور زنده به پایان مهلت زمانی می‌رسد، می‌توانید تغییر مهلت‌های زمانی را در نظر بگیرید\&.
.PP
این بخش متغیرهای تنظیمی موجود را فهرست می‌کند\&. لطفاً به توضیحات آن‌ها در صفحهٔ راهنمای
\fBsssd.conf\fR(5)
مراجعه کنید\&.
.PP
dns_resolver_server_timeout
.RS 4
زمان به میلی‌ثانیه که مشخص می‌کند SSSD پیش از رفتن سراغ سرور بعدی، چقدر با یک سرور DNS مشخص گفتگو کند\&.
.sp
پیش‌فرض: 1000
.RE
.PP
dns_resolver_op_timeout
.RS 4
زمان به ثانیه که مشخص می‌کند SSSD پیش از امتحان نام میزبان یا دامنهٔ شناسایی بعدی، چه مدت برای ارزیابی یک پرس‌وجوی DNS منفرد (مانند ارزیابی نام میزبان یا یک رکورد SRV) تلاش کند\&.
.sp
پیش‌فرض: 3
.RE
.PP
dns_resolver_timeout
.RS 4
مدت زمانی که SSSD تلاش می‌کند یک سرویس جایگزینی هنگام خرابی را ارزیابی کند\&. این ارزیابی سرویس در درون خود ممکن است شامل چندین مرحله باشد، مانند ارزیابی پرس‌وجوهای DNS SRV یا مکان‌یابی سایت\&.
.sp
پیش‌فرض: 6
.RE
.PP
برای ارائه‌دهندگان مبتنی بر LDAP، عملیات ارزیابی به‌عنوان بخشی از عملیات اتصال LDAP انجام می‌شود\&. بنابراین، مهلت زمانی
\(lqldap_opt_timeout\(rq
نیز باید روی مقداری بزرگ‌تر از
\(lqdns_resolver_timeout\(rq
تنظیم شود، که آن هم به نوبه خود باید روی مقداری بزرگ‌تر از
\(lqdns_resolver_op_timeout\(rq
تنظیم گردد، که آن هم باید از
\(lqdns_resolver_server_timeout\(rq
بزرگ‌تر باشد\&.
.SH "شناسایی سرویس (SERVICE DISCOVERY)"
.PP
قابلیت شناسایی سرویس به بک‌اندها اجازه می‌دهد تا با استفاده از یک پرس‌وجوی ویژهٔ DNS به‌طور خودکار سرورهای مناسب را برای اتصال پیدا کنند\&. این قابلیت برای سرورهای پشتیبان پشتیبانی نمی‌شود\&.
.SS "پیکربندی"
.PP
اگر سروری مشخص نشده باشد، بک‌اند به‌طور خودکار از شناسایی سرویس برای یافتن سرور استفاده می‌کند\&. به‌طور اختیاری، کاربر می‌تواند با قرار دادن کلمهٔ کلیدی ویژهٔ
\(lq_srv_\(rq
در فهرست سرورها، از هر دو روش آدرس‌های سرور ثابت و شناسایی سرویس استفاده کند\&. ترتیب اولویت حفظ می‌شود\&. این ویژگی برای مواردی مفید است که مثلاً کاربر ترجیح می‌دهد تا جای ممکن از شناسایی سرویس استفاده کند و در صورتی که هیچ سروری از طریق DNS کشف نشد، به یک سرور خاص رجوع کند\&.
.SS "نام دامنه"
.PP
لطفاً برای جزئیات بیشتر به پارامتر
\(lqdns_discovery_domain\(rq
در صفحهٔ راهنمای
\fBsssd.conf\fR(5)
مراجعه کنید\&.
.SS "پروتکل"
.PP
پرس‌وجوها معمولاً _tcp را به‌عنوان پروتکل تعیین می‌کنند\&. موارد استثنا در توضیحات گزینهٔ مربوطه مستند شده است\&.
.SS "همچنین ببینید"
.PP
برای اطلاعات بیشتر دربارهٔ سازوکار شناسایی سرویس، به RFC 2782 مراجعه کنید\&.
.SH "نگاشت شناسه (ID MAPPING)"
.PP
قابلیت نگاشت شناسه به SSSD اجازه می‌دهد تا بدون نیاز به گسترش صفات کاربری توسط مدیران سیستم جهت پشتیبانی از صفات POSIX برای شناسه‌های کاربر و گروه، به‌عنوان کلاینت Active Directory عمل کند\&.
.PP
نکته: هنگامی که ID-mapping فعال است، صفات uidNumber و gidNumber نادیده گرفته می‌شوند\&. این کار برای جلوگیری از احتمال تداخل بین مقادیر تخصیص‌یافته به‌طور خودکار و مقادیر دستی است\&. اگر نیاز به استفاده از مقادیر تخصیص‌یافته به صورت دستی دارید، تمام مقادیر باید به‌صورت دستی اختصاص یابند\&.
.PP
لطفاً توجه داشته باشید که تغییر گزینه‌های پیکربندی مربوط به نگاشت شناسه باعث تغییر شناسه‌های کاربر و گروه خواهد شد\&. در حال حاضر، SSSD از تغییر شناسه‌ها پشتیبانی نمی‌کند، بنابراین پایگاه‌دادهٔ SSSD باید حذف شود\&. از آنجا که گذرواژه‌های ذخیره‌شده در حافظهٔ موقت (کَش) نیز در پایگاه‌داده نگهداری می‌شوند، حذف پایگاه‌داده تنها زمانی باید انجام شود که سرورهای احراز هویت در دسترس باشند، در غیر این صورت ممکن است دسترسی کاربران قفل شود\&. به منظور ذخیرهٔ گذرواژه در کَش، باید یک احراز هویت انجام گیرد\&. استفاده از
\fBsss_cache\fR(8)
برای حذف پایگاه‌داده کافی نیست، بلکه این فرایند شامل موارد زیر است:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
اطمینان از در دسترس بودن سرورهای راه دور
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
متوقف کردن سرویس SSSD
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
حذف پایگاه‌داده
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
شروع به کار سرویس SSSD
.RE
.sp
علاوه بر این، از آنجا که تغییر شناسه‌ها ممکن است نیازمند تطبیق سایر ویژگی‌های سیستم مانند مالکیت فایل و دایرکتوری باشد، توصیه می‌شود از قبل برنامه‌ریزی کرده و پیکربندی نگاشت شناسه را به‌طور کامل آزمایش کنید\&.
.SS "الگوریتم نگاشت"
.PP
سامانهٔ Active Directory یک objectSID برای هر شیء کاربر و گروه در دایرکتوری فراهم می‌کند\&. این objectSID را می‌توان به مؤلفه‌هایی تجزیه کرد که هویت دامنهٔ Active Directory و شناسهٔ نسبی (RID) شیء کاربر یا گروه را نشان می‌دهند\&.
.PP
الگوریتم ID-mapping در SSSD دامنه‌ای از UIDهای موجود را گرفته و آن را به بخش‌های مؤلفه‌ای هم‌اندازه \- موسوم به «اسلایس» (slices) \- تقسیم می‌کند\&. هر اسلایس نشان‌دهندهٔ فضای در دسترس برای یک دامنهٔ Active Directory است\&.
.PP
هنگامی که یک مدخل کاربر یا گروه برای یک دامنهٔ خاص برای نخستین بار مشاهده می‌شود، SSSD یکی از اسلایس‌های در دسترس را به آن دامنه اختصاص می‌دهد\&. به منظور تکرارپذیر بودن این تخصیص اسلایس در ماشین‌های کلاینت مختلف، اسلایس بر اساس الگوریتم زیر انتخاب می‌شود:
.PP
رشتهٔ SID به الگوریتم murmurhash3 فرستاده می‌شود تا به یک مقدار درهم‌سازی‌شدهٔ ۳۲ بیتی تبدیل گردد\&. سپس باقیماندهٔ تقسیم این مقدار بر تعداد کل اسلایس‌های موجود محاسبه می‌شود تا اسلایس مورد نظر انتخاب گردد\&.
.PP
نکته: احتمال وقوع تصادم در درهم‌سازی و باقیماندهٔ تقسیم بعدی وجود دارد\&. در این وضعیت‌ها، اسلایسِ موجود بعدی انتخاب خواهد شد، اما ممکن است بازتولید همان مجموعه اسلایس دقیق روی سایر ماشین‌ها امکان‌پذیر نباشد (زیرا ترتیبی که دیده می‌شوند اسلایس آن‌ها را مشخص می‌کند)\&. در این شرایط، توصیه می‌شود که یا از صفات صریح POSIX در Active Directory استفاده شود (غیرفعال کردن ID-mapping) یا یک دامنهٔ پیش‌فرض پیکربندی شود تا تضمین گردد حداقل یکی همیشه سازگار است\&. برای جزئیات به
\(lqپیکربندی\(rq
مراجعه کنید\&.
.SS "پیکربندی"
.PP
حداقل پیکربندی (در بخش
\(lq[domain/DOMAINNAME]\(rq\):
.PP
.if n \{\
.RS 4
.\}
.nf
ldap_id_mapping = True
ldap_schema = ad
.fi
.if n \{\
.RE
.\}
.PP
پیکربندی پیش‌فرض منجر به پیکربندی ۱۰٬۰۰۰ اسلایس می‌شود که هرکدام قادر به نگهداری تا ۲۰۰٬۰۰۰ شناسه هستند، که از ۲۰۰٬۰۰۰ شروع شده و تا ۲٬۰۰۰٬۲۰۰٬۰۰۰ ادامه می‌یابد\&. این مقدار باید برای اکثر محیط‌ها کافی باشد\&.
.sp
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBپیکربندی پیشرفته\fR
.RS 4
.PP
ldap_idmap_range_min (عدد صحیح)
.RS 4
کران پایین (شامل خود مقدار) محدودهٔ شناسه‌های POSIX را مشخص می‌کند که برای نگاشت SIDهای کاربر و گروه Active Directory استفاده می‌شود\&. این نخستین شناسهٔ POSIX است که می‌تواند برای نگاشت استفاده شود\&.
.sp
نکته: این گزینه با
\(lqmin_id\(rq
متفاوت است، از این جهت که
\(lqmin_id\(rq
برای فیلتر کردن خروجی درخواست‌ها به این دامنه عمل می‌کند، در حالی که این گزینه محدودهٔ تخصیص شناسه را کنترل می‌کند\&. این تمایزی ظریف است، اما توصیهٔ عمومی این است که
\(lqmin_id\(rq
کوچک‌تر یا مساوی با
\(lqldap_idmap_range_min\(rq
باشد\&.
.sp
پیش‌فرض: 200000
.RE
.PP
ldap_idmap_range_max (عدد صحیح)
.RS 4
کران بالا (بدون احتساب خود مقدار) محدودهٔ شناسه‌های POSIX را مشخص می‌کند که برای نگاشت SIDهای کاربر و گروه Active Directory استفاده می‌شود\&. این نخستین شناسهٔ POSIX است که دیگر نمی‌تواند برای نگاشت استفاده شود؛ یعنی یک واحد بزرگ‌تر از آخرین شناسه‌ای است که می‌تواند برای نگاشت به کار رود\&.
.sp
نکته: این گزینه با
\(lqmax_id\(rq
متفاوت است، از این جهت که
\(lqmax_id\(rq
برای فیلتر کردن خروجی درخواست‌ها به این دامنه عمل می‌کند، در حالی که این گزینه محدودهٔ تخصیص شناسه را کنترل می‌کند\&. این تمایزی ظریف است، اما توصیهٔ عمومی این است که
\(lqmax_id\(rq
بزرگ‌تر یا مساوی با
\(lqldap_idmap_range_max\(rq
باشد\&.
.sp
پیش‌فرض: 2000200000
.RE
.PP
ldap_idmap_range_size (عدد صحیح)
.RS 4
تعداد شناسه‌های موجود برای هر اسلایس را مشخص می‌کند\&. اگر اندازهٔ محدوده به‌طور مساوی بر مقادیر حداقل و حداکثر بخش‌پذیر نباشد، تا حد ممکن اسلایس‌های کامل ایجاد خواهد کرد\&.
.sp
نکته: مقدار این گزینه باید دست‌کم به اندازهٔ بالاترین RID کاربری در نظر گرفته شده برای استفاده در سرور Active Directory باشد\&. جستجوی کاربر و ورود به سیستم برای هر کاربری که RID او بزرگ‌تر از این مقدار باشد، شکست خواهد خورد\&.
.sp
برای نمونه، اگر آخرین کاربر اضافه‌شده در Active Directory دارای objectSid=S\-1\-5\-21\-2153326666\-2176343378\-3404031434\-1107 باشد،
\(lqldap_idmap_range_size\(rq
باید دست‌کم 1108 باشد، چرا که اندازهٔ محدوده برابر با بیشینهٔ RID منهای کمینهٔ RID به‌علاوهٔ یک است (برای مثال: 1108 = 1107 \- 0 + 1)\&.
.sp
برنامه‌ریزی از پیش برای توسعهٔ آینده مهم است، چرا که تغییر این مقدار منجر به تغییر همهٔ نگاشت‌های شناسه در سیستم خواهد شد و باعث می‌شود شناسه‌های محلی کاربران با شناسه‌های پیشین آن‌ها متفاوت گردد\&.
.sp
پیش‌فرض: 200000
.RE
.PP
ldap_idmap_default_domain_sid (رشته)
.RS 4
شناسهٔ SID دامنه را برای دامنهٔ پیش‌فرض تعیین می‌کند\&. این کار تضمین می‌کند که این دامنه همیشه به اسلایس صفر در نقشهٔ شناسه اختصاص یابد و الگوریتم murmurhash توضیح داده شده در بالا دور زده شود\&.
.sp
پیش‌فرض: تنظیم‌نشده
.RE
.PP
ldap_idmap_default_domain (رشته)
.RS 4
نام دامنهٔ پیش‌فرض را تعیین می‌کند\&.
.sp
پیش‌فرض: تنظیم‌نشده
.RE
.PP
ldap_idmap_autorid_compat (بولی)
.RS 4
رفتار الگوریتم ID-mapping را تغییر می‌دهد تا شباهت بیشتری به الگوریتم
\(lqidmap_autorid\(rq
در winbind پیدا کند\&.
.sp
هنگامی که این گزینه پیکربندی شود، تخصیص دامنه‌ها از اسلایس صفر آغاز شده و با هر دامنهٔ اضافی، به‌صورت یکنواخت افزایش می‌یابد\&.
.sp
نکته: این الگوریتم غیرقطعی (non-deterministic) است (به ترتیبی که کاربران و گروه‌ها درخواست می‌شوند بستگی دارد)\&. اگر این حالت برای سازگاری با ماشین‌های اجراکنندهٔ winbind مورد نیاز است، توصیه می‌شود از گزینهٔ
\(lqldap_idmap_default_domain_sid\(rq
نیز استفاده کنید تا تضمین شود دست‌کم یک دامنه به‌طور پیوسته به اسلایس صفر تخصیص می‌یابد\&.
.sp
پیش‌فرض: False
.RE
.PP
ldap_idmap_helper_table_size (عدد صحیح)
.RS 4
حداکثر تعداد اسلایس‌های ثانویه که هنگام انجام نگاشت از شناسهٔ UNIX به SID بررسی می‌شود\&.
.sp
نکته: هنگامی که SID به شناسهٔ UNIX نگاشت می‌شود و بخش RID مربوط به SID خارج از محدودهٔ اسلایس‌های ثانویهٔ تولیدشده تاکنون باشد، ممکن است اسلایس‌های ثانویهٔ اضافی تولید شوند\&. اگر مقدار ldap_idmap_helper_table_size برابر با 0 باشد، هیچ اسلایس ثانویهٔ اضافی‌ای تولید نمی‌شود\&.
.sp
پیش‌فرض: 10
.RE
.RE
.SS "SIDهای شناخته‌شده (Well\-Known SIDs)"
.PP
SSSD از جستجوی نام‌های Well\-Known SIDها (یعنی SIDهایی با معانی خاص و ثابت) پشتیبانی می‌کند\&. از آنجا که کاربران و گروه‌های عمومی مرتبط با این Well\-Known SIDها معادلی در محیط Linux/UNIX ندارند، هیچ شناسه POSIX ID برای این اشیاء در دسترس نیست\&.
.PP
فضای نام SID در مراجع (authorities) سازماندهی شده است که می‌توان آن‌ها را به عنوان دامنه‌های متفاوتی در نظر گرفت\&. مراجع مربوط به Well\-Known SIDها عبارتند از:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Null Authority
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
World Authority
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Local Authority
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Creator Authority
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Mandatory Label Authority
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Authentication Authority
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
NT Authority
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Built\-in
.RE
.sp
نسخه با حروف بزرگ (capitalized) این نام‌ها هنگام بازگرداندن نام کاملاً مشخص (fully qualified name) یک Well\-Known SID به عنوان نام دامنه استفاده می‌شود\&.
.PP
از آنجا که برخی ابزارها امکان اصلاح اطلاعات کنترل دسترسی مبتنی بر SID را به جای استفاده مستقیم از SID با استفاده از نام فراهم می‌کنند، SSSD از جستجوی SID از طریق نام نیز پشتیبانی می‌کند\&. برای جلوگیری از تداخل، فقط از نام‌های کاملاً مشخص می‌توان برای جستجوی Well\-Known SIDها استفاده کرد\&. در نتیجه نام‌های دامنه
\(lqNULL AUTHORITY\(rq،
\(lqWORLD AUTHORITY\(rq،
\(lqLOCAL AUTHORITY\(rq،
\(lqCREATOR AUTHORITY\(rq،
\(lqMANDATORY LABEL AUTHORITY\(rq،
\(lqAUTHENTICATION AUTHORITY\(rq،
\(lqNT AUTHORITY\(rq
و
\(lqBUILTIN\(rq
نباید به عنوان نام دامنه در
sssd\&.conf
استفاده شوند\&.
.SH "مثال (EXAMPLE)"
.PP
مثال زیر فرض می‌کند که SSSD به درستی پیکربندی شده و LDAP به عنوان یکی از دامنه‌ها در بخش
\fI[domains]\fR
تنظیم شده است\&.
.PP
.if n \{\
.RS 4
.\}
.nf
[domain/LDAP]
id_provider = ldap
auth_provider = ldap
ldap_uri = ldap://ldap\&.mydomain\&.org
ldap_search_base = dc=mydomain,dc=org
ldap_tls_reqcert = demand
cache_credentials = true
.fi
.if n \{\
.RE
.\}
.sp
.SH "مثال فیلتر دسترسی LDAP (LDAP ACCESS FILTER EXAMPLE)"
.PP
مثال زیر فرض می‌کند که SSSD به درستی پیکربندی شده و از ldap_access_order=lockout استفاده می‌کند\&.
.PP
.if n \{\
.RS 4
.\}
.nf
[domain/LDAP]
id_provider = ldap
auth_provider = ldap
access_provider = ldap
ldap_access_order = lockout
ldap_pwdlockout_dn = cn=ppolicy,ou=policies,dc=mydomain,dc=org
ldap_uri = ldap://ldap\&.mydomain\&.org
ldap_search_base = dc=mydomain,dc=org
ldap_tls_reqcert = demand
cache_credentials = true
.fi
.if n \{\
.RE
.\}
.sp
.SH "نکات (NOTES)"
.PP
توضیحات برخی از گزینه‌های پیکربندی در این صفحه راهنما بر اساس صفحه راهنمای
\fBldap.conf\fR(5)
از توزیع OpenLDAP 2\&.4 است\&.
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBsssd\fR(8),
\fBsssd.conf\fR(5),
\fBsssd-ldap\fR(5),
\fBsssd-ldap-attributes\fR(5),
\fBsssd-krb5\fR(5),
\fBsssd-simple\fR(5),
\fBsssd-ipa\fR(5),
\fBsssd-ad\fR(5),
\fBsssd-idp\fR(5),
\fBsssd-sudo\fR(5),
\fBsssd-session-recording\fR(5),
\fBsss_cache\fR(8),
\fBsss_debuglevel\fR(8),
\fBsss_obfuscate\fR(8),
\fBsss_seed\fR(8),
\fBsssd_krb5_locator_plugin\fR(8),
\fBsss_ssh_authorizedkeys\fR(1), \fBsss_ssh_knownhosts\fR(1),
\fBsssd-ifp\fR(5),
\fBpam_sss\fR(8)\&.
\fBsss_rpcidmapd\fR(5)
.SH "نویسندگان (AUTHORS)"
.PP
\fBتوسعه‌دهندگان بالادستی SSSD \- https://github\&.com/SSSD/sssd\fR