.\"     # DS - begin display
.de DS
.RS
.nf
.sp
..
.\"     # DE - end display
.de DE
.fi
.RE
.sp
..
.TH rlm_realm 5 "14 March 2004" "" "ماژول FreeRADIUS"
.SH "نام (NAME)"
rlm_realm \- ماژول هدایت قلمروها (realm) در FreeRADIUS
.SH "توضیحات (DESCRIPTION)"
ماژول
\fIrlm_realm\fP
مشخصه‌ی
.B User-Name
را به دو بخش
User
و
Realm
تجزیه می‌کند. این ماژول اصولاً در سناریوهای پروکسی به کار می‌رود؛ با این حال، می‌توان از
Realms
به‌صورت محلی نیز برای ارائه‌ی نمایه‌های (profiles) سرویس متفاوت بر اساس
Realm
استفاده‌شده بهره برد.
.PP
مهم‌ترین موارد پیکربندی که باید از آن‌ها آگاه بود عبارتند از:
.IP format
این مقدار می‌تواند
.B 'prefix'
یا
.B 'suffix'
باشد. مشخص می‌کند که آیا
Realm
قبل از بخش
User
در رشته‌ی
.B User-Name
می‌آید یا پس از آن.
.IP delimiter
یک تک‌نویسه (کاراکتر) درون نقل‌قول، که به‌عنوان نویسه‌ی جداکننده‌ی بخش‌های
Realm
و
User
در رشته استفاده می‌شود.
.IP ignore_default
این مقدار روی
.B 'yes'
یا
.B 'no'
تنظیم می‌شود. در صورت تنظیم روی
.BR 'yes' ،
این گزینه از تطبیق یک قلمرو با مدخل
.B DEFAULT
توسط نمونه‌ی ماژول جلوگیری می‌کند. این ویژگی در زمان داشتن چندین نمونه از ماژول
realm
می‌تواند مفید باشد. مقدار پیش‌فرض
.B 'no'
است.
.IP ignore_null
این مقدار روی
.B 'yes'
یا
.B 'no'
تنظیم می‌شود. در صورت تنظیم روی
.BR 'yes' ،
این گزینه از تطبیق یک قلمرو با مدخل
.B NULL
توسط نمونه‌ی ماژول جلوگیری می‌کند. این ویژگی در زمان داشتن چندین نمونه از ماژول
realm
می‌تواند مفید باشد. مقدار پیش‌فرض
.B 'no'
است.
.PP
این ماژول
realm
را با توجه به پیکربندی نمونه، از مشخصه‌ی
.B User-Name
تجزیه می‌کند و سپس برای یافتن
realm
مطابق در فایل
.I /etc/raddb/proxy.conf
جستجو انجام می‌دهد. بسته به پیکربندی
Realm
تطبیق‌یافته در فایل، نام کاربری ممکن است با قالب «خالص‌شده» (stripped) بازنویسی شود یا بخش
Realm
آن حذف گردد. در هر صورت، هنگام تطابق، یک مشخصه‌ی
Realm
ایجاد شده و به بسته اضافه می‌شود که می‌تواند توسط سایر ماژول‌ها مورد استفاده قرار گیرد.
.SH "پیکربندی (CONFIGURATION)"
.PP
.DS
modules {
  ... stuff here ...
.br
.br
  # useranme@realm syntax
.br
  realm suffix {
.br
    format = suffix
.br
    delimiter = "@"
.br
  }
.br
.br
   # realm/username syntax
.br
   realm prefix {
.br
    format = prefix
.br
    delimiter = "/"
.br
  }
.br
.br
  ... stuff here ...
.br
}
.DE
.PP
.SH "بخش‌ها (SECTIONS)"
.BR authorization ,
.BR pre-accounting
.PP
.SH "فایل‌ها (FILES)"
.IR /etc/raddb/radiusd.conf ,
.I /etc/raddb/proxy.conf
.PP
.SH "همچنین ببینید (SEE ALSO)"
.BR radiusd (8),
.BR radiusd.conf (5),
.BR proxy.conf (5)
.SH "نویسندگان (AUTHORS)"
Chris Parker, cparker@segv.org