Installing the Detector

FortiDevice Detector is a lightweight scan engine that enables network and asset discovery and vulnerability scanning. FortiDevice requires the use of at least one Detector within your environment. The Detector needs to be installed on a system with reliable connectivity to the network you want to discover.

To install the Detector:

1. Checking the system requirements.

2. Optional. Adding a Detector proxy.

3. Downloading the Detector binary package.

4. Checking the Detector version.

Checking the system requirements

Before installing FortiDevice Detector, check the System requirements for the host where the Detector will be installed.

Adding a Detector proxy

Starting in FortiDevice Detector 1.3.a, you can add an external HTTP/HTTPS proxy for installing FortiDevice Detector. The HTTP/HTTPS proxy supports environments that do not have public access to the internet.

The proxy is used only to communicate with the FortiDevice Cloud server; the proxy is not used to scan the network.

To add a Detector proxy:

1. Go to Detectors > Detector Proxies.

   

2. Click ADD PROXY.

   

3. If you selected All Organizations in the Organization dropdown list at the top of the GUI, you can select which organization that the proxy will belong to.

4. In the Proxy Name field, enter a name for the proxy.

5. In the Protocol dropdown list, select HTTP or HTTPS to use for the proxy.

6. Optional. In you do not want the certificate to be checked, select the Skip Certificate Validation checkbox.

7. In the Server IP field, enter the IP address for the server.

8. In the Port field, enter the port number.

9. Optional. In the Username field, enter the user name to use for the server.

10. Optional. In the Password field, enter the password to use for the server.

11. Optional. In the Notes field, enter any information that would be useful.

12. Click SAVE.

Downloading the Detector binary package

FortiDevice offers the following Detector binary packages:

• x86 64-bit for Windows

• ARM 64-bit for Windows

• x86 32-bit for Windows

• x86 64-bit for Linux

• ARM 64-bit for Linux

• x86 32-bit for Linux

• x86 64-bit for MacOS

• ARM 64-bit for MacOS

To download the Detector binary package:

1. Go to Detectors.

   

2. Click DOWNLOAD DETECTOR.

3. If you selected All Organizations in the Organization dropdown list at the top of the GUI, you can select which organization that the Detector will belong to.

4. From the Host Operating System dropdown list, select the operating system of the host where FortiDevice Detector will be installed. You can select Windows, Linux, or MacOS.

   After you select the host, the minimum host system requirements are displayed.

5. From the Host CPU Type dropdown list, select the CPU architecture of the host where FortiDevice Detector will be installed. You can select x86 64-bit, ARM 64-bit, or x86 32-bit for Windows or Linux. You can select x86 64-bit or ARM 64-bit for MacOS.

6. From the Proxy Name dropdown list, select a proxy if you want to use the external HTTP/HTTPS proxy to install FortiDevice Detector.

   NOTE: You must create the Detector proxy before it can be selected here.

7. Click DOWNLOAD INSTALLER to download it.

8. Click Close.

9. Grant the Detector the executable privilege and then execute it.

   • If you are using Windows, locate the downloaded installer in File Explorer and double-click it or right-click the downloaded installer and select Run as administrator.

   • You can click the copy icon to the right of the Curl command and then run the Curl command to install FortiDevice Detector.

     The download link is specific to your FortiDevice account. Using the wrong link can result in a new FortiDevice Detector being associated with the wrong account.

   • In Linux, you can enter commands similar to the following:

     sudo chmod u+x Fortidevice-Detector-Installer-Linux-amd64.bin

     sudo ./Fortidevice-Detector-Installer-Linux-amd64.bin

   • In MacOS, you can enter commands similar to the following:

     sudo chmod u+x Fortidevice-Detector-Installer-MacOS-arm64.bin

     sudo ./Fortidevice-Detector-Installer-Darwin-arm64.bin

To install FortiDevice Dectector on Windows 8:

1. Open PowerShell as an administrator.

2. Run the following command to force PowerShell to use TLS 1.2 for SSL connections:

   [Net.ServicePointManager]::SecurityProtocol =

   [Net.SecurityProtocolType]::Tls12

3. Run the following command to fetch the real download URL:

   $downloadUrl = Invoke-RestMethod -Uri "https://api-test1.fortidevice-cloud-qa.com/download/detector/c8f99dea8e7d74e59493357c8602912bbd3bd77dfda8fcf617353db89fa8e322/-1/Installer-Windows-amd64"

4. Run the following command to use Invoke-WebRequest to download the file:

   Invoke-WebRequest -Uri $downloadUrl -OutFile "Fortidevice-Detector-Installer-Windows-amd64.exe"

Checking the Detector version

Go to Detectors to see the Detector version and build number for each installed Detector.

You can also enter the following command to check the version of the installed Detector:

<dectector_image_name> --version

For example:

• Windows: Fortidevice-Detector-Installer-Windows-amd64.exe --version

• MacOS: ./Fortidevice-Detector-Installer-MacOS-amd64.bin –version

• Linux: ./Fortidevice-Detector-Installer-Linux-amd64.bin –version