.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.0102 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "AUTH_KRB5 8"
.TH AUTH_KRB5 8 2022-07-10 "INN 2.7.4" "InterNetNews Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "نام (NAME)"
auth_krb5 \- احراز هویت‌کننده Kerberos v5 برای nnrpd
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
\&\fBauth_krb5\fR [\fB\-i\fR \fIinstance\fR]
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
این برنامه احراز هویت را برای \fBnnrpd\fR در برابر یک KDC کربروس نگارش ۵ (Kerberos\ v5\ KDC) انجام می‌دهد.
این یک احراز هویت واقعی Kerberos با استفاده از بلیت‌های سرویس نیست؛ بلکه از یک
نام کاربری و گذرواژه برای تلاش جهت دریافت یک Kerberos\ v5\ TGT استفاده می‌شود تا
معتبر بودن آن‌ها تایید گردد. به همین ترتیب، این احراز هویت‌کننده فرض می‌کند که
نام کاربری و گذرواژه کاربر در اختیار \fBnnrpd\fR قرار گرفته است و بنابراین به
اندازه احراز هویت واقعی Kerberos امن نیست. عموماً این برنامه باید تنها به همراه
NNTP بر بستر TLS استفاده شود تا از شنود گذرواژه محافظت به عمل آید.
.PP
در حالت عادی، بهتر است از این احراز هویت‌کننده استفاده نکنید. در عوض از
\&\fBckpasswd\fR با پشتیبانی PAM استفاده کرده و پشته PAM مربوط به \fBnnrpd\fR را به گونه‌ای
پیکربندی کنید که از یک ماژول PAM کربروس استفاده کند. یک ماژول کامل PAM کربروس
در نحوه اعتبارسنجی گذرواژه‌ها دقیق‌تر و پیشرفته‌تر عمل کرده و دارای مجموعه بسیار
گسترده‌تری از گزینه‌ها نسبت به این احراز هویت‌کننده است.
.SH "گزینه‌ها (OPTIONS)"
.IX Header "OPTIONS"
.IP "\fB\-i\fR \fIinstance\fR" 4
.IX Item "-i instance"
اگر این گزینه مشخص شود، \fIinstance\fR به عنوان نمونه (instance) پرینسیپال دریافت‌شده
از \fBnnrpd\fR استفاده خواهد شد و احراز هویت به جای پرینسیپال پایه، در برابر آن
پرینسیپال انجام می‌شود. به عبارت دیگر، پرینسیپالی مانند \f(CW\*(C`user\*(C'\fR وقتی به
\&\fBauth_krb5\fR فراخوانی‌شده با \f(CW\*(C`\-i nntp\*(C'\fR داده شود، پیش از اقدام برای
احراز هویت Kerberos به \f(CW\*(C`user/nntp\*(C'\fR تبدیل خواهد شد.
.Sp
از آنجا که سپردن گذرواژه به \fBnnrpd\fR به اندازه احراز هویت معمول Kerberos امن نیست،
این گزینه از پیکربندی‌ای پشتیبانی می‌کند که در آن به تمامی کاربران یک نمونه
جداگانه فقط برای احراز هویت اخبار (news) با گذرواژه اختصاصی داده می‌شود، تا گذرواژه
حساب کاربری عادی آن‌ها از طریق NNTP فاش نشود.
.SH "مثال‌ها (EXAMPLES)"
.IX Header "EXAMPLE"
قطعه پیکربندی زیر از
.BR readers.conf (5)
به
.B nnrpd
دستور می‌دهد که با تلاش برای دریافت Kerberos\ v5\ TGT برای کاربران، و الحاق یک نمونه از
\f(CW\*(C`nntp\*(C'\fR به نام‌های کاربری پیش از انجام این کار، آن‌ها را احراز هویت کند:
.PP
.Vb 3
\&    auth kerberos {
\&        auth: "auth_krb5 \-i nntp"
\&    }
\&
\&    access kerberos {
\&        users: "*/nntp"
\&        newsgroups: example.*
\&    }
.Ve
.PP
دسترسی به گروه‌های newsgroup با الگوی example.* برای تمام کاربرانی که با موفقیت احراز هویت شوند، اعطا می‌شود.
.SH "اشکالات (BUGS)"
.IX Header "BUGS"
در حال حاضر، هر نام کاربری حاوی اطلاعات قلمرو (شامل \f(CW\*(C`@\*(C'\fR) رد می‌شود.
این اقدام به منظور جلوگیری از آن است که شخصی با وارد کردن نام کاربری مربوط به یک پرینسیپال
در قلمرویی دیگر که به آن دسترسی دارد، از طریق آن به کارساز اخبار دسترسی یابد.
با این وجود، این موردی است که ممکن است افراد در شرایط خاصی تمایل به انجام آن داشته باشند،
بنابراین باید روش بهتری برای رسیدگی به آن وجود داشته باشد (مانند شاید فهرستی از قلمروهای
قابل قبول یا یک فلگ \fB\-r\fR که قلمرو مورد نظر برای تلاش جهت احراز هویت را مشخص کند).
.PP
مشخص نیست هنگامی که نام کاربری ارائه‌شده حاوی \f(CW\*(C`/\*(C'\fR باشد و گزینه
\&\fB\-i\fR نیز مشخص شده باشد، اقدام صحیح چیست. در حال حاضر، \fBauth_krb5\fR یک
پرینسیپال نادرست Kerberos با چند نمونه ایجاد کرده و تلاش می‌کند با آن احراز هویت
کند، که البته شکست خواهد خورد اما شاید با بهترین پیام خطا همراه نباشد.
.SH "تاریخچه (HISTORY)"
.IX Header "HISTORY"
در ابتدا توسط Christopher P.\& Lindsey نوشته شد. این مستندات توسط Russ Allbery
<eagle@eyrie.org> بر اساس فایل \fIREADME\fR اصلی Christopher نوشته شده است.
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "SEE ALSO"
ckpasswd(8), nnrpd(8), readers.conf(5).