summaryrefslogtreecommitdiffstats
path: root/doc/add-source.rst
diff options
context:
space:
mode:
Diffstat (limited to 'doc/add-source.rst')
-rw-r--r--doc/add-source.rst45
1 files changed, 45 insertions, 0 deletions
diff --git a/doc/add-source.rst b/doc/add-source.rst
new file mode 100644
index 0000000..c49692c
--- /dev/null
+++ b/doc/add-source.rst
@@ -0,0 +1,45 @@
+################################
+add-source - Add a source by URL
+################################
+
+Synopsis
+========
+
+::
+
+ suricata-update add-source <name> <url>
+
+Description
+===========
+
+The ``add-source`` adds a source to the set of enabled sources by
+URL. It is useful to add a source that is not provided in the index.
+
+Options
+=======
+
+.. option:: --http-header "Header: Value"
+
+ Add an additional HTTP header to requests for this rule source such
+ as a custom API key. Example::
+
+ add-source --http-header "X-API-Key: 1234"
+
+ HTTP basic authentication can be achieved by setting the HTTP Basic
+ Authentication header with ``base64(user1:password1)``. Example::
+
+ add-source --http-header "Authorization: Basic dXNlcjE6cGFzc3dvcmQx"
+
+ HTTP Bearer authentication can be used by setting the HTTP Bearer Authentication header
+ with a OAuth2 token containing printable ASCII characters. Example::
+
+ add-source --http-header "Auhorization: Bearer NjA2MTUOTAx?D+wOm4U/vpXQy0xhl!hSaR7#ENVpK59"
+
+.. option:: --no-checksum
+
+ Skips downloading the checksum URL for the rule source.
+
+Common Options
+==============
+
+.. include:: ./common-options.rst