Mercurial > hg > nginx
annotate src/mail/ngx_mail_ssl_module.c @ 2044:f45cec1cd270
DH parameters, ssl_dhparam
author | Igor Sysoev <igor@sysoev.ru> |
---|---|
date | Mon, 16 Jun 2008 05:51:32 +0000 |
parents | 12b3ad3353f9 |
children | e0b424b98f24 |
rev | line source |
---|---|
539 | 1 |
2 /* | |
3 * Copyright (C) Igor Sysoev | |
4 */ | |
5 | |
6 | |
7 #include <ngx_config.h> | |
8 #include <ngx_core.h> | |
1136 | 9 #include <ngx_mail.h> |
539 | 10 |
11 | |
12 #define NGX_DEFLAUT_CERTIFICATE "cert.pem" | |
13 #define NGX_DEFLAUT_CERTIFICATE_KEY "cert.pem" | |
547 | 14 #define NGX_DEFLAUT_CIPHERS "ALL:!ADH:RC4+RSA:+HIGH:+MEDIUM:+LOW:+SSLv2:+EXP" |
539 | 15 |
16 | |
1136 | 17 static void *ngx_mail_ssl_create_conf(ngx_conf_t *cf); |
18 static char *ngx_mail_ssl_merge_conf(ngx_conf_t *cf, void *parent, void *child); | |
19 static char *ngx_mail_ssl_session_cache(ngx_conf_t *cf, ngx_command_t *cmd, | |
976 | 20 void *conf); |
539 | 21 |
563 | 22 #if !defined (SSL_OP_CIPHER_SERVER_PREFERENCE) |
23 | |
1136 | 24 static char *ngx_mail_ssl_nosupported(ngx_conf_t *cf, ngx_command_t *cmd, |
563 | 25 void *conf); |
26 | |
1136 | 27 static char ngx_mail_ssl_openssl097[] = "OpenSSL 0.9.7 and higher"; |
563 | 28 |
29 #endif | |
30 | |
539 | 31 |
583 | 32 static ngx_conf_enum_t ngx_http_starttls_state[] = { |
1136 | 33 { ngx_string("off"), NGX_MAIL_STARTTLS_OFF }, |
34 { ngx_string("on"), NGX_MAIL_STARTTLS_ON }, | |
35 { ngx_string("only"), NGX_MAIL_STARTTLS_ONLY }, | |
583 | 36 { ngx_null_string, 0 } |
37 }; | |
38 | |
39 | |
40 | |
1136 | 41 static ngx_conf_bitmask_t ngx_mail_ssl_protocols[] = { |
547 | 42 { ngx_string("SSLv2"), NGX_SSL_SSLv2 }, |
43 { ngx_string("SSLv3"), NGX_SSL_SSLv3 }, | |
44 { ngx_string("TLSv1"), NGX_SSL_TLSv1 }, | |
45 { ngx_null_string, 0 } | |
46 }; | |
47 | |
48 | |
1136 | 49 static ngx_command_t ngx_mail_ssl_commands[] = { |
539 | 50 |
51 { ngx_string("ssl"), | |
1136 | 52 NGX_MAIL_MAIN_CONF|NGX_MAIL_SRV_CONF|NGX_CONF_FLAG, |
539 | 53 ngx_conf_set_flag_slot, |
1136 | 54 NGX_MAIL_SRV_CONF_OFFSET, |
55 offsetof(ngx_mail_ssl_conf_t, enable), | |
539 | 56 NULL }, |
57 | |
583 | 58 { ngx_string("starttls"), |
1136 | 59 NGX_MAIL_MAIN_CONF|NGX_MAIL_SRV_CONF|NGX_CONF_TAKE1, |
583 | 60 ngx_conf_set_enum_slot, |
1136 | 61 NGX_MAIL_SRV_CONF_OFFSET, |
62 offsetof(ngx_mail_ssl_conf_t, starttls), | |
583 | 63 ngx_http_starttls_state }, |
64 | |
539 | 65 { ngx_string("ssl_certificate"), |
1136 | 66 NGX_MAIL_MAIN_CONF|NGX_MAIL_SRV_CONF|NGX_CONF_TAKE1, |
539 | 67 ngx_conf_set_str_slot, |
1136 | 68 NGX_MAIL_SRV_CONF_OFFSET, |
69 offsetof(ngx_mail_ssl_conf_t, certificate), | |
539 | 70 NULL }, |
71 | |
72 { ngx_string("ssl_certificate_key"), | |
1136 | 73 NGX_MAIL_MAIN_CONF|NGX_MAIL_SRV_CONF|NGX_CONF_TAKE1, |
539 | 74 ngx_conf_set_str_slot, |
1136 | 75 NGX_MAIL_SRV_CONF_OFFSET, |
76 offsetof(ngx_mail_ssl_conf_t, certificate_key), | |
539 | 77 NULL }, |
78 | |
2044 | 79 { ngx_string("ssl_dhparam"), |
80 NGX_MAIL_MAIN_CONF|NGX_MAIL_SRV_CONF|NGX_CONF_TAKE1, | |
81 ngx_conf_set_str_slot, | |
82 NGX_MAIL_SRV_CONF_OFFSET, | |
83 offsetof(ngx_mail_ssl_conf_t, dhparam), | |
84 NULL }, | |
85 | |
547 | 86 { ngx_string("ssl_protocols"), |
1136 | 87 NGX_MAIL_MAIN_CONF|NGX_MAIL_SRV_CONF|NGX_CONF_1MORE, |
547 | 88 ngx_conf_set_bitmask_slot, |
1136 | 89 NGX_MAIL_SRV_CONF_OFFSET, |
90 offsetof(ngx_mail_ssl_conf_t, protocols), | |
91 &ngx_mail_ssl_protocols }, | |
547 | 92 |
539 | 93 { ngx_string("ssl_ciphers"), |
1136 | 94 NGX_MAIL_MAIN_CONF|NGX_MAIL_SRV_CONF|NGX_CONF_TAKE1, |
539 | 95 ngx_conf_set_str_slot, |
1136 | 96 NGX_MAIL_SRV_CONF_OFFSET, |
97 offsetof(ngx_mail_ssl_conf_t, ciphers), | |
539 | 98 NULL }, |
99 | |
547 | 100 { ngx_string("ssl_prefer_server_ciphers"), |
1136 | 101 NGX_MAIL_MAIN_CONF|NGX_MAIL_SRV_CONF|NGX_CONF_FLAG, |
563 | 102 #ifdef SSL_OP_CIPHER_SERVER_PREFERENCE |
547 | 103 ngx_conf_set_flag_slot, |
1136 | 104 NGX_MAIL_SRV_CONF_OFFSET, |
105 offsetof(ngx_mail_ssl_conf_t, prefer_server_ciphers), | |
547 | 106 NULL }, |
563 | 107 #else |
1136 | 108 ngx_mail_ssl_nosupported, 0, 0, ngx_mail_ssl_openssl097 }, |
563 | 109 #endif |
110 | |
976 | 111 { ngx_string("ssl_session_cache"), |
1136 | 112 NGX_MAIL_MAIN_CONF|NGX_MAIL_SRV_CONF|NGX_CONF_TAKE12, |
113 ngx_mail_ssl_session_cache, | |
114 NGX_MAIL_SRV_CONF_OFFSET, | |
976 | 115 0, |
116 NULL }, | |
117 | |
573 | 118 { ngx_string("ssl_session_timeout"), |
1136 | 119 NGX_MAIL_MAIN_CONF|NGX_MAIL_SRV_CONF|NGX_CONF_TAKE1, |
573 | 120 ngx_conf_set_sec_slot, |
1136 | 121 NGX_MAIL_SRV_CONF_OFFSET, |
122 offsetof(ngx_mail_ssl_conf_t, session_timeout), | |
573 | 123 NULL }, |
547 | 124 |
539 | 125 ngx_null_command |
126 }; | |
127 | |
128 | |
1136 | 129 static ngx_mail_module_t ngx_mail_ssl_module_ctx = { |
1487
f69493e8faab
ngx_mail_pop3_module, ngx_mail_imap_module, and ngx_mail_smtp_module
Igor Sysoev <igor@sysoev.ru>
parents:
1136
diff
changeset
|
130 NULL, /* protocol */ |
f69493e8faab
ngx_mail_pop3_module, ngx_mail_imap_module, and ngx_mail_smtp_module
Igor Sysoev <igor@sysoev.ru>
parents:
1136
diff
changeset
|
131 |
539 | 132 NULL, /* create main configuration */ |
133 NULL, /* init main configuration */ | |
134 | |
1136 | 135 ngx_mail_ssl_create_conf, /* create server configuration */ |
136 ngx_mail_ssl_merge_conf /* merge server configuration */ | |
539 | 137 }; |
138 | |
139 | |
1136 | 140 ngx_module_t ngx_mail_ssl_module = { |
539 | 141 NGX_MODULE_V1, |
1136 | 142 &ngx_mail_ssl_module_ctx, /* module context */ |
143 ngx_mail_ssl_commands, /* module directives */ | |
144 NGX_MAIL_MODULE, /* module type */ | |
541 | 145 NULL, /* init master */ |
539 | 146 NULL, /* init module */ |
541 | 147 NULL, /* init process */ |
148 NULL, /* init thread */ | |
149 NULL, /* exit thread */ | |
150 NULL, /* exit process */ | |
151 NULL, /* exit master */ | |
152 NGX_MODULE_V1_PADDING | |
539 | 153 }; |
154 | |
155 | |
1136 | 156 static ngx_str_t ngx_mail_ssl_sess_id_ctx = ngx_string("MAIL"); |
543 | 157 |
158 | |
539 | 159 static void * |
1136 | 160 ngx_mail_ssl_create_conf(ngx_conf_t *cf) |
577 | 161 { |
1136 | 162 ngx_mail_ssl_conf_t *scf; |
577 | 163 |
1136 | 164 scf = ngx_pcalloc(cf->pool, sizeof(ngx_mail_ssl_conf_t)); |
539 | 165 if (scf == NULL) { |
166 return NGX_CONF_ERROR; | |
167 } | |
168 | |
169 /* | |
577 | 170 * set by ngx_pcalloc(): |
539 | 171 * |
547 | 172 * scf->protocols = 0; |
2044 | 173 * scf->certificate = { 0, NULL }; |
174 * scf->certificate_key = { 0, NULL }; | |
175 * scf->dhparam = { 0, NULL }; | |
539 | 176 * scf->ciphers.len = 0; |
177 * scf->ciphers.data = NULL; | |
976 | 178 * scf->shm_zone = NULL; |
539 | 179 */ |
180 | |
181 scf->enable = NGX_CONF_UNSET; | |
583 | 182 scf->starttls = NGX_CONF_UNSET; |
976 | 183 scf->prefer_server_ciphers = NGX_CONF_UNSET; |
184 scf->builtin_session_cache = NGX_CONF_UNSET; | |
573 | 185 scf->session_timeout = NGX_CONF_UNSET; |
539 | 186 |
187 return scf; | |
188 } | |
189 | |
190 | |
191 static char * | |
1136 | 192 ngx_mail_ssl_merge_conf(ngx_conf_t *cf, void *parent, void *child) |
539 | 193 { |
1136 | 194 ngx_mail_ssl_conf_t *prev = parent; |
195 ngx_mail_ssl_conf_t *conf = child; | |
539 | 196 |
563 | 197 ngx_pool_cleanup_t *cln; |
198 | |
539 | 199 ngx_conf_merge_value(conf->enable, prev->enable, 0); |
1136 | 200 ngx_conf_merge_value(conf->starttls, prev->starttls, NGX_MAIL_STARTTLS_OFF); |
539 | 201 |
1136 | 202 if (conf->enable == 0 && conf->starttls == NGX_MAIL_STARTTLS_OFF) { |
539 | 203 return NGX_CONF_OK; |
204 } | |
205 | |
573 | 206 ngx_conf_merge_value(conf->session_timeout, |
207 prev->session_timeout, 300); | |
208 | |
547 | 209 ngx_conf_merge_value(conf->prefer_server_ciphers, |
210 prev->prefer_server_ciphers, 0); | |
211 | |
212 ngx_conf_merge_bitmask_value(conf->protocols, prev->protocols, | |
213 (NGX_CONF_BITMASK_SET | |
214 |NGX_SSL_SSLv2|NGX_SSL_SSLv3|NGX_SSL_TLSv1)); | |
215 | |
539 | 216 ngx_conf_merge_str_value(conf->certificate, prev->certificate, |
1778 | 217 NGX_DEFLAUT_CERTIFICATE); |
539 | 218 |
219 ngx_conf_merge_str_value(conf->certificate_key, prev->certificate_key, | |
1778 | 220 NGX_DEFLAUT_CERTIFICATE_KEY); |
539 | 221 |
2044 | 222 ngx_conf_merge_str_value(conf->dhparam, prev->dhparam, ""); |
223 | |
547 | 224 ngx_conf_merge_str_value(conf->ciphers, prev->ciphers, NGX_DEFLAUT_CIPHERS); |
539 | 225 |
226 | |
547 | 227 conf->ssl.log = cf->log; |
539 | 228 |
969 | 229 if (ngx_ssl_create(&conf->ssl, conf->protocols, NULL) != NGX_OK) { |
539 | 230 return NGX_CONF_ERROR; |
231 } | |
232 | |
563 | 233 cln = ngx_pool_cleanup_add(cf->pool, 0); |
234 if (cln == NULL) { | |
539 | 235 return NGX_CONF_ERROR; |
236 } | |
237 | |
563 | 238 cln->handler = ngx_ssl_cleanup_ctx; |
239 cln->data = &conf->ssl; | |
240 | |
241 if (ngx_ssl_certificate(cf, &conf->ssl, &conf->certificate, | |
242 &conf->certificate_key) | |
243 != NGX_OK) | |
547 | 244 { |
245 return NGX_CONF_ERROR; | |
246 } | |
539 | 247 |
248 if (conf->ciphers.len) { | |
547 | 249 if (SSL_CTX_set_cipher_list(conf->ssl.ctx, |
563 | 250 (const char *) conf->ciphers.data) |
251 == 0) | |
539 | 252 { |
253 ngx_ssl_error(NGX_LOG_EMERG, cf->log, 0, | |
254 "SSL_CTX_set_cipher_list(\"%V\") failed", | |
255 &conf->ciphers); | |
256 } | |
257 } | |
258 | |
563 | 259 #ifdef SSL_OP_CIPHER_SERVER_PREFERENCE |
260 | |
261 if (conf->prefer_server_ciphers) { | |
262 SSL_CTX_set_options(conf->ssl.ctx, SSL_OP_CIPHER_SERVER_PREFERENCE); | |
263 } | |
264 | |
265 #endif | |
266 | |
547 | 267 if (ngx_ssl_generate_rsa512_key(&conf->ssl) != NGX_OK) { |
539 | 268 return NGX_CONF_ERROR; |
269 } | |
270 | |
2044 | 271 if (ngx_ssl_dhparam(cf, &conf->ssl, &conf->dhparam) != NGX_OK) { |
272 return NGX_CONF_ERROR; | |
273 } | |
274 | |
976 | 275 ngx_conf_merge_value(conf->builtin_session_cache, |
2032 | 276 prev->builtin_session_cache, NGX_SSL_NONE_SCACHE); |
976 | 277 |
278 if (conf->shm_zone == NULL) { | |
279 conf->shm_zone = prev->shm_zone; | |
280 } | |
539 | 281 |
1136 | 282 if (ngx_ssl_session_cache(&conf->ssl, &ngx_mail_ssl_sess_id_ctx, |
976 | 283 conf->builtin_session_cache, |
284 conf->shm_zone, conf->session_timeout) | |
285 != NGX_OK) | |
286 { | |
287 return NGX_CONF_ERROR; | |
288 } | |
573 | 289 |
539 | 290 return NGX_CONF_OK; |
291 } | |
563 | 292 |
577 | 293 |
976 | 294 static char * |
1136 | 295 ngx_mail_ssl_session_cache(ngx_conf_t *cf, ngx_command_t *cmd, void *conf) |
976 | 296 { |
1136 | 297 ngx_mail_ssl_conf_t *scf = conf; |
976 | 298 |
299 size_t len; | |
300 ngx_str_t *value, name, size; | |
301 ngx_int_t n; | |
302 ngx_uint_t i, j; | |
303 | |
304 value = cf->args->elts; | |
305 | |
306 for (i = 1; i < cf->args->nelts; i++) { | |
307 | |
1778 | 308 if (ngx_strcmp(value[i].data, "off") == 0) { |
309 scf->builtin_session_cache = NGX_SSL_NO_SCACHE; | |
310 continue; | |
311 } | |
312 | |
2032 | 313 if (ngx_strcmp(value[i].data, "none") == 0) { |
314 scf->builtin_session_cache = NGX_SSL_NONE_SCACHE; | |
315 continue; | |
316 } | |
317 | |
976 | 318 if (ngx_strcmp(value[i].data, "builtin") == 0) { |
319 scf->builtin_session_cache = NGX_SSL_DFLT_BUILTIN_SCACHE; | |
320 continue; | |
321 } | |
322 | |
323 if (value[i].len > sizeof("builtin:") - 1 | |
324 && ngx_strncmp(value[i].data, "builtin:", sizeof("builtin:") - 1) | |
325 == 0) | |
326 { | |
327 n = ngx_atoi(value[i].data + sizeof("builtin:") - 1, | |
328 value[i].len - (sizeof("builtin:") - 1)); | |
329 | |
330 if (n == NGX_ERROR) { | |
331 goto invalid; | |
332 } | |
333 | |
334 scf->builtin_session_cache = n; | |
335 | |
336 continue; | |
337 } | |
338 | |
339 if (value[i].len > sizeof("shared:") - 1 | |
340 && ngx_strncmp(value[i].data, "shared:", sizeof("shared:") - 1) | |
341 == 0) | |
342 { | |
343 len = 0; | |
344 | |
345 for (j = sizeof("shared:") - 1; j < value[i].len; j++) { | |
346 if (value[i].data[j] == ':') { | |
347 break; | |
348 } | |
349 | |
350 len++; | |
351 } | |
352 | |
353 if (len == 0) { | |
354 goto invalid; | |
355 } | |
356 | |
357 name.len = len; | |
358 name.data = value[i].data + sizeof("shared:") - 1; | |
359 | |
360 size.len = value[i].len - j - 1; | |
361 size.data = name.data + len + 1; | |
362 | |
363 n = ngx_parse_size(&size); | |
364 | |
365 if (n == NGX_ERROR) { | |
366 goto invalid; | |
367 } | |
368 | |
369 if (n < (ngx_int_t) (8 * ngx_pagesize)) { | |
370 ngx_conf_log_error(NGX_LOG_EMERG, cf, 0, | |
371 "session cache \"%V\" is too small", | |
372 &value[i]); | |
373 | |
374 return NGX_CONF_ERROR; | |
375 } | |
376 | |
377 scf->shm_zone = ngx_shared_memory_add(cf, &name, n, | |
1136 | 378 &ngx_mail_ssl_module); |
976 | 379 if (scf->shm_zone == NULL) { |
380 return NGX_CONF_ERROR; | |
381 } | |
382 | |
383 continue; | |
384 } | |
385 | |
386 goto invalid; | |
387 } | |
388 | |
389 if (scf->shm_zone && scf->builtin_session_cache == NGX_CONF_UNSET) { | |
390 scf->builtin_session_cache = NGX_SSL_NO_BUILTIN_SCACHE; | |
391 } | |
392 | |
393 return NGX_CONF_OK; | |
394 | |
395 invalid: | |
396 | |
397 ngx_conf_log_error(NGX_LOG_EMERG, cf, 0, | |
398 "invalid session cache \"%V\"", &value[i]); | |
399 | |
400 return NGX_CONF_ERROR; | |
401 } | |
402 | |
403 | |
563 | 404 #if !defined (SSL_OP_CIPHER_SERVER_PREFERENCE) |
577 | 405 |
563 | 406 static char * |
1136 | 407 ngx_mail_ssl_nosupported(ngx_conf_t *cf, ngx_command_t *cmd, void *conf) |
577 | 408 { |
563 | 409 ngx_conf_log_error(NGX_LOG_EMERG, cf, 0, |
410 "\"%V\" directive is available only in %s,", | |
411 &cmd->name, cmd->post); | |
412 | |
413 return NGX_CONF_ERROR; | |
414 } | |
415 | |
416 #endif |