Migrate from KeySecureHeaderModule to CryptoHeaderModule

Prerequisites

1. CipherTrust Manager is up and running at a supported version. For more details, refer to CipherTrust Manager Deployment.

2. The CADP for .NET Core library is built on .NET standard 2.1. Click here to refer the supported .NET/.NET Core application versions.

   Recommended version: .NET 6.0 or higher.

3. The supported version should be installed on your machine.

4. While updating your application to the supported version, ensure to:

   1. Update all the Microsoft libraries used in the project

   2. Update dependent projects and libraries to the supported version

Supported Versions

Current Setup

Target Setup

Installation and Migration Steps

1. Back up the ProtectAppForDotNet.properties file. By default, this file is placed at C:\Program Files\SafeNet ProtectApp\DotNet\ProtectAppForDotNet.properties in Registry.

2. Remove the old references of ProtectApp.NET library from your project.

   1. In Visual Studio, go to Solution Explorer > References and remove the reference of ingdnp.dll and KeySecureRSAHeader.dll.

   2. Comment out the "using KeySecureHeaderModule;" line in your project. This will give build errors.

3. Add the CipherTrust.CADP.NETCore package to your project. For details, refer to Adding NuGet Package to the Project. All the dependent libraries will be downloaded automatically to the default NuGet installation directory C:\Users\%UserName%\.nuget\packages\ciphertrust.cadp.netcore\<product-version>\.

4. After installing the package, explicitly add reference of CryptoHeaderModule.dll to the application. The CryptoHeaderModule.dll will be placed in the C:\Users\user profile\.nuget\packages\ciphertrust.cadp.netcore\<latest version>\utility folder.

5. Configure the CADP.NETCore_Properties.xml file (placed at C:\Users\%UserName%\.nuget\packages\ciphertrust.cadp.netcore\<product-version>\content\) similar to the old properties file (backed-up in step 1). Refer to the properties file migration : Properties File

6. Back up the old app.config file, create a new app.config file, and update all the properties respectively.

7. Refer to the following:

   • Sample

   • CryptoHeader Module

Parameter Mapping from KeySecureHeader Module to CryptoHeader Module

Parameters in app.config File

Parameters in Properties File

APIs