نام (NAME)

hosts.conf - کنترل دسترسی برای برنامه‌های CGI ابزارهای Network UPS Tools

توضیحات (DESCRIPTION)

برنامه‌های CGI (upsset.cgi(8)، upsstats.cgi(8)، upsimage.cgi(8)) از این فایل برای تعیین مجاز بودن برقراری ارتباط با یک میزبان استفاده می‌کنند. این امر از سوءاستفاده بازدیدکنندگان تصادفی از وب‌سرور شما برای ایجاد اتصالات خروجی و ایجاد مزاحمت برای دیگران جلوگیری می‌کند.

نکات مهم (IMPORTANT NOTES)

•محتوای این فایل باید تماماً اسکی (ASCII) خالص باشد (کدهای نویسه‌ای خارج از این محدوده با یک پیام هشدار نادیده گرفته می‌شوند).

•این فایل حاوی گذرواژه نیست. پایش فقط‌خواندنی در NUT به‌صورت ناشناس انجام می‌شود، و برنامهٔ upsset(8) هنگام صدور دستور به یک یوپی‌اس خاص، اطلاعات هویتی را در نشست مرورگر درخواست می‌کند (وب‌سرور باید ایمن‌سازی شده باشد، همان‌طور که توسط فایل upsset.conf(5) به برنامه گزارش می‌شود).

دستورالعمل‌ها (DIRECTIVES)

MONITOR ups description

عنصر ups به فرم upsname[@hostname[:port]] است.

برای مجاز کردن اتصالات به یک یوپی‌اس به نام "snoopy" در سیستمی به نام "doghouse" که upsd را روی پورت 7877 اجرا می‌کند، پیکربندی به این شکل خواهد بود:

MONITOR snoopy@doghouse:7877 "Joe Cool"

توضیحات (description) باید یک عنصر واحد باشد، بنابراین اگر حاوی فاصله است، باید همان‌طور که در بالا نشان داده شده در علامت نقل‌قول قرار گیرد. نام میزبان پیش‌فرض "localhost" است.

CUSTOM_TEMPLATE_LIST filename, CUSTOM_TEMPLATE_SINGLE filename

برنامهٔ upsstats(8) امکان استفاده از فایل‌های قالب HTML سفارشی را برای برخی از خروجی‌های خود فراهم می‌کند (نشانه‌گذاری‌های JSON و "treemode" در حال حاضر درون فایل باینری کدگذاری ثابت شده‌اند)، که می‌توانید آن را در بخش رشته پرس‌وجو (query string) از آدرس اینترنتی URI (در index.html و/یا سلول‌های اضافه‌شدهٔ header.html) به‌عنوان مثال مشخص کنید:

.../cgi-bin/upsstats.cgi?template_single=custom-s.htm&template_list=custom-l.htm

+ نام‌های مشخص فایل برای یک نقش خاص باید با این دستورالعمل‌ها مجاز شوند (می‌توانند تکرار شوند). نام‌های فایل باید حاوی زیررشتهٔ .htm باشند و مستقیماً در دایرکتوری پیکربندی NUT قرار داشته باشند (مشابه قالب‌های پیش‌فرض). اگر قالب‌های سفارشی در URI درخواست اولیه استفاده شوند، به‌طور خودکار به پیوندهای تولیدشده افزوده خواهند شد (عمدتاً HOSTLINK، اما همچنین برای احتیاط به TREELINK و TREELINK_JSON اضافه می‌شوند؛ برای جزئیات بیشتر به upsstats.html(5) مراجعه کنید).

همچنین ببینید (SEE ALSO)

upsset.cgi(8), upsstats.cgi(8), upsimage.cgi(8)

منابع اینترنتی (Internet resources):

صفحهٔ خانگی NUT (Network UPS Tools): https://www.networkupstools.org/historic/v2.8.5