Installing the AP .Net Protector

Steps to set up AP .Net on Windows in a Production Environment

Extracting the AP .Net Setup Scripts and Package

To extract the setup scripts and package:

  1. Download the ApplicationProtector_WIN-ALL-64_x86-64_NET-STD-2.0-64_<version>.zip file to any location on the machine where you want to install the protector.
  2. Extract the contents of the ApplicationProtector_WIN-ALL-64_x86-64_NET-STD-2.0-64_<version>.zip file.
    The following setup files are extracted:
    • ApplicationProtector_WIN-ALL-64_x86-64_NET-STD-2.0-64_<version>.zip
    • signatures/ApplicationProtector_WIN-ALL-64_x86-64_NET-STD-2.0-64_<version>.zip_10.0.sig
  3. Verify the digital signature of the signed AP .Net build.
    For more information about verifying the signed AP .Net build, refer to Verification of Signed Protector Build.
  4. Extract the contents of the AP .Net installation package again.
    The following setup files are extracted:
    • LogforwarderSetup_Windows_x64_<version>.exe
    • RPAgentSetup_Windows_x64_<version>.exe
    • APDotNetSetup_Windows_x64_<version>.exe
    • APDotNetMockSetup_Windows_x64_<version>.exe

Before you begin

To preserve all configurations during upgrade:

  • For Log Forwarder, backup all files present under C:\Program Files\Protegrity\logforwarder\data\config.d directory.
  • For RP Agent, backup all files present under C:\Program Files\Protegrity\rpagent\data directory.

Installing Log Forwarder on Windows

This section describes how to install the Log Forwarder on a Windows platform using either the Windows Wizard or Silent mode.

Using Windows Wizard

For more information about installing the Log Forwarder using the Windows wizard, refer to Installing Log Forwarder on Windows.

Using Silent Mode

For more information about installing Log Forwarder using the silent mode, refer to Installing Log Forwarder on Windows using Silent Mode.

Installing RP Agent on Windows

This section describes how to install the RP Agent on a Windows platform using either the Windows Wizard or Silent Mode.

Using Windows Wizard

For more information about installing RP Agent using the Windows wizard, refer to Installing RP Agent on Windows.

Using Silent Mode

For more information about installing RP Agent using the silent mode, refer to Installing RP Agent on Windows using Silent Mode.

RPA Secure Mode with ESA / PPC on Windows

Before proceeding with the RPA installation in secure mode, ensure that the required CA certificate is available and trusted on the system.

  • For PPC (Windows)

    Retrieve the custom CA certificate using the following command:

    kubectl -n cert-manager get secret eclipse-ca -o jsonpath='{.data.tls\.crt}' | base64 -d > ca.crt
    
  • For ESA

    Download the certificate from ESA.

    For more information about downloading certificates from ESA, refer to Manage Certificates.

After obtaining the certificate, configure the system environment variable:

VariableValue
SSL_CERT_FILEFull path to the certificate file (for example, C:\Users\Administrator\ca.crt)

When prompted for the ESA hostname or IP during RPA installation, ensure it is included in the ESA TLS certificate (CN or SAN) and is resolvable from the RPAgent host.

After the CA certificate is available, proceed with the RPA installation.

Using Windows Wizard

For more information about installing RP Agent using the Windows wizard, refer to Installing RP Agent on Windows.

Using Silent Mode

For more information about installing RP Agent using the silent mode, refer to Installing RP Agent on Windows using Silent Mode.

Installing Application Protector .Net on Windows

Using Windows Wizard

This section describes how to install AP .NET on a Windows platform.

Note: Before installation, ensure that the C:\Users\Administrator\.nuget\packages directory does not contain the dotnetprotector folder.

To install the AP .Net on the Windows platform:

  1. Run the APDotNetSetup_Windows_x64_<version>.exe installer from the created directory.
    The Select Destination Location screen appears.

  2. Set the installation directory to C:\Program Files\Protegrity\sdk\dotnet.

  3. Click Next.
    The Ready to Install screen appears.

  4. Click Install.
    The Completing the Defiance AP DOTNET API Setup Wizard screen appears.

  5. Click Finish to complete the installation.

    The AP .NET is now installed successfully.

    The default installation directories for different platforms are given in the following table.

    Table: AP .Net Default Installation Directories

    PlatformDirectory
    Windows 64-bitC:\Program Files\Protegrity\sdk\dotnet\lib
    API DocsC:\Program Files\Protegrity\sdk\dotnet\doc
  6. Verify that the following files exist in the dotnet\lib directory:

    • DotNetProtector.<version>.nupkg - NuGet package for AP .NET
    • dotnetprovider.plm - Dynamically loadable module for Windows

Installing the NuGet Package

  1. In Solution Explorer, right-click on Dependencies and select Manage NuGet Packages.
    The NuGet Package Manager screen appears.

  2. Click the Settings icon next to the Package source list.
    The Options dialog box appears.

  3. Click the ellipsis icon next to the Source field.

  4. Browse to select the lib directory that contains the DotNetProtector.<version>.nupkg package.
    For example, select the C:\Program Files\Protegrity\sdk\dotnet\lib directory.

  5. Specify a name for the package source in the Name field.

  6. Click Update.
    The lib directory path appears in the Package sources list.

  7. Click OK to close the Options dialog box.

  8. In the NuGet Package Manager screen, in the Package source list, select the newly created package source.

  9. Click Browse.
    The DotNetProtector package appears in the list of packages.

  10. Select DotNetProtector and click Install.
    The DotNetProtector package is installed.

    The AP .NET is installed successfully.

Using Silent Mode

This section describes how to perform a silent installation of AP .Net using command-line parameters.

Silent installation allows you to install AP .Net without user interaction, making it suitable for automated deployments and scripting.

To view usage of the AP .Net installation, use the -help parameter during silent installation.

APDotNetSetup_Windows_x64_10.0.0+0.g8606.exe -help

To specify the directory for the AP .Net installation, use the -dir parameter during silent installation.

APDotNetSetup_Windows_x64_10.0.0+0.g8606.exe -dir C:\Users\Administrator

Note: -dir is a mandatory parameter for silent installation.


Last modified : May 21, 2026