'\" t
.\"     Title: sss_ssh_authorizedkeys
.\"    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: English
.\"
.TH "SSS_SSH_AUTHORIZEDKE" "1" "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)"
sss_ssh_authorizedkeys \- دریافت کلیدهای مجاز OpenSSH
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBsss_ssh_authorizedkeys\fR\ 'u
\fBsss_ssh_authorizedkeys\fR [\fIگزینه‌ها\fR] \fIUSER\fR
.SH "توضیحات (DESCRIPTION)"
.PP
دستور
\fBsss_ssh_authorizedkeys\fR
کلیدهای عمومی SSH را برای کاربر
\fIUSER\fR
به دست آورده و آن‌ها را در قالب authorized_keys متعلق به OpenSSH خروجی می‌دهد (برای اطلاعات بیشتر بخش
\(lqAUTHORIZED_KEYS FILE FORMAT\(rq
در
\fBsshd\fR(8)
را ببینید)\&.
.PP
در صورتی که
\fBsshd\fR(8)
با پشتیبانی از گزینهٔ
\(lqAuthorizedKeysCommand\(rq
کامپایل شده باشد، می‌تواند برای استفاده از
\fBsss_ssh_authorizedkeys\fR
جهت احراز هویت کلید عمومی کاربر پیکربندی شود\&. لطفاً برای جزئیات بیشتر درباره این گزینه به صفحه راهنمای
\fBsshd_config\fR(5)
مراجعه کنید\&.
.PP
اگر
\(lqAuthorizedKeysCommand\(rq
پشتیبانی شود،
\fBsshd\fR(8)
را می‌توان با قرار دادن دستورالعمل‌های زیر در
\fBsshd_config\fR(5)
برای استفاده از آن پیکربندی کرد:
.sp
.if n \{\
.RS 4
.\}
.nf
  AuthorizedKeysCommand /usr/bin/sss_ssh_authorizedkeys
  AuthorizedKeysCommandUser nobody
.fi
.if n \{\
.RE
.\}
.sp
.SS "کلیدها از گواهی‌ها (KEYS FROM CERTIFICATES)"
.PP
علاوه بر کلیدهای عمومی SSH برای کاربر
\fIUSER\fR،
دستور
\fBsss_ssh_authorizedkeys\fR
می‌تواند کلیدهای عمومی SSH مشتق‌شده از کلید عمومی یک گواهی X\&.509 را نیز بازگرداند\&.
.PP
برای فعال‌سازی این مورد، گزینهٔ
\(lqssh_use_certificate_keys\(rq
باید در بخش [ssh] از
sssd\&.conf
روی true (پیش‌فرض) تنظیم شود\&. اگر مدخل کاربر حاوی گواهی‌ها باشد (برای جزئیات به
\(lqldap_user_certificate\(rq
در
\fBsssd-ldap\fR(5)
مراجعه کنید) یا گواهی‌ای در مدخل بازنویسی (override) برای کاربر وجود داشته باشد (برای جزئیات به
\fBsss_override\fR(8)
یا
\fBsssd-ipa\fR(5)
مراجعه کنید) و گواهی معتبر باشد، SSSD کلید عمومی را از گواهی استخراج کرده و آن را به قالب مورد انتظار sshd تبدیل می‌کند\&.
.PP
به غیر از
\(lqssh_use_certificate_keys\(rq
گزینه‌های
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
ca_db
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
p11_child_timeout
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
certificate_verification
.RE
.sp
می‌توانند برای واپایش نحوه اعتبارسنجی گواهی‌ها استفاده شوند (برای جزئیات به
\fBsssd.conf\fR(5)
مراجعه کنید)\&.
.PP
اعتبارسنجی مزیت استفاده از گواهی‌های X\&.509 به جای کلیدهای مستقیم SSH است؛ زیرا به عنوان مثال امکان کنترل بهتری بر طول عمر کلیدها فراهم می‌آورد\&. هنگامی که کلاینت ssh طوری پیکربندی شده باشد که از کلیدهای خصوصی یک کارت هوشمند (Smartcard) با کمک یک کتابخانه اشتراکی PKCS#11 استفاده کند (برای جزئیات به
\fBssh\fR(1)
مراجعه کنید)، ممکن است این مسئله ناخوشایند باشد که احراز هویت همچنان کار می‌کند حتی اگر گواهی X\&.509 مربوطه روی کارت هوشمند از قبل منقضی شده باشد، زیرا نه
\fBssh\fR
و نه
\fBsshd\fR
اصلاً به این گواهی توجهی نخواهند کرد\&.
.PP
باید توجه داشت که در صورت مجاز بودن در پیکربندی
\fBsshd\fR،
کلید عمومی مشتق‌شده SSH همچنان می‌تواند به فایل
authorized_keys
کاربر اضافه شود تا اعتبارسنجی گواهی را دور بزند\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB\-d\fR,\fB\-\-domain\fR \fIDOMAIN\fR
.RS 4
جستجوی کلیدهای عمومی کاربر در دامنه SSSD به نام
\fIDOMAIN\fR\&.
.RE
.PP
\fB\-?\fR,\fB\-\-help\fR
.RS 4
نمایش پیام راهنما و خروج\&.
.RE
.SH "وضعیت خروج (EXIT STATUS)"
.PP
در صورت موفقیت، مقدار خروج 0 بازگردانده می‌شود\&. در غیر این صورت، 1 بازگردانده می‌شود\&.
.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