From 72e984a7e3e60a49a89446ac87e3fc6b0ba97b99 Mon Sep 17 00:00:00 2001 From: lapinou Date: Wed, 27 Nov 2024 14:26:20 +0100 Subject: [PATCH 1/4] Update my-resources.rst --- source/exegol-image/my-resources.rst | 45 ++++++++++++++++++++++++++++ 1 file changed, 45 insertions(+) diff --git a/source/exegol-image/my-resources.rst b/source/exegol-image/my-resources.rst index b4d8da4..addf5fe 100644 --- a/source/exegol-image/my-resources.rst +++ b/source/exegol-image/my-resources.rst @@ -94,9 +94,54 @@ 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` (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, one can rename the file ``/opt/my-resources/setup/firefox/policy.json.template`` into ``/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 erxample for the Dark Reader addon, the GUID is ``addon@darkreader.org``, you can then add the extensioins in the JSON file: + +```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: +```json +{ + "url": "https://www.thehacker.recipes/", + "name": "THR" +}, +``` + +or you can add a new folder: +```json +{ + "name": "New folder", + "children": [ + { + "url": "https://regex101.com/", + "name": "Regex101" + } + ] +}, +``` :code:`firefox` (addons, CA) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.. warning:: + This is the old way of personalising Firefox, the new way use :ref:`policy <`firefox` (policy)>`. + .. seealso:: Available from version ``3.0.2`` of any exegol image. From 11c1a1044ae7356caaaecf19414a97f2740228b0 Mon Sep 17 00:00:00 2001 From: lapinou Date: Wed, 27 Nov 2024 14:36:01 +0100 Subject: [PATCH 2/4] Update my-resources.rst --- source/exegol-image/my-resources.rst | 11 ++++------- 1 file changed, 4 insertions(+), 7 deletions(-) diff --git a/source/exegol-image/my-resources.rst b/source/exegol-image/my-resources.rst index addf5fe..d68d2b8 100644 --- a/source/exegol-image/my-resources.rst +++ b/source/exegol-image/my-resources.rst @@ -105,27 +105,25 @@ The file ``/opt/my-resources/setup/firefox/policy.json.template`` can be modifie Once the modifications are done, one can rename the file ``/opt/my-resources/setup/firefox/policy.json.template`` into ``/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 erxample for the Dark Reader addon, the GUID is ``addon@darkreader.org``, you can then add the extensioins in the JSON file: +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 extensions in the JSON file: -```json +.. 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: -```json +.. code-block:: json { "url": "https://www.thehacker.recipes/", "name": "THR" }, -``` or you can add a new folder: -```json +.. code-block:: json { "name": "New folder", "children": [ @@ -135,7 +133,6 @@ or you can add a new folder: } ] }, -``` :code:`firefox` (addons, CA) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ From 5ccce751d4c6335a6c85ecf5226dce839a08e8e6 Mon Sep 17 00:00:00 2001 From: lapinou Date: Wed, 27 Nov 2024 14:37:37 +0100 Subject: [PATCH 3/4] Update my-resources.rst --- source/exegol-image/my-resources.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/exegol-image/my-resources.rst b/source/exegol-image/my-resources.rst index d68d2b8..bee4661 100644 --- a/source/exegol-image/my-resources.rst +++ b/source/exegol-image/my-resources.rst @@ -120,7 +120,7 @@ To add a bookmark you can add a children to an existing folder in the ``ManagedB { "url": "https://www.thehacker.recipes/", "name": "THR" -}, +} or you can add a new folder: .. code-block:: json @@ -132,7 +132,7 @@ or you can add a new folder: "name": "Regex101" } ] -}, +} :code:`firefox` (addons, CA) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ From 10a49532f037fb51a1a81392b68c25afc9b0606a Mon Sep 17 00:00:00 2001 From: lapinou Date: Wed, 27 Nov 2024 14:44:38 +0100 Subject: [PATCH 4/4] Update my-resources.rst --- source/exegol-image/my-resources.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/source/exegol-image/my-resources.rst b/source/exegol-image/my-resources.rst index bee4661..98c67c2 100644 --- a/source/exegol-image/my-resources.rst +++ b/source/exegol-image/my-resources.rst @@ -103,9 +103,9 @@ 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, one can rename the file ``/opt/my-resources/setup/firefox/policy.json.template`` into ``/opt/my-resources/setup/firefox/policy.json`` and the policy will be applied. +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 extensions in the JSON file: +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": { @@ -134,7 +134,7 @@ or you can add a new folder: ] } -:code:`firefox` (addons, CA) +:code:`firefox` (addons, CA) (old) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .. warning:: This is the old way of personalising Firefox, the new way use :ref:`policy <`firefox` (policy)>`.