Compare Revisions

Locked config settings

Revision 165052:

Revision 165052 by Kohei on

Revision 165053:

Revision 165053 by Cripmom on

Title:
Locked config settings
Locked config settings
Slug:
Automatic_Mozilla_Configurator/Locked_config_settings
Automatic_Mozilla_Configurator/Locked_config_settings
Tags:
Administration, enterprise, "Configuration management"
Administration, enterprise, "Configuration management"
Content:

Revision 165052
Revision 165053
n11      This feature exists for Mozilla and Firefox, but not for Thn11      This feature exists for Mozilla and Firefox, but not for Th
>underbird Locked settings can be put into a <code>mozilla.cfg</co>underbird Locked settings can be put into a <code>mozilla.cfg</co
>de> file in the <code>C:\Program Files\mozilla.org\Mozilla</code>>de> file in the <code>C:\Program Files\mozilla.org\Mozilla</code>
> directory. The <a class="external" href="http://alain.knaff.lu/h> directory. The <a class="external" href="http://alain.knaff.lu/h
>owto/MozillaCustomization/mozilla.cfg">mozilla.cfg</a> file is an>owto/MozillaCustomization/mozilla.cfg">mozilla.cfg</a> file is an
> encoded file of javascript commands. The encoding is a simple <a> encoded file of javascript commands. The encoding is a simple <a
> class="external" href="http://groups.google.com/groups?threadm=a> class="external" href="http://groups.google.com/groups?threadm=a
>ltjjj%24cd51%40ripley.netscape.com&amp;rnum=1">"byte-shifting" wi>ltjjj%24cd51%40ripley.netscape.com&amp;rnum=1">"byte-shifting" wi
>th an offset of 13</a> (netscape 4 used a similar encoding, but w>th an offset of 13</a> (netscape 4 used a similar encoding, but w
>ith a of 7 instead). This file also needs to be "called" from <co>ith a of 7 instead). This file also need to be "called" from <cod
>de>C:\Program Files\mozilla.org\Mozilla\defaults\pref\all.js</cod>e>C:\Program Files\mozilla.org\Mozilla\defaults\pref\all.js</code
>e> by appending the following line at the end:>> by appending the following line at the end:
n20      The <a class="external" href="http://alain.knaff.lu/howto/Mn20      Th [http://alain.knaff.lu/howto/MozillaCustomization/moz-by
>ozillaCustomization/moz-byteshift.pl">moz-byteshift.pl</a> script>teshift
> allows to encode...: 
t22    <pre>t
23moz-byteshift.pl -s 13 &lt;mozilla.cfg.txt &gt;mozilla.cfg
24</pre>
25    <p>
26      ... and to decode <code>mozilla.cfg</code> files:
27    </p>
28    <pre>
29moz-byteshift.pl -s -13 &lt;mozilla.cfg &gt;mozilla.cfg.txt
30</pre>
31    <p>
32      Example of an unencoded file: <code><a class="external" hre
>f="http://alain.knaff.lu/howto/MozillaCustomization/mozilla.cfg.t 
>xt">mozilla.cfg.txt</a></code>. The <code>lockPref</code> command 
> puts into place a locked preference, whereas the <code>defaultPr 
>ef</code> command merely puts into a place a default value (which 
> the user may override in his <code>prefs.js</code> file). Note t 
>hat the file <i>must</i> start with <code>//</code>, or else it i 
>s not recognized by Mozilla. As the encoding of the file is prett 
>y trivial, the encoding as such does not provide any real securit 
>y. Instead make sure that file protections make this file unmodif 
>iable by the unprivileged user. Moreover, some settings (such as  
>mail &amp; news configuration) unfortunately seem to be inaccessi 
>ble to <code>mozilla.cfg</code>, which means that these cannot be 
> locked. If you have trouble getting the <code>moz-byteshift.pl</ 
>code> script to work locally, there is also an <a class="external 
>" href="http://www.alain.knaff.lu/~aknaff/howto/MozillaCustomizat 
>ion/cgi/byteshf.cgi">online version</a> available. Note: In recen 
>t versions of mozilla (tested on Windows and Linux, with 1.5, 1.6 
> and 1.7b), the <code>mozilla.cfg</code> file needs to be placed  
>in mozilla's root directory, rather than <code>default\pref</code 
>> where <code>all.js</code> resides. 
33    </p>
34    <p>
35      If you suspect syntax errors in your config file, you can d
>isplay the exact error message by enclosing your code in a try-ca 
>tch block: 
36    </p>
37    <pre>
38try {
39 ...
40} catch(e) {
41 displayError("Test", e);
42}
43</pre>
44    <p>
45      <br>
46    </p>
47    <h3 name="Clear_text_configuration">
48      Clear text configuration
49    </h3>
50    <p>
51      If you don't care about encoding the mozilla.cfg file, appe
>nd this config to all.js instead&nbsp;: 
52    </p>
53    <pre>
54pref("general.config.obscure_value", 0);
55pref("general.config.filename", "mozilla.cfg");
56</pre>

Back to History