3 * Copyright (C) Igor Sysoev
7 #ifndef _NGX_EVENT_OPENSSL_H_INCLUDED_
8 #define _NGX_EVENT_OPENSSL_H_INCLUDED_
11 #include <ngx_config.h>
14 #include <openssl/ssl.h>
15 #include <openssl/err.h>
17 #if OPENSSL_VERSION_NUMBER >= 0x00907000
18 #include <openssl/conf.h>
19 #include <openssl/engine.h>
20 #define NGX_SSL_ENGINE 1
23 #define NGX_SSL_NAME "OpenSSL"
26 #define ngx_ssl_session_t SSL_SESSION
27 #define ngx_ssl_conn_t SSL
37 ngx_ssl_conn_t *connection;
42 ngx_connection_handler_pt handler;
44 ngx_event_handler_pt saved_read_handler;
45 ngx_event_handler_pt saved_write_handler;
47 unsigned handshaked:1;
49 unsigned no_wait_shutdown:1;
50 unsigned no_send_shutdown:1;
51 } ngx_ssl_connection_t;
54 #define NGX_SSL_NO_SCACHE -2
55 #define NGX_SSL_NONE_SCACHE -3
56 #define NGX_SSL_NO_BUILTIN_SCACHE -4
57 #define NGX_SSL_DFLT_BUILTIN_SCACHE -5
60 #define NGX_SSL_MAX_SESSION_SIZE 4096
62 typedef struct ngx_ssl_sess_id_s ngx_ssl_sess_id_t;
64 struct ngx_ssl_sess_id_s {
65 ngx_rbtree_node_t node;
71 #if (NGX_PTR_SIZE == 8)
79 ngx_rbtree_t session_rbtree;
80 ngx_rbtree_node_t sentinel;
81 ngx_queue_t expire_queue;
82 } ngx_ssl_session_cache_t;
86 #define NGX_SSL_SSLv2 2
87 #define NGX_SSL_SSLv3 4
88 #define NGX_SSL_TLSv1 8
91 #define NGX_SSL_BUFFER 1
92 #define NGX_SSL_CLIENT 2
94 #define NGX_SSL_BUFSIZE 16384
97 ngx_int_t ngx_ssl_init(ngx_log_t *log);
98 ngx_int_t ngx_ssl_create(ngx_ssl_t *ssl, ngx_uint_t protocols, void *data);
99 ngx_int_t ngx_ssl_certificate(ngx_conf_t *cf, ngx_ssl_t *ssl,
100 ngx_str_t *cert, ngx_str_t *key);
101 ngx_int_t ngx_ssl_client_certificate(ngx_conf_t *cf, ngx_ssl_t *ssl,
102 ngx_str_t *cert, ngx_int_t depth);
103 ngx_int_t ngx_ssl_generate_rsa512_key(ngx_ssl_t *ssl);
104 ngx_int_t ngx_ssl_dhparam(ngx_conf_t *cf, ngx_ssl_t *ssl, ngx_str_t *file);
105 ngx_int_t ngx_ssl_session_cache(ngx_ssl_t *ssl, ngx_str_t *sess_ctx,
106 ssize_t builtin_session_cache, ngx_shm_zone_t *shm_zone, time_t timeout);
107 ngx_int_t ngx_ssl_create_connection(ngx_ssl_t *ssl, ngx_connection_t *c,
110 void ngx_ssl_remove_cached_session(SSL_CTX *ssl, ngx_ssl_session_t *sess);
111 ngx_int_t ngx_ssl_set_session(ngx_connection_t *c, ngx_ssl_session_t *session);
112 #define ngx_ssl_get_session(c) SSL_get1_session(c->ssl->connection)
113 #define ngx_ssl_free_session SSL_SESSION_free
114 #define ngx_ssl_get_connection(ssl_conn) \
115 SSL_get_ex_data(ssl_conn, ngx_ssl_connection_index)
116 #define ngx_ssl_get_server_conf(ssl_ctx) \
117 SSL_CTX_get_ex_data(ssl_ctx, ngx_ssl_server_conf_index)
120 ngx_int_t ngx_ssl_get_protocol(ngx_connection_t *c, ngx_pool_t *pool,
122 ngx_int_t ngx_ssl_get_cipher_name(ngx_connection_t *c, ngx_pool_t *pool,
124 ngx_int_t ngx_ssl_get_raw_certificate(ngx_connection_t *c, ngx_pool_t *pool,
126 ngx_int_t ngx_ssl_get_certificate(ngx_connection_t *c, ngx_pool_t *pool,
128 ngx_int_t ngx_ssl_get_subject_dn(ngx_connection_t *c, ngx_pool_t *pool,
130 ngx_int_t ngx_ssl_get_issuer_dn(ngx_connection_t *c, ngx_pool_t *pool,
132 ngx_int_t ngx_ssl_get_serial_number(ngx_connection_t *c, ngx_pool_t *pool,
136 ngx_int_t ngx_ssl_handshake(ngx_connection_t *c);
137 ssize_t ngx_ssl_recv(ngx_connection_t *c, u_char *buf, size_t size);
138 ssize_t ngx_ssl_write(ngx_connection_t *c, u_char *data, size_t size);
139 ssize_t ngx_ssl_recv_chain(ngx_connection_t *c, ngx_chain_t *cl);
140 ngx_chain_t *ngx_ssl_send_chain(ngx_connection_t *c, ngx_chain_t *in,
142 void ngx_ssl_free_buffer(ngx_connection_t *c);
143 ngx_int_t ngx_ssl_shutdown(ngx_connection_t *c);
144 void ngx_cdecl ngx_ssl_error(ngx_uint_t level, ngx_log_t *log, ngx_err_t err,
146 void ngx_ssl_cleanup_ctx(void *data);
149 extern int ngx_ssl_connection_index;
150 extern int ngx_ssl_server_conf_index;
151 extern int ngx_ssl_session_cache_index;
154 #endif /* _NGX_EVENT_OPENSSL_H_INCLUDED_ */