.\" # DS - begin display .de DS .RS .nf .sp .. .\" # DE - end display .de DE .fi .RE .sp .. .TH rlm_passwd 5 "20 January 2015" "" "FreeRADIUS Module" .SH "نام (NAME)" rlm_passwd \- ماژول FreeRADIUS برای مجوزدهی با استفاده از فایل‌های با قالب مشابه passwd .SH "توضیحات (DESCRIPTION)" ماژول .I rlm_passwd قابلیت مجوزدهی (authorization) را از طریق فایل‌هایی با قالب مشابه .I /etc/passwd فراهم می‌کند. .PP این ماژول به شما امکان می‌دهد اطلاعات حساب‌های کاربری را از هر فایلی با قالب مشابه passwd (مانند .IR /etc/passwd ، .IR /etc/group ، .IR smbpasswd ، .I .htpasswd و غیره) بازیابی کنید. هر فیلد از فایل می‌تواند به یک مشخصه RADIUS نگاشت شود، در حالی که یکی از فیلدها به عنوان کلید استفاده می‌شود. .PP این ماژول فایل را هنگام مقداردهی اولیه می‌خواند و داده‌ها را در حافظه موقت (کش) ذخیره می‌کند. این کار باعث می‌شود تا سرعت عملکرد آن حتی برای فایل‌هایی با هزاران خط بسیار بالا باشد. برای خواندن مجدد فایل، باید ماژول با استفاده از .BR radmin (8) مجدداً بارگذاری شود یا یک سیگنال SIGHUP به سرور ارسال گردد، زیرا به‌روزرسانی‌های پویا پشتیبانی نمی‌شوند. .SH "پیکربندی (CONFIGURATION)" مورد یا موارد پیکربندی: .IP allow_multiple_keys اگر روی «yes» تنظیم شود و بیش از یک رکورد در فایل با درخواست مطابقت داشته باشد، مشخصه‌های تمام آن رکوردها استفاده خواهند شد. اگر روی «no» (مقدار پیش‌فرض) تنظیم شود، ماژول درباره رکوردهای تکراری هشدار می‌دهد. .IP delimiter\ =\ ":" نویسه‌ای که به عنوان جداکننده میان فیلدها استفاده می‌شود. مقدار پیش‌فرض ":" است. .IP filename مسیر فایل. .IP format قالب فیلدها در فایل که به شکل یک خط نمونه از فایل مشخص می‌شود؛ به طوری که محتوای فیلدها همان مشخصه‌های RADIUS است که فیلدها به آن‌ها نگاشت می‌شوند. فیلدها در پیکربندی با نویسه «:» از یکدیگر جدا می‌شوند (صرف‌نظر از اینکه چه مقداری برای گزینه «delimiter» تنظیم شده باشد). .IP hash_size اندازه جدول درهم‌سازی (hash table). مقدار بزرگ‌تر به معنای احتمال کمتر وقوع تداخل (collision) است، بنابراین رکوردها با سرعت بیشتری پیدا می‌شوند، هرچند حافظه بیشتری مصرف خواهد شد. داشتن hash_size در محدوده ۳۰ تا ۱۰۰ درصد تعداد رکوردهای فایل passwd معقول است. .IP ignore_empty هنگامی که روی «yes» (پیش‌فرض) تنظیم شود، فیلدهای خالی در ورودی نادیده گرفته می‌شوند و مشخصه RADIUS افزوده نخواهد شد. با تنظیم این مقدار روی «no»، تمام مشخصه‌های موجود در فهرست قالب همیشه اضافه خواهند شد، حتی اگر مقداری نداشته باشند. .IP ignore_nislike اگر روی «yes» تنظیم شود، تمام رکوردهای فایل که با علامت «+» شروع می‌شوند نادیده گرفته خواهند شد. مقدار پیش‌فرض «no» است. .SH "قالب (FORMAT)" گزینه .I format نحوه خوانده شدن خطوط از فایل و نگاشت فیلدها به مشخصه‌های RADIUS را کنترل می‌کند. .PP فیلد کلید، فیلدی است که درون فایل جستجو می‌شود. این فیلد معمولاً با قرار گرفتن یک نویسه «*» در ابتدای آن مشخص می‌شود که نشان می‌دهد این فیلد تنها یک کلید دارد، مانند فایل .IR /etc/passwd . فیلد کلید می‌تواند در عوض با «*,» آغاز شود که نشان می‌دهد این فیلد می‌تواند چندین کلید محتمل و جداشده با کاما داشته باشد، مانند زمان جستجو در فایل .IR /etc/group . .PP سایر فیلدها نشان‌دهنده مشخصه‌های RADIUS هستند. به طور پیش‌فرض، آن‌ها به عنوان یک فهرست مشخصه کنترلی (control attribute list) اضافه می‌شوند. .PP برای افزودن یک مشخصه به درخواست RADIUS (به گونه‌ای که گویی توسط NAS ارسال شده است)، نویسه \(aq~\(aq را به ابتدای نام مشخصه در رشته "format" اضافه کنید. .PP برای افزودن یک مشخصه به پاسخ RADIUS (جهت ارسال مجدد به NAS)، نویسه «=» را به ابتدای نام مشخصه در رشته "format" اضافه کنید. .SH "مثال‌ها (EXAMPLES)" .DS format = "*User-Name:Crypt-Password:" .DE .IP برای فایلی که ساختاری مشابه با .I /etc/passwd دارد. فیلد اول، .BR User-Name ، کلیدی است که باید در فایل جستجو شود. هنگامی که رکورد پیدا شود، یک مشخصه کنترلی به نام \(aqCrypt-Password\(aq با محتوای فیلد دوم اضافه خواهد شد. (توجه داشته باشید که این روش با گذرواژه‌های shadow کار نخواهد کرد.) .PP .DS format = "My-Group:::*,User-Name" .DE .IP تجزیه و تحلیل فایلی مشابه با فایل .IR /etc/group . یک مدخل زمانی با درخواست مطابقت دارد که نام موجود در مشخصه User-Name در فهرست مقادیر جداشده با کاما در خطی از فایل وجود داشته باشد. زمانی که یک مدخل تطبیق پیدا کند، یک مشخصه "My-Group" ایجاد شده و به موارد کنترلی درخواست افزوده می‌شود. مقدار این مشخصه از فیلد اولِ خطِ تطبیق‌یافته در فایل گرفته خواهد شد. .IP علامت ":::" در رشته قالب به این معناست که دو فیلد اضافی در آن خط، میان نام گروه و فهرست نام‌های کاربری وجود دارد. آن فیلدها به هیچ مشخصه RADIUS نگاشت نمی‌شوند و بنابراین نادیده گرفته خواهند شد. .IP برای اینکه این مثال در عمل کار کند، باید مشخصه My-Group را به فایل دیکشنری اضافه کنید. برای جزئیات در مورد نحوه انجام این کار، .BR dictionary (5) را ببینید. .PP .DS format = "~My-Group:::*,User-Name" .DE .IP مشابه مدخل قبلی است، با این تفاوت که مشخصه My-Group به خود درخواست اضافه می‌شود، گویی که توسط NAS ارسال شده باشد. .SH "بخش‌ها (SECTIONS)" .BR authorize .SH "فایل‌ها (FILES)" .I /etc/raddb/mods-available/passwd .SH "همچنین ببینید (SEE ALSO)" .BR radiusd (8), .BR radiusd.conf (5), .BR radmin (8), .BR dictionary (5), .BR rlm_unix (5) .SH "نویسندگان (AUTHORS)" Alan DeKok , Matthew Newton .