Upgrading to version 2

This document covers the changes made in version 2 of the Wacom Ink SDK for multi-display in a more in-depth fashion.

New licensing

Please note that licenses for version 2 of the Wacom Ink SDK for multi-display are not compatible with version 1 licenses.

A test license may be generated from our Developer Dashboard here: https://developer.wacom.com/en-us/developer-dashboard/license-keys.

For commercial purposes, or those who have an active contract, please contact your regional Wacom Sales representative to obtain a new license.

Setting	Description
SecureCommunication	Boolean value that when true, will look for a certificate.
UseLocalCertificate	Boolean value that when true, reads a certificate from a machine/user store. NB: Only needed when `SecureCommunication` is set to true.
TrustedServers	Array value that contains a list of trusted server instances.

Setting	Description
ServerCertificates	Whitelist of server certificate Thumbprints

info

TrustedServers replaces the deprecated app_config setting ServerCertificates.
The TrustedServers value now contains one or more public keys extracted from certificates, rather than including the entire certificate along with its private key.
This new approach uses public keys to get the necessary thumbprint, thereby enhancing its security.

WithExtraData() - Assigns a dictionary containing additional signature data. Replaces WithHash().
WithPublicKey() - replaces WithCertificate().

WithHash() - sends a single hashed value containing additional signature data. Replaced by WithExtraData().
WithCertificate() - new method is WithPublicKey().

info

WithExtraData() improves upon WithHash() by being able to include multiple pieces of data within the signature, rather that a single piece of data.
Rather than relying on a raw base64-encoded string as in WithCertificate(), WithPublicKey() now uses public keys to verify and trust server instances, enhancing security and simplifying the verification process.