OpenSCADAWiki: Home Page En/Doc/HTTP ...

Home | Index | Changes | Comments | Users | Registration | Login  Password:  
 
This is an old revision of HomePageEn/Doc/HTTP from 2017-06-11 21:10:20..

The module <HTTP> of subsystem "Protocols"

Module: HTTP
Name: HTTP-realization
Type: Protocol
Source: prot_HTTP.so
Version: 2.0
Author: Roman Savochenko, Maxim Lysenko (2009)
Description: Provides support for the HTTP protocol for WWW-based user interfaces.
License: GPL

Contents

Introduction

Module of the transport protocol HTTP is designed to support the implementation of network protocol HTTP (Hypertext Transfer Protocol) in the system OpenSCADA.


HTTP Protocol is used to transfer the WWW contents. For example, via HTTP the following types of documents are transmitted: html, xhtml, png, java, and many others. Adding the HTTP support in OpenSCADA system together with the Sockets transport allows to implement various user functions based on the WWW interface. The module implements two main methods of the HTTP protocol: "GET" and "POST". "HTTP" module provides control of the integrity of HTTP-queries and, jointly with "Sockets" transport, allows to "collect" holistic requests of their fragments, as well as maintain the keeping of the connection alive (Keep-Alive).


For flexible connection of the user interfaces to the module the modular mechanism within the module HTTP is used. In the role of modules the modules of subsystem the "User interfaces" are used with the additional information field "SubType" with the value of "WWW".


In the requests for the Web resources the URL(Universal Resource Locator) are commonly used, hence the URL is passed as the main parameter via HTTP. The first element of the requested URL is used to identify the module UI. For example URL "http://localhost:10002/WebCfg" means — address to module WebCfg on the host "http://localhost:10002". In the case of an incorrect indication of the module ID, or when you address without identifier of the module at all, HTTP module generates the dialogue of the information on the input and with the choice of one of the available user interfaces. Example of a dialogue is shown in Figure 1.


Dialog of the choice of WWW-interface module. (39 Kb)
Fig.1. Dialog of the choice of WWW-interface module.

1. Authentication

Module supports authentication in the system OpenSCADA while providing access to the WEB-interface modules (Fig.2). Dialogue is formed in the language of "XHTML 1.0 Transitional"!


Authentication dialogue in the system OpenSCADA. (11 Kb)
Fig.2. Authentication dialogue in the system OpenSCADA.

For ease of Web-based interface module provides the ability to automatically log on behalf of the specified user. Configuring automatic login to make by the module settings page (Fig.3).


The module configuring page. (83 Kb)
Fig.3. The module configuring page.

On the module settings you observe active authentication sessions; specify: access rules for deny and allow, HTML-template of custom interface, HTML-template of custom main-page, the lifetime of the authentication and set up automatic login.


Any line is different rule and for the access rules you can use templates (like "*/WebVision/*") or regular expressions (like "/[^/]+/WebVision/.+/").


Automatic login is carried out by matching the address indicated in the column "Address", on behalf of the user specified in the column "User".


In the HTML-template's fields you must specify the address of the file HTML/XHTML, which will be used for formation of the internal/service and main-page interfaces. Internal/service interfaces for example, it's the WEB-modules selection, the login page and like ones of the WEB-modules. From the template required correct XHTML, allowing parse the file by XML-parser, and the presence of tags "#####CONTEXT#####" at the location of the dynamic content, for internal/service interfaces it's necessarily. Resource files of the templates represented by images, CSS and JavaScript files and its are searching from the directory in which the specified file location template and from the current directory. If errors are found in the template there will be use a standard builtin interface. For the templates example you can see to the most used templates:

2. The modules of user WEB-interface

Modules of the user interface (UI) designed to work with HTTP module, should indicate an information field "SubType" with the value "WWW" and "Auth" field with the value "1" if the module requires an authentication at login. For communication of HTTP module and UI modules an advanced communication mechanism is used. This mechanism involves the export of interface functions. In this case the UI modules must export the following function:

void HttpGet( const string &url, string &page, const string &sender, vector<string> &vars, const string &user ); — GET method with the parameters:
url — address of the request;
page — page with the answer;
sender — address of the sender;
vars — request variables;
user — user of the system;
iprt — pointer to an input part object of the protocol.

void HttpPost( const string &url, string &page, const string &sender, vector<string> &vars, const string &user ); — POST method with the parameters:
url — address of the request;
page — page with the answer and with the contents of the body of the POST request;
sender — address of the sender;
vars — request variables;
user — user of the system;
iprt — pointer to an input part object of the protocol.

Then, in the case of a HTTP GET request, the function HTTP_GET or HttpGet will be called, and in the case of the POST request, the function HTTP_POST or HttpPost will be called in the appropriate UI module.

3. Outgoing requests function's API

The outgoing function (messIO()) of API operate by HTTP-request's content which wrapped to XML-packages. The request structure is:

<req Host="host" URI="uri">
  <prm id="pId">pVal</prm>
  <cnt name="cName" filename="cFileName">
    <prm id="cpId">cpVal</prm>
    cVal
  </cnt>
  reqVal
</req>

Where:

Request result's structure is:

<req Host="host" URI="uri" err="err" Protocol="prt" RezCod="rCod" RezStr="rStr">
  <prm id="pId">pVal</prm>
  respVal
</req>

Where:

Into example role we accord using the function into users procedures for GET and POST requests making by language JavaLikeCalc.JavaScript:

//GET request for HTML-page
req = SYS.XMLNode("GET");
req.setAttr("URI","/");
SYS.Transport.Sockets.out_testHTTP.messIO(req,"HTTP");
test = req.text();

//GET request for file
req = SYS.XMLNode("GET");
req.setAttr("URI","/oscadaArch/Work/openscada-0.9-r2188.tar.lzma");
SYS.Transport.Sockets.out_testHTTP.messIO(req,"HTTP");
if(!req.attr("err").length) SYS.fileWrite("/var/tmp/recvFile.tmp", req.text());

//POST request
req = SYS.XMLNode("POST");
req.setAttr("URI","/WebUser/FlowTec.txt");
cntNode = req.childAdd("cnt").setAttr("name","pole0").setAttr("filename","Object2-k001-100309-17.txt");
cntNode.childAdd("prm").setAttr("id","Content-Type").setText("text/plain");
cntText = "Object2-k001\r\n";
cntText += "\r\n";
cntText += "v002\r\n";
cntText += " n1\r\n";
cntText += "  09.03.10 16   Polnyj    7155.25    216.0  32.000  17.5\r\n";
cntText += "v005\r\n";
cntText += " n1\r\n";
cntText += "  09.03.10 16   Polnyj     188.81    350.0   4.000  40.0\r\n";
cntText += "\r\n";
cntNode.setText(cntText);
SYS.Transport.Sockets.out_testHTTP.messIO(req,"HTTP");

4. User programming API

The same module's object "Protocol.HTTP" [SYS.Protocol.HTTP.pgCreator()]

Links

Referring pages: HomePageEn/Doc
HomePageEn/Doc/WebUser
HomePageEn/Doc/WebVision
HomePageEn/Using/APIFunctionLibs/LibUserPrtDevs
HomePageEn/Using/PLC/firmware
HomePageEn/Using/SmartHouse


 
There are no files on this page.[Display files/form]
There is no comment on this page. [Display comments/form]