feat(geolocation): Handle cache key for different scopes (Ip and country)

Author: julienloizelet

docs/ddev.md

@@ -258,4 +258,32 @@ and:
 
 ```
 ddev phpcbf ./my-own-modules/crowdsec-php-lib/vendor/bin/phpcs my-own-modules/crowdsec-php-lib/src
-```
+```
+
+
+### Auto prepend mode
+
+Before using the bouncer in a standalone mode (i.e. with an auto-prepend directive), you should copy the 
+`examples/auto-prepend/settings.example.php` file to a `examples/auto-prepend/settings.php` and edit it depending on 
+your needs.
+
+And you need also to have functional php website sources under your `php-project-sources` folder. For a quick test, 
+you could just create a `php-project-sources/index.php` with the following content;
+```php
+<?php
+
+echo "This is HOMEPAGE";
+```
+
+Then, to configure the Nginx service in order that it uses an auto-prepend directive pointing to the 
+`examples/auto-prepend/scripts/bounce-via-auto-prepend.php` script, please run the 
+following command from the `.ddev` folder:
+
+```
+ddev crowdsec-prepend-nginx
+
+```
+
+
+With that done, every access to your ddev url (i.e. `https://phpXX.ddev.site` where `XX` is your php version) will 
+be bounce

examples/auto-prepend/scripts/bounce-via-auto-prepend.php

@@ -6,7 +6,8 @@
 use CrowdSecBouncer\StandAloneBounce;
 
 $bounce = new StandAloneBounce();
-$bounce->setDebug($crowdSecStandaloneBouncerConfig['debug_mode']);
-$bounce->setDisplayErrors($crowdSecStandaloneBouncerConfig['display_errors']);
+
+$bounce->setDebug($crowdSecStandaloneBouncerConfig['debug_mode']??false);
+$bounce->setDisplayErrors($crowdSecStandaloneBouncerConfig['display_errors'] ?? false);
 $bounce->init($crowdSecStandaloneBouncerConfig);
 $bounce->safelyBounce();

examples/auto-prepend/scripts/cron-refresh-decisions.php

@@ -6,6 +6,8 @@
 use CrowdSecBouncer\StandAloneBounce;
 
 $bounce = new StandAloneBounce();
+$bounce->setDebug($crowdSecStandaloneBouncerConfig['debug_mode']??false);
+$bounce->setDisplayErrors($crowdSecStandaloneBouncerConfig['display_errors'] ?? false);
 $bounce->init($crowdSecStandaloneBouncerConfig);
 $bouncer = $bounce->getBouncerInstance();
 $bouncer->refreshBlocklistCache();

examples/auto-prepend/settings.example.php

@@ -5,7 +5,8 @@
 $crowdSecStandaloneBouncerConfig = [
     'api_url' => 'http://url-to-your-lapi:8080', // [FILL ME] Set the LAPI URL here. Example in the docker-compose dev context, use http://crowdsec:8080
     'api_key' => '...', // [FILL ME] Set a bouncer key here
-    'debug_mode' => false, // [FILL ME] Set to true to stop the process and display errors if any
+    'debug_mode' => false, // [FILL ME] Set to true to enable debug log
+    'display_errors' => false, // [FILL ME] Set to true to stop the process and display errors if any
     'log_directory_path' => __DIR__.'/.logs', // [FILL ME] Important note: be sur this path won't be publicly accessible!
     'fs_cache_path' => __DIR__.'/.cache', // [FILL ME] Important note: be sur this path won't be publicly accessible!
 
@@ -48,4 +49,15 @@
     'theme_text_ban_wall_subtitle' => 'This page is protected against cyber attacks and your IP has been banned by our system.',
     'theme_text_ban_wall_footer' => '',
     'theme_custom_css' => '',
+
+    'geolocation' => [
+        'save_in_session' => true, // Set to true to avoid multiple call to the geolocation database
+        'test_public_ip' => '210.249.74.42', // Only if you test on a local network (docker, etc.)
+        'enabled' => true, // Set to true if you want to geo-localize IP
+        'type' => 'maxmind', // At this moment, only 'maxmind' type is available
+        'maxmind' => [ // MaxMind settings
+            'database_type' => 'city', // You can set 'city' or 'country'
+            'database_path' => '/var/www/html/GeoLite2-City.mmdb' // Absolute path to the MaxMind database
+        ]
+    ]
 ];