.TH RADCLIENT 1 "21 May 2024" "" "FreeRADIUS Daemon"
.SH "نام (NAME)"
radclient \- ارسال بسته‌ها به سرور RADIUS و نمایش پاسخ
.SH "خلاصه دستور (SYNOPSIS)"
.B radclient
.RB [ \-4 ]
.RB [ \-6 ]
.RB [ \-b ]
.RB [ \-c
.IR count ]
.RB [ \-d
.IR raddb_directory ]
.RB [ \-D
.IR dictionary_directory ]
.RB [ \-f
.IR file ]
.RB [ \-F ]
.RB [ \-h ]
.RB [ \-i
.IR id ]
.RB [ \-n
.IR num_requests_per_second ]
.RB [ \-p
.IR num_requests_in_parallel ]
.RB [ \-q ]
.RB [ \-r
.IR num_retries ]
.RB [ \-s ]
.RB [ \-S
.IR shared_secret_file ]
.RB [ \-t
.IR timeout ]
.RB [ \-v ]
.RB [ \-x ]
\fIserver {acct|auth|status|coa|disconnect|auto} secret\fP
.SH "توضیحات (DESCRIPTION)"
\fBradclient\fP یک برنامه کلاینت radius است. این برنامه می‌تواند بسته‌های دلخواه radius را به یک سرور radius ارسال کند و سپس پاسخ را نمایش دهد. از آن می‌توان برای آزمایش تغییراتی که در پیکربندی سرور radius ایجاد کرده‌اید، یا برای نظارت بر فعال بودن سرور radius استفاده کرد.
.PP
\fBradclient\fP جفت‌های ویژگی/مقدار radius را از ورودی استاندارد خود، یا از یک فایل مشخص‌شده در خط فرمان می‌خواند. سپس این جفت‌های ویژگی/مقدار را با استفاده از دیکشنری کدگذاری کرده و به سرور راه دور ارسال می‌کند.
.PP
ویژگی‌های \fIUser-Password\fP و \fICHAP-Password\fP پیش از ارسال بسته به سرور به صورت خودکار رمزگذاری می‌شوند.

.SH "گزینه‌ها (OPTIONS)"

.IP \-4
استفاده از IPv4 (پیش‌فرض)
.IP \-6
استفاده از IPv6
.IP \-b
اعمال بررسی‌های Blast RADIUS. تمامی پاسخ‌ها به یک بسته Access-Request باید دارای Message-Authenticator به عنوان نخستین ویژگی باشند.

برای سازگاری با سرورهای قدیمی، این پرچم به صورت پیش‌فرض فعال نیست. با این حال، radclient همچنان امضای Blast RADIUS را بررسی کرده و بسته‌هایی را که با این حمله تطابق داشته باشند دور می‌اندازد.
.IP \-c\ \fIcount\fP
ارسال هر بسته به تعداد \fIcount\fP بار.
.IP \-d\ \fIraddb_directory\fP
پوشه‌ای که فایل دیکشنری کاربر در آن قرار دارد. پیش‌فرض \fI/etc/raddb\fP است.
.IP \-D\ \fIdictionary_directory\fP
پوشه‌ای که فایل دیکشنری اصلی در آن قرار دارد. پیش‌فرض \fI/usr/share/freeradius\fP است.
.IP \-f\ \fIfile[:file]\fP
فایلی برای خواندن جفت‌های ویژگی/مقدار. اگر این گزینه مشخص نشود، از ورودی استاندارد (stdin) خوانده می‌شوند. این گزینه را می‌توان چندین بار تعیین کرد؛ در این حالت بسته‌ها به ترتیب فایل‌ها و در هر فایل از نخستین بسته تا آخرین بسته ارسال می‌شوند. یک خط خالی، بسته‌های منطقی را درون یک فایل از هم جدا می‌کند. اگر جفتی از فایل‌ها که با دونقطه از یکدیگر جدا شده‌اند مشخص شود، فایل دوم برای پالایش (فیلتر کردن) پاسخ‌های مربوط به درخواست‌های فایل نخست استفاده خواهد شد. تعداد درخواست‌ها و فیلترها باید یکسان باشد. در صورت ارسال گزینه \-s، خلاصه‌ای از نتایج فیلتر نمایش داده می‌شود.
.IP \-F
چاپ نام فایل، شماره بسته و کد پاسخ.
.IP \-h
نمایش اطلاعات راهنمای نحوه استفاده.
.IP \-i\ \fIid\fP
استفاده از \fIid\fP به عنوان شناسه درخواست RADIUS.
.IP \-n\ \fInum_requests_per_second\fP
تلاش برای ارسال \fInum_requests_per_second\fP بسته در ثانیه با فواصل منظم. این گزینه به شما اجازه می‌دهد نرخ ارسال درخواست‌های radclient را کاهش دهید. هنگام عدم استفاده از \-n، حالت پیش‌فرض ارسال بسته‌ها در سریع‌ترین زمان ممکن و بدون وقفه بین بسته‌ای است.

به دلیل محدودیت‌های radclient، این گزینه تعداد بسته‌ها در ثانیه را با دقت کامل ارسال نمی‌کند.
.IP \-p\ \fInum_requests_in_parallel\fP
ارسال \fInum_requests_in_parallel\fP درخواست به صورت هم‌زمان، بدون انتظار برای دریافت پاسخ هر یک از آن‌ها. به طور پیش‌فرض، radclient نخستین درخواستی را که خوانده ارسال می‌کند، منتظر دریافت پاسخ می‌ماند، و پس از دریافت پاسخ، درخواست دوم موجود در فهرست را می‌فرستد. این گزینه امکان ارسال چندین درخواست را به طور هم‌زمان فراهم می‌سازد. پس از ارسال \fInum_requests_in_parallel\fP بسته، radclient تا زمان دریافت تمامی پاسخ‌ها (یا پایان مهلت زمانی درخواست‌ها) منتظر می‌ماند و سپس بسته‌های بعدی را ارسال می‌کند.

این گزینه به شما اجازه می‌دهد بیشترین بار کاری قابل پذیرش توسط سرور RADIUS را ارزیابی و کشف کنید.
.IP "\-P\ \fIproto\fP"
استفاده از پروتکل انتقال \fIproto\fP (مقدار "tcp" یا "udp").
تنها در صورتی در دسترس است که FreeRADIUS با پشتیبانی از انتقال TCP کامپایل شده باشد.
.IP \-q
ورود به حالت بی‌صدا (quiet) و عدم چاپ هرگونه خروجی.
.IP \-r\ \fInum_retries\fP
تلاش برای ارسال مجدد هر بسته به میزان \fInum_retries\fP بار، پیش از صرف‌نظر کردن از آن. مقدار پیش‌فرض ۱۰ است.
.IP \-s
چاپ خلاصه اطلاعات بسته‌های ارسالی و دریافتی.
.IP \-S\ \fIshared_secret_file\fP
به جای خواندن راز مشترک از خط فرمان (که برای سایر افراد در سیستم محلی قابل مشاهده است)، آن را از \fIshared_secret_file\fP می‌خواند.
.IP \-t\ \fItimeout\fP
انتظار به مدت \fItimeout\fP ثانیه پیش از نتیجه‌گیری اینکه NAS به درخواستی پاسخ نداده است و ارسال مجدد بسته. زمان انتظار پیش‌فرض ۳ ثانیه است.
.IP \-v
چاپ اطلاعات نسخه برنامه.
.IP \-x
چاپ اطلاعات اشکال‌زدایی (دیباگ).
.IP server[:port]
نام میزبان یا نشانی IP سرور راه دور. به صورت اختیاری می‌توان درگاه UDP را نیز مشخص کرد. اگر پورت UDP تعیین نشود، در \fI/etc/services\fP جستجو می‌شود. نام سرویس مورد جستجو برای بسته‌های حسابرسی \fBradacct\fP و برای سایر درخواست‌ها \fBradius\fP است. اگر سرویسی در \fI/etc/services\fP یافت نشود، به ترتیب پورت‌های ۱۸۱۳ و ۱۸۱۲ استفاده خواهند شد. برای بسته‌های coa و disconnect از پورت ۳۷۹۹ استفاده می‌شود.

اگر یک نام میزبان مشخص شود، radclient یک جستجوی DNS انجام داده و از رکورد A برای یافتن نشانی IP سرور RADIUS استفاده می‌کند. اگر رکورد A وجود نداشته باشد، radclient به دنبال رکورد AAAA می‌گردد. اگر رکورد AAAA نیز وجود نداشته باشد، خطایی صادر خواهد شد.

نشانی‌های IPv6 را می‌توان با قرار دادن آن‌ها در براکت مشخص کرد. برای نمونه [2002:c000:0201:0:0:0:0:0]، یا همراه با پورت، [2002:c000:0201:0:0:0:0:0]:18120.

ویژگی‌های RADIUS خوانده‌شده توسط \fIradclient\fP می‌توانند شامل ویژگی ویژه \fBPacket-Dst-IP-Address\fP باشند. اگر این ویژگی وجود داشته باشد، بسته به آن نشانی IP ارسال می‌شود و پارامتر \fBserver\fP مشخص‌شده در خط فرمان نادیده گرفته خواهد شد.

اگر فهرست ویژگی‌های RADIUS همواره دارای ویژگی \fBPacket-Dst-IP-Address\fP باشد، پارامتر \fBserver\fP می‌تواند به صورت \fB-\fP تعیین گردد.

ویژگی‌های RADIUS خوانده‌شده توسط \fIradclient\fP می‌توانند حاوی ویژگی ویژه \fBPacket-Dst-Port\fP باشند. در صورت وجود این ویژگی، بسته به آن درگاه UDP ارسال می‌شود و مقدار \fB:port\fP مشخص‌شده در خط فرمان نادیده گرفته خواهد شد.

.IP acct\ |\ auth\ |\ status\ |\ coa\ |\ disconnect\ |\ auto
استفاده از \fBauth\fP برای ارسال بسته احراز هویت (Access-Request)،
\fBacct\fP برای ارسال بسته حسابرسی (Accounting-Request)،
\fBstatus\fP برای ارسال بسته وضعیت (Status-Server)،
\fBcoa\fP برای ارسال بسته CoA-Request، یا
\fBdisconnect\fP برای ارسال درخواست قطع اتصال. به جای این مقادیر، می‌توانید از یک کد ده‌دهی نیز در اینجا استفاده کنید. برای نمونه، کد ۱۲ نیز معادل \fBStatus-Server\fP است.

ویژگی‌های RADIUS خوانده‌شده توسط \fIradclient\fP می‌توانند شامل ویژگی ویژه \fBPacket-Type\fP باشند. در صورت وجود این ویژگی، آن نوع بسته ارسال شده و مقدار \fItype\fP مشخص‌شده در خط فرمان نادیده گرفته می‌شود.

اگر فهرست ویژگی‌های RADIUS همواره شامل ویژگی \fBPacket-Type\fP باشد، پارامتر \fBtype\fP می‌تواند به صورت \fBauto\fP تعیین شود.

.IP secret
راز مشترک (shared secret) برای این کلاینت. این مقدار باید در سمت سرور radius نیز برای نشانی IP که بسته‌های radius را از آن می‌فرستید، تعریف شده باشد.

.SH "مثال (EXAMPLE)"

یک نمونه نشست که سرور راه دور را برای \fIStatus-Server\fP پرس‌وجو می‌کند (همه سرورها از این ویژگی پشتیبانی نمی‌کنند، اما FreeRADIUS دارای پشتیبانی قابل پیکربندی برای آن است).
.RS
.sp
.nf
.ne 3
$ echo "Message-Authenticator = 0x00" | radclient 192.0.2.42 status s3cr3t
Sending request to server 192.0.2.42, port 1812.
radrecv: Packet from host 192.0.2.42 code=2, id=140, length=54
    Reply-Message = "FreeRADIUS up 21 days, 02:05"
.fi
.sp
.RE

.SH "همچنین ببینید (SEE ALSO)"
radiusd(8)
.SH "نویسندگان (AUTHORS)"
Miquel van Smoorenburg, miquels@cistron.nl
.br
Alan DeKok <aland@freeradius.org>