Fortinet white logo
Fortinet white logo

EMS Administration Guide

Configuring EMS settings

Configuring EMS settings

FortiClient EMS installs with a default IP address and port configured. You can change the IP address and port and configure other server settings for FortiClient EMS.

When you enable multitenancy, you must configure some EMS settings at the global level, and other settings at the site level. See Global and per-site configuration.

To configure EMS settings:
  1. Go to System Settings > EMS Settings.
  2. Configure the following options under Shared Settings. EMS uses these settings for FortiClient EMS managing Windows, macOS, and Linux endpoints, and FortiClient EMS managing Chromebook endpoints:

    Hostname

    Displays the FortiClient EMS server's hostname.

    Listen on IP

    Displays the IP addresses for the FortiClient EMS server. FortiClient connects to FortiClient EMS on the specified IP address.

    You can generate a QR code for the specified IP address. See Generating a QR code for centrally managing FortiClient (Android) and (iOS) endpoints.

    Use FQDN

    Specify a fully qualified domain name (FQDN) for the FortiClient EMS server.

    FortiClient's connection to EMS is critical to managing endpoint security. Managing this is relatively easy for internal devices. For external devices or devices that may leave the internal network, you must consider how to maintain this connection. FortiClient can connect to EMS using an IP address or FQDN. An FQDN is preferable for the following reasons:

    • Easy to migrate EMS to a different IP address
    • Easy to migrate to a different EMS instance
    • Flexible to dynamically resolve the FQDN

    The third reason is particularly valuable for environments where devices may be internal or external from day to day. When using an FQDN, you can configure your internal DNS servers to resolve the FQDN to the EMS internal IP address and register your external IP address with public DNS servers. You must then configure the device with your external IP address to forward communication received on port 8013 to your EMS internal IP address. This allows your external clients to leverage a virtual IP address on the FortiGate so that they can reach EMS, while allowing internal clients to use the same FQDN to reach EMS directly.

    Alternatively, you can use a private IP address for the connection. This configuration requires external clients to establish a VPN connection to reach the EMS (VPN policies permitting). This configuration can be problematic if all endpoints need an urgent update but some are disconnected from VPN at that time.

    FQDN

    Enter the FortiClient EMS server FQDN. FortiClient can connect using the specified IP address in the Listen on IP Addresses option or the specified FQDN.

    Remote HTTPS access

    Specify settings for remote administration access to FortiClient EMS.

    Turn remote HTTPS access to FortiClient EMS on and off. When enabled, enter a hostname in the Custom hostname field to let administrators use a browser and HTTPS to log into FortiClient EMS. When disabled, administrators can only log into FortiClient EMS on the server.

    HTTPS port

    Available when Remote HTTPS Access is enabled. Displays the predefined HTTPS port. You cannot change the port.

    Pre-defined hostname

    Available when Remote HTTPS Access is enabled. Displays the predefined hostname. You cannot change the name.

    Custom hostname

    Available when Remote HTTPS Access is turned on. Displays the predefined hostname of the server on which FortiClient EMS is installed. You can customize the hostname. When you change the hostname, the web server restarts.

    Management IP and Port

    Available when Remote HTTPS Access is turned on. If the EMS has an IP address that is usually not publicly reachable but the FortiGate could reach, specify this IP address. In most cases, this is an internal IP address. The FortiOS administrator can use this IP address to connect the FortiGate to the EMS using a Fabric connector.

    Redirect HTTP request to HTTPS

    Available when Remote HTTPS Access is turned on. If this option is enabled, if you attempt to remotely access FortiClient EMS at http://<server_name>, this automatically redirects to https://<server_name>.

    Webserver certificate

    Displays the SSL certificate currently used for the Apache service and the Notify (websockets) daemon. If desired, you can select another certificate from the dropdown list. See Server Certificates.

    Use Webserver certificate for Endpoint Control

    Enable to use the certificate uploaded in the Webserver certificate field for endpoint control.

    Endpoint Control certificate

    Displays the SSL certificate currently used on port 8013 for the Endpoint Control daemon. If desired, you can select another certificate from the dropdown list. See Server Certificates.

    When this option is enabled and FortiClient tries to connect to EMS using the endpoint control protocol, EMS sends the SSL certificate so that FortiClient can use the certificate to verify the connection.

    If the SSL certificate is from a publicly signed certificate authority, only endpoints with the following FortiClient versions can connect to EMS:

    • 6.4.7 and later
    • 7.0.2 and later

    EMS CA certificate (ZTNA)

    This feature requires the ZTNA or EPP license and only applies for endpoints running FortiClient 7.0.0 and later versions. See Windows, macOS, and Linux licenses.

    Displays the EMS CA certificate expiry. EMS sends this certificate to FortiOS. See FortiClient in the Security Fabric.

    Click the Revoke and Update button to revoke and update the certificate. You may want to revoke a certificate if it is compromised and can no longer be trusted. When a certificate is revoked, EMS prompts FortiOS and FortiClient with a new certificate signing request. This may affect existing connections.

    Reset Stalled Deployment Interval

    Enter number of hours after which to reset stalled deployments.

  3. Configure the following options under EMS Settings. FortiClient EMS uses these settings when managing Windows, macOS, and Linux endpoints:

    Listen on port

    Displays the FortiClient EMS server default port. You can change the port by typing a new port number. FortiClient connects using the specified port number.

    Use persistent connections

    Allow FortiClient to create a persistent connection with EMS. This feature allows it to not tear down and renegotiate the TLS connection at every keepalive interval.

    FortiOS Connector port

    Displays the default port that FortiClient EMS uses to connect to FortiOS, where FortiClient EMS is the server and FortiOS is a client. You can change the port by typing a new port number. FortiOS connects using the specified port number.

    Enable TLS 1.0/1.1

    Enable TLS 1.0 and 1.1 for file downloads.

    You must enable this option when upgrading FortiClient on a Windows 7 device via FortiClient EMS.

    FortiClient download URL

    FortiClient deployment packages created in FortiClient EMS are available for download at this URL.

    Open port 10443 in Windows Firewall

    Open port 10443 or close port 10443. Port 10443 is used to download FortiClient.

    Enforce User Verification

    Enforce user verification for endpoints. Users must log in to verified user accounts to register to EMS. See Invitations.

    User Verification Period

    Enter the desired number of days for the user verification period. The minimum number of days is seven.

    Enforce invitations-only registration for

    Enforce invitation-only registration for some or all users. When you select all, FortiClient can only register to EMS using an invitation. See Invitations.

    Sign software packages

    Enable this option to have Windows FortiClient software installers created by or uploaded to FortiClient EMS digitally signed with a code signing certificate.

    Timestamp server

    Enter the server address to timestamp software installers with.

    Certificate

    Upload the desired code signing certificate. This must be a .pfx file. After a certificate has been uploaded, its expiry date is also displayed.

    Password

    Enter the certificate password. This is required for FortiClient EMS to sign the software installers with the certificate.

    Enable Managed by EMS

    Select an option from the dropdown list. Users can configure this IP address in Shared Settings > Listen on IP.

    Connect to local subnets only

    Only allow connection to local subnets.

    Use connection key

    Enable the connection key endpoints can use to connect to FortiGates. Enter and reenter the connection key.

    Enable login banner

    When you enable the login banner, a message appears prior to a user logging into FortiClient EMS. In the Message field, type your message. The Preview section displays a preview of the message.

  4. If managing Chromebooks, enable EMS for Chromebooks Settings. You may need to restart FortiClient EMS after enabling this option.
  5. Configure the following options under EMS for Chromebooks Settings. These settings are used by FortiClient EMS managing Chromebook endpoints:

    Listen on port

    Displays the default port for the FortiClient EMS server for Chromebooks. You can change the port by typing a new port number. The FortiClient Web Filter extension on Chromebooks connects to FortiClient EMS using the specified port number.

    User inactivity timeout

    Enter the number of hours of inactivity after which to timeout the user.

    Profile update interval

    Specify the profile update interval (in seconds).

    Chromebook certificate

    Displays the SSL certificate currently used for the Chromebook daemon. If desired, you can select another certificate from the dropdown list. See Server Certificates.

    Service account

    Displays the service account ID currently in use.

    Update service account

    Update the service account with new credentials.

    Reset service account

    In the event your service account is broken, you can revert back to the default service account by clicking the Reset button. This restores the default service account. You must Save the settings for the change to take effect.

    ID

    Available if the Update service account button is clicked. Enter a new service account ID.

    Private key

    Available if the Update service account button is clicked. Upload a new service account private key.

  6. Configure the following options under Endpoints Settings:

    FortiClient telemetry connection key

    Add the FortiClient Telemetry connection key for FortiClient EMS. FortiClient must provide this key during connection.

    You can generate a QR code for the specified key. See Generating a QR code for centrally managing FortiClient (Android) and (iOS) endpoints.

    Keep alive interval

    Each connected FortiClient endpoint sends a short keep-alive (KA) message to FortiClient EMS at the specified interval.

    Offline timeout

    Configure the number of KA intervals after which EMS considers the endpoint to be offline.

    EMS license timeout

    Configure the number of days after the endpoint has not contacted EMS that EMS removes that endpoint's registration record from EMS.

    FortiClient license timeout

    Configure the number of days after the endpoint has not contacted EMS that EMS removes the license from FortiClient. This setting only applies for endpoints running FortiClient 6.4.

    Delete timeout

    Configure the number of days after which EMS deletes a deregistered endpoint. For example, if you configure this value to be 45 days, EMS deletes the endpoint 45 days after its deregistration.

    Deauthorized user inactivity timeout

    Enable and configure the number of days after which EMS deletes FortiClient user records for unauthorized users.

    Stale verified user cleanup timeout

    Enable and configure the number of days after which EMS deletes FortiClient user records associated with a single device user for unauthorized users. You can click Delete now to delete the records immediately.

    Automatically upload avatars

    FortiClient uploads user avatars to all FortiGates, FortiAnalyzers, and FortiClient EMS servers it is connected to.

    Enable endpoint snapshot reports

    Enable endpoint snapshot reports and enter the interval at which to take reports in seconds. The interval must be between 300 and 86400 seconds.

  7. Enable Manage Multiple Customer Sites. This enables multitenancy for EMS.
  8. Configure the following options under EMS FSSO Settings. These settings add SSL encryption to the Fortinet single sign on protocol between EMS and FortiOS.

    SSL certificate

    Displays the SSL certificate currently imported. If you have already uploaded an SSL certificate, a Replace button displays.

    Certificate

    Browse and upload a new SSL certificate file.

    Password

    Configure a new SSL password.

  9. Click Save.

Configuring EMS settings

Configuring EMS settings

FortiClient EMS installs with a default IP address and port configured. You can change the IP address and port and configure other server settings for FortiClient EMS.

When you enable multitenancy, you must configure some EMS settings at the global level, and other settings at the site level. See Global and per-site configuration.

To configure EMS settings:
  1. Go to System Settings > EMS Settings.
  2. Configure the following options under Shared Settings. EMS uses these settings for FortiClient EMS managing Windows, macOS, and Linux endpoints, and FortiClient EMS managing Chromebook endpoints:

    Hostname

    Displays the FortiClient EMS server's hostname.

    Listen on IP

    Displays the IP addresses for the FortiClient EMS server. FortiClient connects to FortiClient EMS on the specified IP address.

    You can generate a QR code for the specified IP address. See Generating a QR code for centrally managing FortiClient (Android) and (iOS) endpoints.

    Use FQDN

    Specify a fully qualified domain name (FQDN) for the FortiClient EMS server.

    FortiClient's connection to EMS is critical to managing endpoint security. Managing this is relatively easy for internal devices. For external devices or devices that may leave the internal network, you must consider how to maintain this connection. FortiClient can connect to EMS using an IP address or FQDN. An FQDN is preferable for the following reasons:

    • Easy to migrate EMS to a different IP address
    • Easy to migrate to a different EMS instance
    • Flexible to dynamically resolve the FQDN

    The third reason is particularly valuable for environments where devices may be internal or external from day to day. When using an FQDN, you can configure your internal DNS servers to resolve the FQDN to the EMS internal IP address and register your external IP address with public DNS servers. You must then configure the device with your external IP address to forward communication received on port 8013 to your EMS internal IP address. This allows your external clients to leverage a virtual IP address on the FortiGate so that they can reach EMS, while allowing internal clients to use the same FQDN to reach EMS directly.

    Alternatively, you can use a private IP address for the connection. This configuration requires external clients to establish a VPN connection to reach the EMS (VPN policies permitting). This configuration can be problematic if all endpoints need an urgent update but some are disconnected from VPN at that time.

    FQDN

    Enter the FortiClient EMS server FQDN. FortiClient can connect using the specified IP address in the Listen on IP Addresses option or the specified FQDN.

    Remote HTTPS access

    Specify settings for remote administration access to FortiClient EMS.

    Turn remote HTTPS access to FortiClient EMS on and off. When enabled, enter a hostname in the Custom hostname field to let administrators use a browser and HTTPS to log into FortiClient EMS. When disabled, administrators can only log into FortiClient EMS on the server.

    HTTPS port

    Available when Remote HTTPS Access is enabled. Displays the predefined HTTPS port. You cannot change the port.

    Pre-defined hostname

    Available when Remote HTTPS Access is enabled. Displays the predefined hostname. You cannot change the name.

    Custom hostname

    Available when Remote HTTPS Access is turned on. Displays the predefined hostname of the server on which FortiClient EMS is installed. You can customize the hostname. When you change the hostname, the web server restarts.

    Management IP and Port

    Available when Remote HTTPS Access is turned on. If the EMS has an IP address that is usually not publicly reachable but the FortiGate could reach, specify this IP address. In most cases, this is an internal IP address. The FortiOS administrator can use this IP address to connect the FortiGate to the EMS using a Fabric connector.

    Redirect HTTP request to HTTPS

    Available when Remote HTTPS Access is turned on. If this option is enabled, if you attempt to remotely access FortiClient EMS at http://<server_name>, this automatically redirects to https://<server_name>.

    Webserver certificate

    Displays the SSL certificate currently used for the Apache service and the Notify (websockets) daemon. If desired, you can select another certificate from the dropdown list. See Server Certificates.

    Use Webserver certificate for Endpoint Control

    Enable to use the certificate uploaded in the Webserver certificate field for endpoint control.

    Endpoint Control certificate

    Displays the SSL certificate currently used on port 8013 for the Endpoint Control daemon. If desired, you can select another certificate from the dropdown list. See Server Certificates.

    When this option is enabled and FortiClient tries to connect to EMS using the endpoint control protocol, EMS sends the SSL certificate so that FortiClient can use the certificate to verify the connection.

    If the SSL certificate is from a publicly signed certificate authority, only endpoints with the following FortiClient versions can connect to EMS:

    • 6.4.7 and later
    • 7.0.2 and later

    EMS CA certificate (ZTNA)

    This feature requires the ZTNA or EPP license and only applies for endpoints running FortiClient 7.0.0 and later versions. See Windows, macOS, and Linux licenses.

    Displays the EMS CA certificate expiry. EMS sends this certificate to FortiOS. See FortiClient in the Security Fabric.

    Click the Revoke and Update button to revoke and update the certificate. You may want to revoke a certificate if it is compromised and can no longer be trusted. When a certificate is revoked, EMS prompts FortiOS and FortiClient with a new certificate signing request. This may affect existing connections.

    Reset Stalled Deployment Interval

    Enter number of hours after which to reset stalled deployments.

  3. Configure the following options under EMS Settings. FortiClient EMS uses these settings when managing Windows, macOS, and Linux endpoints:

    Listen on port

    Displays the FortiClient EMS server default port. You can change the port by typing a new port number. FortiClient connects using the specified port number.

    Use persistent connections

    Allow FortiClient to create a persistent connection with EMS. This feature allows it to not tear down and renegotiate the TLS connection at every keepalive interval.

    FortiOS Connector port

    Displays the default port that FortiClient EMS uses to connect to FortiOS, where FortiClient EMS is the server and FortiOS is a client. You can change the port by typing a new port number. FortiOS connects using the specified port number.

    Enable TLS 1.0/1.1

    Enable TLS 1.0 and 1.1 for file downloads.

    You must enable this option when upgrading FortiClient on a Windows 7 device via FortiClient EMS.

    FortiClient download URL

    FortiClient deployment packages created in FortiClient EMS are available for download at this URL.

    Open port 10443 in Windows Firewall

    Open port 10443 or close port 10443. Port 10443 is used to download FortiClient.

    Enforce User Verification

    Enforce user verification for endpoints. Users must log in to verified user accounts to register to EMS. See Invitations.

    User Verification Period

    Enter the desired number of days for the user verification period. The minimum number of days is seven.

    Enforce invitations-only registration for

    Enforce invitation-only registration for some or all users. When you select all, FortiClient can only register to EMS using an invitation. See Invitations.

    Sign software packages

    Enable this option to have Windows FortiClient software installers created by or uploaded to FortiClient EMS digitally signed with a code signing certificate.

    Timestamp server

    Enter the server address to timestamp software installers with.

    Certificate

    Upload the desired code signing certificate. This must be a .pfx file. After a certificate has been uploaded, its expiry date is also displayed.

    Password

    Enter the certificate password. This is required for FortiClient EMS to sign the software installers with the certificate.

    Enable Managed by EMS

    Select an option from the dropdown list. Users can configure this IP address in Shared Settings > Listen on IP.

    Connect to local subnets only

    Only allow connection to local subnets.

    Use connection key

    Enable the connection key endpoints can use to connect to FortiGates. Enter and reenter the connection key.

    Enable login banner

    When you enable the login banner, a message appears prior to a user logging into FortiClient EMS. In the Message field, type your message. The Preview section displays a preview of the message.

  4. If managing Chromebooks, enable EMS for Chromebooks Settings. You may need to restart FortiClient EMS after enabling this option.
  5. Configure the following options under EMS for Chromebooks Settings. These settings are used by FortiClient EMS managing Chromebook endpoints:

    Listen on port

    Displays the default port for the FortiClient EMS server for Chromebooks. You can change the port by typing a new port number. The FortiClient Web Filter extension on Chromebooks connects to FortiClient EMS using the specified port number.

    User inactivity timeout

    Enter the number of hours of inactivity after which to timeout the user.

    Profile update interval

    Specify the profile update interval (in seconds).

    Chromebook certificate

    Displays the SSL certificate currently used for the Chromebook daemon. If desired, you can select another certificate from the dropdown list. See Server Certificates.

    Service account

    Displays the service account ID currently in use.

    Update service account

    Update the service account with new credentials.

    Reset service account

    In the event your service account is broken, you can revert back to the default service account by clicking the Reset button. This restores the default service account. You must Save the settings for the change to take effect.

    ID

    Available if the Update service account button is clicked. Enter a new service account ID.

    Private key

    Available if the Update service account button is clicked. Upload a new service account private key.

  6. Configure the following options under Endpoints Settings:

    FortiClient telemetry connection key

    Add the FortiClient Telemetry connection key for FortiClient EMS. FortiClient must provide this key during connection.

    You can generate a QR code for the specified key. See Generating a QR code for centrally managing FortiClient (Android) and (iOS) endpoints.

    Keep alive interval

    Each connected FortiClient endpoint sends a short keep-alive (KA) message to FortiClient EMS at the specified interval.

    Offline timeout

    Configure the number of KA intervals after which EMS considers the endpoint to be offline.

    EMS license timeout

    Configure the number of days after the endpoint has not contacted EMS that EMS removes that endpoint's registration record from EMS.

    FortiClient license timeout

    Configure the number of days after the endpoint has not contacted EMS that EMS removes the license from FortiClient. This setting only applies for endpoints running FortiClient 6.4.

    Delete timeout

    Configure the number of days after which EMS deletes a deregistered endpoint. For example, if you configure this value to be 45 days, EMS deletes the endpoint 45 days after its deregistration.

    Deauthorized user inactivity timeout

    Enable and configure the number of days after which EMS deletes FortiClient user records for unauthorized users.

    Stale verified user cleanup timeout

    Enable and configure the number of days after which EMS deletes FortiClient user records associated with a single device user for unauthorized users. You can click Delete now to delete the records immediately.

    Automatically upload avatars

    FortiClient uploads user avatars to all FortiGates, FortiAnalyzers, and FortiClient EMS servers it is connected to.

    Enable endpoint snapshot reports

    Enable endpoint snapshot reports and enter the interval at which to take reports in seconds. The interval must be between 300 and 86400 seconds.

  7. Enable Manage Multiple Customer Sites. This enables multitenancy for EMS.
  8. Configure the following options under EMS FSSO Settings. These settings add SSL encryption to the Fortinet single sign on protocol between EMS and FortiOS.

    SSL certificate

    Displays the SSL certificate currently imported. If you have already uploaded an SSL certificate, a Replace button displays.

    Certificate

    Browse and upload a new SSL certificate file.

    Password

    Configure a new SSL password.

  9. Click Save.