Skip to main content

Windows Endpoint Agent

Installation​

This section will demonstrate how organisations can download, and install the Endpoint Agent.

  1. Navigate to the Downloads section of the SecurEnvoy Access Management Administration Console.

43-EndpointAgents-2.png

  1. Download the Endpoint Agent Installer Package, either for Windows or Debian-based Linux.

43-EndpointAgents-3.png

  1. Install the Endpoint Agent Installer Package to the desired target machine.

43-EndpointAgents-4.png

  1. Specify the language to use during the installation.

43-EndpointAgents-5.png

  1. The organisation must now read the Software EULA Agreement. This must be accepted in order to continue with the installation.

43-EndpointAgents-6.png

  1. Organisations are required to select a Destination Location for the Endpoint Agent to be installed. The default is "C:\SecurEnvoy\Endpoint Agent".

43-EndpointAgents-7.png

  1. Fill in Organisation Specific details for the SecurEnvoy Access Management Tenant.

Tenant Regions

  • "uk": London, UK (TENANT.uk.securenvoy.directory)
  • "eu-west2": Frankfurt, DE (TENANT.eu-west2.securenvoy.directory)
  • "us-central": Iowa, US (TENANT.us-central.securenvoy.directory)
  • "demo": London, UK (TENANT.azuredemo.mysecurenvoy.com)
  • "on-premises": (TENANT.access-mgmt.directory)

Tenant Name This is the tenant name of the Access Management Tenant. Organisations can find this information by navigating to "Organisation" > General Details > Tenant on the Access Management Administration Console.

API Key This is the API Key set up for the Endpoint Agent. If an API Key has not already been set by the organisation, please continue to the next step where API Key generation is shown.

43-EndpointAgents-8.png

  1. Organisations are required to generate an API Key for all agents on the Access Management Platform. This can be generated by navigating to Configuration > API Keys > Add.

43-EndpointAgents-9.png

SecurEnvoy Recommendation

SecurEnvoy recommends that organisations create a separate API Key for each agent usage, for example - creating a separate API Key for the Organisations SingleAgent for LDAP Connectivity, and a separate API Key for the Organisations Endpoint Agents.

43-EndpointAgents-10.png

  1. Once API Key is generated, Organisations can copy the API Key and store this in a secure place which can be obtained when required. Confirmation is required that the API Key is saved and Organisations are aware that the API Key will not be retrievable in the future.
API Key Loss

Organisations are required to back up and save API Keys that are generated, as these can not be revealed after closing the prompt. If an API Key is lost a new API Key will need to be generated and rolled out. It is therefore very important that these keys are backed up.

43-EndpointAgents-11.png

API Keys will be displayed in the Access Management Platform with "Type", "Description", "Created" and "Last Used" Information, to give Organisation Administrators an efficient view of API Key's in rotation across the estate.

43-EndpointAgents-12.png

  1. Configuration is now complete and the setup is ready to begin installing the Endpoint Agent onto the target Machine. Installation will extract files to C:\SecurEnvoy\Endpoint Agent.

43-EndpointAgents-13.png

  1. After the target machine has completed the installation, this will be registered on the SecurEnvoy Access Management Platform, ready to be used.

43-EndpointAgents-14.png