Configuring FortiClient EMS
The FortiProxy Security Fabric root device can link to FortiClient Endpoint Management System (EMS) and FortiClient EMS Cloud (a cloud-based EMS solution) for endpoint connectors and automation. Up to seven EMS servers can be added to the Security Fabric, including a FortiClient EMS Cloud server. EMS settings are synchronized between all Fabric members.
To enable cloud-based EMS services, the FortiProxy must be registered to FortiCloud with an appropriate user account. The following examples presume that the EMS certificate has already been configured.
To add an on-premise FortiClient EMS server to the Security Fabric in the GUI:
-
Go to Security Fabric > Fabric Connectors and double-click the FortiClient EMS card.
-
Enable an EMS, and set Type to FortiClient EMS.
-
Enter a name and IP address or FQDN.
When connecting to a multitenancy-enabled EMS, Fabric connectors must use an FQDN to connect to EMS, where the FQDN hostname matches a site name in EMS (including "Default"). The following are examples of FQDNs to provide when configuring the connector to connect to the default site and to a site named SiteA, respectively: default.ems.yourcompany.com, sitea.ems.yourcompany.com. See Multitenancy.
-
Optionally, enable EMS Threat Feed.
-
Click OK.
A window appears to verify the EMS server certificate:
-
Click Accept.
-
Click Accept.
The Connection status is now Connected:
-
If the device is not authorized, log in to the FortiClient EMS to authorize the FortiProxy under Administration > Fabric Devices.
To add a FortiClient EMS Cloud server to the Security Fabric in the GUI:
FortiClient EMS Cloud can only be configured when the FortiProxy is registered to FortiCloud and the EMS Cloud entitlement is verified. If the FortiCloud account does not pass the FortiClient EMS Cloud entitlement check, the option is not selectable in the FortiClient EMS connector settings. |
-
Go to Security Fabric > Fabric Connectors and double-click the FortiClient EMS card.
-
Set the Type to FortiClient EMS Cloud.
-
Enter a name.
-
Click OK.
A window appears to verify the EMS server certificate.
-
Click Accept.
The Connection status is now Connected.
To test connectivity with the EMS server:
-
Go to Security Fabric > Fabric Connectors and double-click the FortiClient EMS card.
-
In the Connection status section, click Refresh.
To add an on-premise FortiClient EMS server to the Security Fabric in the CLI:
config endpoint-control fctems edit {1 | 2 | 3 | 4 | 5} set status {enable | disable} set name <string> set server <ip_address> set certificate <string> set https-port <integer> set source-ip <ip_address> next end
The https-port
is the EMS HTTPS access port number, and the source-ip
is the REST API call source IP address.
To add a FortiClient EMS Cloud server to the Security Fabric in the CLI:
config endpoint-control fctems edit {1 | 2 | 3 | 4 | 5} set status {enable | disable} set name <string> set fortinetone-cloud-authentication enable set certificate <string> next end
To verify the EMS Cloud entitlement in the CLI:
# diagnose test update info
To verify an EMS certificate in the CLI:
# fpx1-209 (root) (Interim)# execute fctems verify 1
EMS already verified.
Configuring FortiClient EMS and FortiClient EMS Cloud on a per-VDOM basis
FortiClient EMS and FortiClient EMS Cloud can be added on a per-VDOM basis. Override must be configured for each VDOM that connects to an EMS server. If override is enabled for a VDOM, the global configuration will not affect the VDOM.
This feature requires FortiClient EMS 7.2.1 and later. With this override configuration, the FortiProxy can connect to multiple on-premise FortiClient EMS instances per VDOM. However, with this same configuration, only one FortiClient EMS Cloud instance can be connected per FortiProxy. Each VDOM supports up to seven EMS servers, plus an additional seven in the global configuration. With override enabled on all ten VDOMs, a 10-VDOM contract would have up to 77 EMS servers. If override is enabled on only one VDOM, a 10-VDOM contract would have up to 14 EMS servers. |
This functionality can be applied to MSSP (managed security service provider) configurations, and each VDOM has its own FortiClient EMS card for the EMS server or instance. For example:
-
Separate on-premise FortiClient EMS instances
-
Single FortiClient EMS multi-tenant instance based on FQDN type
-
Separate FortiClient EMS Cloud instances
To configure a FortiClient EMS server per VDOM in the GUI:
-
Enable override in the FortiProxy CLI on the required VDOMs:
config endpoint-control settings set override enable end
-
Navigate to the desired VDOM, then go to Security Fabric > Fabric Connectors and double-click the FortiClient EMS card.
-
Configure the EMS server settings as needed (see the preceding examples for detailed steps).
To configure a FortiClient EMS server per VDOM in the CLI:
-
Enable override on the required VDOMs:
config endpoint-control settings set override enable end
-
Configure the EMS server on the desired VDOM:
fpx1-209 (fctems-override) (Interim)# sh config endpoint-control fctems-override edit 1 set status enable set name "ems24" set server "10.120.1.24" set serial-number "FCTEMS8823005021" set tenant-id "00000000000000000000000000000000" set capabilities fabric-auth silent-approval websocket websocket-malware push-ca-certs common-tags-api tenant-id client-avatars single-vdom-connector set verifying-ca "Fortinet_CA_Backup" next end
Troubleshooting
Certificate not trusted
When configuring a new connection to an EMS server, the certificate might not be trusted.
When you click Authorize, a warning displays: The server certificate cannot be authenticated with installed CA certificates. Please install its CA certificates on this FortiProxy.
In the CLI, an error message displays when you try to verify the certificate:
# execute fctems verify Win2K16-EMS certificate not configured/verified: 2 Could not verify server certificate based on current certificate authorities. Error 1--92-60-0 in get SN call: EMS Certificate is not signed by a known CA.
The default FortiClient EMS certificate that is used for the SDN connection is signed by the CA certificate that is saved on the Windows server when FortiClient EMS is first installed. You can manually export and install it on the FortiProxy.
To manually export and install the certificate on to the FortiProxy:
-
Export the EMS certificate on the server that EMS is installed on:
-
On the Windows server that EMS is installed on, go to Settings > Manage computer certificates.
-
In the certificate management module, go to Trusted Root Certification Authorities > Certificates.
-
Right click on the certificate issued by FortiClient Enterprise Management Server and select All Tasks > Export.
-
The Certificate Export Wizard opens. Click Next.
-
Select Base-64 encoded X.509, then click Next.
-
Enter a file name for the certificate and click Browse to select the folder where it will be located, then click Next.
-
Review the settings, then click Finish. The certificate is downloaded to the specified folder.
-
-
On the FortiProxy, import the certificate:
-
Go to System > Certificate. By default, the Certificate option is not visible, see Feature Visibility for information.
-
Click Import > CA Certificate.
-
Set Type to File, and click Upload to import the certificate from the management computer.
-
Click OK. The imported certificate is shown in the Remote CA Certificate section of the certificate table.
-
-
Try to authorize the certificate on the FortiProxy:
-
Go to Security Fabric > Fabric Connectors and edit the FortiClient EMS connector. The connection status should now say that the certificate is not authorized.
-
Click Authorize. The following warning is shown:
The warning can also be seen in the CLI:
# execute fctems verify Win2K16-EMS failure in certificate configuration/verification: -4 Could not verify EMS. Error 1--94-0-401 in get SN call: Authentication denied.
-
-
Authorize the FortiProxy on EMS:
-
Log in to the EMS server console and go to Administration > Fabric Devices.
-
Select the serial number of the FortiProxy device, then click Authorize.
-
-
Try to authorize the certificate on the FortiProxy again:
-
On the FortiProxy, go to Security Fabric > Fabric Connectors and edit the FortiClient EMS card.
-
Click Refresh.
-
When presented with the EMS server certificate, click Accept to accept the certificate.
Your connection should now be successful and authorized.
-
Click OK.
-
Using EMS silent approval in the Security Fabric
FortiClient EMS with Fabric authorization and silent approval capabilities can approve the root FortiProxy in a Security Fabric once, and then silently approve remaining downstream FortiProxies in the Fabric. Similarly in an HA scenario, an approval only needs to be made once to the HA primary unit. The remaining cluster members are approved silently.
To use EMS silent approval:
- Configure the EMS entry on the root FortiProxy or HA primary:
config endpoint-control fctems edit "ems139" set fortinetone-cloud-authentication disable set server "172.16.200.139" set https-port 443 set source-ip 0.0.0.0 set pull-sysinfo enable set pull-vulnerabilities enable set pull-avatars enable set pull-tags enable set pull-malware-hash enable unset capabilities set call-timeout 30 set websocket-override disable next end
When the entry is created, the capabilities are unset by default.
- Authenticate the FortiProxy with EMS:
# execute fctems verify ems_139 ...
The FortiProxy will enable the Fabric authorization and silent approval based on the EMS supported capabilities.
config endpoint-control fctems edit "ems139" set server "172.18.62.12" set capabilities fabric-auth silent-approval websocket next end
- Configure a downstream device in the Security Fabric. The downstream device will be silently approved.
- Configure a secondary device in an HA system. The secondary device will be silently approved.
Allowing deep inspection certificates to be synchronized to EMS and distributed to FortiClient
On FortiClient EMS versions that support push CA certs
capability, the FortiProxy will push CA certificates used in SSL deep inspection to the EMS server. On the EMS server, the CA certificates can be selected in the managed endpoint profiles so they can be installed on managed endpoints. FortiClient EMS 7.0.1 and later is required to use this feature.
To configure deep inspection certificate synchronization to EMS:
-
Configure the EMS Fabric connector:
config endpoint-control fctems edit "ems138" set fortinetone-cloud-authentication disable set server "172.16.200.138" set https-port 443 set source-ip 0.0.0.0 set pull-sysinfo enable set pull-vulnerabilities enable set pull-avatars enable set pull-tags enable set pull-malware-hash enable set capabilities fabric-auth silent-approval websocket websocket-malware push-ca-certs set call-timeout 30 set websocket-override disable set preserve-ssl-session disable next end
-
Apply the certificate to an SSL/SSH profile for deep inspection:
config firewall ssl-ssh-profile edit "deep-inspection" set comment "Read-only deep inspection profile." config https set ports 443 set status deep-inspection end ... set server-cert-mode re-sign set caname "Fortinet_CA_SSL" set untrusted-caname "Fortinet_CA_Untrusted" next end
The default deep inspection profile, CA certificate, and untrusted CA certificates are used in this example.
-
Configure the firewall policy:
config firewall policy edit 1 set name "deep-inspection" set srcintf "port14" set dstintf "port13" set action accept set srcaddr "all" set dstaddr "all" set schedule "always" set service "ALL" set utm-status enable set inspection-mode proxy set ssl-ssh-profile "deep-inspection" set av-profile "default" set nat enable next end
-
In EMS, verify that the CA certificate was pushed to EMS:
-
Go to Endpoint Policy & Components > CA Certificates.
-
Verify the certificate table to see that the EMS server received the CA certification from the different FortiProxies.
-
-
Select the CA certificate in the endpoint profile:
-
Go to Endpoint Profiles > System Settings and edit a profile. The default profile is used in this example.
-
In the Other section, enable Install CA Certificate on Client and select the Fortinet_CA_SSL certificate for the desired endpoint.
-
Click Save.
After the FortiClient endpoint is registered, it receives the CA certificate. When the FortiClient endpoint tries to access the internet through the FortiProxy with the firewall policy that has deep inspection, no warning message is displayed. The server certificate is trusted with the installed CA certificate to complete the certificate chain.
-
Verification
Before configuring deep inspection certificate synchronization, a warning message is displayed when a FortiClient endpoint accesses the internet through the FortiProxy with the firewall policy that has deep inspection. The FortiClient certificate store does not have the FortiProxy's CA that is used in the deep inspection SSL/SSH profile.
For example, accessing https://www.facebook.com in Chrome shows a warning. In the address bar, clicking Not secure > Certificate opens the Certificate dialog, which indicates that Windows does not have enough information to verify the certificate.
After the EMS profile is pushed to FortiClient endpoint, the expected FortiProxy's certificate is shown in its certificate store.
To verify the deep inspection certificate synchronization:
- In Chrome, go to Settings > Privacy and security and open Manage certificates.
- Click the Trusted Root Certification Authorities tab. The FortiProxy's certificate appears in the list.
- On the FortiClient endpoint using Chrome, go to https://www.facebook.com. The website is displayed.
- In the address bar, click the padlock, then click Certificate. The dialog displays the valid certificate information.
Diagnostics
Use the diagnose endpoint fctems json deep-inspect-cert-sync
command in FortiProxy to verify the certificate information.
To verify the FortiProxy:
FGT_EC_Primary (global) # diagnose endpoint fctems json deep-inspect-cert-sync JSON: """ { "fortiproxies":[ "FPXVULTM24000082" ], "vdoms":[ { "vdom":"root", "certs":[ { "name":"Fortinet_CA_SSL", "cert":"-----BEGIN CERTIFICATE-----\\nMIID8zCCAtugAwIBAgIIQ87QKgsf3EcwDQYJKoZIhvcNAQELBQAwgakxCzAJBgNV\\nBAYTAlVTMRMwEQYDVQQIDApDYWxpZm9ybmlhMRIwEAYDVQQHDAlTdW5ueXZhbGUx\\nETAPBgNVBAoMCEZvcnRpbmV0MR4wHAYDVQQLDBVDZXJ0aWZpY2F0ZSBBdXRob3Jp\\ndHkxGTAXBgNVBAMMEEZQWFZVTFRNMjQwMDAwODIxIzAhBgkqhkiG9w0BCQEWFHN1\\ncHBvcnRAZm9ydGluZXQuY29tMB4XDTI0MDgwODE4NTUyNVoXDTM0MDgwOTE4NTUy\\nNVowgakxCzAJBgNVBAYTAlVTMRMwEQYDVQQIDApDYWxpZm9ybmlhMRIwEAYDVQQH\\nDAlTdW5ueXZhbGUxETAPBgNVBAoMCEZvcnRpbmV0MR4wHAYDVQQLDBVDZXJ0aWZp\\nY2F0ZSBBdXRob3JpdHkxGTAXBgNVBAMMEEZQWFZVTFRNMjQwMDAwODIxIzAhBgkq\\nhkiG9w0BCQEWFHN1cHBvcnRAZm9ydGluZXQuY29tMIIBIjANBgkqhkiG9w0BAQEF\\nAAOCAQ8AMIIBCgKCAQEAqB5rpjMxhcFUKCxU0FQ462UfkwIksm1+X96RyREsY2BP\\nhJtxlW+n5A0qR3ptmQZEt\/uKozitm5cBI52yks2CkxsI9I8H18ba1dWlHkZW+Maq\\ntAegXNB3umJPHsIzist8LOuv2r3n9dAD8aNDSXP6S9xrUxDZiGKDj5xuTnghVGk7\\nljl7YhnXqklDOyRBiF7TLstfUn5DbTEcT03LyZf+TUhDE1HNGO5LAk+rAgb0kDqF\\nkmihD8+T3dLsQAzA\/eGl0hHlJHOBnh5\/mdM1jN0ObaacAwdaqvqOZQrTw0gFEtcE\\nL2XV6clqWIixHpScnwH+\/LBnlSCiMa+jmuQHMbzhLQIDAQABox0wGzAMBgNVHRME\\nBTADAQH\/MAsGA1UdDwQEAwICBDANBgkqhkiG9w0BAQsFAAOCAQEAnMrl0PuwKwoo\\nxb9gKjkfZairHqanDGb19ergYUKm8uIaQ\/kHTi5RjHzdwos9NvGcr3oEjt9RUc2G\\nrrOKxRQwb4JjXsgo6mNxyOk6e3WKgrrUJxqIqoZWxRn4\/v1yZ4R\/BJAc7mEEccjI\\nhUGGDU\/CTsSW\/yfEk+UDIkrQZf9rCGNbY7H1o8BUBNEBWhnnC6itCFDVDRB5E3vZ\\nrIoT6PP7VCWKzlpSYVp4fmS+vq4JzsnLMkBLSDkBV97F8EV8yyDxpUvl0OeaR7wf\\nOhyY8SZKMP2JTHuRuqZwRKh6y6N6jdMer11DpQPADniDtBLCFdVMQx1GXhNO3FTZ\\nDThv1haduw==\\n-----END CERTIFICATE-----\\n" }, { "name":"Fortinet_CA_Untrusted", "cert":"-----BEGIN CERTIFICATE-----\\nMIID\/TCCAuWgAwIBAgIIbq+nqfHMdW0wDQYJKoZIhvcNAQELBQAwga4xCzAJBgNV\\nBAYTAlVTMRMwEQYDVQQIDApDYWxpZm9ybmlhMRIwEAYDVQQHDAlTdW5ueXZhbGUx\\nETAPBgNVBAoMCEZvcnRpbmV0MR4wHAYDVQQLDBVDZXJ0aWZpY2F0ZSBBdXRob3Jp\\ndHkxHjAcBgNVBAMMFUZvcnRpbmV0IFVudHJ1c3RlZCBDQTEjMCEGCSqGSIb3DQEJ\\nARYUc3VwcG9ydEBmb3J0aW5ldC5jb20wHhcNMjQwODA4MTg1NTI1WhcNMzQwODA5\\nMTg1NTI1WjCBrjELMAkGA1UEBhMCVVMxEzARBgNVBAgMCkNhbGlmb3JuaWExEjAQ\\nBgNVBAcMCVN1bm55dmFsZTERMA8GA1UECgwIRm9ydGluZXQxHjAcBgNVBAsMFUNl\\ncnRpZmljYXRlIEF1dGhvcml0eTEeMBwGA1UEAwwVRm9ydGluZXQgVW50cnVzdGVk\\nIENBMSMwIQYJKoZIhvcNAQkBFhRzdXBwb3J0QGZvcnRpbmV0LmNvbTCCASIwDQYJ\\nKoZIhvcNAQEBBQADggEPADCCAQoCggEBAIUqzXof0CxPYABddoAyHtTnxapeGt4p\\nQXh\/SFnsmdNzlpNg3+pZr8vitYcDjKGKXBqGFK100bSuZ9mzeK3g5Zxgl\/CJcNsv\\naiTawXPF1V0nTVfujIOxK5ThABiAuacszhuZ3UAQCVrWogvHiDv63bioJxnNBtEw\\nQB1v0F2W5bTaiAN8CpEUyGnZo+qdvgU+C0t21urdA2wuhEBju7E9nW2OTG\/\/62G2\\nF98uVE5dBzXFx9HZoY6Ra\/fGXFdYugKsmINoagNtKL2nDG9DHzBk\/vtjKAFfCJwl\\nvy797znw\/7+tfKDBP\/aeLpw99Y9zyMiAAjhntd4hwUNNXTSKAxBWul0CAwEAAaMd\\nMBswDAYDVR0TBAUwAwEB\/zALBgNVHQ8EBAMCAgQwDQYJKoZIhvcNAQELBQADggEB\\nAHV4pMDNvvhqQ627Czy6+OXa2PLlGNS\/j4AKtMF2450rqPkjmnSi8glPBQ\/7Isrz\\ne4lxdNQcpvTX6Kd\/KKw4gI2Io2rdXb1udlCZwXkm4eTOnIGs\/24L2BPmWRyo\/WSy\\nX9OyAQ+pprUMXWFvrZ6g5jzmaFKVHz09ytKNnOufeCH4c4NlHx7srlQYJt6udZfF\\ng6sWzhY6qxAKJf56GcdGJDk2l7is9l52P6NOhpCgLnvnEnaADYExKKmswP57MAGZ\\n0\/2FFLPwxobWmAJjvZCixgecDTlEQ4giEM9gCp8LjOTdNgee\/m7JSFRQUMm+K5LF\\nKVFl3KuRqdOyf+hwbxGn1bY=\\n-----END CERTIFICATE-----\\n" } ] }, { "vdom":"vd1", "certs":[ ] }, { "vdom":"vd2", "certs":[ ] } ] } """
Allowing FortiClient EMS connectors to trust EMS server certificate renewals based on the CN field
When a FortiProxy establishes a Fabric connection with FortiClient EMS, the FortiProxy must trust the CA that signed the server certificate. Upon the approval of the EMS certificate, the FortiProxy saves the CN field and will trust future certificates that are signed by the same CA and have the same CN field. This allows EMS servers to update their certificates at regular intervals without requiring re-authorization on the FortiProxy side, as long as the CN field matches. This prevents interruptions to the EMS Fabric connection when a certificate is updated. Previously, upon the user's approval of the certificate, the certificate fingerprint was saved on the FortiProxy, and this required the FortiProxy to re-authorize the EMS connection each time the server certificate is updated.
config endpoint-control fctems edit <id> set trust-ca-cn {enable | disable} next end
This feature is supported for EMS on-premise and cloud connections, and is the default setting. To authorize based on the certificate fingerprint, disable the trust-ca-cn
setting. If the setting is changed back to be enabled at a later time, the user will have to re-approve the EMS certificate.
To configure the EMS Fabric connector to trust EMS server certificate renewals based on the CN field:
config endpoint-control fctems edit 1 set status enable set name "ems133" set dirty-reason none set fortinetone-cloud-authentication disable set server "172.18.62.35" set https-port 443 set serial-number "FCTEMS8822000000" set tenant-id "00000000000000000000000000000000" set source-ip 0.0.0.0 set pull-sysinfo enable set pull-vulnerabilities enable set pull-avatars enable set pull-tags enable set pull-malware-hash enable set capabilities fabric-auth silent-approval websocket websocket-malware push-ca-certs common-tags-api tenant-id set call-timeout 30 set out-of-sync-threshold 180 set websocket-override disable set preserve-ssl-session disable set interface-select-method auto set trust-ca-cn enable next end
To verify the configuration:
-
Download the FortiProxy configuration file.
config endpoint-control fctems-override edit 1 set status enable set name "ems26" set server "10.120.1.26" set serial-number "FCTEMS8824006853" set tenant-id "00000000000000000000000000000000" set capabilities fabric-auth silent-approval websocket websocket-malware push-ca-certs common-tags-api tenant-id client-avatars single-vdom-connector set certificate-fingerprint "D7:2A:AB:25:75:DA:D6:DB:C7:5A:47:5C:C0:5F:5A:80:27:32:06:5E:B7:3C:25:48:E9:E9:14:DB:52:F6:22:5E:06:19:D2:7C:95:28:2D:40:B9:0F:39:55:58:82:71:41:05:E3:BC:9C:85:50:32:E4:C0:48:22:BA:F1:69:82:40" set trust-ca-cn disable next end
# diagnose test application fcnacd 96 ems_id 1, certificate authority and common name: C = CA, ST = BC, L = VANCOUVER, O = FTNT, OU = ReleaseQA, CN = Release_QA, emailAddress = ********@fortinet.comRelease_QA ems_id 1, fingerprint_sha512: ems_id 2, certificate authority and common name: ems_id 2, fingerprint_sha512: 18:51:76:67:EB:4C:31:A1:51:3F:74:F7:8E:1D:47:5C:18:0F:FE:45:DF:52:91:52:37:0B:27:E7:F1:85:5B:01:8C:7D:FB:2D:C7:D2:CC:FE:4A:E3:0E:A9:2A:1C:27:4D:D2:A6:C5:87:B8:97:98:57:75:10:15:28:EF:A2:23:7C
-
Run diagnostics to view the certificate information:
fpx1-209 (global) (Interim)# diagnose test application fcnacd 96 global: ems_id: 1 Verified CN: FCTEMS8824005936 Verifying CA: Fortinet_CA_Backup ems_id: 1, fingerprint_sha512: vdom root: ems_id: 1 Verified CN: FCTEMS8823005021 Verifying CA: Fortinet_CA_Backup ems_id: 1, fingerprint_sha512: vdom vd1: ems_id: 1 Verified CN: Verifying CA: ems_id: 1, fingerprint_sha512: D7:2A:AB:25:75:DA:D6:DB:C7:5A:47:5C:C0:5F:5A:80:27:32:06:5E:B7:3C:25:48:E9:E9:14:DB:52:F6:22:5E:06:19:D2:7C:95:28:2D:40:B9:0F:39:55:58:82:71:41:05:E3:BC:9C:85:50:32:E4:C0:48:22:BA:F1:69:82:40