Skip to content

Commit 4fadc88

Browse files
lap1nouactions-userDramelac
committed
Fixed ff policy instruction in docs (#78)
* Update my-resources.rst --------- Co-authored-by: Github Actions <actions@github.com> Co-authored-by: Dramelac <Dramelac@users.noreply.github.com>
1 parent 0bdcb8c commit 4fadc88

File tree

1 file changed

+82
-4
lines changed

1 file changed

+82
-4
lines changed

source/exegol-image/my-resources.rst

Lines changed: 82 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -101,11 +101,89 @@ To automatically:
101101

102102
A system exists to easily personalise firefox in any new exegol container.
103103

104-
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/.
104+
The file ``/usr/lib/firefox-esr/distribution/policies.json`` can be used as a template in order to create your own Firefox policy. Your policy can then be copied to the location ``/opt/my-resources/setup/firefox/policies.json`` to apply it in the next container deployment (https://support.mozilla.org/en-US/kb/customizing-firefox-using-policiesjson), all available directives can be found here: https://mozilla.github.io/policy-templates/.
105105

106-
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.
106+
.. hint::
107+
Your custom policy will overwrite the default policy created by Exegol.
108+
109+
The default policy applied by Exegol will do the following actions:
110+
111+
`Add a few bookmarks`
112+
113+
.. code-block:: json
114+
115+
{
116+
"policies": {
117+
"ManagedBookmarks": [
118+
{
119+
"toplevel_name": "Exegol Bookmarks"
120+
},
121+
{
122+
"url": "https://exegol.readthedocs.io/en/latest/",
123+
"name": "Exegol Doc"
124+
},
125+
{
126+
"name": "References / Guides",
127+
"children": [
128+
{
129+
"url": "https://www.thehacker.recipes/",
130+
"name": "THR"
131+
},
132+
[...]
133+
{
134+
"url": "https://lolol.farm/",
135+
"name": "LOLOL Farm"
136+
}
137+
]
138+
}
139+
]
140+
}
141+
142+
`Install a few extensions`
143+
144+
.. code-block:: json
145+
146+
{
147+
"policies": {
148+
"ExtensionSettings": {
149+
"foxyproxy@eric.h.jung": {
150+
"installation_mode": "force_installed",
151+
"install_url": "https://addons.mozilla.org/firefox/downloads/latest/foxyproxy-standard/latest.xpi"
152+
},
153+
[...]
154+
}
155+
}
156+
157+
`Disable a few Firefox features such as the telemetry`
158+
159+
.. code-block:: json
160+
161+
{
162+
"policies": {
163+
"DisableTelemetry": true,
164+
"DisplayBookmarksToolbar": "always",
165+
"UserMessaging": {
166+
"WhatsNew": false,
167+
"ExtensionRecommendations": false,
168+
"FeatureRecommendations": false,
169+
"UrlbarInterventions": false,
170+
"SkipOnboarding": true,
171+
"MoreFromMozilla": false
172+
}
173+
}
174+
175+
`Apply the CA of Burpsuite`
176+
177+
.. code-block:: json
178+
179+
{
180+
"policies": {
181+
"Certificates": {
182+
"Install": ["/opt/tools/firefox/cacert.der"]
183+
}
184+
}
107185
108-
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:
186+
In order to install a specific addon in your own policy, 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 your policy file:
109187
110188
.. code-block:: json
111189
@@ -142,7 +220,7 @@ or you can add a new folder:
142220
:code:`firefox` (addons, CA) (deprecated)
143221
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
144222
.. warning::
145-
This covers the previous method for personalizing Firefox; the current approach utilizes :ref:`policy <`firefox` (policy)>`.
223+
This covers the previous method for personalizing Firefox; the current approach utilizes :ref:`policy <\`firefox\` (policy)>`.
146224
147225
.. seealso::
148226
Available from version ``3.0.2`` to ``3.1.5`` of any exegol image.

0 commit comments

Comments
 (0)