Adding web (HTTP) servers to be notified using the CLI

Prev Next

To set up HTTP servers, perform the following subtasks:

  • Add the HTTP servers

  • Configure the HTTP server settings

To add an HTTP server:
  1. Enable the CLI configuration mode:

    hostname > enable
    hostname # configure terminal
  2. Enable HTTP notifications:

    hostname (config) # fenotify http enable
  3. Specify the name of the HTTP server (for example, NX7400) to receive the notification. URLs and email addresses are not allowed.

    hostname (config) # fenotify http service <service name>
  4. Specify which servers will post HTTP notifications (one server per command):

    hostname (config) # fenotify http service <service name> enable
  5. Specify the URL for each HTTP server to receive the notification:

    hostname (config) # fenotify http service <service name> server-url <url>
  6. Save the configuration:

    hostname (config) # write memory
To configure the HTTP server listing:
  1. Enable the CLI configuration mode:

    hostname > enable
    hostname # configure terminal
  2. Enable HTTP notifications:

    hostname (config) # fenotify http enable
  3. (Optional) If authentication is required for the server, enable authentication and then specify the user name and password for HTTP authentication:

    hostname (config) # fenotify http service <service name> auth enable
    hostname (config) # fenotify http service <service name> auth username <user name>
    hostname (config) # fenotify http service <service name> auth password <password>
  4. Select the event type:

    hostname (config) # fenotify http alert domain-match
    hostname (config) # fenotify http alert infection-match
    hostname (config) # fenotify http alert ips-event
    hostname (config) # fenotify http alert malware-callback
    hostname (config) # fenotify http alert malware-object
    hostname (config) # fenotify http alert web-infection
  5. Enable the specified servers to post HTTP notifications when ATI alert updates are detected (one server per command):

    hostname (config) # fenotify http service <service name> alerts-update enable
  6. Specify the delivery frequency for HTTP notifications:

    Note

    Trellix recommends using per-event notifications.

    To receive information about all events detected in the past 24 hours, enter:

    hostname (config) # fenotify http service <service name> prefer message delivery daily-digest

    To receive a daily notification for each entity that was the source of the event, enter:

    hostname (config) # fenotify http service <service name> prefer message delivery daily-per-source

    To receive an hourly notification for each entity that was the source of the event, enter:

    hostname (config) # fenotify http service <service name> prefer message delivery hourly-per-source

    To receive a notification every minute for each entity that was the source of the event, enter:

    hostname (config) # fenotify http service <service name> prefer message delivery per-1min-per-source

    To receive a notification every 5 minutes for each entity that was the source of the event, enter:

    hostname (config) # fenotify http service <service name> prefer message delivery per-5min-per-source

    To receive information about each event, sent when the event is triggered, enter:

    hostname (config) # fenotify http service <service name> prefer message delivery per-event
  7. Specify the delivery schedule for HTTP notifications:

    Note

    Trellix recommends using per-event notifications.

    To send a daily notification of all malware objects detected the past 24 hours in the selected format and level of details (default is Concise), enter:

    hostname (config) # fenotify http service <service name> prefer message delivery daily-digest

    To send a notification each time a malware object is detected, enter:

    hostname (config) # fenotify http service <service name> prefer message delivery per-event
  8. (Optional) If you want to use SSL for notifications:

    hostname (config) # fenotify http service <service name> ssl enable
    hostname (config) # fenotify http service <service name> ssl verify
  9. Specify the service provider. The default service provider is generic.

    Note

    Trellix recommends using the generic service provider.

    To select the generic provider, enter:

    hostname (config) # fenotify http service <service name> provider generic

    To select Aruba as the provider, enter:

    hostname (config) # fenotify http service <service name> provider aruba
  10. Select XML, JavaScript Object Notation (JSON), or Text for the format of the HTTP notifications:

    Note

    The json_legacy-concise, json_legacy-extended, and json_legacy-normal formats are deprecated.

    To post notifications in XML Concise format containing basic information such as alert type, ID, source IP, malware name, hostname, and alert URL, enter:

    hostname (config) # fenotify http service <service name> provider generic message format xml-concise

    To post notifications in XML Extended format containing detailed information and abstracts including data-theft information (if any) and static-analysis details (XML Extended provides all details about files and objects modified during analysis.), enter:

    hostname (config) # fenotify http service <service name> provider generic message format xml-extended

    To post notifications in XML Normal format containing detailed information and abstracts such as alert type, ID, source IP, malware name, hostname, and alert URL without any redundant information, enter:

    hostname (config) # fenotify http service <service name> provider generic message format xml-normal

    To post notifications in JSON Concise format containing basic information such as alert type, ID, source IP, malware name, hostname, and alert URL, enter:

    hostname (config) # fenotify http service <service name> provider generic message format json-concise

    To post notifications in JSON Extended format containing detailed information and abstracts including data-theft information (if any) and static-analysis details (JSON Extended provides all details about files and objects modified during analysis.), enter:

    hostname (config) # fenotify http service <service name> provider generic message format json-extended

    To post notifications in JSON Normal format containing detailed information and abstracts such as alert type, ID, source IP, malware name, hostname, and alert URL without any redundant information, enter:

    hostname (config) # fenotify http service <service name> provider generic message format json-normal

    To post notifications in Text Concise format containing basic information such as alert type, ID, source IP, malware name, hostname, and alert URL, enter:

    hostname (config) # fenotify http service <service name> provider generic message format text-concise

    To post notifications in Text Extended format containing detailed information and abstracts including data-theft information (if any) and static-analysis details (Text Extended provides all details about files and objects modified during analysis.), enter:

    hostname (config) # fenotify http service <service name> provider generic message format text-extended

    To post notifications in Text Normal format containing detailed information and abstracts such as alert type, ID, source IP, malware name, hostname, and alert URL without any redundant information, enter:

    hostname (config) # fenotify http service <service name> provider generic message format text-normal
  11. Save the configuration:

    hostname (config) # write memory
  12. Verify the HTTP notifications status.

    hostname (config) # show fenotify http
    Notification Protocol: http
       Configuration:
          Protocol Enabled:                no
          default-delivery                 per-event
          default-provider                 generic
          provider-generic-message-format  xml-normal
       Alerts:
          domain-match                      yes
          infection-match                   yes
          ips-event                         no
          malware-callback                  yes
          malware-object                    yes
          web-infection                     yes
    Consumers:
     sname
          enabled:                         yes
          alerts-update                    true