OPC Studio User's Guide and Reference
IEasyUAClientServerApplication Interface Members
Properties  Methods  Events

OpcLabs.EasyOpcUA Assembly > OpcLabs.EasyOpc.UA.Application Namespace : IEasyUAClientServerApplication Interface

The following tables list the members exposed by IEasyUAClientServerApplication.

Public Properties
 NameDescription
 PropertyA dictionary containing the application ID for each GDS endpoint the application is registered with, as known to the application.  
 PropertyThe PKI store group used by the OPC UA application.  
 PropertyDetermines whether events are currently locked. (Inherited from OpcLabs.BaseLib.ComponentModel.IEventLocking)
 PropertyThe certificate generation parameters used by the application if no other parameters are specified.  
 PropertyThe certificate request parameters used by the application if no other parameters are specified.  
 PropertyThe certificate type Id of the default certificate type used by the application.  
 PropertyA collection of host names for the application instance.  
 PropertyThe certificate type Ids of the certificates in the application certificate pack.  
 PropertyDetermines whether GDS and CM operations are supported.  
Top
Public Methods
 NameDescription
 MethodAssures the presence of the own application certificate or certificate pack in the trusted peers certificate store.  
 MethodBegins an asynchronous operation that obtains a new application own certificate or certificate pack from the certificate manager, and stores it for subsequent usage.  
 MethodCancels an asynchronous operation started with the BeginObtainNewCertificateOrCertificatePack method.  
 MethodCreates the own certificate or certificate pack the application is currently configured to use.  
 MethodPerforms application-defined tasks associated with freeing, releasing, or resetting unmanaged resources. (Inherited from System.IDisposable)
 MethodHandles the end of the asynchronous operation started by the BeginObtainNewCertificateOrCertificatePack method.  
 MethodExports the OPC UA application configuration data into an XML stream.  
 MethodExports the own certificate and optionally its private key to a given file.  
 MethodExports the registration data of the OPC UA application into an XML stream.  
 MethodExports the security settings of the OPC UA application into an XML stream.  
 MethodFinds all registrations for this application URI in the GDS.  
 MethodFinds the own certificate the application is currently configured to use.  
 MethodGets the subject distinguished name the application is configured to use for its certificates.  
 MethodGets the effective OPC UA application manifest, i.e. the currently used application registration information together with data related to PKI administration, such as paths to the certificate stores used.  
 MethodGet the effective application host names.  
 MethodDetermines strength of the password that is configured for use with the given certificate.  
 MethodGets the service object of the specified type. (Inherited from System.IServiceProvider)
 MethodImports the own certificate and its private key from a given file.  
 MethodFinds all application certificate sub-ids.  
 MethodRetrieves certificate type elements for the certificate types available for a given application store kind.  
 MethodLocks the events on the component. (Inherited from OpcLabs.BaseLib.ComponentModel.IEventLocking)
 MethodProtects or unprotects the private key of the given certificate, or certificate pack.  
 MethodRetrieves the current trust lists for the application from the certificate manager, and refreshes own certificate stores accordingly.  
 MethodCreates an application registration in the GDS, assigning it a new application ID. Existing registrations with the same application URI are removed first.  
 MethodRemoves the own certificates or certificate pack the application is currently configured to use.  
 MethodRemoves the password used to access the private key for given certificate.  
 MethodSets the password used to access the private key for given certificate.  
 MethodUnlocks the events on the component. (Inherited from OpcLabs.BaseLib.ComponentModel.IEventLocking)
 MethodRemoves an application registration from the GDS, if it exists. All existing registrations for the application URI are removed.  
 MethodUpdates an application registration in the GDS, keeping its application ID. A new registration is created if the application is not yet registered in the GDS. Preexisting registrations with the same application URI are removed.  
 MethodValidates the own certificate or certificate pack the application is currently configured to use.  
Top
Extension Methods
 NameDescription
Public Extension MethodAssures presence and validity of the own certificate or certificate pack the application is currently configured to use.
Public Extension MethodOverloaded. Assures presence of the own certificate pack the application is currently configured to use.

This method operates on certificates with certificate type Ids given by OpcLabs.EasyOpc.UA.Application.IEasyUAClientServerApplication.PackCertificateTypeIds.

The AssureOwnCertificatePack methods check if the application has its own application certificate pack (according to application configuration), and create the certificate pack if it is missing.

Returns true if a new certificate pack has been created. Returns false if an existing certificate pack was found and accepted as the current own certificate pack.

If the own certificate pack does not exist in the certificate store prior to the operation, the method creates it. Otherwise, the method also checks whether the instance certificates are present in the trusted peers certificate store, and if they are absent, it copies them there. This is in contrast to the OpcLabs.EasyOpc.UA.Application.IEasyUAClientServerApplication.CreateOwnCertificateOrCertificatePack method, which always creates new certificate(s) when successful.

Public Extension MethodOverloaded. Assures the presence of the own application certificate pack in the trusted peers certificate store, specifying certificate sub-id.
Public Extension MethodOverloaded. Begins obtaining a new application certificate or certificate pack from the certificate manager.

The BeginObtainNewCertificateOrCertificatePack methods begin an asynchronous operation that obtains a new application own certificate or certificate pack from the certificate manager, and stores it for subsequent usage.

When certificate pack is used, this method operates on certificates with certificate type Ids given by OpcLabs.EasyOpc.UA.Application.IEasyUAClientServerApplication.PackCertificateTypeIds.

Public Extension MethodOverloaded. Begins obtaining a new application certificate pack from the certificate manager.

The BeginObtainNewCertificatePack methods begin an asynchronous operation that obtains a new application own certificate pack from the certificate manager, and stores it for subsequent usage.

This method operates on certificates with certificate type Ids given by OpcLabs.EasyOpc.UA.Application.IEasyUAClientServerApplication.PackCertificateTypeIds.

Public Extension MethodOverloaded. Creates the own application certificate pack.

The CreateOwnCertificatePack methods create the own certificate pack the application is currently configured to use.

This method operates on certificates with certificate type Ids given by OpcLabs.EasyOpc.UA.Application.IEasyUAClientServerApplication.PackCertificateTypeIds.

Public Extension MethodExports the OPC UA application configuration data into an XML file.
Public Extension MethodExports the OPC UA application manifest into a stream.
Public Extension MethodExports the OPC UA application manifest into an XML file.
Public Extension MethodOverloaded. Exports the own certificate and optionally its private key to a given file.
Public Extension MethodExports the registration data of the OPC UA application into an XML file.
Public Extension MethodExports the security settings of the OPC UA application into an XML file.
Public Extension MethodFinds the own certificate the application is currently configured to use.
Public Extension MethodGets the OPC UA registration information for this application.
Public Extension MethodGets an application ID assigned to the application by a specified GDS.
Public Extension MethodGets the subject distinguished name the application is configured to use for its certificates.
Public Extension MethodGets a dictionary of certificate subject names corresponding to all application certificate sub-ids.
Public Extension MethodOverloaded. Gets the own certificate pack the application is currently configured to use. Returns the own certificate pack, i.e. the dictionary of own certificates, keyed by the certificate type Id.

This method operates on certificates with certificate type Ids given by OpcLabs.EasyOpc.UA.Application.IEasyUAClientServerApplication.PackCertificateTypeIds.

The actual number of certificates in the application certificate pack may be lower than the count of OpcLabs.EasyOpc.UA.Application.IEasyUAClientServerApplication.PackCertificateTypeIds. This is because multiple certificate types may end up using the same certificate. For example, OpcLabs.EasyOpc.UA.Gds.AddressSpace.UACertificateTypeIds.RsaMinApplicationCertificateType specifies an application certificate with RSA key size 1024 or 2048 bits, and OpcLabs.EasyOpc.UA.Gds.AddressSpace.UACertificateTypeIds.RsaSha256ApplicationCertificateType specifies an application certificate with RSA key size 2048, 3072 or 4096 bits. A single certificate with RSA key size of 2048 bits can therefore be used with both these certificate types.

Public Extension MethodDetermines strength of the password that is configured for use with the default certificate.
Public Extension MethodOverloaded. Determines whether the application's own certificate or certificate pack is present.

When certificate pack is used, this method operates on certificates with certificate type Ids given by OpcLabs.EasyOpc.UA.Application.IEasyUAClientServerApplication.PackCertificateTypeIds.

If the specified certificate type Id is Null, the default certificate type Id from OpcLabs.EasyOpc.UA.Application.IEasyUAClientServerApplication.DefaultCertificateTypeId is used instead.

Public Extension MethodOverloaded. Determines whether the application's own certificate pack is present. Returns true if the application's own certificate pack is present in the certificate store. Returns false otherwise.
Public Extension MethodOverloaded. Determines whether a non-empty password is in use for the default certificate.
Public Extension MethodImports the own default certificate and its private key from a given file.
Public Extension MethodRetrieves certificate type elements available for an application instance.
Public Extension MethodOverloaded. Obtains a new certificate or certificate pack from the certificate manager. Returns the collection of certificates obtained from the certificate manager.

The ObtainNewCertificateOrCertificatePack methods obtain a new application own certificate or certificate pack from the certificate manager, and store it for subsequent usage.

When certificate pack is used, this method operates on certificates with certificate type Ids given by OpcLabs.EasyOpc.UA.Application.IEasyUAClientServerApplication.PackCertificateTypeIds.

If the specified certificate type Id is Null, the default certificate type Id from OpcLabs.EasyOpc.UA.Application.IEasyUAClientServerApplication.DefaultCertificateTypeId is used instead.

The actual number of certificates in the application certificate pack may be lower than the count of OpcLabs.EasyOpc.UA.Application.IEasyUAClientServerApplication.PackCertificateTypeIds. This is because multiple certificate types may end up using the same certificate. For example, OpcLabs.EasyOpc.UA.Gds.AddressSpace.UACertificateTypeIds.RsaMinApplicationCertificateType specifies an application certificate with RSA key size 1024 or 2048 bits, and OpcLabs.EasyOpc.UA.Gds.AddressSpace.UACertificateTypeIds.RsaSha256ApplicationCertificateType specifies an application certificate with RSA key size 2048, 3072 or 4096 bits. A single certificate with RSA key size of 2048 bits can therefore be used with both these certificate types.

The certificate manager may not support all certificate types in the application certificate pack. For an unsupported certificate type, the value of the certificate in the resulting dictionary is null (Nothing in Visual Basic). Unsupported certificate types do not cause the method to fail (throw an exception).

The operation is synchronous. It can take considerable time to execute, because it involves multiple steps, and waiting for a finalization of the requests by the GDS (see the OpcLabs.EasyOpc.UA.Gds.IEasyUACertificateManagement.FinishRequest method).

For an alternative based on asynchronous programming model (APM, System.IAsyncResult) pattern, see the BeginObtainNewCertificateOrCertificatePack method and related extension methods.

For a task-based asynchronous programming pattern alternative, see the ObtainNewCertificateOrCertificatePackAsync(IEasyUAClientServerApplication,UAObtainCertificateArguments) extension method and its overloads.

Public Extension MethodOverloaded. Asynchronously obtains a new certificate or certificate pack from the certificate manager. Returns a task that represents the asynchronous operation. The value of the TResult contains the collection of certificates obtained from the certificate manager.

The ObtainNewCertificateOrCertificatePackAsync methods asynchronously obtain a new application own certificate or certificate pack from the certificate manager, and store it for subsequent usage.

When certificate pack is used, this method operates on certificates with certificate type Ids given by OpcLabs.EasyOpc.UA.Application.IEasyUAClientServerApplication.PackCertificateTypeIds.

If the specified certificate type Id is Null, the default certificate type Id from OpcLabs.EasyOpc.UA.Application.IEasyUAClientServerApplication.DefaultCertificateTypeId is used instead.

The operation is asynchronous, because it involves multiple steps, and waiting for a finalization of the request by the GDS (see the OpcLabs.EasyOpc.UA.Gds.IEasyUACertificateManagement.FinishRequest method).

For a synchronous alternative, see the ObtainNewCertificateOrCertificatePack(IEasyUAClientServerApplication,UAObtainCertificateArguments) extension method and its overloads.

For an alternative based on asynchronous programming model (APM, System.IAsyncResult) pattern, see the BeginObtainNewCertificateOrCertificatePack method and related extension methods.

Public Extension MethodOverloaded. Obtains a new certificate pack from the certificate manager. Returns the collection of certificates obtained from the certificate manager.

The ObtainNewCertificatePack methods obtain a new application own certificate pack from the certificate manager, and store it for subsequent usage.

When certificate pack is used, this method operates on certificates with certificate type Ids given by OpcLabs.EasyOpc.UA.Application.IEasyUAClientServerApplication.PackCertificateTypeIds.

The actual number of certificates in the application certificate pack may be lower than the count of OpcLabs.EasyOpc.UA.Application.IEasyUAClientServerApplication.PackCertificateTypeIds. This is because multiple certificate types may end up using the same certificate. For example, OpcLabs.EasyOpc.UA.Gds.AddressSpace.UACertificateTypeIds.RsaMinApplicationCertificateType specifies an application certificate with RSA key size 1024 or 2048 bits, and OpcLabs.EasyOpc.UA.Gds.AddressSpace.UACertificateTypeIds.RsaSha256ApplicationCertificateType specifies an application certificate with RSA key size 2048, 3072 or 4096 bits. A single certificate with RSA key size of 2048 bits can therefore be used with both these certificate types.

The certificate manager may not support all certificate types in the application certificate pack. For an unsupported certificate type, the value of the certificate in the resulting dictionary is null (Nothing in Visual Basic). Unsupported certificate types do not cause the method to fail (throw an exception).

The operation is synchronous. It can take considerable time to execute, because it involves multiple steps, and waiting for a finalization of the requests by the GDS (see the OpcLabs.EasyOpc.UA.Gds.IEasyUACertificateManagement.FinishRequest method).

For an alternative based on asynchronous programming model (APM, System.IAsyncResult) pattern, see the BeginObtainNewCertificatePack(IEasyUAClientServerApplication,UAEndpointDescriptor) method and related extension methods.

For a task-based asynchronous programming pattern alternative, see the ObtainNewCertificatePackAsync(IEasyUAClientServerApplication,UAEndpointDescriptor) extension method and its overloads.

Public Extension MethodOverloaded. Asynchronously obtains a new certificate pack from the certificate manager. Returns a task that represents the asynchronous operation. The value of the TResult contains the collection of certificates obtained from the certificate manager.

The ObtainNewCertificatePackAsync methods asynchronously obtain a new application own certificate pack from the certificate manager, and store it for subsequent usage.

When certificate pack is used, this method operates on certificates with certificate type Ids given by OpcLabs.EasyOpc.UA.Application.IEasyUAClientServerApplication.PackCertificateTypeIds.

The operation is asynchronous, because it involves multiple steps, and waiting for a finalization of the request by the GDS (see the OpcLabs.EasyOpc.UA.Gds.IEasyUACertificateManagement.FinishRequest method).

For a synchronous alternative, see the ObtainNewCertificatePack(IEasyUAClientServerApplication,UAEndpointDescriptor) extension method and its overloads.

For an alternative based on asynchronous programming model (APM, System.IAsyncResult) pattern, see the BeginObtainNewCertificatePack(IEasyUAClientServerApplication,UAEndpointDescriptor) method and related extension methods.

Public Extension MethodOverloaded. Protects the private key of the given certificate, or certificate pack.

When certificate pack is used, this method operates on certificates with certificate type Ids given by OpcLabs.EasyOpc.UA.Application.IEasyUAClientServerApplication.PackCertificateTypeIds.

If the specified certificate type Id is Null, the default certificate type Id from OpcLabs.EasyOpc.UA.Application.IEasyUAClientServerApplication.DefaultCertificateTypeId is used instead.

A preexisting private key password, if any, must be correctly configured in the application, for this operation to succeed.

Public Extension MethodOverloaded. Protects the private keys of the certificate pack.

This method operates on certificates with certificate type Ids given by OpcLabs.EasyOpc.UA.Application.IEasyUAClientServerApplication.PackCertificateTypeIds.

A preexisting private key password, if any, must be correctly configured in the application, for this operation to succeed.

Public Extension MethodRetrieves the current trust lists for the application from the certificate manager, and refreshes own certificate stores accordingly.
Public Extension MethodOverloaded. Removes the own application certificate pack.

This method operates on certificates with certificate type Ids given by OpcLabs.EasyOpc.UA.Application.IEasyUAClientServerApplication.PackCertificateTypeIds.

The RemoveOwnCertificatePack methods remove the own certificate pack the application is currently configured to use.

Public Extension MethodSets the password used to access the private key for the default certificate.
Public Extension MethodShows the form which allows the interactive user to administer the OPC UA application modally.
Public Extension MethodOverloaded. Unprotects the private key of the given certificate, or certificate pack.

When certificate pack is used, this method operates on certificates with certificate type Ids given by OpcLabs.EasyOpc.UA.Application.IEasyUAClientServerApplication.PackCertificateTypeIds.

If the specified certificate type Id is Null, the default certificate type Id from OpcLabs.EasyOpc.UA.Application.IEasyUAClientServerApplication.DefaultCertificateTypeId is used instead.

A preexisting private key password, if any, must be correctly configured in the application, for this operation to succeed.

Public Extension MethodOverloaded. Unprotects the private keys of the certificate pack.

This method operates on certificates with certificate type Ids given by OpcLabs.EasyOpc.UA.Application.IEasyUAClientServerApplication.PackCertificateTypeIds.

A preexisting private key password, if any, must be correctly configured in the application, for this operation to succeed.

Public Extension MethodOverloaded. Validates the own application certificate pack.

The ValidateOwnCertificatePack methods validate the own certificate pack the application is currently configured to use.

This method operates on certificates with certificate type Ids given by OpcLabs.EasyOpc.UA.Application.IEasyUAClientServerApplication.PackCertificateTypeIds.

The own certificate must exist in the certificate store prior to the operation, otherwise an error is reported.

Top
Public Events
 NameDescription
 EventRaised when the application certificate environment has changed.  
Top
See Also

Reference

IEasyUAClientServerApplication Interface
OpcLabs.EasyOpc.UA.Application Namespace