summaryrefslogtreecommitdiffstats
path: root/docs/html/security.html
blob: e1ca3631d5eda19787c48887d7a0f18da8783be5 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
<HTML
><HEAD
><TITLE
>Bugzilla Security</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.64
"><LINK
REL="HOME"
TITLE="The Bugzilla Guide"
HREF="index.html"><LINK
REL="UP"
TITLE="Administering Bugzilla"
HREF="administration.html"><LINK
REL="PREVIOUS"
TITLE="Product, Component, Milestone, and Version Administration"
HREF="programadmin.html"><LINK
REL="NEXT"
TITLE="Using Bugzilla"
HREF="using.html"></HEAD
><BODY
CLASS="SECTION"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TH
COLSPAN="3"
ALIGN="center"
>The Bugzilla Guide</TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="programadmin.html"
>Prev</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
>Chapter 3. Administering Bugzilla</TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="using.html"
>Next</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="SECTION"
><H1
CLASS="SECTION"
><A
NAME="SECURITY"
>3.4. Bugzilla Security</A
></H1
><TABLE
BORDER="0"
WIDTH="100%"
CELLSPACING="0"
CELLPADDING="0"
CLASS="EPIGRAPH"
><TR
><TD
WIDTH="45%"
>&nbsp;</TD
><TD
WIDTH="45%"
ALIGN="LEFT"
VALIGN="TOP"
><I
><P
><I
>Putting your money in a wall safe is better protection than depending on the fact that
	no one knows that you hide your money in a mayonnaise jar in your fridge.</I
></P
></I
></TD
></TR
></TABLE
><DIV
CLASS="NOTE"
><BLOCKQUOTE
CLASS="NOTE"
><P
><B
>Note: </B
>	Poorly-configured MySQL, Bugzilla, and FTP installations have given attackers full
	access to systems in the past.  Please take these guidelines seriously, even
	for Bugzilla machines hidden away behind your firewall.  80% of all computer
	trespassers are insiders, not anonymous crackers.
      </P
></BLOCKQUOTE
></DIV
><P
>      First thing's first: Secure your installation.
      <DIV
CLASS="NOTE"
><BLOCKQUOTE
CLASS="NOTE"
><P
><B
>Note: </B
>	  These instructions must, of necessity, be somewhat vague since Bugzilla runs on so many different
	  platforms.  If you have refinements of these directions for specific platforms, please
	  submit them to <A
HREF="mailto://mozilla-webtools@mozilla.org"
TARGET="_top"
>mozilla-webtools@mozilla.org</A
>
	</P
></BLOCKQUOTE
></DIV
>
      <P
></P
><OL
TYPE="1"
><LI
><P
>	    Ensure you are running at least MysQL version 3.22.32 or newer.  Earlier versions had
	    notable security holes and poorly secured default configuration choices.
	  </P
></LI
><LI
><P
><EM
>There is no substitute for understanding the tools on your system!</EM
>
	    Read <A
HREF="http://www.mysql.com/documentation/mysql/bychapter/manual_Privilege_system.html"
TARGET="_top"
>	  The MySQL Privelege System</A
> until you can recite it from memory!</P
><P
>	    At the very least, ensure you password the "mysql -u root" account and the "bugs" account, establish grant
	    table rights (consult the Keystone guide in Appendix C: The Bugzilla Database for some easy-to-use details)
	    that do not allow CREATE, DROP, RELOAD, SHUTDOWN, and PROCESS for user "bugs".  I wrote up the Keystone
	    advice back when I knew far less about security than I do now : )
	  </P
></LI
><LI
><P
>	    Lock down /etc/inetd.conf.  Heck, disable inet entirely on this box.  It should only listen to
	    port 25 for Sendmail
	    and port 80 for Apache.
	  </P
></LI
><LI
><P
>Do not run Apache as "nobody".  This will require very lax permissions in your Bugzilla directories.
	  Run it, instead, as a user with a name, set via your httpd.conf file.</P
></LI
><LI
><P
>	    Ensure you have adequate access controls for the $BUGZILLA_HOME/data/ and
	    $BUGZILLA_HOME/shadow/ directories, as well as the $BUGZILLA_HOME/localconfig and
	    $BUGZILLA_HOME/globals.pl files.
	    The localconfig file stores your "bugs" user password,
	    which would be terrible to have in the hands
	    of a criminal, while the "globals.pl" stores some default information regarding your
	    installation which could aid a system cracker.
	    In addition, some files under $BUGZILLA_HOME/data/ store sensitive information, and
	    $BUGZILLA_HOME/shadow/ stores bug information for faster retrieval.  If you fail to secure
	    these directories and this file, you will expose bug information to those who may not
	    be allowed to see it.
	  </P
><DIV
CLASS="NOTE"
><BLOCKQUOTE
CLASS="NOTE"
><P
><B
>Note: </B
>	      Bugzilla provides default .htaccess files to protect the most common Apache
	      installations.  However, you should verify these are adequate according to the site-wide
	      security policy of your web server, and ensure that the .htaccess files are
	      allowed to "override" default permissions set in your Apache configuration files.
	      Covering Apache security is beyond the scope of this Guide; please consult the Apache
	      documentation for details.
	    </P
><P
>	      If you are using a web server that does not support the .htaccess control method,
	      <EM
>you are at risk!</EM
>  After installing, check to see if you can
	      view the file "localconfig" in your web browser (ergo: 
	      <A
HREF="http://bugzilla.mozilla.org/localconfig"
TARGET="_top"
>	      http://bugzilla.mozilla.org/localconfig</A
>.  If you can read the contents of this
	      file, your web server has not secured your bugzilla directory properly and you
	      must fix this problem before deploying Bugzilla.  If, however, it gives you a
	      "Forbidden" error, then it probably respects the .htaccess conventions and you
	      are good to go.
	    </P
></BLOCKQUOTE
></DIV
><P
>	    On Apache, you can use .htaccess files to protect access to these directories, as outlined
	    in <A
HREF="http://bugzilla.mozilla.org/show_bug.cgi?id=57161"
TARGET="_top"
>Bug 57161</A
> for the
	    localconfig file, and <A
HREF="http://bugzilla.mozilla.org/show_bug.cgi?id=65572"
TARGET="_top"
>	    Bug 65572</A
> for adequate protection in your data/ and shadow/ directories.
	  </P
><P
>	    Note the instructions which follow are Apache-specific.  If you use IIS, Netscape, or other
	    non-Apache web servers, please consult your system documentation for how to secure these
	    files from being transmitted to curious users.
	  </P
><P
>	    Place the following text into a file named ".htaccess", readable by your web server,
	    in your $BUGZILLA_HOME/data directory.
	    <P
CLASS="LITERALLAYOUT"
>	&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&#60;Files&nbsp;comments&#62;<br>
	&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;allow&nbsp;from&nbsp;all<br>
	&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&#60;/Files&#62;<br>
	&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;deny&nbsp;from&nbsp;all<br>
	&nbsp;&nbsp;&nbsp;&nbsp;</P
>
	  </P
><P
>	    Place the following text into a file named ".htaccess", readable by your web server,
	    in your $BUGZILLA_HOME/ directory.
	    <P
CLASS="LITERALLAYOUT"
>	&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&#60;Files&nbsp;localconfig&#62;<br>
	&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;deny&nbsp;from&nbsp;all<br>
	&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&#60;/Files&#62;<br>
	&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;allow&nbsp;from&nbsp;all<br>
	&nbsp;&nbsp;&nbsp;&nbsp;</P
>
	  </P
><P
>	    Place the following text into a file named ".htaccess", readable by your web server,
	    in your $BUGZILLA_HOME/shadow directory.
	    <P
CLASS="LITERALLAYOUT"
>	&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;deny&nbsp;from&nbsp;all<br>
	&nbsp;&nbsp;&nbsp;&nbsp;</P
>
	  </P
></LI
></OL
>
    </P
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="programadmin.html"
>Prev</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.html"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="using.html"
>Next</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>Product, Component, Milestone, and Version Administration</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="administration.html"
>Up</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>Using Bugzilla</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>