36.1. HTTP resource

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:

[Tip]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]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

Start page. "SYS" or file name with related URL (E.g.: "/default.htm" or "/root/home.htm" ). Max. 128 characters. Case is preserved. Spaces are allowed. Strings holding spaces must be written between quotation marks (E.g.: "/My url/index.htm")

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]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).