From 194e6c2e4b5ea80abe4298407a4ace7ed83d4d1a Mon Sep 17 00:00:00 2001
From: Laurence Jones <laurence.jones@live.co.uk>
Date: Mon, 23 Dec 2024 14:11:37 +0000
Subject: [PATCH] enhance: Add pull and sharing options in configuration (#667)

* enhance: Add new configuration options for 1.6.4

* enhance: Update linkage
---
 .../configuration/crowdsec_configuration.md   | 39 +++++++++++++++++++
 1 file changed, 39 insertions(+)

diff --git a/crowdsec-docs/docs/configuration/crowdsec_configuration.md b/crowdsec-docs/docs/configuration/crowdsec_configuration.md
index ecf46e8e8..d6c8a6fc7 100644
--- a/crowdsec-docs/docs/configuration/crowdsec_configuration.md
+++ b/crowdsec-docs/docs/configuration/crowdsec_configuration.md
@@ -175,6 +175,10 @@ api:
     use_forwarded_for_headers: "<true|false>"
     console_path: <path_to_console_file>
     online_client:
+      sharing: "(true|false)"
+      pull:
+        community: "(true|false)"
+        blocklists: "(true|false)"
       credentials_path: "<path_to_crowdsec_api_client_credential_file>"
     disable_remote_lapi_registration: (true|false)
     capi_whitelists_path: "<path_to_capi_whitelists_file>"
@@ -697,6 +701,10 @@ api:
     use_forwarded_for_headers: "(true|false)"
     console_path: <path_to_console_file>
     online_client:
+      sharing: "(true|false)"
+      pull:
+        community: "(true|false)"
+        blocklists: "(true|false)"
       credentials_path: "<path_to_crowdsec_api_client_credential_file>"
     disable_remote_lapi_registration: (true|false)
     capi_whitelists_path: "<path_to_capi_whitelists_file>"
@@ -803,6 +811,10 @@ server:
     #- 10.0.0.0/24
   console_path: <path_to_console_file>
   online_client:
+    sharing: "(true|false)"
+    pull:
+      community: "(true|false)"
+      blocklists: "(true|false)"
     credentials_path: <path_to_crowdsec_api_client_credential_file>
   disable_remote_lapi_registration: (true|false)
   capi_whitelists_path: "<path_to_capi_whitelists_file>"
@@ -876,9 +888,36 @@ Configuration to push signals and receive bad IPs from Crowdsec API.
 
 ```yaml
 online_client:
+  sharing: "(true|false)"
+  pull:
+    community: "(true|false)"
+    blocklists: "(true|false)"
   credentials_path: "<path_to_crowdsec_api_client_credential_file>"
 ```
 
+###### `sharing`
+> bool
+
+Whether you want to share signals with Central API, please note as outlined in the [Community blocklists](central_api/blocklist.md) section, enabling or disabling based on your plan type will affect how many IP's are downloaded from the community blocklists.
+
+###### `pull`
+
+```yaml
+pull:
+  community: "(true|false)"
+  blocklists: "(true|false)"
+```
+
+###### `community`
+> bool
+
+Whether to pull signals from the community blocklists. Useful when you want to share your signals with the community but don't want to receive signals from the community.
+
+###### `blocklists`
+> bool
+
+Whether to pull signals from the CrowdSec blocklists. Useful when you want to share your signals with the community but don't want to receive signals from 3rd party or first party blocklists.
+
 ###### `credentials_path`
 > string