36.1. HTTP resource

36.1. HTTP resource
	Chapter 36. HTTP - HyperText Transfer Protocol

Abilis HTTP server allows to access to the web interface. Many but not all configurations can be done using web pages. Only the CP allows to configure each Abilis feature.

Abilis HTTP server supports both PLAIN and SSL operations. The securty level can be managed by:

allowing access only to a restricted list of ip addresses;
configuring http rights for users.

	Tip
	Refer to Section 36.6, “Appendix - HTTP” to have more information about HTTP.

36.1.1. Activating the HTTP resource

Add the resource to the Abilis system with the following command:

[12:25:41] ABILIS_CPX:a res:http

RES:HTTP ALREADY EXISTS

The HTTP resource may already exist in the system, but may not yet be active: set it active with the command:

[12:25:44] ABILIS_CPX:s act res:http

COMMAND EXECUTED

	Caution
	After adding or setting the HTTP active, you must restart the Abilis to make the resource running (use the command warm start to reboot the Abilis).

[17:14:59] ABILIS_CPX:s p http act:yes

COMMAND EXECUTED

[17:15:17] ABILIS_CPX:d p http

RES:Http - Not Saved (SAVE CONF), Not Refreshed (INIT) ------------------------
Run    DESCR:HyperText_Transfer_Protocol
       LOG:NO                   ACT:YES              LOGIN-COOKIE-TOUT:1440
       WDIR:C:\APP\HTTP\
       START-PAGE:SYS (/sys/pub/cpx.htm)
       SYS-CSS:SYS (/sys/pub/cpx.css)
       CORS-DOMAINS-LIST:#                     
       - HTTP plain -----------------------------------------------------------
       ACT-P:YES                tcp-locport-p:80     sesnum-p:30
       IPSRC-P:*                IPSRCLIST-P:#                     
       - HTTP ssl -------------------------------------------------------------
       ACT-S:NO                 tcp-locport-s:443    sesnum-s:0
       IPSRC-S:*                IPSRCLIST-S:#                     
       - CHAT (XMPP) Provisioning ---------------------------------------------
       CHAT-GATEWAY-URL:
       CHAT-SERVER:
       CHAT-DOMAIN:AUTO

36.1.2. HTTP resource parameters

Use the following command to display the parameters of the resource; the d p http ? command shows the meaning of parameters.

[17:25:33] ABILIS_CPX:d p http

RES:Http ----------------------------------------------------------------------
Run    DESCR:HyperText_Transfer_Protocol
       LOG:NO                   ACT:YES              LOGIN-COOKIE-TOUT:1440
       WDIR:C:\APP\HTTP\
       START-PAGE:SYS (/sys/pub/cpx.htm)
       SYS-CSS:SYS (/sys/pub/cpx.css)
       CORS-DOMAINS-LIST:#                     
       - HTTP plain -----------------------------------------------------------
       ACT-P:YES                tcp-locport-p:80     sesnum-p:30
       IPSRC-P:*                IPSRCLIST-P:#                     
       - HTTP ssl -------------------------------------------------------------
       ACT-S:NO                 tcp-locport-s:443    sesnum-s:0
       IPSRC-S:*                IPSRCLIST-S:#                     
       - CHAT (XMPP) Provisioning ---------------------------------------------
       CHAT-GATEWAY-URL:
       CHAT-SERVER:
       CHAT-DOMAIN:AUTO

Meaning of the most important parameters:

LOG: Logging functionalities activation/deactivation.
ACT: Runtime HTTP activation/deactivation.
LOGIN-COOKIE-TOUT: Lifetime of the cookie used to store login information.
WDIR: Directory where temporary files are saved.
START-PAGE: Selects the HTTP start page.
CORS-DOMAINS-LIST: List of domains for which CORS are enabled.
SYS-CSS: Selects Cascading Style Sheets for dynamic pages.
ACT-P: Activates/deactivates the PLAIN protocol.
sesnum-p: HTTP TCP/IP PLAIN sessions number.
IPSRC-P: Client IP addresses allowed to connect to HTTP server in PLAIN mode.
IPSRCLIST-P: Additional list of client IP addresses allowed to connect to HTTP server in PLAIN mode.
ACT-S: Activates/deactivates the SSL protocol.
sesnum-s: HTTP TCP/IP SSL sessions number.
IPSRC-S: Client IP addresses allowed to connect to HTTP server in SSL mode.
IPSRCLIST-S: Additional list of client IP addresses allowed to connect to HTTP server in PLAIN mode in SSL mode.
CHAT-GATEWAY-URL: Url, with optional http:// or https://, of the XMPP gateway.
CHAT-SERVER: IP address or FQDN name of the XMPP server.

The following command allows the administrator to change the configuration of the resource:

s p http parameter:value...

	Caution
	To activate the changes made on the upper case parameters, execute the initialization command init res:http; while to set act the changes made on the lowercase parameters a save conf and an Abilis restart are required (i.e. with warm start command).


Chapter 36. HTTP - HyperText Transfer Protocol		36.2. HTTP tables