Merge pull request #73 from ThePorgs/dev-images

Firefox policy support in `my-resources`

Author: ShutdownRepo

source/exegol-image/my-resources.rst

@@ -94,9 +94,51 @@ To automatically:
     To be considered for replacing or merging, the customqueries files must be **valid** and bear the ``.json`` extension. The file names do not matter.
     The output will be saved into the single file ``~/.config/bloodhound/customqueries.json``.
 
-
-:code:`firefox` (addons, CA)
+:code:`firefox` (policy)
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.. seealso::
+    Available from version ``3.1.6`` of any exegol image.
+
+A system exists to easily personalise firefox in any new exegol container.
+
+The file ``/opt/my-resources/setup/firefox/policy.json.template`` can be modified to apply a Firefox policy (https://support.mozilla.org/en-US/kb/customizing-firefox-using-policiesjson), all available directives can be found here: https://mozilla.github.io/policy-templates/.
+
+Once the modifications are done, the template file can be renamed to ``/opt/my-resources/setup/firefox/policy.json`` and the policy will be applied.
+
+In order to install a specific addon, you can go to the Firefox addon webpage, and search for the addon GUID in the page HTML source code by searching for the JSON field ``"guid":``, for example for the Dark Reader addon, the GUID is ``addon@darkreader.org``, you can then add the extension in the JSON file:
+
+.. code-block:: json
+"ExtensionSettings": {
+    "addon@darkreader.org": {
+        "installation_mode": "force_installed",
+        "install_url": "https://addons.mozilla.org/firefox/downloads/latest/addon@darkreader.org/latest.xpi"
+    },
+}
+
+To add a bookmark you can add a children to an existing folder in the ``ManagedBookmarks`` directive:
+.. code-block:: json
+{
+    "url": "https://www.thehacker.recipes/",
+    "name": "THR"
+}
+
+or you can add a new folder:
+.. code-block:: json
+{
+    "name": "New folder",
+    "children": [
+        {
+        "url": "https://regex101.com/",
+        "name": "Regex101"
+        }
+    ]
+}
+
+:code:`firefox` (addons, CA) (deprecated)
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.. warning::
+    This covers the previous method for personalizing Firefox; the current approach utilizes :ref:`policy <`firefox` (policy)>`.
+
 .. seealso::
     Available from version ``3.0.2`` of any exegol image.