==============
HTTP Transport
==============

OPCUA clients and servers can communicate over HTTP. This is useful for clients and
servers that are behind firewalls that only allow HTTP traffic.

OPCUA specification allows to use binary encoding over HTTP. This is called "OPCUA Binary
Protocol". This is the most efficient way to communicate between clients and servers.
Despite this SDK also supports to use JSON encoding over HTTP.


HTTP Client
===========

To connect to a server over HTTP, you need to create a client object and call the
``connect`` method.

Connect method accepts the following parameters:

* **endpointUrl** - The URL of the server.

    Different server supports two kinds of schemes for HTTP endpoints.

      * **opc.http://host:port/path**
      * **opc.https://host:port/path**

    Some servers may support also ususal HTTP/HTTPS schemes:

      * **http://host:port/path**
      * **https://host:port/path**


* **transportProfile** - The transport profile to use. This can be one of the following:

    * **ua.Types.TranportProfileUri.HttpsJson** expads to string *http://opcfoundation.org/UA-Profile/Transport/https-json*
    * **ua.Types.TranportProfileUri.HttpsBinary** expands to string *http://opcfoundation.org/UA-Profile/Transport/https-uabinary*

    This parameter is optional. If not provided, the client will try to connect using binary encoding.

Examples
--------

Binary Encoding
~~~~~~~~~~~~~~~

The following example shows how to connect to a server using binary encoding over HTTP.

.. literalinclude:: examples/client/client_connect_http_binary.lua
    :language: lua
    :lines: 16-22

`Full source <_static/client/client_connect_http_binary.lua>`__

You can can also omit second parameter, the client will try to connect using binary encoding.

.. literalinclude:: examples/client/client_connect_https_binary_default.lua
    :language: lua
    :lines: 16-22


To connect to a server over HTTPS, you need to pass URL with `opc.https://` scheme.

.. literalinclude:: examples/client/client_connect_https_binary.lua
    :language: lua
    :lines: 16-22

`Full source <_static/client/client_connect_https_binary.lua>`__


JSON Encoding
~~~~~~~~~~~~~

JSON encoding is non-standard way to communicate between OPCUA clients and servers.
Because of this you can only connect to RealTimeLogic server using JSON encoding.

The following example shows how to connect to a server using JSON encoding over HTTP.

.. literalinclude:: examples/client/client_connect_https_json.lua
    :language: lua
    :lines: 16-22

`Full source <_static/client/client_connect_https_json.lua>`__


HTTP Server
===========

To enable HTTP transport you need to configure server and add corresponding endpoint URL.
You don't need to specify JSON or Binary encoding, the server will automatically detect it
by MIME type of the HTTP request.

Also currently server supports only secure policy None for OPCUA messages
over HTTP. Security in this case is provided by HTTPS and if you select to use HTTP
you should be aware that messages are not encrypted and not signed.

Example
-------

.. literalinclude:: examples/server/server_http.lua
    :language: lua

`Full source <_static/server/server_http.lua>`__