نام (NAME)

inn-radius.conf - پیکربندی برای احراز هویت‌کننده RADIUS برنامه nnrpd

توضیحات (DESCRIPTION)

این سند، ساختار و مشخصه‌های فایل پیکربندی برای احراز هویت‌کننده RADIUS در nnrpd را شرح می‌دهد. برای کسب اطلاعات بیشتر دربارهٔ برنامهٔ احراز هویت، به radius(8) مراجعه کنید. مکان پیش‌فرض این فایل inn-radius.conf در دایرکتوری pathetc است.

خطوط خالی و خطوطی که با "#" شروع می‌شوند نادیده گرفته می‌شوند؛ همچنین هر چیزی که بعد از "#" در یک خط قرار بگیرد نادیده گرفته خواهد شد. سایر خطوط باید با یک نام پارامتر و به دنبال آن دو نقطه (:) و مقدار آن کلید شروع شوند، مگر اینکه هر بخش پیکربندی برای یک سرور مشخص در ساختار زیر محصور شده باشد:

server <name> {
    # parameters...
}

که در آن <name> صرفاً یک نام یا برچسب مناسب برای آن سرور است.

پارامترهای گروه سرور (SERVER GROUP PARAMETERS)

پارامترهای در دسترس عبارتند از:

radhost: نام میزبان (hostname) سرور RADIUS که برای احراز هویت استفاده می‌شود. این پارامتر باید حتماً تنظیم شود.
radport: درگاهی (port) که باید در سرور RADIUS پرس‌وجو شود. در صورت عدم تنظیم، مقدار پیش‌فرض 1645 است.
lochost: نام میزبان یا آدرس IP ارسال‌کنندهٔ درخواست. سرور RADIUS انتظار یک آدرس IP را دارد؛ نام میزبان با تابع gethostbyname() به آدرس IP ترجمه خواهد شد. در صورت مشخص نشدن، این اطلاعات در درخواست گنجانده نمی‌شود (همهٔ پیکربندی‌های RADIUS نیازمند این اطلاعات نیستند).
locport: درگاهی که کلاینت احراز هویت‌شونده به آن متصل است. در صورت مشخص نشدن، مقدار پیش‌فرض 119 است. نیازی به تنظیم این پارامتر نیست مگر اینکه خوانندگان به درگاهی غیر استاندارد متصل شوند.
secret: رمز اشتراکی (shared secret) با سرور RADIUS. اگر رمز شما شامل فاصله، تب یا "#" است، حتماً آن را درون علامت‌های نقل‌قول دوتایی قرار دهید. این پارامتر باید حتماً تنظیم شود.
prefix: مقدار این پارامتر را پیش از ارسال نام‌های کاربری به سرور RADIUS، به ابتدای تمام آن‌ها اضافه می‌کند. می‌توان از این گزینه برای افزودن عبارتی مانند "news-" به ابتدای نام‌های کاربری استفاده کرد تا کاربران news در فضانامی (namespace) جداگانه نسبت به سایر حساب‌های موجود در همان سرور قرار گیرند. در صورت عدم تنظیم، چیزی به ابتدا اضافه نمی‌شود.
suffix: مقدار این پارامتر را پیش از ارسال نام‌های کاربری به سرور RADIUS، به انتهای تمام آن‌ها اضافه می‌کند. بسته به نحوهٔ راه‌اندازی سرور RADIUS شما، این مقدار معمولاً عبارتی مانند "@example.com" است. در صورت عدم تنظیم، چیزی به انتها افزوده نمی‌شود.
ignore-source: می‌تواند روی "true"، "yes"، "on"، "false"، "no" یا "off" تنظیم شود. اگر روی false تنظیم شود، احراز هویت‌کنندهٔ RADIUS اطمینان حاصل می‌کند که پاسخ دریافتی دقیقاً از همان آدرس IP ارسال‌کنندهٔ درخواست آمده باشد (برای افزایش امنیت). اگر روی true تنظیم شود، این مرحلهٔ اعتبارسنجی نادیده گرفته می‌شود (اگر سرور RADIUS شما دارای چندین آدرس IP باشد یا شرایط خاص دیگری برقرار باشد، ممکن است دریافت پاسخ از یک آدرس IP متفاوت کاملاً طبیعی باشد).

مثال‌ها (EXAMPLES)

در اینجا پیکربندی برای یک سرور اخبار به نام news.example.com آورده شده است که کاربران را از طریق radius.example.com احراز هویت کرده و عبارت "@example.com" را پیش از ارسال نام‌های کاربریِ ارائه‌شده توسط کلاینت به سرور RADIUS، به انتهای آن‌ها اضافه می‌کند:

server example {
    radhost: radius.example.com
    lochost: news.example.com
    secret: IamARADIUSsecRET
    suffix: @example.com
}

رمز اشتراکی با سرور RADIUS برابر "IamARADIUSsecRET" است.

تاریخچه (HISTORY)

این مستندات توسط Russ Allbery <eagle@eyrie.org> بر اساس توضیحات فایل نمونهٔ inn-radius.conf اثر Yury B. Razbegin نوشته شده است.

همچنین ببینید (SEE ALSO)

radius(8).