RAZOR-ADMIN(1) User Contributed Perl Documentation RAZOR-ADMIN(1)

razor-admin - عامل ثبت‌نام Razor

razor-admin [options]  [ -register | -create | -discover ]

"razor-admin" عامل Razor است که عملکردهای مدیریتی را انجام می‌دهد، به‌ویژه ثبت‌نام (-register).

"razor-admin" باید یکی از آرگومان‌های زیر را داشته باشد:

"-register"
یک هویت جدید را ثبت می‌کند که برای احراز هویت با سرورهای Razor Nomination به کار می‌رود. هویت‌ها یک جفت نام کاربری + گذرواژه هستند که در "<razorhome>/identity-<user>" ذخیره می‌شوند. نخستین باری که "razor-admin -register" با موفقیت به پایان برسد، یک پیوند نمادین (symlink) به نام "identity" ایجاد می‌شود تا به فایل فعال "identity-<user>" اشاره کند. پس از آن، هویت‌های جدید نیز می‌توانند ایجاد شوند، اما برای استفاده از آن‌ها باید پیوند نمادین "identity" تغییر داده شود تا به آن‌ها اشاره نماید. به‌طور کلی، این دستور باید یک بار از خط فرمان اجرا شود. در صورت موفقیت با کد 0 و در صورت بروز خطا با کد 1 همراه با یک پیام خروجی خوانا برای انسان خارج می‌شود.

هر دو دستور razor-report(1) و razor-revoke(1) برای کار کردن به احراز هویت کاربر نیاز دارند، در حالی که razor-check(1) نیازی ندارد. این به سرور Razor Nomination اجازه می‌دهد تا تعداد پیام‌هایی را که یک کاربر گزارش یا لغو می‌کند، پیگیری نماید. هرچه کاربر پیام‌های بیشتری را به‌درستی گزارش کرده و/یا به‌درستی لغو کند، اعتبار بیشتری کسب می‌کند. به همین ترتیب، اگر پیام‌ها به‌نادرست گزارش یا لغو شوند، اعتماد به آن کاربر کاهش می‌یابد. کاربرانی با درجهٔ اعتماد بالا بیشترین تأثیر را روی پایگاه‌دادهٔ Razor خواهند داشت.

"-discover"
اکتشاف (discovery) را اجباری می‌کند. این کار فایل‌های "server.*.lst" را در <razorhome> ایجاد خواهد کرد.
"-create"
به‌طور صریح فایل "razor-agent.conf" را در <razorhome>، و همچنین در صورت عدم وجود، دایرکتوری <razorhome> را ایجاد می‌کند. در حالت عادی اگر "/etc/razor/razor-agent.conf" وجود داشته باشد آن را بارگذاری می‌کند و برای هر موردی که یافت نشود از مقادیر پیش‌فرض استفاده می‌نماید. برای ثبت‌نام در سرور تلاشی نمی‌کند، اما فرایند اکتشاف را انجام می‌دهد؛ گزینهٔ "-discover" را ببینید.

"razor-admin" آرگومان‌های اختیاری زیر را می‌پذیرد:

"-h"
پیام نحوهٔ استفاده را چاپ کرده و خارج می‌شود.
"-v"
شمارهٔ نسخه را چاپ کرده و خارج می‌شود.
"-d | --verbose"
اطلاعات اشکال‌زدایی را چاپ می‌کند.
"-debuglevel=n | -dl=n"
سطح اشکال‌زدایی را روی 'n' تنظیم می‌کند. پیش‌فرض بدون گزینهٔ "-d" برابر با 3، و همراه با آن 9 است.
"-s"
یک بررسی را شبیه‌سازی می‌کند. تمام کارها را به‌جز برقراری ارتباط با سرور انجام می‌دهد.
"-conf=filename"
یک فایل پیکربندی جایگزین را مشخص می‌کند. اگر مشخص نشود، مقدار آن محاسبه خواهد شد؛ برای جزئیات به صفحه راهنمای razor-agents(1) مراجعه کنید. برای گزینه‌های مختلف پیکربندی به صفحه راهنمای razor-agent.conf(5) مراجعه نمایید. مقدار پیش‌فرض "<razorhome>/razor-agent.conf" است.
"-home=directory"
دایرکتوری razorhome را مشخص می‌کند. این مکان جایی است که فایل پیکربندی، فایل‌های لاگ، هویت‌ها و فایل‌های سرور نگهداری می‌شوند. اگر مشخص نشود، محاسبه خواهد شد؛ برای جزئیات به صفحه راهنمای razor-agents(1) مراجعه کنید.
"-logfile=file"
فایلی را برای ثبت وقایع به‌جای مقدار تعیین‌شده در فایل پیکربندی مشخص می‌کند. مقدار پیش‌فرض "<razorhome>/razor-agent.log" است.
"-ident=filename"
یک فایل هویت را برای ذخیرهٔ هویت تازه ثبت‌شده مشخص می‌کند. اگر مشخص نشود، از "<razorhome>/identity-<user>" استفاده می‌شود.
"-rs=razor.server.com"
به‌جای خواندن "servers.nomination.lst" از این سرور Razor Nomination استفاده می‌کند.
"-user=user@domain.com"
درخواست می‌کند با این نام کاربری شناخته شود. باید کمتر از ۶۴ نویسه باشد و می‌تواند شامل A-Z، a-z، 0-9 و همچنین نویسه‌های قابل چاپ [مانند: - _ @ . + / ] باشد. اگر مشخص نشود، یک نام کاربری اختصاص داده خواهد شد. به کاربران Razor توصیه می‌شود که از نشانی‌های رایانامه خود به عنوان نام کاربری استفاده کنند.
"-pass=password"
این گذرواژه را درخواست می‌کند. نویسه‌های معتبر همانند گزینهٔ -user هستند. اگر مشخص نشود، یک گذرواژه اختصاص داده خواهد شد.
"-l"
هویت ایجادشده در طول این اجرای "razor-admin" به هویت پیش‌فرض تبدیل می‌شود. در حالت عادی، نخستین فایل هویتی که توسط "razor-admin" ایجاد می‌شود به عنوان پیش‌فرض به کار می‌رود.

در صورت عدم تعریف razorhome سراسری (حالت پیش‌فرض) در /etc/razor/razor-agents.conf، دایرکتوری .razor را در دایرکتوری خانگی کاربر ایجاد می‌کند.

در صورت تعریف razorhome سراسری در /etc/razor/razor-agents.conf، تلاش می‌کند از آن استفاده کند و در صورت عدم برخورداری از مجوزهای مناسب با خطا مواجه خواهد شد.

یک هویت جدید را ثبت کرده و آن را در <razorhome> ذخیره می‌کند. نام کاربری و گذرواژه توسط سرور ایجاد خواهند شد. داشتن یک هویت برای razor-report(1) و razor-revoke(1) الزامی است.
تلاش می‌کند یک هویت جدید با استفاده از نام کاربری 'me\@a.com' ثبت کند. اگر این نام کاربری قبلاً گرفته شده باشد، ناموفق خواهد بود.
دایرکتوری .razor را در دایرکتوری خانگی کاربر ایجاد می‌کند که در صورت عدم تعیین در خط فرمان، دایرکتوری خانگی پیش‌فرض خواهد بود. اطلاعات اشکال‌زدایی را به stdout ارسال کرده و با هیچ‌یک از سرورهای Razor ارتباط برقرار نمی‌کند.
دایرکتوری سراسری razorhome یعنی /etc/razor را ایجاد می‌کند. این دایرکتوری ویژه مکانی است که اگر هیچ razorhome خاصی در خط فرمان مشخص نشده باشد یا در دایرکتوری خانگی کاربر یافت نشود، به آن مراجعه خواهد شد.

Vipul Ved Prakash <mail@vipul.net> و Chad Norwood <chad@samo.org>

razor-agents(1), razor-agent.conf(5), razor-check(1), razor-report(1), razor-revoke(1), razor-whitelist(5)

این یک نرم‌افزار آزاد است که تحت مجوز Artistic License 2.0 توزیع می‌شود.

2026-04-06 perl v5.42.2