45.1. HTTP resource

45.1. HTTP resource
	Chapter 45. HTTP - HyperText Transfer Protocol

The 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.

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

Allowing access only to a restricted list of IP addresses;
Configuring http rights for users.

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

45.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

45.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

State changes log and alarm generation [NO, D, S, A, L, T, ALL] [+E] (D: Debug Log; S: System Log; A: Alarm view; L: Local audible alarm; T: SNMP traps; +E: Extended Log of state changes, see ref. manual).

ACT

Operation activation [NO, YES].

LOGIN-COOKIE-TOUT

Lifetime of the cookie used to store login information [NOMAX, 5..65534 min.].

WDIR

Directory where temporary files are saved. Full path with drive letter ['C'..'Z'] terminated by '\'. Max 128 chars. Spaces require double quotes (E.g. "C:\My dir\").

START-PAGE

Start page. SYS or file name with related URL (E.g. "/default.htm" or "/root/home.htm" ). Max 128 chars. Spaces require double quotes (E.g. "/My url/index.htm").

CORS-DOMAINS-LIST

List of domains for which CORS are enabled. # or * or the name of a TXT list.

#: CORS disabled.
*: CORS enabled for any domain.
<list-name>: CORS enabled for selected domains.

SYS-CSS

Cascading Style Sheets for dynamic pages. SYS or file name with related URL (E.g. http://www.mysite.com/css/mycpxcss.css or /pub/mycss/mycpxcss.css). Max 128 char. Spaces require double quotes (E.g. "/My url/my css.css").

ACT-P

HTTP activation or redirection to HTTPS [NO, YES, REDIR-HTTPS]:

NO: HTTP inactive, not listening.
YES: HTTP active, listening.
REDIR-HTTPS: HTTP is listening but forces URL redirection to HTTPS.

tcp-locport-p

HTTP local TCP port number [1..65535].

sesnum-p

Number of HTTP sessions [0..255].

IPSRC-P

HTTP incoming requests: accepted source IP address [*, 1-126.x.x.x, 127.0.0.1, 128-223.x.x.x].

IPSRCLIST-P

HTTP incoming requests: list of further accepted source IP addresses [#, IP/IR/RU/MR listname].

ACT-S

HTTPS activation.

tcp-locport-s

HTTPS local TCP port number [1..65535].

sesnum-s

Number of HTTPS sessions [0..255].

IPSRC-S

HTTPS incoming requests: accepted source IP address [*, 1-126.x.x.x, 127.0.0.1, 128-223.x.x.x].

IPSRCLIST-S

HTTPS incoming requests: list of further accepted source IP addresses [#, IP/IR/RU/MR listname].

CHAT-GATEWAY-URL

Url, with optional http:// or https://, of the XMPP gateway. Max 128 chars. Spaces require double quotes (E.g. "http://a k.it:333/a").

CHAT-SERVER

IP address [1-126.x.x.x, 127.0.0.1, 128-223.x.x.x] or FQDN name of the XMPP server. From 0 up to 64 characters in the range ['0'..'9', 'a'..'z', '-', '.' ]. FQDN name is forced to lower case.

CHAT-DOMAIN

Domain of CHAT users. AUTO or IP address [1-126.x.x.x, 127.0.0.1, 128-223.x.x.x] or FQDN name. From 0 up to 64 characters in the range ['0'..'9', 'a'..'z', '-', '.' ]. FQDN name is forced to lower case. When AUTO, the value of CHAT-SERVER is used.

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 45. HTTP - HyperText Transfer Protocol		45.2. HTTP tables