Linux Secure Boot support for agents

The Unified Extensible Firmware Interface (UEFI) Secure Boot feature is supported with some versions of Deep Security Agent for Linux. For details, see this Secure Boot support table.

When Secure Boot is enabled on an agent computer, the Linux kernel performs a signature check on kernel modules before they are installed. These Deep Security features install kernel modules:

  • Anti-Malware
  • Web Reputation
  • Firewall
  • Integrity Monitoring
  • Intrusion Prevention
  • Application Control

If you intend to use any of those features on a computer where Secure Boot is enabled, you must enroll the Trend Micro public key (provided after installation, for example DS20.der) into the Linux computer's firmware so that it recognizes the Trend Micro kernel module's signature. Otherwise, the Deep Security features can't be installed.

To enroll the Trend Micro public key:

  1. On the computer that you want to protect, and where Secure Boot is enabled, install the Deep Security Agent, if it isn't installed already.

    After installation, the Trend Micro public keys are in /opt/ds_agent/DS20.der and /opt/ds_agent/secureboot/DS20_v2.der.

  2. Install the Machine Owner Key (MOK) facility, if it isn't already installed.

    yum install mokutil

  3. Add the public keys to the MOK list:

    mokutil --import /opt/ds_agent/DS20.der /opt/ds_agent/secureboot/DS20_v2.der

    For details about manually adding the public key to the MOK list, see your Linux documentation.

    For SuSE 15 after 5.3.18-24.34-default, DS20_v2.der is required because the checking kernel modules behavior has changed.

  4. When prompted, enter a password that you will use later in this procedure.
  5. Reboot the system.
  6. After the computer restarts, the Shim UEFI key management console opens:
  7. Shim UEFI key management console
  8. Press any key to get started.
  9. On the Perform MOK management screen, select Enroll MOK.
  10. On the Enroll MOK screen, you can select View key X to check the details of the keys, and press any key to go back to the Enroll MOK screen.
  11. Select Continue on the Enroll the key(s)? screen.
  12. Select Yes, then enter the password you set in step 4.
  13. On the The system must now be rebooted screen, select OK to confirm your changes and reboot.
  14. Use the mokutil utility to check if the key successfully enrolled or not.
  15. mokutil --test-key /opt/ds_agent/DS20.der

    mokutil --test-key /opt/ds_agent/secureboot/DS20_v2.der

Update the Trend Micro public keys

The following situations require you to update the Trend Micro public keys: