.\" -*- 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 "INN-RADIUS.CONF 5"
.TH INN-RADIUS.CONF 5 2024-05-19 "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)"
inn\-radius.conf \- پیکربندی برای احراز هویت‌کننده RADIUS برنامه nnrpd
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
این سند، ساختار و مشخصه‌های فایل پیکربندی برای احراز هویت‌کننده RADIUS در \fBnnrpd\fR را شرح می‌دهد. برای کسب اطلاعات بیشتر دربارهٔ برنامهٔ احراز هویت، به radius(8) مراجعه کنید. مکان پیش‌فرض این فایل \fIinn\-radius.conf\fR در دایرکتوری \fIpathetc\fR است.
.PP
خطوط خالی و خطوطی که با \f(CW\*(C`#\*(C'\fR شروع می‌شوند نادیده گرفته می‌شوند؛ همچنین هر چیزی که بعد از \f(CW\*(C`#\*(C'\fR در یک خط قرار بگیرد نادیده گرفته خواهد شد. سایر خطوط باید با یک نام پارامتر و به دنبال آن دو نقطه (:) و مقدار آن کلید شروع شوند، مگر اینکه هر بخش پیکربندی برای یک سرور مشخص در ساختار زیر محصور شده باشد:
.PP
.Vb 3
\&    server <name> {
\&        # parameters...
\&    }
.Ve
.PP
که در آن <name> صرفاً یک نام یا برچسب مناسب برای آن سرور است.
.SH "پارامترهای گروه سرور (SERVER GROUP PARAMETERS)"
.IX Header "SERVER GROUP PARAMETERS"
پارامترهای در دسترس عبارتند از:
.IP \fIradhost\fR 4
.IX Item "radhost"
نام میزبان (hostname) سرور RADIUS که برای احراز هویت استفاده می‌شود. این پارامتر باید حتماً تنظیم شود.
.IP \fIradport\fR 4
.IX Item "radport"
درگاهی (port) که باید در سرور RADIUS پرس‌وجو شود. در صورت عدم تنظیم، مقدار پیش‌فرض 1645 است.
.IP \fIlochost\fR 4
.IX Item "lochost"
نام میزبان یا آدرس IP ارسال‌کنندهٔ درخواست. سرور RADIUS انتظار یک آدرس IP را دارد؛ نام میزبان با تابع gethostbyname() به آدرس IP ترجمه خواهد شد. در صورت مشخص نشدن، این اطلاعات در درخواست گنجانده نمی‌شود (همهٔ پیکربندی‌های RADIUS نیازمند این اطلاعات نیستند).
.IP \fIlocport\fR 4
.IX Item "locport"
درگاهی که کلاینت احراز هویت‌شونده به آن متصل است. در صورت مشخص نشدن، مقدار پیش‌فرض 119 است. نیازی به تنظیم این پارامتر نیست مگر اینکه خوانندگان به درگاهی غیر استاندارد متصل شوند.
.IP \fIsecret\fR 4
.IX Item "secret"
رمز اشتراکی (shared secret) با سرور RADIUS. اگر رمز شما شامل فاصله، تب یا \f(CW\*(C`#\*(C'\fR است، حتماً آن را درون علامت‌های نقل‌قول دوتایی قرار دهید. این پارامتر باید حتماً تنظیم شود.
.IP \fIprefix\fR 4
.IX Item "prefix"
مقدار این پارامتر را پیش از ارسال نام‌های کاربری به سرور RADIUS، به ابتدای تمام آن‌ها اضافه می‌کند. می‌توان از این گزینه برای افزودن عبارتی مانند \f(CW\*(C`news\-\*(C'\fR به ابتدای نام‌های کاربری استفاده کرد تا کاربران news در فضانامی (namespace) جداگانه نسبت به سایر حساب‌های موجود در همان سرور قرار گیرند. در صورت عدم تنظیم، چیزی به ابتدا اضافه نمی‌شود.
.IP \fIsuffix\fR 4
.IX Item "suffix"
مقدار این پارامتر را پیش از ارسال نام‌های کاربری به سرور RADIUS، به انتهای تمام آن‌ها اضافه می‌کند. بسته به نحوهٔ راه‌اندازی سرور RADIUS شما، این مقدار معمولاً عبارتی مانند \f(CW\*(C`@example.com\*(C'\fR است. در صورت عدم تنظیم، چیزی به انتها افزوده نمی‌شود.
.IP \fIignore-source\fR 4
.IX Item "ignore-source"
می‌تواند روی \f(CW\*(C`true\*(C'\fR، \f(CW\*(C`yes\*(C'\fR، \f(CW\*(C`on\*(C'\fR، \f(CW\*(C`false\*(C'\fR، \f(CW\*(C`no\*(C'\fR یا \f(CW\*(C`off\*(C'\fR تنظیم شود. اگر روی false تنظیم شود، احراز هویت‌کنندهٔ RADIUS اطمینان حاصل می‌کند که پاسخ دریافتی دقیقاً از همان آدرس IP ارسال‌کنندهٔ درخواست آمده باشد (برای افزایش امنیت). اگر روی true تنظیم شود، این مرحلهٔ اعتبارسنجی نادیده گرفته می‌شود (اگر سرور RADIUS شما دارای چندین آدرس IP باشد یا شرایط خاص دیگری برقرار باشد، ممکن است دریافت پاسخ از یک آدرس IP متفاوت کاملاً طبیعی باشد).
.SH "مثال‌ها (EXAMPLES)"
.IX Header "EXAMPLE"
در اینجا پیکربندی برای یک سرور اخبار به نام news.example.com آورده شده است که کاربران را از طریق radius.example.com احراز هویت کرده و عبارت \f(CW\*(C`@example.com\*(C'\fR را پیش از ارسال نام‌های کاربریِ ارائه‌شده توسط کلاینت به سرور RADIUS، به انتهای آن‌ها اضافه می‌کند:
.PP
.Vb 6
\&    server example {
\&        radhost: radius.example.com
\&        lochost: news.example.com
\&        secret: IamARADIUSsecRET
\&        suffix: @example.com
\&    }
.Ve
.PP
رمز اشتراکی با سرور RADIUS برابر \f(CW\*(C`IamARADIUSsecRET\*(C'\fR است.
.SH "تاریخچه (HISTORY)"
.IX Header "HISTORY"
این مستندات توسط Russ Allbery <eagle@eyrie.org> بر اساس توضیحات فایل نمونهٔ \fIinn\-radius.conf\fR اثر Yury B.\ Razbegin نوشته شده است.
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "SEE ALSO"
radius(8).