'\" t
.\"     Title: sssd-ad
.\"    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\-AD" "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-ad \- ارائه‌دهنده Active Directory برای SSSD
.SH "توضیحات (DESCRIPTION)"
.PP
این صفحه راهنما، پیکربندی ارائه‌دهنده AD را برای
\fBsssd\fR(8)
شرح می‌دهد\&. برای مرجع دقیق ساختار، به بخش
\(lqFILE FORMAT\(rq
در صفحه راهنمای
\fBsssd.conf\fR(5)
مراجعه کنید\&.
.PP
ارائه‌دهنده AD یک بک‌اند است که برای اتصال به سرور Active Directory به کار می‌رود\&. این ارائه‌دهنده مستلزم پیوستن ماشین به دامین AD و در دسترس بودن یک keytab است\&. ارتباط بک‌اند روی یک کانال رمزنگاری‌شده با GSSAPI انجام می‌شود؛ گزینه‌های SSL/TLS نباید همراه با ارائه‌دهنده AD استفاده شوند و استفاده از Kerberos جایگزین آن‌ها خواهد شد\&.
.PP
ارائه‌دهنده AD از اتصال به Active Directory 2008 R2 یا نسخه‌های جدیدتر پشتیبانی می‌کند\&. نسخه‌های قدیمی‌تر ممکن است کار کنند، اما پشتیبانی نمی‌شوند\&.
.PP
ارائه‌دهنده AD می‌تواند برای دریافت اطلاعات کاربران و احراز هویت کاربران دامین‌های مورد اعتماد استفاده شود\&. در حال حاضر تنها دامین‌های مورد اعتماد در همان forest شناسایی می‌شوند\&. علاوه بر این، سرورهای دامین‌های مورد اعتماد همیشه به‌صورت خودکار شناسایی می‌شوند\&.
.PP
ارائه‌دهنده AD به SSSD امکان می‌دهد از ارائه‌دهنده هویت
\fBsssd-ldap\fR(5)
و ارائه‌دهنده احراز هویت
\fBsssd-krb5\fR(5)
همراه با بهینه‌سازی‌هایی برای محیط‌های Active Directory استفاده کند\&. ارائه‌دهنده AD با چند استثنا، همان گزینه‌های مورد استفاده در ارائه‌دهنده‌های sssd\-ldap و sssd\-krb5 را می‌پذیرد\&. با این حال، تنظیم این گزینه‌ها نه لازم است و نه توصیه می‌شود\&.
.PP
ارائه‌دهنده AD اساساً گزینه‌های پیش‌فرض ارائه‌دهنده‌های سنتی ldap و krb5 را با چند استثنا کپی می‌کند؛ تفاوت‌ها در بخش
\(lqMODIFIED DEFAULT OPTIONS\(rq
فهرست شده‌اند\&.
.PP
ارائه‌دهنده AD همچنین می‌تواند به عنوان ارائه‌دهنده access،‏ chpass،‏ sudo و autofs استفاده شود\&. هیچ پیکربندی خاصی برای ارائه‌دهنده دسترسی در سمت کلاینت لازم نیست\&.
.PP
اگر
\(lqauth_provider=ad\(rq
یا
\(lqaccess_provider=ad\(rq
در sssd\&.conf پیکربندی شده باشد، id_provider نیز باید روی
\(lqad\(rq
تنظیم شود\&.
.PP
به‌طور پیش‌فرض، ارائه‌دهنده AD مقادیر UID و GID را از پارامتر objectSID در Active Directory نگاشت می‌کند\&. برای جزئیات در این باره، بخش
\(lqنگاشت شناسه (ID MAPPING)\(rq
را در زیر ببینید\&. اگر می‌خواهید نگاشت شناسه را غیرفعال کرده و در عوض به ویژگی‌های POSIX تعریف‌شده در Active Directory تکیه کنید، باید مقدار زیر را تنظیم کنید:
.sp
.if n \{\
.RS 4
.\}
.nf
ldap_id_mapping = False
            
.fi
.if n \{\
.RE
.\}
.sp
در صورت استفاده از ویژگی‌های POSIX، به دلایل کارایی توصیه می‌شود این ویژگی‌ها در Global Catalog نیز تکثیر (replicate) شوند\&. اگر ویژگی‌های POSIX تکثیر شده باشند، SSSD تلاش می‌کند تا دامین یک شناسه عددی درخواستی را به کمک Global Catalog مکان‌یابی کرده و تنها آن دامین را جستجو کند\&. در مقابل، اگر ویژگی‌های POSIX در Global Catalog تکثیر نشده باشند، SSSD باید تمام دامین‌های موجود در forest را به‌صورت متوالی جستجو کند\&. لطفاً توجه داشته باشید که گزینه
\(lqcache_first\(rq
نیز ممکن است در سرعت بخشیدن به جستجوهای بدون دامین مفید باشد\&. توجه داشته باشید که اگر تنها زیرمجموعه‌ای از ویژگی‌های POSIX در Global Catalog موجود باشد، ویژگی‌های تکثیرنشده در حال حاضر از پورت LDAP خوانده نمی‌شوند\&.
.PP
کاربران، گروه‌ها و سایر موجودیت‌های ارائه‌شده توسط SSSD، جهت سازگاری با پیاده‌سازی LDAP در Active Directory، در ارائه‌دهنده AD همواره بدون حساسیت به حروف کوچک و بزرگ در نظر گرفته می‌شوند\&.
.PP
‏SSSD تنها گروه‌های امنیتی (Security Groups) مربوط به Active Directory را حل‌وفصل می‌کند\&. برای اطلاعات بیشتر پیرامون انواع گروه‌های AD ببینید:
\m[blue]\fBActive Directory security groups\fR\m[]\&\s-2\u[1]\d\s+2
.PP
‏SSSD گروه‌های Domain Local را از دامین‌های دوردست در forest متعلق به AD فیلتر می‌کند\&. به‌طور پیش‌فرض برای نمونه هنگام دنبال کردن سلسله‌مراتب گروه‌های تو‌در‌تو در دامین‌های دوردست، آن‌ها فیلتر می‌شوند زیرا در دامین محلی معتبر نیستند\&. این کار به منظور هم‌خوانی با تخصیص عضویت گروهی Active Directory انجام می‌شود که در PAC بلیت Kerberos صادرشده از سوی Active Directory برای کاربر قابل مشاهده است\&.
.SH "گزینه‌های پیکربندی (CONFIGURATION OPTIONS)"
.PP
برای جزئیات مربوط به پیکربندی دامین SSSD، به بخش
\(lqDOMAIN SECTIONS\(rq
در صفحه راهنمای
\fBsssd.conf\fR(5)
مراجعه کنید\&.
.PP
ad_domain (string)
.RS 4
نام دامین Active Directory را مشخص می‌کند\&. این گزینه اختیاری است\&. در صورت ارائه نشدن، نام دامین پیکربندی استفاده می‌شود\&.
.sp
برای کارکرد درست، این گزینه باید به صورت نسخه تماماً حروف کوچک از نام کامل دامین Active Directory مشخص شود\&.
.sp
نام کوتاه دامین (شناخته‌شده به عنوان نام NetBIOS یا نام flat) به‌طور خودکار توسط SSSD شناسایی می‌شود\&.
.RE
.PP
ad_enabled_domains (string)
.RS 4
فهرستی از دامین‌های فعال‌شده Active Directory که با کاما از هم جدا شده‌اند\&. در صورت ارائه، SSSD دامین‌هایی را که در این گزینه ذکر نشده‌اند نادیده می‌گیرد\&. در صورت خالی بودن، همه دامین‌های کشف‌شده از AD forest در دسترس خواهند بود\&.
.sp
در طول شناسایی دامین‌ها، SSSD برخی دامین‌ها را که فلگ‌ها یا ویژگی‌هایشان نشان می‌دهد به forest محلی تعلق ندارند یا غیرقابل‌اعتماد هستند، فیلتر می‌کند\&. در صورت تنظیم ad_enabled_domains، ارائه‌دهنده SSSD تلاش می‌کند تمام دامین‌های ذکرشده را فعال کند\&.
.sp
برای کارکرد درست، این گزینه باید تماماً با حروف کوچک و به عنوان نام دامنه کاملاً واجد شرایط (FQDN) دامین Active Directory مشخص شود\&. برای نمونه:
.sp
.if n \{\
.RS 4
.\}
.nf
ad_enabled_domains = sales\&.example\&.com, eng\&.example\&.com
                            
.fi
.if n \{\
.RE
.\}
.sp
نام کوتاه دامین (معروف به نام NetBIOS یا نام flat) به‌طور خودکار توسط SSSD شناسایی خواهد شد\&.
.sp
پیش‌فرض: تنظیم‌نشده
.RE
.PP
ad_server, ad_backup_server (string)
.RS 4
فهرست جداشده با کاما از نام‌های میزبان سرورهای AD که SSSD باید به ترتیب اولویت به آن‌ها متصل شود\&. برای اطلاعات بیشتر درباره جایگزینی هنگام خرابی و افزونگی سرور، به بخش
\(lqجایگزینی هنگام خرابی (FAILOVER)\(rq
مراجعه کنید\&.
.sp
در صورت فعال بودن شناسایی خودکار، این گزینه اختیاری است\&. برای اطلاعات بیشتر در خصوص شناسایی سرویس، به بخش
\(lqشناسایی سرویس (SERVICE DISCOVERY)\(rq
مراجعه کنید\&.
.sp
نکته: دامین‌های مورد اعتماد همواره سرورها را به‌طور خودکار شناسایی می‌کنند، حتی اگر سرور اصلی صراحتاً در گزینه ad_server تعریف شده باشد\&.
.RE
.PP
ad_hostname (string)
.RS 4
اختیاری\&. در ماشین‌هایی که hostname(5) بازتاب‌دهنده نام کاملاً واجد شرایط نیست، sssd تلاش می‌کند تا نام کوتاه را گسترش دهد\&. اگر این امر ممکن نیست یا باید واقعاً از نام کوتاه استفاده شود، این پارامتر را صراحتاً تنظیم کنید\&.
.sp
این فیلد برای تعیین host principal مورد استفاده در keytab و انجام به‌روزرسانی‌های پویای DNS به کار می‌رود\&. این مقدار باید با نام میزبانی که keytab برای آن صادر شده مطابقت داشته باشد\&.
.RE
.PP
ad_enable_dns_sites (boolean)
.RS 4
سایت‌های DNS را فعال می‌کند \- شناسایی سرویس مبتنی بر موقعیت مکانی\&.
.sp
اگر مقدار true باشد و شناسایی سرویس (بند Service Discovery در انتهای صفحه راهنما را ببینید) فعال باشد، SSSD ابتدا تلاش می‌کند تا با استفاده از Active Directory Site Discovery، سرور Active Directory را برای اتصال شناسایی کند و در صورتی که هیچ سایت AD یافت نشد، به رکوردهای DNS SRV بازگردد\&. پیکربندی DNS SRV، شامل دامین شناسایی، در حین شناسایی سایت نیز مورد استفاده قرار می‌گیرد\&.
.sp
پیش‌فرض: true
.RE
.PP
ad_access_filter (string)
.RS 4
یک فیلتر کنترل دسترسی LDAP را مشخص می‌کند که کاربر برای به دست آوردن دسترسی باید با آن تطابق داشته باشد\&. برای اثرگذاری این گزینه، مقدار
\(lqaccess_provider\(rq
باید صراحتاً روی
\(lqad\(rq
تنظیم شده باشد\&. اگر می‌خواهید از
\(lqad_access_filter\(rq
به عنوان تنها شیوه کنترل دسترسی استفاده کنید، باید کنترل دسترسی مبتنی بر GPO را غیرفعال کنید (برای جزئیات، گزینه
\(lqad_gpo_access_control\(rq
را ببینید)\&.
.sp
این گزینه همچنین از تعیین فیلترهای متفاوت به ازای هر دامین یا forest پشتیبانی می‌کند\&. این فیلتر تعمیم‌یافته متشکل است از:
\(lqKEYWORD:NAME:FILTER\(rq\&. کلمه کلیدی می‌تواند
\(lqDOM\(rq،‏
\(lqFOREST\(rq
یا خالی باشد\&.
.sp
اگر کلمه کلیدی برابر با
\(lqDOM\(rq
یا خالی باشد،
\(lqNAME\(rq
دامین یا زیردامینی را که فیلتر روی آن اعمال می‌شود تعیین می‌کند\&. اگر کلمه کلیدی برابر با
\(lqFOREST\(rq
باشد، فیلتر روی تمام دامین‌های متعلق به forest تعیین‌شده با
\(lqNAME\(rq
اعمال خواهد شد\&.
.sp
مشابه شیوه عملکرد پایه‌های جستجو (search bases)، فیلترهای چندگانه را می‌توان با نویسه
\(lq?\(rq
از یکدیگر جدا کرد\&.
.sp
عضویت در گروه‌های تو‌در‌تو باید با استفاده از یک OID ویژه
\(lq:1\&.2\&.840\&.113556\&.1\&.4\&.1941:\(rq
علاوه بر ساختار کامل DOM:domain\&.example\&.org: جستجو شود تا اطمینان حاصل گردد تجزیه‌کننده نویسه‌های دونقطه مربوط به OID را تفسیر نخواهد کرد\&. اگر از این OID استفاده نکنید، عضویت در گروه‌های تو‌در‌تو حل‌وفصل نخواهد شد\&. مثال کاربردی زیر را ببینید و برای اطلاعات بیشتر درباره این OID به اینجا مراجعه کنید:
\m[blue]\fB[MS\-ADTS] section LDAP extensions\fR\m[]\&\s-2\u[2]\d\s+2
.sp
همواره دقیق‌ترین تطابق مورد استفاده قرار می‌گیرد\&. برای نمونه، اگر این گزینه فیلتری برای یک دامین که کاربر عضو آن است و یک فیلتر سراسری مشخص کند، فیلتر اختصاصی دامین اعمال خواهد شد\&. چنانچه چند تطابق با مشخصات یکسان وجود داشته باشند، اولین مورد به کار گرفته می‌شود\&.
.sp
مثال‌ها:
.sp
.if n \{\
.RS 4
.\}
.nf
# اعمال فیلتر فقط روی دامین با نام dom1:
dom1:(memberOf=cn=admins,ou=groups,dc=dom1,dc=com)

# اعمال فیلتر فقط روی دامین با نام dom2:
DOM:dom2:(memberOf=cn=admins,ou=groups,dc=dom2,dc=com)

# اعمال فیلتر فقط روی forest با نام EXAMPLE\&.COM:
FOREST:EXAMPLE\&.COM:(memberOf=cn=admins,ou=groups,dc=example,dc=com)

# اعمال فیلتر برای عضوی از یک گروه تو‌در‌تو در dom1:
DOM:dom1:(memberOf:1\&.2\&.840\&.113556\&.1\&.4\&.1941:=cn=nestedgroup,ou=groups,dc=example,dc=com)
                        
.fi
.if n \{\
.RE
.\}
.sp
پیش‌فرض: تنظیم‌نشده
.RE
.PP
ad_site (string)
.RS 4
سایت AD را که کلاینت باید برای اتصال به آن تلاش کند مشخص می‌سازد\&. در صورت ارائه نشدن این گزینه، سایت AD به‌صورت خودکار شناسایی خواهد شد\&.
.sp
پیش‌فرض: تنظیم‌نشده
.RE
.PP
ad_enable_gc (boolean)
.RS 4
به‌طور پیش‌فرض، SSSD ابتدا به Global Catalog متصل می‌شود تا کاربران را از دامین‌های مورد اعتماد بازیابی کند و از پورت LDAP برای بازیابی عضویت‌های گروهی یا به عنوان پشتیبان استفاده می‌نماید\&. غیرفعال کردن این گزینه سبب می‌شود SSSD تنها به پورت LDAP سرور AD فعلی متصل گردد\&.
.sp
لطفاً توجه داشته باشید که غیرفعال کردن پشتیبانی از Global Catalog، بازیابی کاربران از دامین‌های مورد اعتماد را غیرفعال نمی‌سازد\&. در این حالت SSSD در عوض به پورت LDAP دامین‌های مورد اعتماد متصل خواهد شد\&. با این حال، به منظور حل‌وفصل عضویت‌های گروهی بین‌دامینی، استفاده از Global Catalog الزامی است\&.
.sp
پیش‌فرض: true
.RE
.PP
ad_gpo_access_control (string)
.RS 4
این گزینه حالت عملیاتی را برای قابلیت کنترل دسترسی مبتنی بر GPO تعیین می‌کند: اینکه در حالت غیرفعال، حالت اجباری (enforcing) یا حالت مجاز (permissive) عمل کند\&. لطفاً توجه داشته باشید که گزینه
\(lqaccess_provider\(rq
باید صراحتاً روی
\(lqad\(rq
تنظیم شده باشد تا این گزینه اثرگذار شود\&.
.sp
قابلیت کنترل دسترسی مبتنی بر GPO از تنظیمات خط‌مشی GPO برای تعیین اینکه آیا یک کاربر مشخص مجاز به ورود به میزبان است یا خیر استفاده می‌کند\&. برای اطلاعات بیشتر پیرامون تنظیمات خط‌مشی‌های پشتیبانی‌شده لطفاً به گزینه‌های
\(lqad_gpo_map\(rq
مراجعه کنید\&.
.sp
لطفاً توجه داشته باشید که نسخه فعلی SSSD از گروه‌های توکار (built\-in) در Active Directory پشتیبانی نمی‌کند\&. گروه‌های توکار (مانند Administrators با SID S\-1\-5\-32\-544) در قوانین کنترل دسترسی GPO توسط SSSD نادیده گرفته می‌شوند\&. ردیاب مشکلات بالادستی را در https://github\&.com/SSSD/sssd/issues/5063 ببینید\&.
.sp
پیش از اعمال کنترل دسترسی، SSSD فیلتر امنیتی خط‌مشی گروهی را روی GPOها اعمال می‌کند\&. برای هر ورود مجزای کاربر، قابلیت انطباق GPOهایی که به میزبان پیوند خورده‌اند بررسی می‌شود\&. برای اینکه یک GPO روی یک کاربر اعمال شود، کاربر یا دست‌کم یکی از گروه‌هایی که به آن تعلق دارد باید مجوزهای زیر را روی GPO داشته باشد:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Read: کاربر یا یکی از گروه‌های آن باید دسترسی خواندن به ویژگی‌های GPO را داشته باشد (RIGHT_DS_READ_PROPERTY)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Apply Group Policy: کاربر یا دست‌کم یکی از گروه‌های آن باید مجاز به اعمال GPO باشد (RIGHT_DS_CONTROL_ACCESS)\&.
.RE
.sp
به‌طور پیش‌فرض، گروه Authenticated Users روی یک GPO حضور دارد و این گروه دارای هر دو حق دسترسی Read و Apply Group Policy است\&. از آنجا که احراز هویت یک کاربر پیش از آغاز فیلترسازی امنیتی GPO و کنترل دسترسی باید با موفقیت انجام شده باشد، مجوزهای گروه Authenticated Users روی GPO همواره بر کاربر نیز اعمال می‌شود\&.
.sp
نکته: اگر حالت عملیاتی روی enforcing تنظیم شود، ممکن است کاربرانی که پیش‌تر اجازه ورود داشتند، اکنون از ورود منع شوند (همان‌طور که تنظیمات خط‌مشی GPO تعیین می‌کند)\&. برای تسهیل انتقال روان برای مدیران سیستم، یک حالت permissive در دسترس است که قوانین کنترل دسترسی را اعمال نمی‌کند، اما آنها را ارزیابی کرده و در صورتی که دسترسی رد می‌شد یک پیام syslog صادر می‌کند\&. مدیران سیستم می‌توانند با بررسی لاگ‌ها، تغییرات لازم را پیش از تنظیم حالت روی enforcing انجام دهند\&. برای ثبت لاگ کنترل دسترسی مبتنی بر GPO، سطح اشکال‌زدایی \*(Aqtrace functions\*(Aq مورد نیاز است (صفحه راهنمای
\fBsssctl\fR(8)
را ببینید)\&.
.sp
سه مقدار پشتیبانی‌شده برای این گزینه وجود دارد:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
disabled: قوانین کنترل دسترسی مبتنی بر GPO نه ارزیابی می‌شوند و نه اعمال\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
enforcing: قوانین کنترل دسترسی مبتنی بر GPO ارزیابی و اعمال می‌شوند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
permissive: قوانین کنترل دسترسی مبتنی بر GPO ارزیابی می‌شوند، اما اعمال نمی‌شوند\&. در عوض، یک پیام syslog صادر خواهد شد که نشان می‌دهد اگر مقدار این گزینه روی enforcing تنظیم شده بود، دسترسی کاربر رد می‌شد\&.
.RE
.sp
پیش‌فرض: enforcing
.RE
.PP
ad_gpo_implicit_deny (boolean)
.RS 4
به‌طور معمول وقتی هیچ GPO قابل اعمالی یافت نشود، به کاربران اجازه دسترسی داده می‌شود\&. هنگامی که این گزینه روی True تنظیم شود، به کاربران تنها در صورتی اجازه دسترسی داده خواهد شد که صراحتاً توسط یک قانون GPO مجاز شده باشند\&. در غیر این صورت دسترسی کاربران رد خواهد شد\&. از این گزینه می‌توان برای سخت‌سازی امنیت استفاده کرد، اما در استفاده از آن احتیاط کنید زیرا اگر هیچ قانونی از GPO بر کاربران گروه توکار Administrators اعمال نشود، می‌تواند حتی دسترسی آنان را نیز رد کند\&.
.sp
پیش‌فرض: False
.sp
۲ جدول زیر نشان می‌دهند که چه زمانی یک کاربر بر اساس حقوق ورود allow و deny تعریف‌شده در سمت سرور و تنظیم ad_gpo_implicit_deny مجاز شناخته شده یا رد می‌شود\&.
.TS
allbox tab(:);
cB s s
cB cB cB.
T{
ad_gpo_implicit_deny = False (پیش‌فرض)
T}
T{
قوانین allow
T}:T{
قوانین deny
T}:T{
نتایج
T}
.T&
c c c
c c c
c c c
c c c.
T{
ناموجود
T}:T{
ناموجود
T}:T{
همه کاربران مجاز هستند
T}
T{
ناموجود
T}:T{
موجود
T}:T{
تنها کاربرانی که در قوانین deny نیستند مجاز هستند
T}
T{
موجود
T}:T{
ناموجود
T}:T{
تنها کاربرانی که در قوانین allow هستند مجاز هستند
T}
T{
موجود
T}:T{
موجود
T}:T{
تنها کاربرانی که در قوانین allow هستند و در قوانین deny نیستند مجاز هستند
T}
.TE
.sp 1
.TS
allbox tab(:);
cB s s
cB cB cB.
T{
ad_gpo_implicit_deny = True
T}
T{
قوانین allow
T}:T{
قوانین deny
T}:T{
نتایج
T}
.T&
c c c
c c c
c c c
c c c.
T{
ناموجود
T}:T{
ناموجود
T}:T{
هیچ کاربری مجاز نیست
T}
T{
ناموجود
T}:T{
موجود
T}:T{
هیچ کاربری مجاز نیست
T}
T{
موجود
T}:T{
ناموجود
T}:T{
تنها کاربرانی که در قوانین allow هستند مجاز هستند
T}
T{
موجود
T}:T{
موجود
T}:T{
تنها کاربرانی که در قوانین allow هستند و در قوانین deny نیستند مجاز هستند
T}
.TE
.sp 1
.RE
.PP
ad_gpo_ignore_unreadable (boolean)
.RS 4
به‌طور معمول وقتی برخی کانتینرهای خط‌مشی گروه (شیء AD) مربوط به اشیاء خط‌مشی گروهِ قابل‌اعمال برای SSSD قابل خواندن نباشند، دسترسی کاربران رد می‌شود\&. این گزینه اجازه می‌دهد تا کانتینرهای خط‌مشی گروه و خط‌مشی‌های مرتبط با آنها، در صورتی که مشخصه‌های آنها در کانتینرهای خط‌مشی گروه برای SSSD قابل خواندن نباشد، نادیده گرفته شوند\&.
.sp
پیش‌فرض: False
.RE
.PP
ad_gpo_cache_timeout (integer)
.RS 4
مدت زمان بین جستجوهای فایل‌های خط‌مشی GPO در سرور AD\&. در صورتی که درخواست‌های کنترل دسترسی متعددی در مدت کوتاهی ارسال شود، این گزینه تاخیر و بار کاری سرور AD را کاهش خواهد داد\&.
.sp
پیش‌فرض: 5 (ثانیه)
.RE
.PP
ad_gpo_map_interactive (string)
.RS 4
فهرستی جداشده با کاما از نام‌های سرویس PAM که کنترل دسترسی مبتنی بر GPO برای آنها بر اساس تنظیمات خط‌مشی InteractiveLogonRight و DenyInteractiveLogonRight ارزیابی می‌شود\&. تنها آن دسته از GPOهایی ارزیابی می‌شوند که کاربر مجوز Read و Apply Group Policy را برای آنها دارد (گزینه
\(lqad_gpo_access_control\(rq
را ببینید)\&. اگر یک GPO ارزیابی‌شده شامل تنظیم deny interactive logon برای کاربر یا یکی از گروه‌های آن باشد، دسترسی محلی کاربر رد می‌شود\&. اگر در هیچ‌یک از GPOهای ارزیابی‌شده حق ورود تعاملی تعریف نشده باشد، به کاربر دسترسی محلی داده می‌شود\&. اگر دست‌کم یک GPO ارزیابی‌شده شامل تنظیمات حق ورود تعاملی باشد، دسترسی محلی به کاربر تنها در صورتی داده می‌شود که خودش یا دست‌کم یکی از گروه‌هایش بخشی از تنظیمات خط‌مشی باشند\&.
.sp
نکته: در Group Policy Management Editor این مقدار \(lqAllow log on locally\(rq و \(lqDeny log on locally\(rq نامیده می‌شود\&.
.sp
امکان افزودن نام یک سرویس PAM دیگر به مجموعه پیش‌فرض با استفاده از
\(lq+service_name\(rq
یا حذف صریح یک نام سرویس PAM از مجموعه پیش‌فرض با استفاده از
\(lq\-service_name\(rq
وجود دارد\&. برای نمونه، جهت جایگزینی یک نام پیش‌فرض سرویس PAM برای این حق ورود (مانند
\(lqlogin\(rq)
با یک نام سرویس PAM سفارشی (مانند
\(lqmy_pam_service\(rq)،
می‌توان از پیکربندی زیر استفاده کرد:
.sp
.if n \{\
.RS 4
.\}
.nf
ad_gpo_map_interactive = +my_pam_service, \-login
                            
.fi
.if n \{\
.RE
.\}
.sp
پیش‌فرض: مجموعه پیش‌فرض نام‌های سرویس PAM شامل موارد زیر است:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
login
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
su
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
su\-l
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
gdm\-fingerprint
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
gdm\-password
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
gdm\-smartcard
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
kdm
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
lightdm
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
lxdm
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
plasmalogin
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
sddm
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
unity
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
xdm
.RE
.sp
.RE
.PP
ad_gpo_map_remote_interactive (رشته)
.RS 4
فهرستی از نام‌های سرویس PAM جداشده با کاما که کنترل دسترسی مبتنی بر GPO برای آن‌ها بر اساس تنظیمات خط‌مشی RemoteInteractiveLogonRight و DenyRemoteInteractiveLogonRight ارزیابی می‌شود\&. تنها GPOهایی ارزیابی می‌شوند که کاربر برای آن‌ها مجوز Read و Apply Group Policy داشته باشد (گزینه
\(lqad_gpo_access_control\(rq
را ببینید)\&. اگر یک GPO ارزیابی‌شده حاوی تنظیم منع ورود از راه دور برای کاربر یا یکی از گروه‌های آن باشد، دسترسی تعاملی از راه دور به کاربر داده نخواهد شد\&. اگر در هیچ‌یک از GPOهای ارزیابی‌شده مجوزی برای ورود تعاملی از راه دور تعریف نشده باشد، به کاربر دسترسی از راه دور داده می‌شود\&. اگر حداقل یک GPO ارزیابی‌شده حاوی تنظیمات حق ورود تعاملی از راه دور باشد، دسترسی از راه دور تنها در صورتی به کاربر داده می‌شود که خود کاربر یا حداقل یکی از گروه‌های آن بخشی از تنظیمات خط‌مشی باشند\&.
.sp
نکته: در Group Policy Management Editor، این مقدار تحت عناوین "Allow log on through Remote Desktop Services" و "Deny log on through Remote Desktop Services" نامیده می‌شود\&.
.sp
می‌توان با استفاده از
\(lq+service_name\(rq
یک نام سرویس PAM دیگر به مجموعه پیش‌فرض افزود یا با استفاده از
\(lq\-service_name\(rq
یک نام سرویس PAM را صراحتاً از مجموعه پیش‌فرض حذف کرد\&. برای مثال، به‌منظور جایگزینی یک نام سرویس PAM پیش‌فرض برای این حق ورود (مانند
\(lqsshd\(rq)
با یک نام سرویس PAM سفارشی (مانند
\(lqmy_pam_service\(rq)،
می‌توان از پیکربندی زیر استفاده کرد:
.sp
.if n \{\
.RS 4
.\}
.nf
ad_gpo_map_remote_interactive = +my_pam_service, \-sshd
                            
.fi
.if n \{\
.RE
.\}
.sp
پیش‌فرض: مجموعه پیش‌فرض نام‌های سرویس PAM شامل موارد زیر است:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
sshd
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
cockpit
.RE
.sp
.RE
.PP
ad_gpo_map_network (رشته)
.RS 4
فهرستی از نام‌های سرویس PAM جداشده با کاما که کنترل دسترسی مبتنی بر GPO برای آن‌ها بر اساس تنظیمات خط‌مشی NetworkLogonRight و DenyNetworkLogonRight ارزیابی می‌شود\&. تنها GPOهایی ارزیابی می‌شوند که کاربر برای آن‌ها مجوز Read و Apply Group Policy داشته باشد (گزینه
\(lqad_gpo_access_control\(rq
را ببینید)\&. اگر یک GPO ارزیابی‌شده حاوی تنظیم منع ورود از طریق شبکه برای کاربر یا یکی از گروه‌های آن باشد، دسترسی ورود از طریق شبکه به کاربر داده نخواهد شد\&. اگر در هیچ‌یک از GPOهای ارزیابی‌شده مجوزی برای ورود از طریق شبکه تعریف نشده باشد، به کاربر دسترسی ورود داده می‌شود\&. اگر حداقل یک GPO ارزیابی‌شده حاوی تنظیمات حق ورود از طریق شبکه باشد، دسترسی ورود تنها در صورتی به کاربر داده می‌شود که خود کاربر یا حداقل یکی از گروه‌های آن بخشی از تنظیمات خط‌مشی باشند\&.
.sp
نکته: در Group Policy Management Editor، این مقدار تحت عناوین "Access this computer from the network" و "Deny access to this computer from the network" نامیده می‌شود\&.
.sp
می‌توان با استفاده از
\(lq+service_name\(rq
یک نام سرویس PAM دیگر به مجموعه پیش‌فرض افزود یا با استفاده از
\(lq\-service_name\(rq
یک نام سرویس PAM را صراحتاً از مجموعه پیش‌فرض حذف کرد\&. برای مثال، به‌منظور جایگزینی یک نام سرویس PAM پیش‌فرض برای این حق ورود (مانند
\(lqftp\(rq)
با یک نام سرویس PAM سفارشی (مانند
\(lqmy_pam_service\(rq)،
می‌توان از پیکربندی زیر استفاده کرد:
.sp
.if n \{\
.RS 4
.\}
.nf
ad_gpo_map_network = +my_pam_service, \-ftp
                            
.fi
.if n \{\
.RE
.\}
.sp
پیش‌فرض: مجموعه پیش‌فرض نام‌های سرویس PAM شامل موارد زیر است:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
ftp
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
samba
.RE
.sp
.RE
.PP
ad_gpo_map_batch (string)
.RS 4
فهرستی از نام‌های سرویس PAM جداشده با کاما که کنترل دسترسی مبتنی بر GPO برای آن‌ها بر اساس تنظیمات خط‌مشی BatchLogonRight و DenyBatchLogonRight ارزیابی می‌شود\&. تنها آن دسته از GPOهایی ارزیابی می‌شوند که کاربر مجوز Read و Apply Group Policy را برای آن‌ها داشته باشد (گزینه
\(lqad_gpo_access_control\(rq
را ببینید)\&. اگر یک GPO ارزیابی‌شده حاوی تنظیم رد ورود دسته‌ای (deny batch logon) برای کاربر یا یکی از گروه‌هایش باشد، دسترسی ورود دسته‌ای کاربر رد می‌شود\&. اگر هیچ‌یک از GPOهای ارزیابی‌شده دارای حق ورود دسته‌ای تعریف‌شده نباشد، به کاربر دسترسی ورود داده می‌شود\&. اگر دست‌کم یک GPO ارزیابی‌شده شامل تنظیمات حق ورود دسته‌ای باشد، کاربر تنها در صورتی مجاز به ورود است که خود یا حداقل یکی از گروه‌هایش بخشی از تنظیمات این خط‌مشی باشند\&.
.sp
نکته: در Group Policy Management Editor این مقدار \(lqAllow log on as a batch job\(rq و \(lqDeny log on as a batch job\(rq نامیده می‌شود\&.
.sp
می‌توان با استفاده از
\(lq+service_name\(rq
یک نام سرویس PAM دیگر را به مجموعه پیش‌فرض افزود یا با استفاده از
\(lq\-service_name\(rq
صریحاً یک نام سرویس PAM را از مجموعه پیش‌فرض حذف کرد\&. برای نمونه، جهت جایگزین کردن یک نام سرویس پیش‌فرض PAM برای این حق ورود (مانند
\(lqcrond\(rq)
با یک نام سرویس pam سفارشی (مانند
\(lqmy_pam_service\(rq)،
از پیکربندی زیر استفاده می‌شود:
.sp
.if n \{\
.RS 4
.\}
.nf
ad_gpo_map_batch = +my_pam_service, \-crond
                            
.fi
.if n \{\
.RE
.\}
.sp
نکته: نام سرویس Cron ممکن است بسته به توزیع لینوکس مورد استفاده متفاوت باشد\&.
.sp
پیش‌فرض: مجموعه پیش‌فرض نام‌های سرویس PAM شامل موارد زیر است:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
crond
.RE
.sp
.RE
.PP
ad_gpo_map_service (string)
.RS 4
فهرستی از نام‌های سرویس PAM جداشده با کاما که کنترل دسترسی مبتنی بر GPO برای آن‌ها بر اساس تنظیمات خط‌مشی ServiceLogonRight و DenyServiceLogonRight ارزیابی می‌شود\&. تنها آن دسته از GPOهایی ارزیابی می‌شوند که کاربر مجوز Read و Apply Group Policy را برای آن‌ها داشته باشد (گزینه
\(lqad_gpo_access_control\(rq
را ببینید)\&. اگر یک GPO ارزیابی‌شده حاوی تنظیم رد ورود سرویس (deny service logon) برای کاربر یا یکی از گروه‌هایش باشد، دسترسی ورود سرویس کاربر رد می‌شود\&. اگر هیچ‌یک از GPOهای ارزیابی‌شده دارای حق ورود سرویس تعریف‌شده نباشد، به کاربر دسترسی ورود داده می‌شود\&. اگر دست‌کم یک GPO ارزیابی‌شده شامل تنظیمات حق ورود سرویس باشد، کاربر تنها در صورتی مجاز به ورود است که خود یا حداقل یکی از گروه‌هایش بخشی از تنظیمات این خط‌مشی باشند\&.
.sp
نکته: در Group Policy Management Editor این مقدار \(lqAllow log on as a service\(rq و \(lqDeny log on as a service\(rq نامیده می‌شود\&.
.sp
می‌توان با استفاده از
\(lq+service_name\(rq
یک نام سرویس PAM را به مجموعه پیش‌فرض افزود\&. از آن‌جا که مجموعه پیش‌فرض خالی است، حذف نام سرویس PAM از مجموعه پیش‌فرض امکان‌پذیر نیست\&. برای نمونه، جهت افزودن یک نام سرویس pam سفارشی (مانند
\(lqmy_pam_service\(rq)،
از پیکربندی زیر استفاده می‌شود:
.sp
.if n \{\
.RS 4
.\}
.nf
ad_gpo_map_service = +my_pam_service
                            
.fi
.if n \{\
.RE
.\}
.sp
پیش‌فرض: تنظیم نشده است
.RE
.PP
ad_gpo_map_permit (string)
.RS 4
فهرستی از نام‌های سرویس PAM جداشده با کاما که دسترسی مبتنی بر GPO برای آن‌ها همیشه مجاز دانسته می‌شود، صرف‌نظر از هرگونه GPO Logon Rights\&.
.sp
می‌توان با استفاده از
\(lq+service_name\(rq
یک نام سرویس PAM دیگر را به مجموعه پیش‌فرض افزود یا با استفاده از
\(lq\-service_name\(rq
صریحاً یک نام سرویس PAM را از مجموعه پیش‌فرض حذف کرد\&. برای نمونه، جهت جایگزین کردن یک نام سرویس پیش‌فرض PAM برای دسترسی بدون قید و شرط مجاز (مانند
\(lqsudo\(rq)
با یک نام سرویس pam سفارشی (مانند
\(lqmy_pam_service\(rq)،
از پیکربندی زیر استفاده می‌شود:
.sp
.if n \{\
.RS 4
.\}
.nf
ad_gpo_map_permit = +my_pam_service, \-sudo
                            
.fi
.if n \{\
.RE
.\}
.sp
پیش‌فرض: مجموعه پیش‌فرض نام‌های سرویس PAM شامل موارد زیر است:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
polkit\-1
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
sudo
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
sudo\-i
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
systemd\-user
.RE
.sp
.RE
.PP
ad_gpo_map_deny (string)
.RS 4
فهرستی از نام‌های سرویس PAM جداشده با کاما که دسترسی مبتنی بر GPO برای آن‌ها همیشه رد می‌شود، صرف‌نظر از هرگونه GPO Logon Rights\&.
.sp
می‌توان با استفاده از
\(lq+service_name\(rq
یک نام سرویس PAM را به مجموعه پیش‌فرض افزود\&. از آن‌جا که مجموعه پیش‌فرض خالی است، حذف نام سرویس PAM از مجموعه پیش‌فرض امکان‌پذیر نیست\&. برای نمونه، جهت افزودن یک نام سرویس pam سفارشی (مانند
\(lqmy_pam_service\(rq)،
از پیکربندی زیر استفاده می‌شود:
.sp
.if n \{\
.RS 4
.\}
.nf
ad_gpo_map_deny = +my_pam_service
                            
.fi
.if n \{\
.RE
.\}
.sp
پیش‌فرض: تنظیم نشده است
.RE
.PP
ad_gpo_default_right (string)
.RS 4
این گزینه نحوه ارزیابی کنترل دسترسی را برای نام‌های سرویس PAM که صریحاً در یکی از گزینه‌های ad_gpo_map_* فهرست نشده‌اند، مشخص می‌کند\&. این گزینه را می‌توان به دو روش مختلف تنظیم کرد\&. نخست، این گزینه می‌تواند برای استفاده از یک حق ورود پیش‌فرض تنظیم شود\&. برای نمونه، اگر این گزینه روی \*(Aqinteractive\*(Aq تنظیم شود، به این معنی است که نام‌های سرویس PAM نگاشت‌نشده بر اساس تنظیمات خط‌مشی InteractiveLogonRight و DenyInteractiveLogonRight پردازش خواهند شد\&. در حالت دیگر، می‌توان این گزینه را طوری تنظیم کرد که همواره دسترسی برای نام‌های سرویس PAM نگاشت‌نشده را مجاز دانسته یا همیشه رد کند\&.
.sp
مقادیر پشتیبانی‌شده برای این گزینه شامل موارد زیر است:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
interactive
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
remote_interactive
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
network
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
batch
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
service
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
permit
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
deny
.RE
.sp
پیش‌فرض: deny
.RE
.PP
ad_maximum_machine_account_password_age (عدد صحیح)
.RS 4
‏SSSD روزی یک بار بررسی می‌کند که آیا سن گذرواژهٔ حساب ماشین از مقدار ارائه‌شده بر حسب روز بیشتر است یا خیر، و برای تمدید آن تلاش می‌کند\&. مقدار 0 تلاش برای تمدید را غیرفعال می‌کند\&.
.sp
پیش‌فرض: ۳۰ روز
.RE
.PP
ad_machine_account_password_renewal_opts (رشته)
.RS 4
این گزینه تنها باید برای آزمودن وظیفهٔ تمدید حساب ماشین استفاده شود\&. این گزینه ۳ عدد صحیح و یک رشته را که با دو نقطه (\*(Aq:\*(Aq) جدا شده‌اند می‌پذیرد\&. عدد صحیح نخست، فاصلهٔ زمانی به ثانیه را برای چگونگی اجرای متناوب این وظیفه تعیین می‌کند\&. عدد دوم، مهلت زمانی اولیه را بر حسب ثانیه پیش از نخستین اجرای وظیفه پس از راه‌اندازی مشخص می‌کند\&. مقدار سوم اختیاری، بیشینهٔ آفست تصادفی را نسبت به دو مقدار پیشین تعیین می‌کند تا از به‌روزرسانی هم‌زمان چندین میزبان جلوگیری شود (مسئلهٔ \(lqthundering herd\(rq)\&. اگر این مقدار در رشتهٔ مقدار موجود نباشد یا خالی باشد، \*(Aq0\*(Aq استفاده خواهد شد\&.
.sp
چهارمین مقدار اختیاری رشته، فایل باینری کمکی را که باید برای تمدید استفاده شود تعیین می‌کند\&. در حال حاضر
\fBadcli\fR
و
\fBrealm\fR
پشتیبانی می‌شوند\&. اگر این مقدار در رشتهٔ مقدار موجود نباشد یا خالی باشد،
\fBrealm\fR
استفاده خواهد شد\&. از آنجا که برنامهٔ کمکی تحت همان کاربری که SSSD با آن اجرا می‌شود اجرا می‌گردد، این احتمال وجود دارد که اگر این کاربر دسترسی‌های لازم برای تغییر فایل keytab محل ذخیرهٔ اعتبارنامه‌های حساب ماشین را نداشته باشد، تمدید با شکست مواجه شود\&. این وضعیت معمولاً برای
\fBadcli\fR
رخ می‌دهد\&.
.sp
ابزار
\fBrealm\fR
فایل keytab را مستقیماً به‌روزرسانی نمی‌کند، بلکه فرایند
\fBrealmd\fR
را که تحت کاربر root اجرا می‌شود برای این وظیفه فراخوانی می‌کند\&.
\fBrealmd\fR
می‌تواند با کمک PolicyKit به کاربران غیرممتاز اجازهٔ دسترسی دهد و SSSD به‌طور پیش‌فرض قواعد مناسبی را برای کاربری که SSSD تحت آن اجرا می‌شود فراهم می‌کند\&.
.sp
پیش‌فرض: 86400:750:300:realm (۲۴ ساعت، ۱۲ دقیقه و ۳۰ ثانیه، و ۵ دقیقه)
.RE
.PP
ad_update_samba_machine_account_password (بولی)
.RS 4
در صورت فعال بودن، هنگامی که SSSD گذرواژهٔ حساب ماشین را تمدید می‌کند، در پایگاه دادهٔ Samba نیز به‌روزرسانی می‌شود\&. این کار از منقضی شدن نسخهٔ گذرواژهٔ حساب ماشین در Samba هنگامی که برای احراز هویت با AD پیکربندی شده است جلوگیری می‌کند\&.
.sp
پیش‌فرض: false
.RE
.PP
ad_use_ldaps (بولی)
.RS 4
به‌طور پیش‌فرض SSSD از درگاه متنی سادهٔ LDAP یعنی 389 و درگاه Global Catalog یعنی 3628 استفاده می‌کند\&. اگر این گزینه روی True تنظیم شود، SSSD از درگاه LDAPS یعنی 636 و درگاه Global Catalog یعنی 3629 به همراه حفاظت LDAPS استفاده خواهد کرد\&. از آنجا که AD اجازهٔ داشتن چندین لایهٔ رمزنگاری را روی یک اتصال نمی‌دهد و ما همچنان می‌خواهیم از SASL/GSSAPI یا SASL/GSS\-SPNEGO برای احراز هویت استفاده کنیم، ویژگی امنیتی SASL یعنی maxssf برای این اتصال‌ها روی 0 (صفر) تنظیم می‌شود\&.
.sp
پیش‌فرض: False
.RE
.PP
dyndns_update (بولی)
.RS 4
اختیاری\&. این گزینه به SSSD اعلام می‌کند که کارگزار DNS در Active Directory را به‌طور خودکار با آدرس IP این کلاینت به‌روزرسانی کند\&. این به‌روزرسانی با استفاده از GSS\-TSIG ایمن می‌شود\&. در نتیجه، مدیر Active Directory تنها باید به‌روزرسانی‌های امن را برای ناحیهٔ (zone) مربوط به DNS مجاز کند\&. در صورتی که با استفاده از گزینهٔ
\(lqdyndns_iface\(rq
طور دیگری تعیین نشده باشد، از آدرس IP مربوط به اتصال AD LDAP برای به‌روزرسانی‌ها استفاده می‌شود\&.
.sp
نکته: در سیستم‌های قدیمی‌تر (مانند RHEL 5)، برای عملکرد مطمئن این سازوکار، realm پیش‌فرض Kerberos باید به درستی در /etc/krb5\&.conf تنظیم شده باشد\&.
.sp
پیش‌فرض: true
.RE
.PP
dyndns_ttl (عدد صحیح)
.RS 4
مقدار TTL جهت اعمال روی رکورد DNS کلاینت هنگام به‌روزرسانی آن\&. اگر dyndns_update برابر false باشد این گزینه تأثیری ندارد\&. این مقدار، در صورت تعیین شدن توسط مدیر در سمت سرور، TTL را رونویسی خواهد کرد\&.
.sp
پیش‌فرض: 3600 (ثانیه)
.RE
.PP
dyndns_iface (رشته)
.RS 4
اختیاری\&. تنها زمانی کاربرد دارد که dyndns_update برابر true باشد\&. رابط شبکه یا فهرستی از رابط‌ها را انتخاب کنید که آدرس‌های IP آن‌ها باید برای به‌روزرسانی‌های پویای DNS استفاده شوند\&. نام رابط می‌تواند یک الگوی عام (wildcard) باشد که برای مستثنی کردن رابط، پیشوند
\fI!\fR
می‌گیرد\&. اولین تطابق، ارزیابی را متوقف می‌کند\&. برای نمونه فهرست
\fI!eth1, *\fR
به SSSD دستور می‌دهد از تمامی رابط‌ها به جز
\fIeth1\fR
استفاده کند\&. برای جزئیات مربوط به الگوها به
\fIman 7 glob\fR
مراجعه کنید\&.
.sp
نکته: در حالی که هنوز استفاده از گزینهٔ قدیمی
\fIipa_dyndns_iface\fR
امکان‌پذیر است، کاربران باید در فایل پیکربندی خود به استفاده از
\fIdyndns_iface\fR
مهاجرت کنند\&.
.sp
پیش‌فرض: استفاده از آدرس‌های IP رابطی که برای اتصال AD LDAP استفاده می‌شود
.sp
مثال: dyndns_iface = em[12], !vnet1, vnet*
.RE
.PP
dyndns_address (رشته)
.RS 4
اختیاری\&. تنها زمانی کاربرد دارد که
\fIdyndns_update\fR
برابر true باشد\&. فهرستی از آدرس‌های IP یا شبکه‌های IP که باید برای به‌روزرسانی‌های پویای DNS استفاده شوند\&. آدرس‌های شبکه باید در قالب CIDR باشند\&. برای مشخص کردن موارد مستثنی، می‌توان به یک مدخل پیشوند
\fI!\fR
اضافه کرد\&. برای تعیین اینکه آیا یک آدرس شامل یا مستثنی شود، از
\fIبهترین تطابق\fR
استفاده می‌شود (یعنی پیشوند طولانی‌تر اولویت دارد)\&.
.sp
پیش‌فرض: بدون فیلتر کردن آدرس‌های IP\&.
.sp
مثال: dyndns_address = 10\&.0\&.0\&.0/16, !10\&.0\&.1\&.0/24
.RE
.PP
dyndns_refresh_interval (عدد صحیح)
.RS 4
بک‌اند علاوه بر به‌روزرسانی خودکاری که هنگام برخط شدن انجام می‌دهد، هر چند وقت یک‌بار باید به‌روزرسانی دوره‌ای DNS را اجرا کند\&. این گزینه اختیاری است و تنها زمانی کاربرد دارد که dyndns_update برابر true باشد\&. توجه داشته باشید که کمترین مقدار ممکن ۶۰ ثانیه است؛ در صورتی که مقداری کمتر از ۶۰ وارد شود، پارامتر تنها کمترین مقدار را در نظر خواهد گرفت\&.
.sp
پیش‌فرض: 86400 (۲۴ ساعت)
.RE
.PP
dyndns_update_ptr (بولی)
.RS 4
مشخص می‌کند که آیا هنگام به‌روزرسانی رکوردهای DNS کلاینت، رکورد PTR نیز باید به‌صراحت به‌روزرسانی شود یا خیر\&. تنها زمانی کاربرد دارد که dyndns_update برابر true باشد\&.
.sp
توجه داشته باشید که پارامتر
\fIdyndns_update_per_family\fR
برای به‌روزرسانی‌های رکورد PTR اعمال نمی‌شود\&. این به‌روزرسانی‌ها همواره جداگانه ارسال می‌شوند\&.
.sp
پیش‌فرض: True
.RE
.PP
dyndns_force_tcp (بولی)
.RS 4
مشخص می‌کند که آیا ابزار nsupdate برای برقراری ارتباط با کارگزار DNS به‌طور پیش‌فرض از TCP استفاده کند یا خیر\&.
.sp
پیش‌فرض: False (اجازه به nsupdate برای انتخاب پروتکل)
.RE
.PP
dyndns_auth (رشته)
.RS 4
مشخص می‌کند که آیا ابزار nsupdate باید از احراز هویت GSS\-TSIG برای به‌روزرسانی‌های امن در ارتباط با کارگزار DNS استفاده کند یا خیر؛ به‌روزرسانی‌های ناامن را می‌توان با تنظیم این گزینه روی \*(Aqnone\*(Aq ارسال کرد\&.
.sp
پیش‌فرض: GSS\-TSIG
.RE
.PP
dyndns_auth_ptr (رشته)
.RS 4
مشخص می‌کند که آیا ابزار nsupdate باید از احراز هویت GSS\-TSIG برای به‌روزرسانی‌های امن PTR در ارتباط با کارگزار DNS استفاده کند یا خیر؛ به‌روزرسانی‌های ناامن را می‌توان با تنظیم این گزینه روی \*(Aqnone\*(Aq ارسال کرد\&.
.sp
پیش‌فرض: همانند dyndns_auth
.RE
.PP
dyndns_server (رشته)
.RS 4
کارگزار DNS مورد استفاده هنگام انجام به‌روزرسانی DNS\&. در بیشتر ساختارها، توصیه می‌شود این گزینه بدون مقدار رها شود\&.
.sp
تنظیم این گزینه برای محیط‌هایی مناسب است که کارگزار DNS با کارگزار هویت تفاوت دارد، یا زمانی که از DNS رمزگذاری‌شده استفاده می‌کنیم\&.
.sp
این پارامتر می‌تواند یک رشتهٔ ساده شامل نام DNS یا آدرس IP باشد\&. همچنین می‌تواند یک URI باشد\&. این URI می‌تواند شبیه
\fIdns://servername/\fR
یا
\fIdns+tls://1\&.2\&.3\&.4:853#servername/\fR
باشد\&.
.sp
مثال دوم پروتکل DNS\-over\-TLS را برای به‌روزرسانی‌های DNS فعال می‌کند\&. ابزار nsupdate باید از DoT پشتیبانی کند \- پیش از فعال‌سازی آن در SSSD،
\fIman nsupdate\fR
را بررسی کنید\&.
.sp
لطفاً توجه داشته باشید که این گزینه تنها در تلاش جایگزین (fallback) هنگامی که تلاش پیشین با استفاده از تنظیمات به‌طور خودکار شناسایی‌شده شکست بخورد، یا زمانی که DNS\-over\-TLS فعال باشد استفاده خواهد شد\&.
.sp
پیش‌فرض: None (اجازه به nsupdate برای انتخاب کارگزار)
.RE
.PP
dyndns_update_per_family (بولی)
.RS 4
به‌روزرسانی DNS به‌طور پیش‌فرض در دو مرحله انجام می‌شود \- به‌روزرسانی IPv4 و سپس به‌روزرسانی IPv6\&. در برخی موارد ممکن است انجام به‌روزرسانی IPv4 و IPv6 در یک مرحله مطلوب باشد\&.
.sp
پیش‌فرض: true
.RE
.PP
dyndns_dot_cacert (رشته)
.RS 4
این گزینه فایل مربوط به گواهی‌های مراجع صدور گواهی (در قالب PEM) را جهت تأیید اعتبار گواهی TLS کارگزار راه دور هنگام استفاده از DoT مشخص می‌کند\&.
.sp
پیش‌فرض: None (استفاده از مخزن سراسری گواهی‌ها)
.RE
.PP
dyndns_dot_cert (رشته)
.RS 4
این گزینه فایل گواهی(ها) را برای احراز هویت در بستر انتقال DoT به کارگزار راه دور تعیین می‌کند\&. فایل زنجیرهٔ گواهی باید در قالب PEM باشد\&.
.sp
گزینه‌های
\fIdyndns_dot_cert\fR
و
\fIdyndns_dot_key\fR
هر دو باید تعیین شوند تا احراز هویت دوطرفهٔ TLS حاصل شود\&.
.sp
پیش‌فرض: None (عدم استفاده از احراز هویت TLS)
.RE
.PP
dyndns_dot_key (رشته)
.RS 4
این گزینه فایل کلید را برای رمزنگاری احراز هویت‌شده در بستر انتقال DoT به کارگزار راه دور تعیین می‌کند\&. فایل کلید خصوصی باید در قالب PEM باشد\&.
.sp
پیش‌فرض: None (عدم استفاده از احراز هویت TLS)
.RE
.PP
override_homedir (رشته)
.RS 4
دایرکتوری خانگی کاربر را جایگزین می‌کند\&. می‌توانید یک مقدار مطلق یا یک الگو ارائه دهید\&. در الگو، دنباله‌های زیر جایگزین می‌شوند:
.PP
%u
.RS 4
نام ورود
.RE
.PP
%U
.RS 4
شماره UID
.RE
.PP
%d
.RS 4
نام دامنه
.RE
.PP
%f
.RS 4
نام کامل و واجد شرایط کاربر (user@domain)
.RE
.PP
%l
.RS 4
حرف نخست نام ورود\&.
.RE
.PP
%P
.RS 4
شناسهٔ UPN \- User Principal Name (name@REALM)
.RE
.PP
%o
.RS 4
مقدار homedir که در دایرکتوری ارائه‌دهندهٔ هویت تعریف شده است\&.
.sp
این جایگزینی برای استفاده در سناریوی اعتمادسازی IPA\-AD طراحی شده است\&. اگر این جایگزینی برای گزینهٔ
\fIsubdomain_homedir\fR
استفاده شود، مقدار دایرکتوری خانگی را از دامنهٔ AD به کلاینت‌های IPA انتشار می‌دهد\&. در این سناریو، این گزینه باید در پیکربندی SSSD روی سرور IPA که SSSD در آن در حالت کارگزار (server mode) اجرا می‌شود تنظیم گردد\&.
.RE
.PP
%h
.RS 4
مسیر تعریف‌شده برای مشخصهٔ دایرکتوری homedir در ارائه‌دهندهٔ هویت، اما با حروف کوچک\&. برای جزئیات کاربرد، به
\fI%o\fR
مراجعه کنید\&.
.RE
.PP
%H
.RS 4
مقدار گزینهٔ پیکربندی
\fIhomedir_substring\fR\&.
.RE
.PP
%%
.RS 4
نویسهٔ تحت‌اللفظی \*(Aq%\*(Aq
.RE
.sp
این گزینه همچنین می‌تواند به ازای هر دامنه تنظیم شود\&.
.sp
مثال:
.sp
.if n \{\
.RS 4
.\}
.nf
override_homedir = /home/%u
        
.fi
.if n \{\
.RE
.\}
.sp
پیش‌فرض: تنظیم‌نشده (SSSD از مقدار دریافت‌شده از LDAP استفاده خواهد کرد)
.sp
لطفاً توجه داشته باشید، دایرکتوری خانگی برگرفته از یک جایگزینی مشخص برای کاربر، خواه به‌صورت محلی (نگاه کنید به
\fBsss_override\fR(8)) یا id\-overrideهای IPA مدیریت‌شده به‌طور متمرکز، اولویت بالاتری دارد و به‌جای مقدار ارائه‌شده توسط override_homedir استفاده خواهد شد\&.
.RE
.PP
homedir_substring (رشته)
.RS 4
مقدار این گزینه در بسط گزینهٔ
\fIoverride_homedir\fR
استفاده خواهد شد اگر الگو حاوی رشتهٔ قالب‌بندی
\fI%H\fR
باشد\&. یک مدخل دایرکتوری LDAP می‌تواند مستقیماً حاوی این الگو باشد تا بتوان از این گزینه برای بسط مسیر دایرکتوری خانگی برای هر ماشین کلاینت (یا سیستم‌عامل) استفاده کرد\&. این گزینه می‌تواند به ازای هر دامنه یا به‌صورت سراسری در بخش [nss] تنظیم شود\&. مقدار مشخص‌شده در یک بخش دامنه، مقدار تنظیم‌شده در بخش [nss] را بازنویسی خواهد کرد\&.
.sp
پیش‌فرض: /home
.RE
.PP
krb5_confd_path (رشته)
.RS 4
مسیر مطلق دایرکتوری‌ای که SSSD باید قطعه‌های پیکربندی Kerberos را در آن قرار دهد\&.
.sp
برای غیرفعال کردن ایجاد قطعه‌های پیکربندی، پارامتر را روی \*(Aqnone\*(Aq تنظیم کنید\&.
.sp
پیش‌فرض: تنظیم‌نشده (زیردایرکتوری krb5\&.include\&.d از دایرکتوری pubconf مربوط به SSSD)
.RE
.SH "گزینه‌های پیش‌فرض تغییریافته (MODIFIED DEFAULT OPTIONS)"
.PP
پیش‌فرض برخی از گزینه‌ها با مقادیر پیش‌فرض ارائه‌دهندهٔ بک‌اند مربوطه‌شان مطابقت ندارد؛ این نام‌های گزینه‌ها و مقادیر پیش‌فرض ویژهٔ ارائه‌دهندهٔ AD در زیر فهرست شده‌اند:
.SS "ارائه‌دهنده KRB5 (KRB5 Provider)"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
krb5_validate = true
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
krb5_use_enterprise_principal = true
.RE
.SS "ارائه‌دهنده LDAP (LDAP Provider)"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
ldap_schema = ad
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
ldap_force_upper_case_realm = true
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
ldap_id_mapping = true
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
ldap_sasl_mech = GSS\-SPNEGO
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
ldap_referrals = false
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
ldap_account_expire_policy = ad
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
ldap_use_tokengroups = true
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
ldap_sasl_authid = sAMAccountName@REALM (معمولاً SHORTNAME$@REALM)
.sp
ارائه‌دهندهٔ AD به‌طور پیش‌فرض به دنبال پرینسیپالی متفاوت از ارائه‌دهندهٔ LDAP می‌گردد، زیرا در یک محیط Active Directory پرینسیپال‌ها به دو گروه تقسیم می‌شوند \- پرینسیپال‌های کاربر (User Principals) و پرینسیپال‌های سرویس (Service Principals)\&. تنها پرینسیپال کاربر می‌تواند برای دریافت TGT استفاده شود و به‌طور پیش‌فرض، پرینسیپال شیء رایانه از sAMAccountName آن و realm مربوط به AD ساخته می‌شود\&. پرینسیپال شناخته‌شدهٔ host/hostname@REALM یک پرینسیپال سرویس است و بنابراین نمی‌توان از آن برای دریافت TGT استفاده کرد\&.
.RE
.SS "پیکربندی NSS (NSS configuration)"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
fallback_homedir = /home/%d/%u
.sp
ارائه‌دهندهٔ AD به‌طور خودکار "fallback_homedir = /home/%d/%u" را تنظیم می‌کند تا دایرکتوری‌های خانگی شخصی را برای کاربرانی که فاقد مشخصهٔ homeDirectory هستند فراهم کند\&. اگر دامنهٔ AD شما به‌درستی با مشخصه‌های Posix مقداردهی شده باشد، و می‌خواهید از این رفتار جایگزین (fallback) جلوگیری کنید، می‌توانید صراحتاً "fallback_homedir = %o" را تنظیم کنید\&.
.sp
توجه داشته باشید که سیستم معمولاً انتظار دارد دایرکتوری خانگی در پوشهٔ /home/%u باشد\&. اگر تصمیم بگیرید از ساختار دایرکتوری متفاوتی استفاده کنید، ممکن است برخی دیگر از بخش‌های سیستم شما نیاز به تنظیم داشته باشند\&.
.sp
برای مثال ایجاد خودکار دایرکتوری‌های خانگی در ترکیب با selinux نیازمند تنظیمات selinux است، در غیر این صورت دایرکتوری خانگی با کانتکست (context) نادرست selinux ایجاد خواهد شد\&.
.RE
.SH "جایگزینی هنگام خرابی (FAILOVER)"
.PP
ویژگی جایگزینی هنگام خرابی به بک‌اندها اجازه می‌دهد در صورت از کار افتادن سرور فعلی، به‌طور خودکار به یک سرور دیگر سوییچ کنند\&.
.SS "نحو جایگزینی هنگام خرابی"
.PP
فهرست سرورها به‌صورت فهرستی جداشده با کاما مشخص می‌شود؛ قرار دادن هر تعداد فاصله اطراف کاما مجاز است\&. سرورها به ترتیب اولویت فهرست می‌شوند\&. فهرست می‌تواند شامل هر تعداد سرور باشد\&.
.PP
به ازای هر گزینهٔ پیکربندی دارای قابلیت جایگزینی هنگام خرابی، دو نوع وجود دارد:
\fIprimary\fR
و
\fIbackup\fR\&.
ایده این است که سرورهای موجود در فهرست اصلی (primary) اولویت دارند و سرورهای پشتیبان (backup) تنها در صورتی جستجو می‌شوند که هیچ سرور اصلی در دسترس نباشد\&. اگر یک سرور پشتیبان انتخاب شود، مهلت زمانی ۳۱ ثانیه‌ای تعیین می‌شود\&. پس از این مهلت زمانی، SSSD به‌صورت دوره‌ای تلاش می‌کند تا دوباره به یکی از سرورهای اصلی متصل شود\&. در صورت موفقیت، سرور اصلی جایگزین سرور فعال فعلی (پشتیبان) خواهد شد\&.
.SS "سازوکار جایگزینی هنگام خرابی"
.PP
سازوکار جایگزینی هنگام خرابی میان یک ماشین و یک سرویس تمایز قائل می‌شود\&. بک‌اند ابتدا تلاش می‌کند نام میزبان یک ماشین مشخص را تحلیل کند؛ اگر این تلاش ناموفق باشد، ماشین آفلاین تلقی می‌شود\&. هیچ تلاش دیگری برای اتصال به این ماشین برای هیچ سرویس دیگری انجام نخواهد شد\&. در صورت موفقیت‌آمیز بودن تحلیل نام، بک‌اند تلاش می‌کند به یک سرویس روی آن ماشین متصل شود\&. اگر تلاش برای اتصال به سرویس ناموفق باشد، فقط همان سرویس خاص آفلاین در نظر گرفته می‌شود و بک‌اند به‌طور خودکار به سرویس بعدی سوییچ می‌کند\&. ماشین همچنان آنلاین تلقی شده و ممکن است برای سرویس دیگری دوباره امتحان شود\&.
.PP
تلاش‌های بعدی برای اتصال به ماشین‌ها یا سرویس‌هایی که آفلاین علامت‌گذاری شده‌اند پس از گذشت یک بازهٔ زمانی مشخص انجام می‌شود؛ این بازه در حال حاضر به‌صورت ثابت روی ۳۰ ثانیه تنظیم شده است\&.
.PP
اگر ماشین دیگری برای امتحان وجود نداشته باشد، کل بک‌اند به حالت آفلاین می‌رود و سپس هر ۳۰ ثانیه برای برقراری مجدد اتصال تلاش می‌کند\&.
.SS "مهلت‌های زمانی و تنظیم جایگزینی هنگام خرابی"
.PP
تحلیل سرور برای اتصال می‌تواند به سادگی اجرای یک پرس‌وجوی DNS منفرد باشد، یا ممکن است شامل چندین مرحله مانند یافتن سایت درست یا امتحان چندین نام میزبان در صورت عدم دسترسی به برخی سرورهای پیکربندی‌شده باشد\&. سناریوهای پیچیده‌تر ممکن است زمان‌بر باشند و 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 ویژه، سرورهای مناسب را برای اتصال به‌طور خودکار پیدا کنند\&. این ویژگی برای سرورهای پشتیبان (backup) پشتیبانی نمی‌شود\&.
.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
ویژگی ID\-mapping به SSSD امکان می‌دهد به عنوان کلاینت Active Directory عمل کند، بدون نیاز به اینکه مدیران سیستم ویژگی‌های کاربر را برای پشتیبانی از مشخصه‌های POSIX جهت شناسه‌های کاربر و گروه توسعه دهند\&.
.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
پیکربندی پیش‌فرض منجر به تنظیم 10,000 برش می‌شود که هر کدام گنجایش حداکثر 200,000 شناسه را دارند؛ این بازه از 200,000 آغاز شده و تا 2,000,200,000 ادامه می‌یابد\&. این مقدار برای بیشتر پیاده‌سازی‌ها کافی خواهد بود\&.
.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 از جستجوی نام‌های SIDهای شناخته‌شده (Well\-Known SIDs)، یعنی SIDهایی با معانی خاص و ثابت (hardcoded)، پشتیبانی می‌کند\&. از آنجا که کاربران و گروه‌های عمومی مرتبط با این Well\-Known SIDها هیچ معادلی در محیط Linux/UNIX ندارند، هیچ شناسهٔ POSIXی برای این اشیاء در دسترس نیست\&.
.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
نسخه با حروف بزرگ این نام‌ها هنگام بازگرداندن نام کاملاً مشخص (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 به‌درستی پیکربندی شده و example\&.com یکی از دامنه‌ها در بخش
\fI[sssd]\fR
است\&. این مثال فقط گزینه‌های اختصاصی ارائه‌دهندهٔ AD را نشان می‌دهد\&.
.PP
.if n \{\
.RS 4
.\}
.nf
[domain/EXAMPLE]
id_provider = ad
auth_provider = ad
access_provider = ad
chpass_provider = ad

ad_server = dc1\&.example\&.com
ad_hostname = client\&.example\&.com
ad_domain = example\&.com
.fi
.if n \{\
.RE
.\}
.sp
.SH "نکات (NOTES)"
.PP
ارائه‌دهندهٔ کنترل دسترسی AD بررسی می‌کند که آیا حساب کاربری منقضی شده است یا خیر\&. این عملکرد تأثیری مشابه پیکربندی زیر در ارائه‌دهندهٔ LDAP دارد:
.sp
.if n \{\
.RS 4
.\}
.nf
access_provider = ldap
ldap_access_order = expire
ldap_account_expire_policy = ad
.fi
.if n \{\
.RE
.\}
.PP
با این حال، مگر اینکه ارائه‌دهندهٔ کنترل دسترسی
\(lqad\(rq
به‌صورت صریح پیکربندی شده باشد، ارائه‌دهندهٔ دسترسی پیش‌فرض
\(lqpermit\(rq
است\&. لطفاً توجه داشته باشید اگر ارائه‌دهندهٔ کنترلی به‌جز
\(lqad\(rq
را پیکربندی کنید، باید تمام پارامترهای اتصال (مانند URIهای LDAP و جزئیات رمزنگاری) را دستی تنظیم کنید\&.
.PP
هنگامی که ارائه‌دهندهٔ autofs روی
\(lqad\(rq
تنظیم شده باشد، نگاشت ویژگی شِمای RFC2307 (از جمله nisMap، nisObject و غیره) استفاده می‌شود، زیرا این ویژگی‌ها در شِمای پیش‌فرض Active Directory گنجانده شده‌اند\&.
.PP
.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
.SH "نکات (NOTES)"
.IP " 1." 4
گروه‌های امنیتی Active Directory
.RS 4
\%https://docs.microsoft.com/en-us/windows-server/identity/ad-ds/manage/understand-security-groups
.RE
.IP " 2." 4
بخش افزونه‌های LDAP در [MS-ADTS]
.RS 4
\%https://msdn.microsoft.com/en-us/library/cc223367.aspx
.RE