BBMESSAGE.CGI(8)					      System Manager's Manual						  BBMESSAGE.CGI(8)

NAME

       bbmessage.cgi - CGI utility used for proxying Xymon data over HTTP

SYNOPSIS

       bbmessage.cgi

DESCRIPTION

       bbmessage.cgi(8)  is the server-side utility receiving Xymon messages sent by the bb(1) utility over an HTTP transport. The bb utility nor-
       mally sends data over a dedicated TCP protocol, but it may use HTTP to go through proxies or through restrictive firewalls. In  that  case,
       the  webserver  must  have this CGI utility installed, which takes care of receiving the message via HTTP, and forwards it to a local Xymon
       server through the normal Xymon transport.

       The CGI expects to be invoked from an HTTP "POST" request, with the POST-data being the status-message.	bbmessage.cgi simply collects  all
       of  the	POST  data,  and  send	it  off  as a message to the Xymon daemon running on IP 127.0.0.1. This destination IP currently cannot be
       changed.

       The CGI will return any output provided by the Xymon daemon back to the requestor as the response to the HTTP POST, so this allows for  all
       normal Xymon commands to work.

SECURITY

       bbmesage.cgi will only send data to a Xymon server through the loopback interface, i.e. IP-address 127.0.0.1.

       Access  to  the	CGI  should  be  restricted through webserver access controls, since the CGI provides no authentication at all to validate
       incoming messages.

       If possible, consider using the bbproxy(8) utility instead for native proxying of Xymon data between networks.

SEE ALSO

       bb(1), bbproxy(8), xymon(7)

Xymon							    Version 4.2.3:  4 Feb 2009						  BBMESSAGE.CGI(8)