OPC Studio User's Guide and Reference
IEasyUAClientServerApplicationExtension Class Members
Methods 


OpcLabs.EasyOpcUA Assembly > OpcLabs.EasyOpc.UA.Application.Extensions Namespace : IEasyUAClientServerApplicationExtension Class

The following tables list the members exposed by IEasyUAClientServerApplicationExtension.

Public Methods
 NameDescription
Public Methodstatic (Shared in Visual Basic)Assures presence and validity of the own certificate or certificate pack the application is currently configured to use.  
Public Methodstatic (Shared in Visual Basic)Overloaded. 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 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 CreateOwnCertificateOrCertificatePack method, which always creates new certificate(s) when successful.

 
Public Methodstatic (Shared in Visual Basic)Overloaded. Assures the presence of the own application certificate pack in the trusted peers certificate store, specifying certificate sub-id.  
Public Methodstatic (Shared in Visual Basic)Overloaded. 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 PackCertificateTypeIds.

 
Public Methodstatic (Shared in Visual Basic)Overloaded. 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 PackCertificateTypeIds.

 
Public Methodstatic (Shared in Visual Basic)Overloaded. 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 PackCertificateTypeIds.

 
Public Method (Inherited from object)
Public Methodstatic (Shared in Visual Basic)Exports the OPC UA application configuration data into an XML file.  
Public Methodstatic (Shared in Visual Basic)Exports the OPC UA application manifest into a stream.  
Public Methodstatic (Shared in Visual Basic)Exports the OPC UA application manifest into an XML file.  
Public Methodstatic (Shared in Visual Basic)Overloaded. Exports the own certificate and optionally its private key to a given file.  
Public Methodstatic (Shared in Visual Basic)Exports the registration data of the OPC UA application into an XML file.  
Public Methodstatic (Shared in Visual Basic)Exports the security settings of the OPC UA application into an XML file.  
Public Methodstatic (Shared in Visual Basic)Finds the own certificate the application is currently configured to use.  
Public Methodstatic (Shared in Visual Basic)Gets the OPC UA registration information for this application.  
Public Methodstatic (Shared in Visual Basic)Gets an application ID assigned to the application by a specified GDS.  
Public Methodstatic (Shared in Visual Basic)Gets the subject distinguished name the application is configured to use for its certificates.  
Public Methodstatic (Shared in Visual Basic)Gets a dictionary of certificate subject names corresponding to all application certificate sub-ids.  
Public MethodServes as the default hash function. (Inherited from object)
Public Methodstatic (Shared in Visual Basic)Overloaded. 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 PackCertificateTypeIds.

The actual number of certificates in the application certificate pack may be lower than the count of 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 Methodstatic (Shared in Visual Basic)Determines strength of the password that is configured for use with the default certificate.  
Public MethodGets the System.Type of the current instance. (Inherited from object)
Public Methodstatic (Shared in Visual Basic)Overloaded. 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 PackCertificateTypeIds.

If the specified certificate type Id is Null, the default certificate type Id from DefaultCertificateTypeId is used instead.

 
Public Methodstatic (Shared in Visual Basic)Overloaded. 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 Methodstatic (Shared in Visual Basic)Overloaded. Determines whether a non-empty password is in use for the default certificate.  
Public Methodstatic (Shared in Visual Basic)Imports the own default certificate and its private key from a given file.  
Public Methodstatic (Shared in Visual Basic)Retrieves certificate type elements available for an application instance.  
Public Methodstatic (Shared in Visual Basic)Overloaded. 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 PackCertificateTypeIds.

If the specified certificate type Id is Null, the default certificate type Id from DefaultCertificateTypeId is used instead.

The actual number of certificates in the application certificate pack may be lower than the count of 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 Methodstatic (Shared in Visual Basic)Overloaded. 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 PackCertificateTypeIds.

If the specified certificate type Id is Null, the default certificate type Id from 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 Methodstatic (Shared in Visual Basic)Overloaded. 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 PackCertificateTypeIds.

The actual number of certificates in the application certificate pack may be lower than the count of 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 Methodstatic (Shared in Visual Basic)Overloaded. 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 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 Methodstatic (Shared in Visual Basic)Overloaded. 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 PackCertificateTypeIds.

If the specified certificate type Id is Null, the default certificate type Id from DefaultCertificateTypeId is used instead.

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

 
Public Methodstatic (Shared in Visual Basic)Overloaded. Protects the private keys of the certificate pack.

This method operates on certificates with certificate type Ids given by PackCertificateTypeIds.

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

 
Public Methodstatic (Shared in Visual Basic)Retrieves the current trust lists for the application from the certificate manager, and refreshes own certificate stores accordingly.  
Public Methodstatic (Shared in Visual Basic)Overloaded. Removes the own application certificate pack.

This method operates on certificates with certificate type Ids given by PackCertificateTypeIds.

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

 
Public Methodstatic (Shared in Visual Basic)Sets the password used to access the private key for the default certificate.  
Public MethodReturns a string that represents the current object. (Inherited from object)
Public Methodstatic (Shared in Visual Basic)Overloaded. 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 PackCertificateTypeIds.

If the specified certificate type Id is Null, the default certificate type Id from DefaultCertificateTypeId is used instead.

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

 
Public Methodstatic (Shared in Visual Basic)Overloaded. Unprotects the private keys of the certificate pack.

This method operates on certificates with certificate type Ids given by PackCertificateTypeIds.

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

 
Public Methodstatic (Shared in Visual Basic)Overloaded. 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 PackCertificateTypeIds.

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

 
Top
Protected Methods
 NameDescription
Protected MethodAllows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from object)
Protected MethodCreates a shallow copy of the current System.Object. (Inherited from object)
Top
Extension Methods
 NameDescription
Public Extension MethodSets the arbitrary object associated with the node.
Top
See Also

Reference

IEasyUAClientServerApplicationExtension Class
OpcLabs.EasyOpc.UA.Application.Extensions Namespace