نام (NAME)

rlm_sql - ماژول پایگاه‌داده FreeRADIUS

توضیحات (DESCRIPTION)

ماژول rlm_sql یک رابط SQL برای بازیابی اطلاعات مجوزدهی (authorization) و ذخیره‌سازی اطلاعات حسابرسی (accounting) فراهم می‌کند. این ماژول می‌تواند همراه با ماژول‌های files و detail، یا به‌جای آن‌ها استفاده شود. ماژول SQL درایورهایی برای پشتیبانی از پایگاه‌های دادهٔ SQL زیر دارد:

     db2
     iodbc
     mysql
     oracle
     postgresql
     sybase
     unixodbc

به دلیل حجم زیاد متغیرهای پیکربندی، ماژول sql معمولاً در یک فایل جداگانه پیکربندی می‌شود که از طریق یک دستورالعمل include در فایل اصلی radiusd.conf گنجانده می‌شود.

مهم‌ترین موارد پیکربندی که باید به آن‌ها توجه شود عبارتند از:

driver: این متغیر درایوری را که باید بارگذاری شود مشخص می‌کند.
server
login
password: این متغیرها نام سرور، نام کاربری و گذرواژه‌ای را مشخص می‌کنند که ماژول برای اتصال به پایگاه داده استفاده خواهد کرد.
radius_db: نام پایگاه داده‌ای که جدول‌های radius در آن ذخیره شده‌اند.
acct_table1
acct_table2: این موارد نام جدول‌ها را برای رکوردهای accounting مشخص می‌کنند. متغیر acct_table1 جدولی را مشخص می‌کند که رکوردهای Start در آن ذخیره می‌شوند. متغیر acct_table2 جدولی را مشخص می‌کند که رکوردهای Stop در آن ذخیره می‌شوند. در بیشتر موارد، این متغیرها باید به یک جدول یکسان اشاره کنند.
postauth_table: نام جدولی برای ذخیره‌سازی داده‌های پس از احراز هویت (post-authentication).
authcheck_table
authreply_table: جدول‌هایی که Check-Items و Reply-Items هر کاربر در آن‌ها ذخیره می‌شوند.
groupcheck_table
groupreply_table: جدول‌هایی که Check-Items و Reply-Items مربوط به گروه‌ها در آن‌ها ذخیره می‌شوند.
usergroup_table: جدولی که ارتباط بین نام کاربری و گروه‌ها در آن ذخیره می‌شود.
deletestalesessions: این گزینه روی 'yes' یا 'no' تنظیم می‌شود. اگر در حال بررسی Simultaneous-Use هستید و این گزینه روی yes تنظیم شده باشد، نشست‌های معلق و قدیمی (که به عنوان نشست‌هایی تعریف می‌شوند که رکورد Stop برای آن‌ها دریافت نشده است) پاکسازی می‌شوند.
logfile: این گزینه برای اشکال‌زدایی مشکلات sql مفید است. اگر logfile تنظیم شده باشد، تمام پرس‌وجوهای sql برای بخش مربوطه در فایل مشخص‌شده نوشته می‌شوند. این قابلیت برای اشکال‌زدایی و درج‌های دسته‌ای (bulk inserts) کاربرد دارد.
num_sql_socks: تعداد اتصالات sql که باید با پایگاه داده برقرار شوند.
connect_failure_retry_delay: تعداد ثانیه‌هایی که باید پیش از تلاش مجدد برای اتصال به یک پایگاه داده با اتصال ناموفق سپری شود.
sql_user_name: این تعریف مشخصهٔ SQL-User-Name است. این متغیر یک‌بار تنظیم می‌شود تا بتوانید به‌جای جایگزینی‌های تودرتوی نام کاربری، از %{SQL-User-Name} در پرس‌وجوهای SQL استفاده کنید. این کار تضمین می‌کند که Username برای تمام پرس‌وجوهای SQL اجرا شده به صورت یکدست و سازگار پردازش شود.
default_user_profile: نام نمایهٔ پیش‌فرضی است که در صورت تنظیم، به همهٔ کاربران اعمال خواهد شد. این گزینه به‌طور پیش‌فرض تنظیم نشده است.
query_on_not_found: این گزینه روی 'yes' یا 'no' تنظیم می‌شود. اگر روی yes تنظیم شده باشد، در صورتی که هیچ تطابق خاصی برای کاربر پیدا نشود، نمایهٔ کاربری پیش‌فرض بازگردانده می‌شود.
authorize_check_query
authorize_reply_query: این پرس‌وجوها در مرحلهٔ مجوزدهی اجرا می‌شوند تا اطلاعات مجوز کاربر را از ${authcheck_table} و ${authreply_table} استخراج کنند.
authorize_group_check_query
authorize_group_reply_query: این پرس‌وجوها در مرحلهٔ مجوزدهی اجرا می‌شوند تا اطلاعات مجوز گروه را از ${groupcheck_table} و ${groupreply_table} استخراج کنند.
accounting_onoff_query: پرس‌وجویی که هنگام دریافت بستهٔ Accounting On یا Accounting Off اجرا می‌شود.
accounting_update_query
accounting_update_query_alt: پرس‌وجویی که هنگام دریافت بستهٔ Accounting Update اجرا می‌شود. اگر پرس‌وجوی اصلی ناموفق باشد، پرس‌وجوی alt اجرا خواهد شد.
accounting_start_query
accounting_start_query_alt: پرس‌وجویی که هنگام دریافت بستهٔ Accounting Start اجرا می‌شود. اگر پرس‌وجوی اصلی ناموفق باشد، پرس‌وجوی alt اجرا خواهد شد.
accounting_stop_query
accounting_stop_query_alt: پرس‌وجویی که هنگام دریافت بستهٔ Accounting Stop اجرا می‌شود. اگر پرس‌وجوی اصلی ناموفق باشد، پرس‌وجوی alt اجرا خواهد شد.
simul_count_query: پرس‌وجویی که برای بازگرداندن تعداد نشست‌های هم‌زمان به منظور محدود کردن Simultaneous Use اجرا می‌شود.
simul_verify_query: پرس‌وجویی برای بازگرداندن اطلاعات جزئی مورد نیاز جهت تأیید اینکه تمام نشست‌های مشکوک متصل‌شده معتبر هستند و نشست‌های معلق نیستند.
group_membership_query: پرس‌وجویی که برای بررسی عضویت کاربر در گروه اجرا می‌شود.
postauth_query: پرس‌وجویی که در مرحلهٔ پس از احراز هویت اجرا می‌شود.

پیکربندی (CONFIGURATION)

به دلیل حجم زیاد پیکربندی این ماژول، در این صفحهٔ راهنما گنجانده نشده است. لطفاً برای مشاهدهٔ پرس‌وجوهای نمونه و جزئیات پیکربندی، فایل‌های پیکربندی ارائه‌شده همراه برنامه را بررسی کنید.

بخش‌ها (SECTIONS)

authorization, accounting, checksimul, post-authentication

فایل‌ها (FILES)

/etc/raddb/radiusd.conf , /etc/raddb/sql.conf , /etc/raddb/sql/<DB>/dialup.conf , /etc/raddb/sql/<DB>/schema.sql ,

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

radiusd(8), radiusd.conf(5)

نویسندگان (AUTHORS)

Chris Parker, cparker@segv.org