Getting Started

Prerequisites

Installation

The binaries needed for the SDK are hosted by PKWARE. The SDK is split into components so you can pick and choose the components your application needs.

NuGet

Create a NuGet.Config file at the root of your project, next to your .sln file, with the following content

<?xml version="1.0" encoding="utf-8"?>
<configuration>
    <packageSources>
        <add key="PKWARE" value="https://packages.smartcrypt.com/repository/nuget-public/" />
    </packageSources>
    <packageSourceCredentials>
        <PKWARE>
            <add key="Username" value="your_username" />
            <add key="ClearTextPassword" value="your_password" />
        </PKWARE>
    </packageSourceCredentials>
</configuration>

Manual

If not using NuGet, or if unable to reach the PKWARE NuGet server, you can download the required files manually.

  1. Navigate to https://packages.smartcrypt.com/#browse/browse:nuget-public

  2. Sign in using your credentials

  3. Refresh the page. You should now be able to see the artifacts.

  4. Expand that target artifact all the way and download the nupkg files needed

  5. Change the downloaded files from .nupkg to .zip

  6. Extract the DLL from the lib folder in the zip, and check the .nuspec file for any transitive dependencies needed.

Note

The repository is password protected; use the credentials issued by PKWARE Sales and Support for access.

Add the following NuGet packages

  • PKWARE.Smartcrypt.KeyManagement - Required for creating, syncing, and modifying Smartkeys

  • PKWARE.Smartcrypt.Structured - Required for working with structured data encryption

  • PKWARE.Smartcrypt.Unstructured - Required for working with unstructured data encryption

PKArchive.NET Toolkit

The Unstructured Data component requires the PKArchive.NET Toolkit. This is available as a Windows installer, and can be downloaded from https://packages.smartcrypt.com/repository/binaries-public/sdk/PKWARE_Toolkit_Win_11.00.0066.exe. After installing, the PKArchive.NET DLLs can be found in Documents\Visual Studio 2010\Projects\PKWARE\PAAPI11\Lib.

Framework compatibility

The PKWARE SDK supports .NET Framework 4.6.1 and up on Windows and .NET Core 3.1 and up on all platforms. Use of the Unstructured Data component (PKArchive.NET) requires .NET Framework to be installed on the system. Other aspects of the SDK target .NET Standard 2.0. For additional reference, a complete compatibility matrix is available from Microsoft.

Visual Studio

If using Visual Studio, it is recommended you use 2017. If using 2015, you must: