connect

Connect OPC UA client to server

Syntax

connect(uaClient)

connect(uaClient, userName, password)

connect(uaClient,publicKeyFilename,privateKeyFileName,privateKeyPassword)

Description

connect(uaClient) connects the OPC UA client uaClient to its referenced server using anonymous user authentication.

connect(uaClient, userName, password) connects the OPC UA Client uaClient to its server using username and password authentication. The userName and password arguments must be provided, although the password field can be empty.

connect(uaClient,publicKeyFilename,privateKeyFileName,privateKeyPassword) connects the OPC UA Client uaClient to its server using the User Certificate stored in the public and private key files referenced by publicKeyFilename in .DER and privateKeyFilename in .PEM format. privateKeyPassword is the password used to protect the Private Key File. Private Key Files for OPC must be password protected.

When the client successfully connects to the server, the client object Status property is set to 'Connected', the first level of the server namespace is retrieved, and various essential properties of the client are read from the server.

If uaClient is a vector of clients, and some but not all clients can connect, a warning is issued. If no clients can connect, an error is generated. You can only connect a vector of clients using the same username and password, or the same certificate parameters. If you need to use different usernames and passwords for different servers, call connect on each of the clients individually.

Examples

Connect OPC UA Client to Server

Create a client and connect it to the OPC UA server.

uaClient = opcua("opc.tcp://localhost:53530/OPCUA/SimulationServer1");
connect(uaClient);

Check the connection status.

isConnected(uaClient)

1

Create OPC UA Client Connection Using Username Token

Create an OPC UA client.

uaClient = opcua("opc.tcp://localhost:53530/OPCUA/SimulationServer2");

Connection with username token requires a username and password for authentication. Use the setSecret and getSecret functions to securely store and retrieve the password from your MATLAB^® vault.

setSecret("TestPassword")

Connect the OPC UA client using username and password authentication.

connect(uaClient, "TestUser", getSecret("TestPassword"));

For releases prior to R2024a, specify password as a string.

Check the connection status.

isConnected(uaClient)

1

Create OPC UA Client Connection Using Certificate Token

Create an OPC UA client.

uaClient = opcua("opc.tcp://localhost:53530/OPCUA/SimulationServer1");

Connection with certificate token requires a certificate file, private key file and password. Use the setSecret and getSecret functions to securely store and retrieve the private key password from your MATLAB vault.

setSecret("PrivatePassword")

Connect the OPC UA client using certificate.

connect(uaClient, "C:\MyFolder\TestCertificate.der",...
         "C:\MyFolder\TestPrivateFile.pem", getSecret("PrivatePassword"));

For releases prior to R2024a, specify password as a string.

Check the connection status.

isConnected(uaClient)

1

Input Arguments

uaClient — OPC UA client

OPC UA client object

OPC UA client, specified as an OPC UA client object or array of objects.

Example: connect(uaclient)

userName — User name for connection to server

string | character vector

User name for connection to the server, specified as a string or character vector.

Example: connect(uaclient, "User", "Password")

password — Password for connection to server

string | character vector

Password for connection to the server, specified as a string or character vector. Use the setSecret and getSecret functions to securely store and retrieve the password from your MATLAB vault.

Example: connect(uaclient, "User", "Password")

publicKeyFilename — Certificate file with public key

string | character vector

Certificate file with public key, specified as a string or character vector.

Example: connect(opcClient, "C:\MyFolder\TestCertificate.der", "C:\MyFolder\TestPrivateFile.pem", "TestKey")

privateKeyFileName — Certificate file with private key

string | character vector

Certificate file with private key, specified as a string or character vector.

Example: connect(opcClient, "C:\MyFolder\TestCertificate.der", "C:\MyFolder\TestPrivateFile.pem", "TestKey")

privateKeyPassword — Password for private key file

string | character vector

Password to access the certificate file with private key, specified as a string or character vector. Use the setSecret and getSecret functions to securely store and retrieve the password from your MATLAB vault.

Example: connect(opcClient, "C:\MyFolder\TestCertificate.der", "C:\MyFolder\TestPrivateFile.pem", "TestKey")

Version History

Introduced in R2015b