'\" t
.\"     Title: sssd_krb5_locator_plugin
.\"    Author: The SSSD upstream - https://github.com/SSSD/sssd/
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 06/09/2026
.\"    Manual: SSSD Manual pages
.\"    Source: SSSD
.\"  Language: Persian
.\"
.TH "SSSD_KRB5_LOCATOR_PL" "8" "06/09/2026" "SSSD" "SSSD Manual pages"
.\" -----------------------------------------------------------------
.\" * 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_krb5_locator_plugin \- افزونه مکان‌یاب کربروس (Kerberos)
.SH "توضیحات (DESCRIPTION)"
.PP
افزونه مکان‌یاب کربروس
\fBsssd_krb5_locator_plugin\fR
توسط libkrb5 برای یافتن KDCها جهت یک قلمرو (realm) مشخص کربروس به کار می‌رود\&. برنامه SSSD چنین افزونه‌ای را فراهم می‌کند تا تمام کلاینت‌های کربروس روی یک سیستم را به سمت یک KDC واحد هدایت کند\&. به‌طور کلی نباید تفاوتی داشته باشد که یک فرآیند کلاینت با کدام KDC ارتباط برقرار می‌کند\&. اما مواردی وجود دارد، برای نمونه پس از تغییر گذرواژه، که همه KDCها در وضعیت یکسانی نیستند، زیرا داده‌های جدید ابتدا باید تکثیر شوند\&. برای جلوگیری از شکست‌های غیرمنتظره در احراز هویت و حتی احتمال قفل شدن حساب کاربری، بهتر است تا جای ممکن با یک KDC واحد ارتباط برقرار شود\&.
.PP
کتابخانه libkrb5 افزونه مکان‌یاب را در زیرپوشه libkrb5 از دایرکتوری افزونه‌های کربروس جستجو خواهد کرد؛ برای جزئیات به plugin_base_dir در
\fBkrb5.conf\fR(5)
مراجعه کنید\&. این افزونه را فقط می‌توان با حذف فایل آن غیرفعال کرد\&. هیچ گزینه‌ای در پیکربندی کربروس برای غیرفعال کردن آن وجود ندارد\&. اما متغیر محیطی SSSD_KRB5_LOCATOR_DISABLE می‌تواند برای غیرفعال کردن افزونه برای دستورات مجزا استفاده شود\&. به عنوان روش جایگزین، گزینه krb5_use_kdcinfo=False در SSSD می‌تواند استفاده شود تا داده‌های مورد نیاز افزونه تولید نشوند\&. در این حالت افزونه همچنان فراخوانی می‌شود ولی هیچ داده‌ای در اختیار فراخواننده قرار نمی‌دهد تا libkrb5 بتواند به سایر روش‌های تعریف‌شده در krb5\&.conf بازگردد\&.
.PP
این افزونه اطلاعات مربوط به KDCهای یک قلمرو مشخص را از فایلی به نام
kdcinfo\&.REALM
می‌خواند\&. این فایل باید شامل یک یا چند نام DNS یا نشانی IP در قالب ده‌دهی نقطه‌دار IPv4 یا قالب هگزادسیمال IPv6 باشد\&. یک شماره پورت اختیاری می‌تواند با دو نقطه در انتها اضافه شود؛ در این حالت طبق معمول نشانی IPv6 باید درون کروشه قرار گیرد\&. ورودی‌های معتبر عبارتند از:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
kdc\&.example\&.com
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
kdc\&.example\&.com:321
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
1\&.2\&.3\&.4
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
5\&.6\&.7\&.8:99
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
2001:db8:85a3::8a2e:370:7334
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
[2001:db8:85a3::8a2e:370:7334]:321
.RE
.sp
بخش auth\-provider مربوط به krb5 در SSSD که توسط ارائه‌دهندگان IPA و AD نیز استفاده می‌شود، نشانی KDC فعلی یا کنترل‌کننده دامنه مورد استفاده SSSD را به این فایل اضافه می‌کند\&.
.PP
در محیط‌هایی با KDCهای فقط‌خواندنی و خواندنی\-نوشتنی، که در آن‌ها انتظار می‌رود کلاینت‌ها برای عملیات عمومی از نمونه‌های فقط‌خواندنی و تنها برای تغییرات پیکربندی مانند تغییر گذرواژه از KDC خواندنی\-نوشتنی استفاده کنند، از فایل
kpasswdinfo\&.REALM
نیز برای شناسایی KDCهای خواندنی\-نوشتنی استفاده می‌شود\&. اگر این فایل برای قلمرو مشخص‌شده وجود داشته باشد، محتوای آن توسط افزونه برای پاسخ به درخواست‌های سرور kpasswd یا kadmin یا KDC اصلی ویژه MIT Kerberos استفاده خواهد شد\&. اگر نشانی شامل شماره پورت باشد، پورت پیش‌فرض KDC یعنی ۸۸ برای مورد اخیر به کار گرفته می‌شود\&.
.SH "نکات (NOTES)"
.PP
همه پیاده‌سازی‌های کربروس از به‌کارگیری افزونه‌ها پشتیبانی نمی‌کنند\&. اگر
\fBsssd_krb5_locator_plugin\fR
روی سیستم شما در دسترس نیست، باید /etc/krb5\&.conf را ویرایش کنید تا تنظیمات کربروس شما اعمال شود\&.
.PP
اگر متغیر محیطی SSSD_KRB5_LOCATOR_DEBUG روی هر مقداری تنظیم شده باشد، پیام‌های اشکال‌زدایی به stderr فرستاده خواهند شد\&.
.PP
اگر متغیر محیطی SSSD_KRB5_LOCATOR_DISABLE روی هر مقداری تنظیم شده باشد، افزونه غیرفعال شده و تنها مقدار KRB5_PLUGIN_NO_HANDLE را به فراخواننده برمی‌گرداند\&.
.PP
اگر متغیر محیطی SSSD_KRB5_LOCATOR_IGNORE_DNS_FAILURES روی هر مقداری تنظیم شده باشد، افزونه تلاش خواهد کرد تا تمام نام‌های DNS در فایل kdcinfo را تحلیل (resolve) کند\&. به‌طور پیش‌فرض، افزونه با اولین شکست در تحلیل DNS، بلافاصله مقدار KRB5_PLUGIN_NO_HANDLE را به فراخواننده بازمی‌گرداند\&.
.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