.\"     # DS - begin display
.de DS
.RS
.nf
.sp
..
.\"     # DE - end display
.de DE
.fi
.RE
.sp
..
.TH USERS 5 "04 Jan 2004" "" "FreeRADIUS user authorization file"
.SH "نام (NAME)"
users \- فایل مجوزدهی کاربران برای کارساز FreeRADIUS
.SH "توضیحات (DESCRIPTION)"
فایل‌های \fBusers\fP در دایرکتوری پیکربندی ماژول files، به‌طور پیش‌فرض در \fB/etc/raddb/mods-config/files/\fP قرار دارند. این فایل شامل مجموعه‌ای از دستورالعمل‌های پیکربندی است که توسط ماژول \fIfiles\fP برای تصمیم‌گیری درباره نحوهٔ احراز هویت و مجوزدهی به هر درخواست کاربر استفاده می‌شود.

هر خطی که با علامت هش
.RB (' # ')
شروع شود به عنوان کامنت در نظر گرفته شده و نادیده گرفته می‌شود.
.PP
هر مدخل (entry) از فایل با یک نام کاربری شروع می‌شود، که به دنبال آن فهرستی (احتمالاً خالی) از موارد بررسی (check items) می‌آید، همگی در یک خط. خط بعدی با یک نویسهٔ تب (tab) و فهرستی (احتمالاً خالی) از موارد پاسخ (reply items) آغاز می‌شود. هر مورد در فهرست موارد بررسی یا پاسخ، یک ویژگی (صفت یا attribute) به فرم \fBname = value\fP است. چندین مورد می‌توانند در یک خط قرار گیرند، که در این صورت باید با کاما از هم جدا شوند. موارد پاسخ ممکن است در چندین خط مشخص شوند، که در این حالت هر خط باید با یک کاما پایان یابد و آخرین خط از موارد پاسخ نباید با کاما پایان یابد.

موارد بررسی، فهرستی از ویژگی‌ها هستند که برای مطابقت با درخواست ورودی استفاده می‌شوند. اگر نام کاربری مطابقت داشته باشد، و تمام موارد بررسی نیز با درخواست ورودی تطابق داشته باشند، آنگاه موارد پاسخ به فهرست ویژگی‌هایی که در پاسخ به آن درخواست ارسال خواهند شد اضافه می‌شوند. این فرآیند برای تمام مدخل‌های موجود در فایل users تکرار می‌شود.

اگر درخواست ورودی با هیچ مدخلی مطابقت نداشته باشد، آنگاه درخواست رد (reject) می‌شود.

.SH "نکات مهم (CAVEATS)"
کلیدواژهٔ ویژهٔ \fBDEFAULT\fP با تمام نام‌های کاربری مطابقت دارد.

مدخل‌ها به ترتیب، از بالای فایل \fBusers\fP به سمت پایین پردازش می‌شوند. اگر یک مدخل شامل ویژگی ویژهٔ \fBFall-Through = No\fP در بخش پاسخ باشد، پردازش فایل متوقف شده و هیچ مدخل دیگری بررسی نمی‌شود. با هر فهرست مورد پاسخ که فاقد ویژگی \fBFall-Through\fP باشد، به گونه‌ای رفتار می‌شود که گویی ویژگی \fBFall-Through = No\fP را داراست.

اگر یک مدخل شامل ویژگی ویژهٔ \fBFall-Through = Yes\fP به عنوان صفت پاسخ باشد، پردازش به ترتیب به مدخل بعدی ادامه می‌یابد.

هنگام استفاده از \fBFall-Through\fP باید احتیاط کرد. کارساز باید در حالت اشکال‌زدایی (debugging) با تعدادی درخواست آزمایشی بررسی شود تا اطمینان حاصل گردد که مدخل‌های پیکربندی‌شده طبق انتظار عمل می‌کنند.

ویژگی ویژهٔ \fBAuth-Type\fP برای مشخص کردن نوع احراز هویت مورد استفاده برای آن کاربر به کار می‌رود. برای مشاهدهٔ فهرست مقادیر مجاز ویژگی \fBAuth-Type\fP به فایل \fBdictionary\fP مراجعه کنید.

پس از پردازش فایل \fBusers\fP، درخواست با استفاده از روش تعیین‌شده توسط \fBAuth-Type\fP احراز هویت می‌شود.

.SH "عملگرها (OPERATORS)"
علاوه بر \fB=\fP، ممکن است عملگرهای دیگری نیز برای ویژگی‌ها در فهرست موارد بررسی یا موارد پاسخ استفاده شوند. در ادامه فهرستی از عملگرها و معانی آن‌ها آمده است:

.TP 0.5i
.B "Attribute = Value"
به عنوان یک مورد بررسی برای ویژگی‌های پروتکل RADIUS مجاز نیست. برای ویژگی‌های پیکربندی کارساز (مانند Auth-Type و غیره) مجاز است و مقدار یک ویژگی را تنها در صورتی تنظیم می‌کند که هیچ مورد دیگری از همان ویژگی وجود نداشته باشد.
.br
به عنوان یک مورد پاسخ، به این معناست: «این مورد را به فهرست پاسخ اضافه کن، اما فقط اگر هیچ مورد دیگری از همان ویژگی وجود نداشته باشد.»

.TP 0.5i
.B "Attribute := Value"
به عنوان یک مورد بررسی همواره مطابقت می‌یابد، و در موارد پیکربندی هر ویژگی با همان نام را جایگزین می‌کند. اگر هیچ ویژگی‌ای با آن نام در درخواست ظاهر نشود، این ویژگی اضافه می‌گردد.
.br
به عنوان یک مورد پاسخ، معنایی مشابه دارد، اما این عمل به جای موارد درخواست، برای موارد پاسخ اعمال می‌شود.

.TP 0.5i
.B "Attribute == Value"
به عنوان یک مورد بررسی، در صورتی مطابقت دارد که ویژگی نام‌برده در درخواست موجود باشد، و مقدار داده‌شده را نیز داشته باشد.
.br
به عنوان یک مورد پاسخ مجاز نیست.

.TP 0.5i
.B "Attribute += Value"
به عنوان یک مورد بررسی همواره مطابقت می‌یابد، و ویژگی جاری را با مقدار مشخص به انتهای فهرست موارد پیکربندی اضافه می‌کند.
.br
به عنوان یک مورد پاسخ، معنایی مشابه دارد، اما ویژگی به انتهای فهرست موارد پاسخ اضافه می‌شود.

.TP 0.5i
.B "Attribute ^= Value"
به عنوان یک مورد بررسی همواره مطابقت می‌یابد، و ویژگی جاری را با مقدار مشخص به ابتدای فهرست موارد پیکربندی اضافه می‌کند.
.br
به عنوان یک مورد پاسخ، معنایی مشابه دارد، اما ویژگی به ابتدای فهرست موارد پاسخ اضافه می‌شود.

.TP 0.5i
.B "Attribute != Value"
به عنوان یک مورد بررسی، در صورتی مطابقت دارد که ویژگی داده‌شده در درخواست موجود باشد، و دارای مقدار داده‌شده نباشد.
.br
به عنوان یک مورد پاسخ مجاز نیست.

.TP 0.5i
.B "Attribute > Value"
به عنوان یک مورد بررسی، در صورتی مطابقت دارد که درخواست شامل ویژگی‌ای با مقداری بزرگ‌تر از مقدار داده‌شده باشد.
.br
به عنوان یک مورد پاسخ مجاز نیست.

.TP 0.5i
.B "Attribute >= Value"
به عنوان یک مورد بررسی، در صورتی مطابقت دارد که درخواست شامل ویژگی‌ای با مقداری بزرگ‌تر یا مساوی با مقدار داده‌شده باشد.
.br
به عنوان یک مورد پاسخ مجاز نیست.

.TP 0.5i
.B "Attribute < Value"
به عنوان یک مورد بررسی، در صورتی مطابقت دارد که درخواست شامل ویژگی‌ای با مقداری کوچک‌تر از مقدار داده‌شده باشد.
.br
به عنوان یک مورد پاسخ مجاز نیست.

.TP 0.5i
.B "Attribute <= Value"
به عنوان یک مورد بررسی، در صورتی مطابقت دارد که درخواست شامل ویژگی‌ای با مقداری کوچک‌تر یا مساوی با مقدار داده‌شده باشد.
.br
به عنوان یک مورد پاسخ مجاز نیست.

.TP 0.5i
.B "Attribute =* Value"
به عنوان یک مورد بررسی، در صورتی مطابقت دارد که درخواست شامل ویژگی نام‌برده باشد، بدون توجه به این که مقدار آن چه باشد.
.br
به عنوان یک مورد پاسخ مجاز نیست.

.TP 0.5i
.B "Attribute !* Value"
به عنوان یک مورد بررسی، در صورتی مطابقت دارد که درخواست فاقد ویژگی نام‌برده باشد، بدون توجه به این که مقدار آن چه باشد.
.br
به عنوان یک مورد پاسخ مجاز نیست.

.SH "مثال‌ها (EXAMPLES)"

.DS
bob	Cleartext-Password := "hello"

.DE
.RS
درخواست‌های حاوی ویژگی User-Name با مقدار «bob»، با استفاده از گذرواژهٔ معتبر «hello» احراز هویت خواهند شد. هیچ مورد پاسخی وجود ندارد، بنابراین پاسخ ارسالی خالی خواهد بود.
.RE

.DS
DEFAULT Service-Type == Framed-User, Framed-Protocol == PPP
.br
	Service-Type = Framed-User,
.br
	Framed-Protocol = PPP,
.br
	Fall-Through = Yes

.DE
.RS
اگر بستهٔ درخواست حاوی ویژگی‌های Service-Type و Framed-Protocol با مقادیر داده‌شده باشد، آنگاه این ویژگی‌ها در پاسخ گنجانده می‌شوند.

یعنی به کاربر همان چیزی که درخواست کرده داده می‌شود. این مدخل همچنین نحوهٔ تعیین چندین مورد پاسخ را نشان می‌دهد.
.RE

برای مثال‌ها و توضیحات بیشتر، فایل \fBusers\fP ارائه‌شده همراه با کارساز را مشاهده کنید.

.SH "راهنماها و نکات (HINTS)"
کارساز را در حالت اشکال‌زدایی (\fB-X\fP) اجرا کنید، و از برنامهٔ \fBradclient\fP برای ارسال بسته‌های آزمایشی که فکر می‌کنید با مدخل‌های خاصی مطابقت دارند استفاده نمایید. کارساز چاپ خواهد کرد که کدام مدخل‌ها برای آن درخواست مطابقت داشته‌اند، تا بتوانید صحت انتظارات خود را ارزیابی کنید. این باید نخستین کاری باشد که در صورت شک داشتن به وجود مشکل در فایل انجام می‌دهید.

هنگام نوشتن مدخل‌ها برای فایل \fBusers\fP باید دقت زیادی به خرج داد. پیکربندی نادرست کارساز به گونه‌ای که درخواست‌ها در زمان تمایل شما به رد آن‌ها پذیرفته شوند، بسیار محتمل است. مدخل‌ها باید مرتب باشند و مورد Fall-Through فقط در جایی که واقعاً نیاز است استفاده شود.

مدخل‌هایی که درخواست‌های خاصی را رد می‌کنند باید در بالای فایل قرار گیرند و نباید در موارد پاسخ خود دارای Fall-Through باشند. مدخل‌های مربوط به کاربران خاص که فاقد Fall-Through هستند باید در ادامه بیایند. هرگونه مدخل DEFAULT معمولاً باید در پایان قرار گیرد، مگر در مورد مدخل‌های دارای Fall-Through که ویژگی‌های پاسخ را مقداردهی می‌کنند.

.SH "فایل‌ها (FILES)"
/etc/raddb/mods-config/files/
.SH "همچنین ببینید (SEE ALSO)"
.BR radclient (1),
.BR radiusd (8),
.BR dictionary (5)

.SH "نویسندگان (AUTHORS)"
تیم FreeRADIUS (The FreeRADIUS team).