'\" t
.\"     Title: sssd-idp
.\"    Author: The SSSD upstream - https://github.com/SSSD/sssd/
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 06/09/2026
.\"    Manual: قالب‌های فایل و قراردادها
.\"    Source: SSSD
.\"  Language: Persian
.\"
.TH "SSSD\-IDP" "5" "06/09/2026" "SSSD" "قالب‌های فایل و قراردادها"
.\" -----------------------------------------------------------------
.\" * 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-idp \- ارائه‌دهنده IdP در SSSD
.SH "توضیحات (DESCRIPTION)"
.PP
این صفحه راهنما، پیکربندی ارائه‌دهندهٔ IdP را برای
\fBsssd\fR(8)
توضیح می‌دهد\&. برای یک مرجع تفصیلی از ساختار نحوی (syntax)، به بخش
\(lqFILE FORMAT\(rq
در صفحه راهنمای
\fBsssd.conf\fR(5)
مراجعه کنید\&.
.PP
ارائه‌دهندهٔ IdP یک پس‌بخش (back end) است که برای اتصال به یک ارائه‌دهنده هویت (IdP) مبتنی بر OAuth 2\&.0 و REST استفاده می‌شود\&. از آنجا که محصولات ممکن است پیاده‌سازی‌های اختصاصی از REST API برای جستجوی مشخصه‌های کاربر و گروه داشته باشند، ممکن است به کدهای اختصاصی نیاز باشد؛ برای جزئیات به گزینهٔ
\(lqidp_type\(rq
مراجعه فرمایید\&.
.PP
ارائه‌دهنده‌های هویت (IdPها) معمولاً مشخصه‌های POSIX مانند شناسه کاربر (UID) یا شاخه خانگی (home directory) را ارائه نمی‌دهند\&. ارائه‌دهندهٔ IdP در SSSD مشخصه‌های مورد نیاز را به‌طور خودکار تولید می‌کند\&. هدف الگوریتم پیش‌فرض برای تولید شناسه‌های کاربری (UIDs) و شناسه‌های گروهی (GIDs)، ایجاد شناسه‌های بازتولیدپذیر و یکسان در سیستم‌های مختلف است\&. به عنوان یک نقص، ممکن است این الگوریتم شناسه‌های یکسانی را به اشیاء متفاوتی اختصاص دهد و در این حالت تنها اولین شیء درخواست‌شده از طریق SSSD در دسترس خواهد بود\&.
.SH "گزینه‌های پیکربندی (CONFIGURATION OPTIONS)"
.PP
برای جزئیات بیشتر در مورد پیکربندی یک دامنه SSSD، به بخش
\(lqDOMAIN SECTIONS\(rq
در صفحه راهنمای
\fBsssd.conf\fR(5)
مراجعه کنید\&.
.PP
idp_type (string)
.RS 4
گزینه‌ای الزامی که محصول IdP را مشخص می‌کند\&. در حال حاضر Entra ID (با شناسه entra_id) و Keycloak (با شناسه keycloak) پشتیبانی می‌شوند\&.
.sp
بسته به محصول IdP، ممکن است گزینه‌های خاص آن پلتفرم با علامت دونقطه (:) به دنبال نام بیایند\&. برای مثال برای Keycloak باید URI پایه برای REST API کاربر و گروه مشخص شود\&. برای Entra ID می‌توان URI پایه برای Microsoft Graph API را تعیین کرد تا به جای نقطه پایانی پیش‌فرض (https://graph\&.microsoft\&.com/v1\&.0)، از نقاط پایانی ابری دولتی یا حاکمیتی استفاده شود\&. مانند
\(lqentra_id:https://graph\&.microsoft\&.us/v1\&.0\(rq
برای ابر دولتی ایالات متحده (GCC High)\&.
.sp
پیش‌فرض: تنظیم نشده (الزامی)
.RE
.PP
idp_client_id (string)
.RS 4
شناسهٔ کلاینت IdP که توسط SSSD برای احراز هویت کاربران و به عنوان کلاینتی جهت جستجوی مشخصه‌های کاربر و گروه استفاده می‌شود\&. این کلاینت باید امکان مجوزیابی دستگاه (device authorization) را مطابق با RFC\-8628 ارائه دهد و مجوزهای لازم برای جستجو و خواندن مشخصه‌های کاربر و گروه را دارا باشد\&.
.sp
پیش‌فرض: تنظیم نشده (الزامی)
.RE
.PP
idp_client_secret (string)
.RS 4
گذرواژه کلاینت IdP\&. این گذرواژه برای id_provider الزامی است\&. در صورتی که فقط به عنوان auth_provider استفاده شود، الزام آن به پیکربندی سمت سرور بستگی خواهد داشت\&.
.sp
پیش‌فرض: تنظیم نشده
.RE
.PP
idp_token_endpoint (string)
.RS 4
نقطه پایانی IdP برای درخواست توکن‌های دسترسی (access tokens)\&.
.sp
پیش‌فرض: تنظیم نشده (الزامی)
.RE
.PP
idp_device_auth_endpoint (string)
.RS 4
نقطه پایانی IdP برای احراز هویت دستگاه بر اساس RFC\-8628\&. این گزینه برای احراز هویت کاربر الزامی است\&.
.sp
پیش‌فرض: تنظیم نشده
.RE
.PP
idp_userinfo_endpoint (string)
.RS 4
نقطه پایانی userinfo در IdP برای درخواست مشخصه‌های کاربر پس از احراز هویت موفقیت‌آمیز کاربر\&. برای احراز هویت الزامی است\&.
.sp
پیش‌فرض: تنظیم نشده
.RE
.PP
idp_id_scope (string)
.RS 4
محدوده (Scope) مورد نیاز برای جستجوی مشخصه‌های کاربر و گروه با REST API\&. این محدوده‌ها توسط سرور برای تعیین اینکه چه مشخصه‌ها/ادعاهایی (claims) به فراخوان‌کننده بازگردانده شوند، استفاده می‌شوند\&.
.sp
نکته: در نسخه‌های قبلی SSSD، انتظار می‌رفت مقدار این گزینه از پیش به‌صورت URL\-encoded باشد\&.
.sp
پیش‌فرض: تنظیم نشده
.RE
.PP
idp_auth_scope (string)
.RS 4
محدوده (Scope) مورد نیاز در طول احراز هویت\&. این محدوده‌ها توسط سرور برای تعیین اینکه چه مشخصه‌ها/ادعاهایی به فراخوان‌کننده بازگردانده شوند، استفاده می‌شوند\&.
.sp
در حال حاضر توکن‌های بازگردانده شده در طول احراز هویت کاربر برای اهداف دیگری استفاده نمی‌شوند، بنابراین تنها ادعای مهم، شناسه موضوع \*(Aqsub\*(Aq است که برای بررسی اینکه آیا کاربر احراز هویت شده همان کاربری است که قصد ورود دارد یا خیر، به کار می‌رود\&. این رفتار ممکن است در آینده تغییر کند\&.
.sp
پیش‌فرض: تنظیم نشده
.RE
.PP
idp_request_timeout (integer)
.RS 4
مهلت زمانی (Timeout) به ثانیه برای هر درخواست مجزا به IdP\&.
.sp
پیش‌فرض: 10
.RE
.PP
idp_auto_refresh (boolean)
.RS 4
نوسازی خودکار توکن‌ها پس از سپری شدن حدود نیمی از طول عمر آنها\&.
.sp
نکته: نوسازی‌های زمان‌بندی‌شدهٔ توکن پس از راه‌اندازی مجدد SSSD حفظ نمی‌شوند\&.
.sp
پیش‌فرض: false
.RE
.PP
idmap_range_min (integer)
.RS 4
حد پایین (شامل خود عدد) بازهٔ شناسه‌های POSIX را مشخص می‌کند که برای نگاشت کاربران و گروه‌های IdP به شناسه‌های POSIX استفاده می‌شود\&. این نخستین شناسهٔ POSIX است که می‌تواند برای نگاشت مورد استفاده قرار گیرد\&.
.sp
فاصلهٔ بین
\(lqidmap_range_min\(rq
و
\(lqidmap_range_max\(rq
به دامنه‌های کوچکتری با اندازهٔ
\(lqidmap_range_size\(rq
تقسیم می‌شود که توسط یک دامنهٔ مجزای IdP استفاده خواهد شد\&.
.sp
پیش‌فرض: 200000
.RE
.PP
idmap_range_max (integer)
.RS 4
حد بالای (غیرشامل) بازهٔ شناسه‌های POSIX را مشخص می‌کند که برای نگاشت کاربران و گروه‌های IdP به شناسه‌های POSIX استفاده می‌شود\&. این نخستین شناسهٔ POSIX است که دیگر برای نگاشت شناسهٔ POSIX استفاده نخواهد شد\&.
.sp
پیش‌فرض: 2000200000
.RE
.PP
idmap_range_size (integer)
.RS 4
تعداد شناسه‌های POSIX موجود برای یک دامنهٔ تکی IdP را مشخص می‌کند\&.
.sp
پیش‌فرض: 200000
.RE
.SH "مثال‌ها (EXAMPLES)"
.PP
.if n \{\
.RS 4
.\}
.nf
[domain/entra_id]
id_provider = idp
idp_type = entra_id
idp_client_id = 12345678\-abcd\-0101\-efef\-ba9876543210
idp_client_secret = YOUR\-CLIENT\-SCERET
idp_token_endpoint = https://login\&.microsoftonline\&.com/TENNANT\-ID/oauth2/v2\&.0/token
idp_userinfo_endpoint = https://graph\&.microsoft\&.com/v1\&.0/me
idp_device_auth_endpoint = https://login\&.microsoftonline\&.com/TENNANT\-ID/oauth2/v2\&.0/devicecode
idp_id_scope = https://graph\&.microsoft\&.com/\&.default
idp_auth_scope = openid profile email
.fi
.if n \{\
.RE
.\}
.sp

.sp
.if n \{\
.RS 4
.\}
.nf
[domain/keycloak]
idp_type = keycloak:https://master\&.keycloak\&.test:8443/auth/admin/realms/master/
id_provider = idp
idp_client_id = myclient
idp_client_secret = YOUR\-CLIENT\-SCERET
idp_token_endpoint = https://master\&.keycloak\&.test:8443/auth/realms/master/protocol/openid\-connect/token
idp_userinfo_endpoint = https://master\&.keycloak\&.test:8443/auth/realms/master/protocol/openid\-connect/userinfo
idp_device_auth_endpoint = https://master\&.keycloak\&.test:8443/auth/realms/master/protocol/openid\-connect/auth/device
idp_id_scope = profile
idp_auth_scope = openid profile email
.fi
.if n \{\
.RE
.\}
.sp
.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