Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
XYMON-WEBACCESS(5)	      File Formats Manual	    XYMON-WEBACCESS(5)

NAME
       xymon-webaccess - Web-based access controls in Xymon

DESCRIPTION
       Xymon  does  not	provide	any built-in authentication (login) mechanism.
       Instead,	it relies on the access	controls available in your web server,
       e.g. the	Apache mod_auth	modules.

       This provides a simple way of controlling access	to the physical	direc-
       tories that make	up the pages and subpages with the  hosts  defined  in
       your  Xymon  hosts.cfg(5) setup - you can use the Apache	"require" set-
       ting to allow or	deny  access  to  information  on  any	page,  usually
       through	the  use of a "Require group ..." setting. The group name then
       refers to one or	more groups in an Apache AuthGroupFile file.

       However,	this does not work for the Xymon CGI programs since  they  are
       used to fetch information about all hosts in Xymon, but there is	only a
       single directory	holding	all of the CGI's. So here you can only require
       that the	user is	logged-in (the Apache "Require valid-user" directive).
       A user with a login can - if he knows the hostname - manipulate the re-
       quest  sent  to the webserver and fetch information about any status by
       use of the Xymon	CGI programs, even though he cannot see	 the  overview
       webpages.

       To alleviate this situation, the	following Xymon	CGI's support a	"--ac-
       cess=FILENAME" option, where FILENAME is	an Apache compatible group-de-
       finitions file:
       svcstatus.cgi(1)
       acknowledge.cgi(1)
       enadis.cgi(1)
       appfeed.cgi(1)

       When invoked with this option the CGI will read the Apache group-defin-
       itions  file, and assume	that an	Apache group maps to a Xymon page, and
       then - based on the logged-in userid - determine	which pages and	 hosts
       the user	is allowed access to.  Only information	about those hosts will
       be made available by the	CGI tool.

       Members of the group root has access to all hosts.

       Access  will  also  be granted, if the user is a	member of a group with
       the same	name as	the host being requested, or as	the statuscolumn being
       requested.

SEE ALSO
       The Apache "Authentication, Authorization and Access Control"  documen-
       tation, http://httpd.apache.org/docs/2.2/howto/auth.html

Xymon			  Version 4.3.30:  4 Sep 2019	    XYMON-WEBACCESS(5)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=xymonwebaccess&sektion=5&manpath=FreeBSD+Ports+14.3.quarterly>

home | help