.TH ntp.keys 5 "25 May 2024" "4.2.8p18" "قالب‌های فایل"
.\"
.SH "نام (NAME)"
ntp.keys \- قالب فایل کلید متقارن NTP
.de1 NOP
.  it 1 an-trap
.  if \\n[.$] \,\\$*\/
..
.ie t \
.ds B-Font [CB]
.ds I-Font [CI]
.ds R-Font [CR]
.el \
.ds B-Font B
.ds I-Font I
.ds R-Font R
.SH "خلاصه دستور (SYNOPSIS)"
\f\*[B-Font]\fP
[\f\*[B-Font]\-\-option-name\f[]]
[\f\*[B-Font]\-\-option-name\f[] \f\*[I-Font]value\f[]]
.sp \n(Ppu
.ne 2

تمام آرگومان‌ها باید از نوع گزینه‌ها باشند.
.sp \n(Ppu
.ne 2

.SH "توضیحات (DESCRIPTION)"
این سند قالب فایل کلیدهای متقارن NTP را شرح می‌دهد. برای توضیح نحوه استفاده از این نوع فایل، بخش «پشتیبانی از احراز هویت» در صفحه راهنمای
\fCntp.conf\f[]\fR(5)\f[]
را ببینید.
.sp \n(Ppu
.ne 2

برنامه
\fCntpd\f[]\fR(8)\f[]
کلیدهای خود را از فایلی می‌خواند که با استفاده از گزینه خط فرمان
\f\*[B-Font]\-k\f[]
یا دستور
\f\*[B-Font]keys\f[]
در فایل پیکربندی مشخص می‌شود. در حالی که کلید شماره ۰ توسط استاندارد NTP تثبیت شده است (به صورت ۵۶ بیت صفر) و قابل تغییر نیست، یک یا چند کلید با شماره‌های بین ۱ تا ۶۵۵۳۵ می‌توانند به دلخواه در فایل کلیدها تنظیم شوند.
.sp \n(Ppu
.ne 2

فایل کلیدها از همان قراردادهای کامنت‌گذاری فایل پیکربندی استفاده می‌کند. ورودی‌های کلید از قالبی ثابت به شکل زیر استفاده می‌کنند:
.sp \n(Ppu
.ne 2

.in +4
\f\*[I-Font]keyno\f[] \f\*[I-Font]type\f[] \f\*[I-Font]key\f[] \f\*[I-Font]opt_IP_list\f[]
.in -4
.sp \n(Ppu
.ne 2

که در آن
\f\*[I-Font]keyno\f[]
یک عدد صحیح مثبت (بین ۱ تا ۶۵۵۳۵)،
\f\*[I-Font]type\f[]
الگوریتم خلاصه پیام (داکجِست)،
\f\*[I-Font]key\f[]
خود کلید، و
\f\*[I-Font]opt_IP_list\f[]
فهرستی اختیاری و جداشده با ویرگول از نشانی‌های IP است که در آن‌ها
\f\*[I-Font]keyno\f[]
باید مورد اعتماد باشد و اجازه ارائه زمان دارند.
هر نشانی IP در
\f\*[I-Font]opt_IP_list\f[]
می‌تواند شامل مشخصه اختیاری
\f\*[B-Font]/subnetbits\f[]
باشد که تعداد بیت‌های زیرشبکه مورد اعتماد را مشخص می‌کند.
اگر
\f\*[I-Font]opt_IP_list\f[]
خالی باشد، هر پیام احراز هویت شده به درستی پذیرفته خواهد شد.
.sp \n(Ppu
.ne 2

مقدار
\f\*[I-Font]key\f[]
می‌تواند در قالبی ارائه شود که توسط فیلد
\f\*[I-Font]type\f[]
کنترل می‌شود.
نوع
\f[C]MD5\f[]
همواره پشتیبانی می‌شود.
اگر
\f[C]ntpd\f[]
با کتابخانه OpenSSL ساخته شده باشد، هر نوع خلاصه پیام پشتیبانی‌شده توسط آن کتابخانه می‌تواند مشخص شود.
با این حال، اگر انطباق با FIPS 140-2 الزامی باشد،
\f\*[I-Font]type\f[]
باید
\f[C]SHA\f[]
یا
\f[C]SHA1\f[]
باشد.
.sp \n(Ppu
.ne 2

در ادامه برخی از انواع کلیدها و قالب‌های متناظر آن‌ها آمده است:
.sp \n(Ppu
.ne 2

.TP 7
.NOP \f[C]MD5\f[]
کلید ۱ تا ۱۶ نویسه قابل چاپ است که با پایان خط (EOL)، فاصله سفید یا نویسه
\f[C]#\f[]
(که نویسه شروع کامنت است) خاتمه می‌یابد.
.sp \n(Ppu
.ne 2

.br
.ns
.TP 7
.NOP \f[C]SHA\f[]
.br
.ns
.TP 7
.NOP \f[C]SHA1\f[]
.br
.ns
.TP 7
.NOP \f[C]RMD160\f[]
کلید یک رشته ASCII با کدگذاری هگزادسیمال شامل ۴۰ نویسه است که در صورت نیاز کوتاه‌سازی می‌شود.
.PP
.sp \n(Ppu
.ne 2

توجه داشته باشید که کلیدهای استفاده‌شده توسط برنامه‌های
\fCntpq\f[]\fR(8)\f[]
و
\fCntpdc\f[]\fR(8)\f[]
در برابر گذرواژه‌های درخواست‌شده توسط برنامه‌ها و واردشده به صورت دستی بررسی می‌شوند، بنابراین عموماً مناسب است که این کلیدها با قالب ASCII تعیین گردند.
.SH "فایل‌ها (FILES)"
.TP 14
.NOP \fI/etc/ntp.keys\f[]
نام پیش‌فرض فایل پیکربندی
.PP
.SH "همچنین ببینید (SEE ALSO)"
\fCntp.conf\f[]\fR(5)\f[],
\fCntpd\f[]\fR(1)\f[],
\fCntpdate\f[]\fR(1)\f[],
\fCntpdc\f[]\fR(1)\f[],
\fCsntp\f[]\fR(1)\f[]
.SH "نویسندگان (AUTHORS)"
دانشگاه دلاور و بنیاد زمان شبکه (Network Time Foundation)
.SH "حق نشر (COPYRIGHT)"
حق نشر (C) 1992-2024 دانشگاه دلاور و بنیاد زمان شبکه؛ کلیه حقوق محفوظ است.
این برنامه تحت شرایط مجوز NTP منتشر شده است: <http://ntp.org/license>
.SH "اشکالات (BUGS)"
لطفاً گزارش اشکالات را به این نشانی‌ها ارسال کنید: https://bugs.ntp.org و bugs@ntp.org
.SH "نکات (NOTES)"
این سند از FreeBSD اقتباس شده است.
.sp \n(Ppu
.ne 2

این صفحه راهنما توسط \fIAutoGen\fP از تعاریف گزینه‌های \fBntp.keys\fP تولید شده است.