]> git.ipfire.org Git - thirdparty/suricata.git/commitdiff
doc: removed unified2 output
authorJason Ish <jason.ish@oisf.net>
Wed, 6 Nov 2019 02:26:27 +0000 (20:26 -0600)
committerVictor Julien <victor@inliniac.net>
Tue, 25 Feb 2020 06:37:00 +0000 (07:37 +0100)
doc/userguide/configuration/suricata-yaml.rst
doc/userguide/output/log-rotation.rst

index bb24efa5f382fee54dabc0426fb66259d7f229be..70a6effdfd64c4a6b2ace47c118b176f889a5a0d 100644 (file)
@@ -161,9 +161,6 @@ outputs section and storing them in outputs.yaml
       filename: fast.log
       append: yes
 
-  - unified2-alert:
-      enabled: yes
-
   ...
 
 ::
@@ -190,9 +187,6 @@ different YAML file.
           filename: fast.log
           append: yes
 
-      - unified2-alert:
-          enabled: yes
-
 ::
 
   # suricata.yaml
@@ -326,80 +320,6 @@ For more advanced configuration options, see :ref:`Eve JSON Output <eve-json-out
 
 The format is documented in :ref:`Eve JSON Format <eve-json-format>`.
 
-.. _suricata_yaml_unified2:
-
-Alert output for use with Barnyard2 (unified2.alert)
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-.. note:: Unified2 output has been deprecated and will be removed by
-          December 2019. Please see the `deprecation policy`_ for more
-          information.
-
-This log format is a binary format compatible with the unified2 output
-of another popular IDS format and is designed for use with Barnyard2
-or other tools that consume the unified2 log format.
-
-By default a file with the given filename and a timestamp (unix epoch
-format) will be created until the file hits the configured size limit,
-then a new file, with a new timestamp will be created. It is the job
-of other tools, such as Barnyard2 to cleanup old unified2 files.
-
-If the `nostamp` option is set the log file will not have a timestamp
-appended. The file will be re-opened on SIGHUP like other log files
-allowing external log rotation tools to work as expected. However, if
-the limit is reach the file will be deleted and re-opened.
-
-This output supports IPv6 and IPv4 events.
-
-::
-
-  - unified2-alert:
-      enabled: yes
-
-      # The filename to log to in the default log directory. A
-      # timestamp in unix epoch time will be appended to the filename
-      # unless nostamp is set to yes.
-      filename: unified2.alert
-
-      # File size limit.  Can be specified in kb, mb, gb.  Just a number
-      # is parsed as bytes.
-      #limit: 32mb
-
-      # By default unified2 log files have the file creation time (in
-      # unix epoch format) appended to the filename. Set this to yes to
-      # disable this behavior.
-      #nostamp: no
-
-      # Sensor ID field of unified2 alerts.
-      #sensor-id: 0
-
-      # Include payload of packets related to alerts. Defaults to true, set to
-      # false if payload is not required.
-      #payload: yes
-
-      # HTTP X-Forwarded-For support by adding the unified2 extra header or
-      # overwriting the source or destination IP address (depending on flow
-      # direction) with the one reported in the X-Forwarded-For HTTP header.
-      # This is helpful when reviewing alerts for traffic that is being reverse
-      # or forward proxied.
-      xff:
-        enabled: no
-        # Two operation modes are available, "extra-data" and "overwrite". Note
-        # that in the "overwrite" mode, if the reported IP address in the HTTP
-        # X-Forwarded-For header is of a different version of the packet
-        # received, it will fall-back to "extra-data" mode.
-        mode: extra-data
-        # Two proxy deployments are supported, "reverse" and "forward". In
-        # a "reverse" deployment the IP address used is the last one, in a
-        # "forward" deployment the first IP address is used.
-        deployment: reverse
-        # Header name where the actual IP address will be reported, if more
-        # than one IP address is present, the last IP address will be the
-        # one taken into consideration.
-        header: X-Forwarded-For
-
-This alert output needs Barnyard2.
-
 A line based log of HTTP requests (http.log)
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
index e15e857e7a85adf8dd3390d35e90b3592fc11da1..d6f00932fce6b8ef7cac15f9a8d60c9188fa9881 100644 (file)
@@ -43,5 +43,4 @@ log files is still the responsibility of external tools. These outputs
 include:
 
 - :ref:`Eve <output_eve_rotate>`
-- :ref:`Unified2 <suricata_yaml_unified2>`
 - :ref:`PCAP log <suricata_yaml_pcap_log>`