.TH RADIUSD 8 "26 Apr 2012" "" "FreeRADIUS Daemon"
.SH "نام (NAME)"
radiusd \- کارساز احراز هویت، اعطای مجوز و حسابرسی (AAA)
.SH "خلاصه دستور (SYNOPSIS)"
.B radiusd
.RB [ \-C ]
.RB [ \-d
.IR config_directory ]
.RB [ \-D
.IR dictionary_directory ]
.RB [ \-f ]
.RB [ \-h ]
.RB [ \-i
.IR ip-address ]
.RB [ \-l
.IR log_file ]
.RB [ \-m ]
.RB [ \-n
.IR name ]
.RB [ \-p
.IR port ]
.RB [ \-P ]
.RB [ \-s ]
.RB [ \-t ]
.RB [ \-v ]
.RB [ \-x ]
.RB [ \-X ]
.SH "توضیحات (DESCRIPTION)"
نرم‌افزار FreeRADIUS یک کارساز RADIUS با کارایی بالا و قابلیت پیکربندی بسیار منعطف است. این کارساز از پس‌لایه‌های پایگاه‌داده متعددی از جمله پرونده‌های متنی ساده (flat-text)، SQL، LDAP، Perl، Python و غیره پشتیبانی می‌کند. همچنین پروتکل‌های احراز هویت گوناگونی همچون PAP، CHAP، MS-CHAP(v2)، HTTP Digest و EAP (شامل EAP-MD5، EAP-TLS، PEAP، EAP-TTLS، EAP-SIM و غیره) را پشتیبانی می‌نماید.
.PP
این نرم‌افزار همچنین از پروتکل پرسمان سیسکو (VMPS) و DHCP به‌طور کامل پشتیبانی می‌کند.
.PP
لطفاً بخش اشکال‌زدایی (DEBUGGING) در ادامه را مطالعه کنید. این بخش شامل دستورالعمل‌هایی برای پیکربندی سریع کارساز بر روی سیستم محلی شما است.
.SH "گزینه‌ها (OPTIONS)"
گزینه‌های خط فرمان زیر توسط کارساز پشتیبانی می‌شوند:
.IP \-C
بررسی پیکربندی و خروج فوری. در صورت وجود مشکل در خواندن پیکربندی، کارساز با یک کد وضعیت غیرصفر خارج خواهد شد. اگر پیکربندی قابل‌قبول به نظر برسد، کارساز با کد وضعیت صفر خارج می‌شود.
.PP
توجه داشته باشید که این بررسی محدودیت‌هایی دارد. با توجه به پیچیدگی‌های مربوط به آماده‌سازی و راه‌اندازی کارساز RADIUS، این بررسی‌ها لزوماً کامل نیستند. کارساز ممکن است در هنگام اجرا با گزینه
.B \-C
کد وضعیت صفر بازگرداند، اما همچنان در اجرای عادی با خطا خارج شود.
.PP
خروجی دستور
.B "radiusd \-XC"
را برای مشاهده فهرست جامعی از ماژول‌هایی که صحت پیکربندی آن‌ها بررسی شده و ماژول‌هایی که نادیده گرفته شده و بررسی نشده‌اند، ببینید.
.IP "\-d \fIconfig directory\fP"
مسیر پوشه پیکربندی را مشخص می‌کند. مقدار پیش‌فرض
.I /etc/raddb
است. دستور
.B radiusd
در این مسیر به دنبال پرونده‌های پیکربندی خود مانند پرونده‌های
.I dictionary
و
.I users
می‌گردد.
.IP "\-D \fIdictionary directory\fP"
تنظیم پوشه فرهنگ‌واژگان اصلی. مقدار پیش‌فرض
.I /usr/share/freeradius
است.
.IP \-f
عدم انشعاب فرآیند (fork نکردن) و اجرا در پیش‌زمینه (foreground).
.IP \-h
چاپ اطلاعات راهنمای استفاده و خروج.
.IP "\-i \fIip-address\fP"
مشخص می‌کند که کارساز از کدام نشانی IP برای ارسال و دریافت بسته‌ها استفاده کند.
.PP
در صورت تعیین این گزینه خط فرمان، مقدار «bind_address» و تمامی مدخل‌های «{}listen» در پرونده
.I radiusd.conf
نادیده گرفته می‌شوند.
.PP
این گزینه حتماً باید همراه با گزینه
.B \-p
استفاده شود.
.IP "\-l \fIlog_file\fP"
مسیر پرونده ثبت وقایع (لاگ). مقدار پیش‌فرض
.I ${logdir}/radius.log
است.
.B radiusd
اطلاعات ثبت وقایع خود را در این پرونده می‌نویسد. اگر مقدار log_file برابر رشته «stdout» باشد، گزارش‌ها در خروجی استاندارد نوشته خواهند شد.
.IP \-m
هنگام دریافت سیگنال SIGINT یا SIGQUIT به جای خروج فوری، به‌صورت تمیز و بدون اشکال خارج می‌شود. این ویژگی هنگام اجرای کارساز به همراه «valgrind» بسیار کاربردی است.
.IP "\-n \fIname\fP"
خواندن پرونده
.I raddb/name.conf
به‌جای
.IR raddb/radiusd.conf .
.IP "\-p \fIport\fP"
مشخص می‌کند که کدام درگاه (پورت) برای دریافت بسته‌های احراز هویت استفاده شود. بسته‌های حسابرسی بر روی «port + 1» دریافت می‌شوند.
.PP
در صورت تعیین این گزینه خط فرمان، تمام بخش‌های «listen» در پرونده
.I radiusd.conf
نادیده گرفته می‌شوند.
.PP
این گزینه حتماً باید همراه با گزینه
.B \-i
استفاده شود.
.IP \-P
همیشه شناسه فرآیند (PID) را در پرونده می‌نویسد، حتی در صورت استفاده از گزینه
.BR \-f .
.IP \-s
اجرا در حالت «تک‌کارساز» (single server). کارساز در حالت عادی با چندین رشته (thread) و/یا فرآیند اجرا می‌شود که می‌تواند زمان پاسخ‌گویی به درخواست‌ها را کاهش دهد. با این حال، برخی سیستم‌ها با چندریسمانی مشکل دارند؛ بنابراین اجرای کارساز در حالت «تک‌کارساز» می‌تواند به رفع این مشکلات کمک کند. در این حالت، کارساز به پس‌زمینه نیز منتقل نخواهد شد (خودکار daemonize نمی‌شود).
.IP \-t
عدم ایجاد رشته‌های پردازشی جدید (threads).
.IP \-v
چاپ اطلاعات نگارش کارساز و خروج.
.IP \-X
حالت اشکال‌زدایی. معادل با «\-sfxx \-l stdout». هنگام تلاش برای درک چگونگی عملکرد کارساز، همواره آن را با
.B "radiusd \-X"
اجرا کنید. برای کارسازهای عملیاتی، از دستور
.B raddebug
استفاده کنید.
.IP \-x
حالت اشکال‌زدایی دقیق‌تر با جزئیات بیشتر. در این حالت کارساز جزئیات هر درخواست را در خروجی استاندارد
.B stdout
چاپ می‌کند. می‌توانید این گزینه را چندین بار (مانند
.B \-x
.B \-x
یا
.BR \-xx )
مشخص کنید تا خروجی با جزئیات بیشتر دریافت نمایید.
.SH "اشکال‌زدایی (DEBUGGING)"
پیکربندی پیش‌فرض به گونه‌ای تنظیم شده است که در گسترده‌ترین شرایط ممکن کار کند و به حداقل تغییرات برای سیستم شما نیاز دارد.
.PP
با این حال، ممکن است نیازهای شما پیچیده بوده و نیازمند اعمال تغییرات اساسی در پیکربندی کارساز باشد. اعمال تغییرات تصادفی و آزمون‌وخطا روشی تضمین‌شده برای شکست است! در عوض، ما اکیداً توصیه می‌کنیم مراحل زیر را دنبال کنید:
.PP
۱) همیشه پس از اعمال هرگونه تغییر در پیکربندی، کارساز را در حالت اشکال‌زدایی (
.B radiusd \-X
) اجرا نمایید. هر چقدر بر این موضوع تأکید کنیم کم است. اگر کارساز را در حالت اشکال‌زدایی اجرا نکنید،
.I هرگز
قادر نخواهید بود ببینید چه اتفاقی در حال رخ دادن است و نمی‌توانید مشکلات را برطرف کنید.
.PP
اگر در فهرست پستی (mailing list) سؤالی بپرسید، اولین پاسخ به شما این خواهد بود: «کارساز را در حالت اشکال‌زدایی اجرا کنید». لطفاً این دستورالعمل‌ها را رعایت نمایید.
.PP
۲) تا جای ممکن کمترین تغییرات را در پرونده‌های پیکربندی پیش‌فرض اعمال کنید. این کارساز حاصل بیش از یک دهه تجربه در تعامل با پروتکل‌ها، پایگاه‌های داده و سیستم‌های گوناگون است. پیکربندی پیش‌فرض آن به گونه‌ای طراحی شده که تقریباً در همه جا کار کند و تقریباً هر آنچه نیاز دارید را برآورده سازد.
.PP
۳) هنگام اعمال یک تغییر کوچک، پیش از تغییر هر چیز دیگری، آن را بیازمایید. اگر تغییر به درستی عمل کرد، یک نسخه پشتیبان از پیکربندی ذخیره کرده و سپس تغییر بعدی را اعمال کنید. اگر تغییر کار نکرد، آن را اشکال‌زدایی کرده و تلاش کنید بفهمید چرا کار نمی‌کند.
.PP
اگر کار را با ایجاد تغییرات بزرگ در پیکربندی کارساز آغاز کنید، هرگز کار نخواهد کرد و هیچ‌گاه نخواهید توانست مشکل را بیابید و رفع کنید.
.PP
۴) اگر نیاز به افزودن اتصال به یک پایگاه داده مشخص مانند FOO (مثلاً LDAP یا SQL) دارید:
.PP
.in +0.3i
الف) پرونده raddb/modules/foo را ویرایش کنید:
.br
این پرونده حاوی پیکربندی پیش‌فرض ماژول است و توضیحاتی دارد که موارد قابل پیکربندی و معنای هر مدخل را شرح می‌دهد.
.br
.br
ب) پرونده raddb/sites-available/default را ویرایش کنید:
.br
این پرونده شامل خط‌مشی پیش‌فرض کارساز است؛ مثلاً «فعال‌سازی احراز هویت CHAP، MS-CHAP و EAP». در این پرونده به دنبال تمامی ارجاعات به ماژول «foo» خود بگردید. توضیحات را بخوانید و علامت هش «#» ابتدای خطوط ارجاع‌دهنده به ماژول را بردارید تا ماژول فعال شود.
.br
.br
ج) پرونده raddb/sites-available/inner-tunnel را ویرایش کنید:
.br
این پرونده شامل خط‌مشی پیش‌فرض برای بخش تونل‌شده برخی روش‌های EAP است. ویرایش‌هایی مشابه با پرونده «default» در مرحله قبل انجام دهید. اگر از پروتکل EAP (استاندارد 802.1X) استفاده نمی‌کنید، می‌توانید از این مرحله صرف‌نظر نمایید.
.br
.br
د) کارساز را در حالت اشکال‌زدایی (
.B radiusd \-X
) راه‌اندازی کرده و آزمایش را آغاز کنید.
.in -0.3i
.PP
۵) پرسش‌های خود را در فهرست پستی (freeradius-users@lists.freeradius.org) مطرح کنید. هنگام ارسال سؤال، حتماً خروجی حالت اشکال‌زدایی (
.B radiusd \-X
) را پیوست نمایید. این اطلاعات به دیگران امکان می‌دهد به شما کمک کنند. در صورت عدم درج این اطلاعات، اولین پاسخ به پیام شما این خواهد بود: «خروجی حالت دیباگ را ارسال کنید».
.PP
سؤالات را زودتر مطرح کنید و معطل نکنید. اگر نتوانستید مشکلی را در طول یک روز حل کنید، آن را در فهرست پستی بپرسید. بیشتر سؤالات قبلاً مطرح شده‌اند و پاسخ آن‌ها به سرعت داده می‌شود.
.SH "پیش‌زمینه و مفاهیم (BACKGROUND)"
پروتکل
.B RADIUS
پروتکلی است که میان یک کارساز دسترسی (Access Server) \- معمولاً دستگاهی متصل به چندین مودم یا خطوط ISDN \- و یک کارساز
.B radius
رد و بدل می‌شود. هنگامی که کاربری به کارساز دسترسی متصل می‌شود، از وی نام کاربری و گذرواژه درخواست می‌گردد. این اطلاعات سپس به کارساز
.B radius
ارسال می‌شود. کارساز با پیام «دسترسی رد شد» (access denied) یا «دسترسی مجاز است» (access OK) پاسخ می‌دهد. در حالت دوم، اطلاعات مربوط به ورود کاربر (مانند نشانی IP در اتصالات PPP) نیز ارسال می‌گردد.
.PP
کارساز دسترسی همچنین سوابق ورود و خروج کاربر را به کارساز
.B radius
ارسال می‌کند تا حسابرسی و ثبت عملکرد (accounting) انجام شود. این سوابق برای هر کارساز پایانه (terminal server) به‌طور مجزا در پرونده‌ای به نام
.B detail
و نیز در پرونده ثبت وقایع سازگار با
.I wtmp
در مسیر
.B /var/log/radwtmp
نگهداری می‌شوند.
.SH "پیکربندی (CONFIGURATION)"
دستور
.B radiusd
از چندین پرونده پیکربندی استفاده می‌کند. هر پرونده صفحه راهنمای اختصاصی خود را دارد که ساختار آن را تشریح می‌کند. این پرونده‌ها عبارتند از:
.IP radiusd.conf
پرونده اصلی پیکربندی که موارد تحت کنترل مدیر سیستم در آن تنظیم می‌شوند.
.IP dictionary
این پرونده معمولاً ایستا است. تمام ویژگی‌های (attributes) ممکن RADIUS مورد استفاده در سایر پرونده‌های پیکربندی را تعریف می‌کند و نیازی به تغییر آن ندارید. این پرونده سایر پرونده‌های فرهنگ‌واژگان موجود در همان پوشه را نیز شامل می‌شود.
.IP hints
رهنمودها و سرنخ‌های خاصی را بر اساس نام کاربری یا سایر مشخصه‌های ارسال‌شده توسط کارساز دسترسی برای کارساز radius تعریف می‌کند. همچنین امکان نگاشت نام‌های کاربری (مانند Pusername -> username) را فراهم می‌سازد. این سازوکار قابلیتی را فراهم می‌کند که کارساز
.I Livingston 2.0
به عنوان پشتیبانی از «پیشوند» (Prefix) و «پسوند» (Suffix) در پرونده
.I users
ارائه می‌داد، اما به شکلی کلی‌تر و منعطف‌تر. البته روش کارساز Livingston نیز همچنان پشتیبانی می‌شود و حتی می‌توان از هر دو روش به طور هم‌زمان (در چارچوب محدودیت‌های مشخص) استفاده کرد.
.IP huntgroups
گروه‌های شکار (huntgroups) موجود را تعریف کرده و محدودسازی دسترسی به برخی گروه‌های شکار را برای کاربران (یا گروه‌هایی از کاربران) خاص امکان‌پذیر می‌کند.
.IP users
در این پرونده کاربران تعریف می‌شوند. در یک راه‌اندازی معمول، این پرونده عمدتاً شامل مدخل‌های DEFAULT برای پردازش انواع مختلف ورود، بر اساس رهنمودهای موجود در پرونده hints است. احراز هویت سپس بر مبنای محتویات پرونده یونیکس
.I /etc/passwd
انجام می‌گیرد. با این حال، امکان تعریف تمامی کاربران و گذرواژه‌های آن‌ها در همین پرونده نیز وجود دارد.
.SH "همچنین ببینید (SEE ALSO)"
.BR radiusd.conf (5),
.BR users (5),
.BR huntgroups (5),
.BR hints (5),
.BR dictionary (5),
.BR raddebug (8)
.SH "نویسندگان (AUTHORS)"
پروژه کارساز FreeRADIUS
.RB ( http://www.freeradius.org )