Skip to main content

Agent Settings

Descriptions of different settings that you can give to a Frends Agent.

Ossi Galkin avatar
Written by Ossi Galkin
Updated over a year ago

Name for the Agent

Give the Agent a unique name to distinguish it from other Agents within the same Agent Group. A good practice here is to use the logical name of the server you are installing the Agent to as the Agent name. Once the Agent is created the name cannot be changed.

Username for the Agent

Enter the Windows or Active Directory username the Agent service is going to be executing according to the following format: DOMAIN\Username

An example of an Agent username is "Device Name" \ "Name of the user in the device the agent will be installed on".

The Device Name can be found from the Settings - System - About page. The user is simply the name of the user that the agent will be installed with on that machine.

On Windows, Frends only requires a local user, not a Microsoft user when creating an agent. It is possible to create an entirely new user specifically for hosting the agent. There are many ways to create a new user, and many guides available if help is required, for example here.

Password for the Agent

Provide the same password that is used by the user in the device the agent will be installed on.

Ports for REST API (HTTPS) and (HTTP)

Choose the ports that the Agent will be using to expose any REST API services. Note that if you want to have the standardized ports 80 for HTTP and 443 for HTTPS you will need to make sure no other service is using those ports at the server.

External Address

If your server is hooked up to a DNS service, you can optionally provide the name of the server to help with publishing APIs through Frends' API Management Features

SSL Certificate thumbprint

If you have a valid SSL certificate for the server, you can choose the correct certificate by giving the certificate thumbprint here. If left empty the Agent will generate a self-signed certificate for SSL communication.
​NOTE: Make sure to remove any additional characters such as spaces or hidden characters. (Older versions of Windows add an invisible character at the beginning of the thumbprint when copy pasting from the Certificate manager)

Did this answer your question?