The NodeOPCUA API The NodeOPCUA API

  • API Docs for Version: 0.1.0-pre

    • APIs

    Show:

    ClientSecureChannelLayer Class

    Uses
    Extends EventEmitter
    Defined in: packages\node-opcua-secure-channel\src\client\client_secure_channel_layer.js:138
    Module: opcua.client

    a ClientSecureChannelLayer represents the client side of the OPCUA secure channel.

    Constructor

    ClientSecureChannelLayer

    (
    • options
    )

    Defined in packages\node-opcua-secure-channel\src\client\client_secure_channel_layer.js:138

    Parameters:

    • options Object
      • [defaultSecureTokenLifetime=30000 ] Number optional
      • [securityMode=MessageSecurityMode.NONE] optional
      • [securityPolicy=SecurityPolicy.None] optional
      • [serverCertificate=null] optional

        the serverCertificate (required if securityMode!=None)

      • parent OPCUAClientBase

        parent

      • [factory] optional

        an factory that provides a method createObjectId(id) for the message builder

      • [transportTimeout= ClientSecureChannelLayer.defaultTransportTimeout ] optional

        the transport timeout interval in ms

      • [connectionStrategy] Object optional
        • [maxRetry= 10] optional
        • [initialDelay= 10] optional
        • [maxDelay= 10000] optional

    Methods

    _performMessageTransaction

    (
    • msgType
    • requestMessage
    • callback
    )
    private

    Defined in packages\node-opcua-secure-channel\src\client\client_secure_channel_layer.js:914

    internal version of _performMessageTransaction.

    Parameters:

    • msgType String
    • requestMessage Object
    • callback Object

    _read_headers

    (
    • binaryStream
    )
    Boolean private

    Inherited from MessageBuilder: packages\node-opcua-secure-channel\src\message_builder.js:327

    Parameters:

    • binaryStream Object

    Returns:

    Boolean:

    chunkSecureMessage

    (
    • msgType
    • options
    • message
    • messageChunkCallback
    )

    Inherited from MessageChunker: packages\node-opcua-secure-channel\src\message_chunker.js:53

    Parameters:

    • msgType String
    • options Object
      • tokenId
      • chunkSize

        [default=8196]

      • signatureLength Integer

        [default=0]

      • signingFunc Function

        [default=null]

    • message Object
    • messageChunkCallback Function

    close

    (
    • callback
    )
    async

    Defined in packages\node-opcua-secure-channel\src\client\client_secure_channel_layer.js:1253

    Close a client SecureChannel ,by sending a CloseSecureChannelRequest to the server.

    After this call, the connection is closed and no further transaction can be made.

    Parameters:

    • callback Function

    create

    (
    • endpoint_url
    • callback
    )
    async

    Defined in packages\node-opcua-secure-channel\src\client\client_secure_channel_layer.js:592

    establish a secure channel with the provided server end point.

    Parameters:

    • endpoint_url String
    • callback Function

      the async callback function

      • err Error | Null

    Example:

    
                    var secureChannel  = new ClientSecureChannelLayer();
                    
                    secureChannel.on("end", function(err) {
                         console.log("secure channel has ended",err);
                         if(err) {
                            console.log(" the connection was closed by an external cause such as server shutdown");
                        }
                    });
                    secureChannel.create("opc.tcp://localhost:1234/UA/Sample", function(err) {
                         if(err) {
                              console.log(" cannot establish secure channel" , err);
                         } else {
                              console.log("secure channel has been established");
                         }
                    });

    get

    () Variant

    Provided by the opcua.transport module.

    Defined in packages\node-opcua-samples\bin\simple_server.js:192

    returns the current value as a Variant

    Returns:

    Variant:

    getPrivateKey

    () Buffer

    Defined in packages\node-opcua-secure-channel\src\client\client_secure_channel_layer.js:252

    Returns:

    Buffer:

    the privateKey

    makeRequestId

    () Number private

    Defined in packages\node-opcua-secure-channel\src\client\client_secure_channel_layer.js:860

    Returns:

    Number:

    a newly generated request id

    performMessageTransaction

    (
    • requestMessage
    • callback
    )

    Defined in packages\node-opcua-secure-channel\src\client\client_secure_channel_layer.js:870

    perform a OPC-UA message transaction, asynchronously.

    Parameters:

    • requestMessage Object
    • callback Function

      During a transaction, the client sends a request to the server. The provided callback will be invoked at a later stage with the reply from the server, or the error.

      preconditions:

      • the channel must be opened

    Example:

    var secure_channel ; // get a  ClientSecureChannelLayer somehow
                    
                    var message = new BrowseNameRequest({...});
                    secure_channel.performMessageTransaction(message,function(err,response) {
                       if (err) {
                         // an error has occurred
                       } else {
                          assert(response instanceof BrowseNameResponse);
                         // do something with response.
                       }
                    });

    update

    (
    • options
    )

    Inherited from MessageChunker: packages\node-opcua-secure-channel\src\message_chunker.js:33

    Parameters:

    • options Object
      • securityHeader Object

        SecurityHeader

      • [derivedKeys] Object optional

        derivedKeys

    Properties

    isConnecting

    Boolean

    Defined in packages\node-opcua-secure-channel\src\client\client_secure_channel_layer.js:775

    true if the secure channel is trying to establish the connection with the server. In this case, the client may be in the middle of the b ackoff connection process.

    Events

    close

    Defined in packages\node-opcua-secure-channel\src\client\client_secure_channel_layer.js:362

    notify the observers that the transport connection has ended. The error object is null or undefined if the disconnection was initiated by the ClientSecureChannelLayer. A Error object is provided if the disconnection has been initiated by an external cause.

    Event Payload:

    • error Error

    invalid_sequence_number

    Inherited from MessageBuilder: packages\node-opcua-secure-channel\src\message_builder.js:91

    notify the observers that a message with an invalid sequence number has been received.

    Event Payload:

    • expected Number
      sequence Number
    • actual Number
      sequence Number

    lifetime_75

    Defined in packages\node-opcua-secure-channel\src\client\client_secure_channel_layer.js:385

    notify the observer that the secure channel has now reach 75% of its allowed live time and that a new token is going to be requested.

    Event Payload:

    • securityToken Object

      : the security token that is about to expire.

    message

    Inherited from MessageBuilder: packages\node-opcua-secure-channel\src\message_builder.js:435

    notify the observers that a full message has been received

    Event Payload:

    • objMessage Object
      the decoded message object
    • msgType String
      the message type ( "HEL","ACK","OPN","CLO" or "MSG" )
    • the Number
      request Id

    receive_chunk

    Defined in packages\node-opcua-secure-channel\src\client\client_secure_channel_layer.js:564

    notify the observers that ClientSecureChannelLayer has received a message chunk

    Event Payload:

    • message_chunk Buffer

    receive_response

    Defined in packages\node-opcua-secure-channel\src\client\client_secure_channel_layer.js:974

    notify the observers that a server response has been received on the channel

    Event Payload:

    • response Object

      the response object

    security_token_renewed

    Defined in packages\node-opcua-secure-channel\src\client\client_secure_channel_layer.js:831

    notify the observers that the security has been renewed

    send_chunk

    Defined in packages\node-opcua-secure-channel\src\client\client_secure_channel_layer.js:1089

    notify the observer that a message chunk is about to be sent to the server

    Event Payload:

    • message_chunk Object

      the message chunk

    send_request

    Defined in packages\node-opcua-secure-channel\src\client\client_secure_channel_layer.js:1242

    notify the observer that a client request is being sent the server

    Event Payload:

    • requestMessage Object

    timed_out_request notify the observer that the response from the request has not been received within the timeoutHint specified

    Defined in packages\node-opcua-secure-channel\src\client\client_secure_channel_layer.js:1005

    Event Payload:

    • message_chunk Object

      the message chunk