src/vnet/tls/tls.h

   1 /*
   2  * Copyright (c) 2018 Cisco and/or its affiliates.
   3  * Licensed under the Apache License, Version 2.0 (the "License");
   4  * you may not use this file except in compliance with the License.
   5  * You may obtain a copy of the License at:
   6  *
   7  *     http://www.apache.org/licenses/LICENSE-2.0
   8  *
   9  * Unless required by applicable law or agreed to in writing, software
  10  * distributed under the License is distributed on an "AS IS" BASIS,
  11  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  12  * See the License for the specific language governing permissions and
  13  * limitations under the License.
  14  */
  15
  16
  17 #include <vnet/session/application_interface.h>
  18 #include <vppinfra/lock.h>
  19
  20 #ifndef SRC_VNET_TLS_TLS_H_
  21 #define SRC_VNET_TLS_TLS_H_
  22
  23 #define TLS_DEBUG               0
  24 #define TLS_DEBUG_LEVEL_CLIENT  0
  25 #define TLS_DEBUG_LEVEL_SERVER  0
  26
  27 #define TLS_CHUNK_SIZE          (1 << 14)
  28 #define TLS_CA_CERT_PATH        "/etc/ssl/certs/ca-certificates.crt"
  29
  30 #if TLS_DEBUG
  31 #define TLS_DBG(_lvl, _fmt, _args...)                   \
  32   if (_lvl <= TLS_DEBUG)                                \
  33     clib_warning (_fmt, ##_args)
  34 #else
  35 #define TLS_DBG(_fmt, _args...)
  36 #endif
  37
  38 /* *INDENT-OFF* */
  39 typedef CLIB_PACKED (struct tls_cxt_id_
  40 {
  41   u32 parent_app_index;
  42   session_handle_t app_session_handle;
  43   session_handle_t tls_session_handle;
  44   u32 listener_ctx_index;
  45   u8 tcp_is_ip4;
  46 }) tls_ctx_id_t;
  47 /* *INDENT-ON* */
  48
  49 STATIC_ASSERT (sizeof (tls_ctx_id_t) <= 42, "ctx id must be less than 42");
  50
  51 typedef struct tls_ctx_
  52 {
  53   union
  54   {
  55     transport_connection_t connection;
  56     tls_ctx_id_t c_tls_ctx_id;
  57   };
  58 #define parent_app_index c_tls_ctx_id.parent_app_index
  59 #define app_session_handle c_tls_ctx_id.app_session_handle
  60 #define tls_session_handle c_tls_ctx_id.tls_session_handle
  61 #define listener_ctx_index c_tls_ctx_id.listener_ctx_index
  62 #define tcp_is_ip4 c_tls_ctx_id.tcp_is_ip4
  63 #define tls_ctx_idx c_c_index
  64   /* Temporary storage for session open opaque. Overwritten once
  65    * underlying tcp connection is established */
  66 #define parent_app_api_context c_s_index
  67
  68   u8 is_passive_close;
  69   u8 *srv_hostname;
  70 } tls_ctx_t;
  71
  72 typedef struct tls_main_
  73 {
  74   u32 app_index;
  75   tls_ctx_t *listener_ctx_pool;
  76   tls_ctx_t *half_open_ctx_pool;
  77   clib_rwlock_t half_open_rwlock;
  78
  79   /*
  80    * Config
  81    */
  82   u8 use_test_cert_in_ca;
  83   char *ca_cert_path;
  84 } tls_main_t;
  85
  86 typedef struct tls_engine_vft_
  87 {
  88   u32 (*ctx_alloc) (void);
  89   void (*ctx_free) (tls_ctx_t * ctx);
  90   tls_ctx_t *(*ctx_get) (u32 ctx_index);
  91   tls_ctx_t *(*ctx_get_w_thread) (u32 ctx_index, u8 thread_index);
  92   int (*ctx_init_client) (tls_ctx_t * ctx);
  93   int (*ctx_init_server) (tls_ctx_t * ctx);
  94   int (*ctx_read) (tls_ctx_t * ctx, u8 * buf, u32 len);
  95   int (*ctx_write) (tls_ctx_t * ctx, u8 * buf, u32 len);
  96   int (*ctx_handshake_rx) (tls_ctx_t * ctx);
  97     u8 (*ctx_handshake_is_over) (tls_ctx_t * ctx);
  98 } tls_engine_vft_t;
  99
 100 enum tls_handshake_results_
 101 {
 102   HANDSHAKE_NOT_OVER,
 103   CLIENT_HANDSHAKE_OK,
 104   CLIENT_HANDSHAKE_FAIL,
 105   SERVER_HANDSHAKE_OK
 106 };
 107
 108 typedef enum tls_engine_type_
 109 {
 110   TLS_ENGINE_MBEDTLS,
 111   TLS_ENGINE_OPENSSL,
 112   TLS_N_ENGINES
 113 } tls_engine_type_t;
 114
 115 tls_main_t *vnet_tls_get_main (void);
 116 void tls_register_engine (const tls_engine_vft_t * vft,
 117                           tls_engine_type_t type);
 118 int tls_add_vpp_q_evt (svm_fifo_t * f, u8 evt_type);
 119
 120 #endif /* SRC_VNET_TLS_TLS_H_ */
 121 /*
 122  * fd.io coding-style-patch-verification: ON
 123  *
 124  * Local Variables:
 125  * eval: (c-set-style "gnu")
 126  * End:
 127  */