'\" t
.\"     Title: sss_ssh_knownhosts
.\"    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 "SSS_SSH_KNOWNHOSTS" "1" "2026/06/09" "SSSD" "صفحات راهنمای 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)"
sss_ssh_knownhosts \- دریافت کلیدهای عمومی میزبان‌های شناخته‌شده OpenSSH
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBsss_ssh_knownhosts\fR\ 'u
\fBsss_ssh_knownhosts\fR [\fIگزینه‌ها\fR] \fIHOST\fR
.SH "توضیحات (DESCRIPTION)"
.PP
\fBsss_ssh_knownhosts\fR
کلیدهای عمومی SSH را برای میزبان
\fIHOST\fR
به دست می‌آورد و آن‌ها را در قالب کلید known_hosts برای OpenSSH در خروجی می‌نویسد (برای اطلاعات بیشتر به بخش
\(lqSSH_KNOWN_HOSTS FILE FORMAT\(rq
در
\fBsshd\fR(8)
مراجعه کنید)\&.
.PP
می‌توان
\fBssh\fR(1)
را به گونه‌ای پیکربندی کرد که با استفاده از گزینه
\(lqKnownHostsCommand\(rq
از
\fBsss_ssh_knownhosts\fR
برای احراز هویت کلید عمومی میزبان استفاده کند:
.sp
.if n \{\
.RS 4
.\}
.nf
                KnownHostsCommand /usr/bin/sss_ssh_knownhosts %H
            
.fi
.if n \{\
.RE
.\}
.sp
لطفاً برای جزئیات بیشتر درباره این گزینه به صفحه راهنمای
\fBssh_config\fR(5)
مراجعه کنید\&.
.PP
این ابزار برای کارکرد صحیح نیازمند فعال بودن سرویس ssh مربوط به SSSD است\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB\-d\fR,\fB\-\-domain\fR \fIDOMAIN\fR
.RS 4
جستجوی کلیدهای عمومی میزبان در دامنه SSSD مشخص‌شده با
\fIDOMAIN\fR\&.
.RE
.PP
\fB\-o\fR,\fB\-\-only\-host\-name\fR
.RS 4
هنگامی که کلیدهای دریافت‌شده از بک‌اند شامل نام میزبان نباشند، این ابزار نام میزبان تغییرنیافته را همان‌گونه که فراخواننده ارائه داده است اضافه خواهد کرد\&. اگر این فلگ تنظیم شود، تنها نام میزبان (بدون شماره درگاه) به کلیدها افزوده خواهد شد\&.
.RE
.PP
\fB\-?\fR,\fB\-\-help\fR
.RS 4
نمایش پیام راهنما و خروج\&.
.RE
.SH "بازیابی کلید (KEY RETRIEVAL)"
.PP
انتظار می‌رود خطوط کلید دریافت‌شده از بک‌اند با قالب کلید شرح داده شده در بخش
\(lqSSH_KNOWN_HOSTS FILE FORMAT\(rq
از
\fBsshd\fR(8)
همخوانی داشته باشند\&. با این حال، بازگرداندن تنها نوع کلید و خود کلید نیز قابل قبول است؛ در این صورت، نام میزبان دریافت‌شده به عنوان پارامتر، پیش از نوع کلید افزوده خواهد شد تا خطی با قالب‌بندی درست خروجی داده شود\&. بسته به اینکه گزینه
\fB\-o\fR,\fB\-\-only\-host\-name\fR
مشخص شده باشد یا خیر، نام میزبان به صورت دست‌نخورده یا فقط نام میزبان (بدون شماره درگاه) اضافه خواهد شد\&.
.PP
هنگامی که کارساز SSH روی درگاهی غیر از درگاه پیش‌فرض گوش فرا می‌دهد، بک‌اند حتماً باید نام میزبان را به همراه شماره درگاه در قالب و جایگاه درست به عنوان بخشی از خط کلید ارائه دهد\&. برای نمونه، حداقل خط کلید به صورت زیر خواهد بود:
.sp
.if n \{\
.RS 4
.\}
.nf
                [canonical\&.host\&.name]:2222 <keytype> <base64\-encoded key>
            
.fi
.if n \{\
.RE
.\}
.sp
.SH "وضعیت خروج (EXIT STATUS)"
.PP
در صورت اجرای موفقیت‌آمیز، حتی اگر کلیدی برای آن میزبان یافت نشود یا ارتباط با پاسخ‌دهنده ssh برقرار نگردد، مقدار 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