Skip to content

Installing the CodeLogic Windows .NET Agent

The agents send metadata to the CodeLogic Server, they are installed on the servers upon which the applications or databases are running. The applications and databases to be scanned are specified in the agent configuration files.

Note

You must have .NET 6.0 installed.

High-Level Overview

  1. Install a Certificate
  2. Download the Windows .NET Agent
  3. Run the Installer
  4. Execute or Start the Agent
  5. Authorize the Agent

Install a Certificate

Important

If you are using HTTPS you will need to install a certificate. If you are not using HTTPS skip to the next step.

Importing root/intermediate certificate into Windows 

certutil.exe -addstore root path\to\yourCertificate.cer

Download the Windows .NET Agent

  • From a web browser on your system, log in to the CodeLogic Server.

  • Click Admin and then select the Installers tab.

    CodeLogic Admin Installers Page

  • Click Download on Windows.NETAgent to download the Windows installer package.

Run the Installer

  • Double-click the downloaded netcape-installer.exe icon to begin installation.
  • Enter the IP address or host name of the CodeLogic Server.
  • Optionally, enter a descriptive name for the agent.

Note

The descriptive name is populated with the default agent name. If a descriptive name is not entered, the default name will be used.

  • Click Next.
  • To accept the default installation path, click Next or click Change... to change the install location.
  • Complete the installation.

Execute or Start the Agent

The CodeLogic.NET Agent can be executed through a Command-Line Interface (CLI) or started through the Graphical User Interface (GUI).

Change directory to the C:\Program Files (x86)\CodeLogic\NetCape directory and run the agent from the command line.

Commands

cd “C:\Program Files (x86)\CodeLogic\NetCape”  
NetCapeAgent “path_to_scan”

Note

Replace “path_to_scan” with the path to the .NET application to be analyzed.

A lot of output will be printed. The window can be minimized. When decomposing, all available CPUs will be used.

Verify the NetCape service is running through the Windows Services Manager.

Windows Services Manager > NetCape

Authorize the Agent

For security, agents must be authorized before they will send metadata to the CodeLogic Server.

  • From a web browser on your system, log in to the CodeLogic Server.

  • Click Admin and then select the Agents tab.

  • Locate the agent in the list.

Note

The Request Status will be listed as OPEN.

  • Click the more menu icon in the Actions column and select Approve/Reject.

    • The Approve window opens.

  • Optionally, enter a name for the agent in the Agent Name field.

  • Click Approve to complete the authorization process.

Next Steps To run a scan immediately, see Binary Scanning via Command Line (.NET). To configure scanning, and set up a scanning schedule, see Configuring the CodeLogic Windows .NET Agent.