QOpcUaGdsClient Class

QOpcUaGdsClient c;

// In case the credentials are needed
QObject::connect(&c, &QOpcUaGdsClient::authenticationRequired, [&](QOpcUaAuthenticationInformation &authInfo) {
        authInfo.setUsernameAuthentication("root", "secret");
 });

// Await success
QObject::connect(&c, &QOpcUaGdsClient::applicationRegistered, [&]() {
    qDebug() << "Application" << c.applicationId() << "registered";
});

c.setBackend(...);
c.setEndpoint(...);
c.setApplicationIdentity(...);
c.setPkiConfiguration(...);
c.setApplicationRecord(...);
c.setCertificateSigningRequestPresets(...);
c.start();

Member Function Documentation

QOpcUaGdsClient::QOpcUaGdsClient(QObject *parent = nullptr)

Constructs a GDS client with parent as the parent object.

[virtual noexcept] QOpcUaGdsClient::~QOpcUaGdsClient()

Destructs a GDS client.

QString QOpcUaGdsClient::applicationId() const

Returns the application id assigned by the server.

Is is a shortcut to receive the application id from the application record data.

See also applicationRecord().

const QOpcUaApplicationIdentity &QOpcUaGdsClient::applicationIdentity() const

Returns the current applicationIdentity.

See also setApplicationIdentity().

const QOpcUaApplicationRecordDataType &QOpcUaGdsClient::applicationRecord() const

Returns the application record data that is used by the client.

See also setApplicationRecord().

[signal] void QOpcUaGdsClient::applicationRegistered()

This signal is emitted when an application was registered successfully.

[signal] void QOpcUaGdsClient::authenticationRequired(QOpcUaAuthenticationInformation &authInfo)

This signal is emitted when the GDS client tries to do a first time authentication with a server, that requires administrative privileges.

authInfo has to be filled with valid authentication information. This slot must not be used crossing thread boundaries.

const QString &QOpcUaGdsClient::backend() const

Returns the current backend setting.

If the backend was changed after starting the client, it will return the changed setting, but not the actually used instance.

See also setBackend().

int QOpcUaGdsClient::certificateCheckInterval() const

Returns the interval in milliseconds for checking the validity of the client certificate.

See also setCertificateCheckInterval().

[signal] void QOpcUaGdsClient::certificateGroupsReceived(QStringList certificateGroups)

This signal is emitted when the GDS client receives a new list of certificateGroups for this application.

[signal] void QOpcUaGdsClient::certificateUpdateRequired()

This signal is emitted when the GDS client detects that an update of the currently used certificate is necessary.

This could be caused by the server, requesting the client to update the certificate, when the certificate's due date is met or if the certificate is self-signed.

The certificate update is handled automatically. This signal is only for informational purpose that an update is going to happen.

[signal] void QOpcUaGdsClient::certificateUpdated()

This signal is emitted when the GDS client received a new certificate that was stored on disk.

const QOpcUaX509DistinguishedName &QOpcUaGdsClient::distinguishedNameCertificateSigningRequestPreset() const

Returns the distinguished name preset for certificate siging requests.

const QString &QOpcUaGdsClient::dnsCertificateSigningRequestPreset() const

Returns the DNS preset for certificate siging requests.

const QOpcUaEndpointDescription &QOpcUaGdsClient::endpoint() const

Returns the current endpoint setting.

If the endpoint was changed after starting the client, it will return the changed setting, but not the actually used endpoint.

See also setEndpoint().

QOpcUaGdsClient::Error QOpcUaGdsClient::error() const

Returns the current error state.

[signal] void QOpcUaGdsClient::errorChanged(QOpcUaGdsClient::Error error)

This signal is emitted when an error occurred.

const QOpcUaPkiConfiguration &QOpcUaGdsClient::pkiConfiguration() const

Returns the current pkiConfiguration.

See also setPkiConfiguration().

void QOpcUaGdsClient::setApplicationIdentity(const QOpcUaApplicationIdentity &appIdentity)

Sets the application identity appIdentity to be used by the client.

This identity is used to register with the GDS server. This function has to be called before starting the GDS client. Changing this setting afterwards has no effect.

See also applicationIdentity().

void QOpcUaGdsClient::setApplicationRecord(const QOpcUaApplicationRecordDataType &appRecord)

Sets the application record data appRecord to be used by the client.

This data is used to register with the GDS server. This function has to be called before starting the GDS client.

Most of the data is the same as in the application identity. After registration the assigned application id can be retrieved.

See also applicationRecord() and setApplicationIdentity.

void QOpcUaGdsClient::setBackend(const QString &backend)

Sets the backend to be used by the client to communicate with the server to backend.

This function has to be called before starting the GDS client. Changing this setting afterwards has no effect.

See also backend(), QOpcUaProvider::availableBackends(), and start().

void QOpcUaGdsClient::setCertificateCheckInterval(int interval)

Sets the interval in milliseconds for checking the validity of the client certificate to interval.

See also certificateCheckInterval().

void QOpcUaGdsClient::setCertificateSigningRequestPresets(const QOpcUaX509DistinguishedName &dn, const QString &dns)

Sets the presets for certificate siging requests; the distinguished name dn and the DNS string dns.

When creating a certificate signing request some additional information is needed, that is not provided by the application identity.

This function has to be called before starting the GDS client.

See also setApplicationIdentity().

void QOpcUaGdsClient::setEndpoint(const QOpcUaEndpointDescription &endpoint)

Sets the endpoint to be used by the client to communicate with the server to endpoint.

This function has to be called before starting the GDS client. Changing this setting afterwards has no effect.

Communication to a GDS server is only possible through an encrypted endpoint. Using an unencrypted endpoint will fail.

See also endpoint().

void QOpcUaGdsClient::setPkiConfiguration(const QOpcUaPkiConfiguration &pkiConfig)

Sets the PKI configuration pkiConfig to be used by the client.

All certificates, keys and trust lists will be used from or stored to the locations given. In order to use the certificate received from the GDS, the same configuration has to be used with QOpcUaClient.

This function has to be called before starting the GDS client. Changing this setting afterwards has no effect.

See also pkiConfiguration().

void QOpcUaGdsClient::setTrustListUpdateInterval(int interval)

Sets the interval in milliseconds for updating the trust list from the server to interval.

See also trustListUpdateInterval().

void QOpcUaGdsClient::start()

Starts the client process.

After setting up all information, the client can be started.

• setBackend
• setEndpoing
• setApplicationIdentity
• setPkiConfiguration
• setApplicationRecord
• setCertificateSigingRequestPresets

QOpcUaGdsClient::State QOpcUaGdsClient::state() const

Returns the current client state.

[signal] void QOpcUaGdsClient::stateChanged(QOpcUaGdsClient::State state)

This signal is emitted when the internal state of the client changes. The state indicates the new state.

int QOpcUaGdsClient::trustListUpdateInterval() const

Returns the interval in milliseconds for updating the trust list from the server.

See also setTrustListUpdateInterval().

[signal] void QOpcUaGdsClient::trustListUpdated()

This signal is emitted when the GDS client has received a new trust list from the server and stored to disk.

void QOpcUaGdsClient::unregisterApplication()

Unregisters an application from the server.

This function can be used when an application has to be removed permanently from the network. It does not need to be called when rebooting or shutting down.

[signal] void QOpcUaGdsClient::unregistered()

This signal is emitted when the GDS client has unregistered the application.