[KB8566] "Peer certificate is going to expire" error in ESET PROTECT On-Prem

Issue

Required user permissions

This article assumes that you have the appropriate access rights and permissions to perform the tasks below.

If you use the default Administrator user or are unable to perform the tasks below (the option is unavailable), create a second administrator user with all access rights.

  • Endpoints stop checking in to ESET PROTECT On-Prem
  • “Peer certificate is going to expire” or “Peer certificate is invalid” message in ESET PROTECT On-Prem

Details


Click to expand


As part of the installation process, ESET PROTECT On-Prem requires that you create a peer Certificate Authority and a peer certificate for Agents. These certificates are used to authenticate products distributed under your license. 

If the Agent certificate expires, the agent will not notify you, but you will see warnings in ESET PROTECT On-Prem for 30 days before expiration. After expiration, the Agent will still attempt to connect, and client computers will not be removed automatically. However, they will stop connecting, and the server task "Delete not connecting computers" will eventually remove them if configured to do so.


Solution


See the article Create a new certificate of Certificate Authority in ESET PROTECT On-Prem if you do not know how to create a new peer certificate or Certification Authority.

Certificates are contained in the static group labeled All

Peer certificates and Certification Authority created during the installation are by default contained in the static group labeled All.

Scenario 1: The Agent certificate is going to expire

When the Agents are connecting to the ESET PROTECT Server, ensure that the Agent certificate will not expire sooner than its expiration date.

  1. Create a new Certificate Authority and Peer Certificate in ESET PROTECT On-Prem

  2. Create and apply a new ESET Management Agent policy and distribute the newly created Agent peer certificate.

Do not delete the old certificate until the new certificate is applied to all the Agents.


Scenario 2: The Agent certificate is invalid (expired)

If the Agents cannot connect to the ESET PROTECT Server, redeploy the ESET Management Agent on all the machines that use the expired Agent certificate.

  1. Create a new Certificate Authority and Peer Certificate in ESET PROTECT On-Prem

  2. Deploy the ESET Management Agent using ESET PROTECT or ESET PROTECT On-Prem.


Scenario 3: The Server certificate is expiring soon

If the Certification Authority is expired too, proceed with Scenario 5 instead of this scenario.

  1. Create a new Server certificate. Select Server from the Product drop-down menu.

  2. Select your new ESET PROTECT Server certificate.


Scenario 4: The Server certificate is invalid (expired)

The Agents cannot connect to the ESET PROTECT Server because the Server certificate is expired. After setting up a new Server certificate, Agents with a valid certificate will be able to connect to the ESET PROTECT Server.

If the Certification Authority is expired too, proceed with Scenario 6 instead of this scenario.

  1. Create a new Server certificate. Select Server from the Product drop-down menu.

  2. Select your new ESET PROTECT Server certificate.


Scenario 5: The Certification Authority is expiring soon

The Agents are connecting to the ESET PROTECT Server, however, after creating a new Certification Authority, all certificates you use must be replaced: Server, Agent and Virtual Agent Host.

  1. Create a new Certification Authority and be sure to use a new Common Name different from the expired Certification Authority.

  2. Create a new Server certificate. Select Server from the Product drop-down menu) and sign it with the newly created Certification Authority.

  3. Create new certificates for other product components as needed (Agent and Virtual Agent Host).

  4. Create and apply a new ESET Management Agent policy and distribute the newly created Agent peer certificate.

  5. Apply other peer certificates using policies. 

  6. Wait for replication of the new certificate and Certification Authority to all Agents.

  7. Wait for replication of the new certificate and Certification Authority to all other product components.

  8. Select your new ESET PROTECT Server certificate.

Do not delete the expiring Certification Authority until new certificates are applied to all components.


Scenario 6: The Certification Authority is invalid (expired)

The Agents cannot connect to the ESET PROTECT Server. Create a new Certification Authority. All certificates you use must be replaced: Server, Agent and Virtual Agent Host.

  1. Create a new Certification Authority and be sure to use a new Common Name different from the expired Certification Authority.

  2. Create a new Server certificate. Select Server from the Product drop-down menu) and sign it with the newly created Certification Authority.

  3. Create new certificates for other product components as needed (Agent and Virtual Agent Host).

  4. Deploy the ESET Management Agent using ESET PROTECT or ESET PROTECT On-Prem.

  5. Select your new ESET PROTECT Server certificate.


Troubleshooting logs

When a client computer does not appear to be connecting to your ESET PROTECT Server, we recommend that you perform ESET Management Agent troubleshooting locally on the client machine. See the Online Help topic, Troubleshooting - Agent connection for more information.

Chat with ESET AI Advisor for support