Certificate Hash Example

This example calculates a certificate hash that is intended to be added to the Windows registry for the USB driver configuration. This example is meant for SDK users that need to allow their own signed applications to access USB functionality in Windows. For more information see the PCoIP SDK USB Windows driver documentation.

The steps below are meant as a quick start guide for developers.

The online SDK user guide has detailed information on this example.

Building the example

1. Install the SDK by opening the .dmg and dragging the PCoIPSoftClientSDK folder to your Documents folder (or other location).
2. Install OpenSSL (e.g. via brew)

    brew install openssl

3. Ensure that the appropriate symlink is created to openSSL installation

    mkdir -p /usr/local/opt/
    ln -s /opt/homebrew/Cellar/openssl@1.1/1.1.1q/ /usr/local/opt/openssl@1.1

4. Navigate to the example directory

    cd ~/Documents/PCoIPSoftClientSDK/Examples/cert_hash_example

5. Create a build directory and navigate there

    mkdir build && cd build

6. Configure the build using cmake. Be sure to include the path to the OpenSSL dependency using OPENSSL_ROOT_DIR

    cmake -DOPENSSL_ROOT_DIR=/usr/local/opt/openssl@1.1 -G Xcode ..

7. Build the example

    cmake --build . --config RelWithDebInfo

8. Run the example

    ./RelWithDebInfo/cert_hash_example
    >> Usage: cert_hash_example <certificate file>

Running the example with the sample certificate

1. Build the example accroding to the steps in (Building the example)[#building-the-example]
2. Run the example executable with a path to a certificate as an argument

    ./RelWithDebInfo/cert_hash_example ../sample_certificate.cert