Difference between revisions of "What's new in QuickOPC 2023.1"

From OPC Labs Knowledge Base
Jump to navigation Jump to search
Line 97: Line 97:
 
=== OPC UA Client-Server ===
 
=== OPC UA Client-Server ===
 
* The '''uaClientApplication removeInstanceCertificate''' command now has an additional option, '''-me|-mustExist <bool>''', specifying whether the certificate must be present in the certificate store.  
 
* The '''uaClientApplication removeInstanceCertificate''' command now has an additional option, '''-me|-mustExist <bool>''', specifying whether the certificate must be present in the certificate store.  
 +
* Added '''createInstanceCertificate''' and '''validateInstanceCertificate''' commands to the '''uaClientApplication''' command.
 
<!--
 
<!--
 
=== OPC UA PubSub ===
 
=== OPC UA PubSub ===
 
=== Common ===
 
=== Common ===
 
-->
 
-->
 +
 
== All Command-Line Tools ==
 
== All Command-Line Tools ==
 
* The .NET build configurations of the command-line tools now target .NET 7.
 
* The .NET build configurations of the command-line tools now target .NET 7.

Revision as of 20:45, 20 December 2022

See also: Versions; Previous version: What's new in QuickOPC 2022.2

Internal version number: 5.71

Key changes:


Targeting

  • .NET runtimes: Added support for .NET 7.
  • .NET runtimes: Removed support for .NET Core 3.1.

Component Improvements

OPC UA Client-Server

  • When the effective endpoint selection policy only allows connection with no message security, the client instance certificate is not used when creating the OPC UA session.

OPC UA Administration and PKI

  • Created a new object, CertificateGenerationParameters, with settings that influence how the certificates are generated. You can set the maximum expiration date, minimum key size, and/or the validity period in months. For creation of application instance certificates, these parameters can be changed in the new InstanceCertificateGenerationParameters property of the UAClientServerApplicationParameters object.
  • The auto-generation of client instance certificate is now skipped when the effective endpoint selection policy only allows connections with no message security.
  • The IEasyUAApplication.RemoveInstanceCertificate method now takes an additional boolean argument, specifying whether the certificate must be present in the certificate store. An extension method without the additional argument is also available.
  • When the application instance certificate is removed, its copies in the trusted peers certificate store, if any, are now removed as well.
  • It is now possible to specify the format of the application URI (unless the application URI string is specified in the application manifest). The format can be set in the UAClientServerApplicationParameters.ApplicationUriFormat property. See OPC UA Application URI Derivation for the format syntax, and more details about how the application URI is determined.
  • Added CreateInstanceCertificate method to the IEasyUAApplication interface. The method creates the instance certificate the application is currently configured to use. It is possible to specify whether the instance certificate must not be present prior to the operation, or whether the operation will be able to replace it.
  • Added ValidateInstanceCertificate method to the IEasyUAApplication interface. The method validates the instance certificate the application is currently configured to use.

Component Refactorings

OPC UA Administration and PKI

  • The default lifetime of auto-generated application instance certificate is now 60 months (5 years), regardless of whether you target .NET Framework, or .NET 6+. Previously, the default was 600 months (50 years) for .NET Framework, and 12 months (1 year) otherwise.
  • The property UAClientServerApplicationParameters.AllowOwnCertificatePrompt has been renamed to AllowUserInteraction and moved to the CertificateGenerationParameters class.

Development Productivity

Code Analysis

  • When the Visual Studio extension is installed, it provides additional code analysis specifically aimed at the proper usage of QuickOPC APIs, and OPC in general. Affected places are marked up with "squiggles" directly in the code, and also appear as warnings (or other message severities) in the Error List window.

Tools and Online Services

OpcCmd Utility

OPC UA Client-Server

  • The uaClientApplication removeInstanceCertificate command now has an additional option, -me|-mustExist <bool>, specifying whether the certificate must be present in the certificate store.
  • Added createInstanceCertificate and validateInstanceCertificate commands to the uaClientApplication command.

All Command-Line Tools

  • The .NET build configurations of the command-line tools now target .NET 7.
  • In table output, values in columns with data of enumerated types are now automatically colorized, allowing quick visual distinction between the distinct enum values.

Examples

OPC UA Client-Server

  • Added C# example showing how to set the validity period of the auto-generated application instance certificate.