.\"     # DS - begin display
.de DS
.RS
.nf
.sp
..
.\"     # DE - end display
.de DE
.fi
.RE
.sp
..
.TH rlm_sql 5 "5 فوریه 2004" "" "ماژول FreeRADIUS"
.SH "نام (NAME)"
rlm_sql \- ماژول پایگاه‌داده FreeRADIUS
.SH "توضیحات (DESCRIPTION)"
ماژول \fIrlm_sql\fP یک رابط SQL برای بازیابی اطلاعات مجوزدهی (authorization) و ذخیره‌سازی اطلاعات حسابرسی (accounting) فراهم می‌کند. این ماژول می‌تواند همراه با ماژول‌های files و detail، یا به‌جای آن‌ها استفاده شود. ماژول SQL درایورهایی برای پشتیبانی از پایگاه‌های دادهٔ SQL زیر دارد:
.PP
.DS
.br
     db2
.br
     iodbc
.br
     mysql
.br
     oracle
.br
     postgresql
.br
     sybase
.br
     unixodbc
.br
.DE
.PP
به دلیل حجم زیاد متغیرهای پیکربندی، ماژول sql معمولاً در یک فایل جداگانه پیکربندی می‌شود که از طریق یک دستورالعمل include در فایل اصلی radiusd.conf گنجانده می‌شود.
.PP
مهم‌ترین موارد پیکربندی که باید به آن‌ها توجه شود عبارتند از:
.IP driver
این متغیر درایوری را که باید بارگذاری شود مشخص می‌کند.
.IP server
.IP login
.IP password
این متغیرها نام سرور، نام کاربری و گذرواژه‌ای را مشخص می‌کنند که ماژول برای اتصال به پایگاه داده استفاده خواهد کرد.
.IP radius_db
نام پایگاه داده‌ای که جدول‌های radius در آن ذخیره شده‌اند.
.IP acct_table1
.IP acct_table2
این موارد نام جدول‌ها را برای رکوردهای accounting مشخص می‌کنند. متغیر acct_table1 جدولی را مشخص می‌کند که رکوردهای Start در آن ذخیره می‌شوند. متغیر acct_table2 جدولی را مشخص می‌کند که رکوردهای Stop در آن ذخیره می‌شوند. در بیشتر موارد، این متغیرها باید به یک جدول یکسان اشاره کنند.
.IP postauth_table
نام جدولی برای ذخیره‌سازی داده‌های پس از احراز هویت (post-authentication).
.IP authcheck_table
.IP authreply_table
جدول‌هایی که Check-Items و Reply-Items هر کاربر در آن‌ها ذخیره می‌شوند.
.IP groupcheck_table
.IP groupreply_table
جدول‌هایی که Check-Items و Reply-Items مربوط به گروه‌ها در آن‌ها ذخیره می‌شوند.
.IP usergroup_table
جدولی که ارتباط بین نام کاربری و گروه‌ها در آن ذخیره می‌شود.
.IP deletestalesessions
این گزینه روی 'yes' یا 'no' تنظیم می‌شود. اگر در حال بررسی Simultaneous-Use هستید و این گزینه روی yes تنظیم شده باشد، نشست‌های معلق و قدیمی (که به عنوان نشست‌هایی تعریف می‌شوند که رکورد Stop برای آن‌ها دریافت نشده است) پاکسازی می‌شوند.
.IP logfile
این گزینه برای اشکال‌زدایی مشکلات sql مفید است. اگر logfile تنظیم شده باشد، تمام پرس‌وجوهای sql برای بخش مربوطه در فایل مشخص‌شده نوشته می‌شوند. این قابلیت برای اشکال‌زدایی و درج‌های دسته‌ای (bulk inserts) کاربرد دارد.
.IP num_sql_socks
تعداد اتصالات sql که باید با پایگاه داده برقرار شوند.
.IP connect_failure_retry_delay
تعداد ثانیه‌هایی که باید پیش از تلاش مجدد برای اتصال به یک پایگاه داده با اتصال ناموفق سپری شود.
.IP sql_user_name
این تعریف مشخصهٔ SQL-User-Name است. این متغیر یک‌بار تنظیم می‌شود تا بتوانید به‌جای جایگزینی‌های تودرتوی نام کاربری، از %{SQL-User-Name} در پرس‌وجوهای SQL استفاده کنید. این کار تضمین می‌کند که Username برای تمام پرس‌وجوهای SQL اجرا شده به صورت یکدست و سازگار پردازش شود.
.IP default_user_profile
نام نمایهٔ پیش‌فرضی است که در صورت تنظیم، به همهٔ کاربران اعمال خواهد شد. این گزینه به‌طور پیش‌فرض تنظیم نشده است.
.IP query_on_not_found
این گزینه روی 'yes' یا 'no' تنظیم می‌شود. اگر روی yes تنظیم شده باشد، در صورتی که هیچ تطابق خاصی برای کاربر پیدا نشود، نمایهٔ کاربری پیش‌فرض بازگردانده می‌شود.
.IP authorize_check_query
.IP authorize_reply_query
این پرس‌وجوها در مرحلهٔ مجوزدهی اجرا می‌شوند تا اطلاعات مجوز کاربر را از ${authcheck_table} و ${authreply_table} استخراج کنند.
.IP authorize_group_check_query
.IP authorize_group_reply_query
این پرس‌وجوها در مرحلهٔ مجوزدهی اجرا می‌شوند تا اطلاعات مجوز گروه را از ${groupcheck_table} و ${groupreply_table} استخراج کنند.
.IP accounting_onoff_query
پرس‌وجویی که هنگام دریافت بستهٔ Accounting On یا Accounting Off اجرا می‌شود.
.IP accounting_update_query
.IP accounting_update_query_alt
پرس‌وجویی که هنگام دریافت بستهٔ Accounting Update اجرا می‌شود. اگر پرس‌وجوی اصلی ناموفق باشد، پرس‌وجوی alt اجرا خواهد شد.
.IP accounting_start_query
.IP accounting_start_query_alt
پرس‌وجویی که هنگام دریافت بستهٔ Accounting Start اجرا می‌شود. اگر پرس‌وجوی اصلی ناموفق باشد، پرس‌وجوی alt اجرا خواهد شد.
.IP accounting_stop_query
.IP accounting_stop_query_alt
پرس‌وجویی که هنگام دریافت بستهٔ Accounting Stop اجرا می‌شود. اگر پرس‌وجوی اصلی ناموفق باشد، پرس‌وجوی alt اجرا خواهد شد.
.IP simul_count_query
پرس‌وجویی که برای بازگرداندن تعداد نشست‌های هم‌زمان به منظور محدود کردن Simultaneous Use اجرا می‌شود.
.IP simul_verify_query
پرس‌وجویی برای بازگرداندن اطلاعات جزئی مورد نیاز جهت تأیید اینکه تمام نشست‌های مشکوک متصل‌شده معتبر هستند و نشست‌های معلق نیستند.
.IP group_membership_query
پرس‌وجویی که برای بررسی عضویت کاربر در گروه اجرا می‌شود.
.IP postauth_query
پرس‌وجویی که در مرحلهٔ پس از احراز هویت اجرا می‌شود.
.SH "پیکربندی (CONFIGURATION)"
.PP
به دلیل حجم زیاد پیکربندی این ماژول، در این صفحهٔ راهنما گنجانده نشده است. لطفاً برای مشاهدهٔ پرس‌وجوهای نمونه و جزئیات پیکربندی، فایل‌های پیکربندی ارائه‌شده همراه برنامه را بررسی کنید.
.SH "بخش‌ها (SECTIONS)"
.BR authorization ,
.BR accounting ,
.BR checksimul ,
.BR post-authentication
.PP
.SH "فایل‌ها (FILES)"
.I /etc/raddb/radiusd.conf ,
.I /etc/raddb/sql.conf ,
.I /etc/raddb/sql/<DB>/dialup.conf ,
.I /etc/raddb/sql/<DB>/schema.sql ,
.BR
.PP
.SH "همچنین ببینید (SEE ALSO)"
.BR radiusd (8),
.BR radiusd.conf (5)
.SH "نویسندگان (AUTHORS)"
Chris Parker, cparker@segv.org