lws-gendtls.h

Go to the documentation of this file.

/*
 * libwebsockets - small server side websockets and web server implementation
 *
 * Copyright (C) 2010 - 2020 Andy Green <andy@warmcat.com>
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to
 * deal in the Software without restriction, including without limitation the
 * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
 * sell copies of the Software, and to permit persons to whom the Software is
 * furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be included in
 * all copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
 * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
 * IN THE SOFTWARE.
 */

 
#if defined(LWS_WITH_DTLS)
 
#if defined(LWS_WITH_MBEDTLS)
#include <mbedtls/ssl.h>
#include <mbedtls/entropy.h>
#include <mbedtls/ctr_drbg.h>
#include <mbedtls/ssl_cookie.h>
#elif defined(LWS_WITH_GNUTLS)
#include <gnutls/gnutls.h>
#elif defined(LWS_WITH_SCHANNEL)
#define SECURITY_WIN32
#include <security.h>
#include <schannel.h>
#else /* OpenSSL */
#include <openssl/ssl.h>
#endif
 
struct lws_gendtls_ctx {
#if defined(LWS_WITH_MBEDTLS)
        mbedtls_ssl_context                     ssl;
        mbedtls_ssl_config                      conf;
        mbedtls_ctr_drbg_context                ctr_drbg;
        mbedtls_entropy_context                 entropy;
        mbedtls_x509_crt                        cacert;
        mbedtls_pk_context                      pkey;
        mbedtls_ssl_cookie_ctx                  cookie_ctx;
        struct lws_buflist                      *rx_head;
        struct lws_buflist                      *tx_head;
        lws_usec_t                              timer_set_us;
        uint32_t                                timer_int_ms;
        uint32_t                                timer_fin_ms;
#if defined(MBEDTLS_SSL_DTLS_SRTP)
        mbedtls_ssl_srtp_profile                srtp_profiles[4];
#endif
#elif defined(LWS_WITH_GNUTLS)
        gnutls_session_t                        session;
        gnutls_certificate_credentials_t        cred;
        gnutls_datum_t                          cookie_key;
        struct lws_buflist                      *rx_head;
        struct lws_buflist                      *tx_head;
        int                                     handshake_done;
        int                                     cookie_read;
        /* Temporary storage for certificates/keys until both are present */
        uint8_t                                 *cert_mem;
        size_t                                  cert_len;
        uint8_t                                 *key_mem;
        size_t                                  key_len;
        struct lws_context                      *context;
#elif defined(LWS_WITH_SCHANNEL)
        CredHandle                              cred;
        CtxtHandle                              ctxt;
        struct lws_buflist                      *rx_head;
        struct lws_buflist                      *tx_head;
        struct lws_context                      *context;
        int                                     mode;
        int                                     handshake_done;
        /* Windows handles */
        HCERTSTORE                              store;
        PCCERT_CONTEXT                          cert_ctxt;
        SCHANNEL_CRED                           schannel_cred;
        int                                     cred_init;
        /* Temporary storage for certificates/keys until both are present */
        uint8_t                                 *cert_mem;
        size_t                                  cert_len;
        uint8_t                                 *key_mem;
        size_t                                  key_len;
        char                                    key_container_name[64];
        NCRYPT_KEY_HANDLE                       key_cng;
        /* Store the client address for SChannel DTLS ACCEPT */
        struct sockaddr_storage                 client_addr;
        size_t                                  client_addr_len;
#else /* OpenSSL */
        void                                    *ssl; /* SSL * */
        /* OpenSSL Bio mems are handled internally via SSL_set_bio */
#endif
};
 
enum lws_gendtls_conn_mode {
        LWS_GENDTLS_MODE_CLIENT,
        LWS_GENDTLS_MODE_SERVER
};
 
struct lws_gendtls_creation_info {
        struct lws_context                      *context;
        enum lws_gendtls_conn_mode              mode;
        unsigned int                            mtu;
        unsigned int                            timeout_ms;
        const char                              *use_srtp;
};

LWS_VISIBLE LWS_EXTERN int
lws_gendtls_create(struct lws_gendtls_ctx *ctx,
                   const struct lws_gendtls_creation_info *info);

LWS_VISIBLE LWS_EXTERN void
lws_gendtls_destroy(struct lws_gendtls_ctx *ctx);

LWS_VISIBLE LWS_EXTERN int
lws_gendtls_set_cert_mem(struct lws_gendtls_ctx *ctx, const uint8_t *cert, size_t len);

LWS_VISIBLE LWS_EXTERN int
lws_gendtls_set_key_mem(struct lws_gendtls_ctx *ctx, const uint8_t *key, size_t len);

LWS_VISIBLE LWS_EXTERN int
lws_gendtls_put_rx(struct lws_gendtls_ctx *ctx, const uint8_t *in, size_t len);

LWS_VISIBLE LWS_EXTERN int
lws_gendtls_get_rx(struct lws_gendtls_ctx *ctx, uint8_t *out, size_t max_len);

LWS_VISIBLE LWS_EXTERN int
lws_gendtls_put_tx(struct lws_gendtls_ctx *ctx, const uint8_t *in, size_t len);

LWS_VISIBLE LWS_EXTERN int
lws_gendtls_get_tx(struct lws_gendtls_ctx *ctx, uint8_t *out, size_t max_len);

LWS_VISIBLE LWS_EXTERN int
lws_gendtls_export_keying_material(struct lws_gendtls_ctx *ctx, const char *label,
                                   size_t label_len, const uint8_t *context,
                                   size_t context_len, uint8_t *out, size_t out_len);

LWS_VISIBLE LWS_EXTERN int
lws_gendtls_handshake_done(struct lws_gendtls_ctx *ctx);

LWS_VISIBLE LWS_EXTERN int
lws_gendtls_is_clean(struct lws_gendtls_ctx *ctx);

LWS_VISIBLE LWS_EXTERN const char *
lws_gendtls_get_srtp_profile(struct lws_gendtls_ctx *ctx);
 
#if defined(LWS_WITH_SCHANNEL)
LWS_VISIBLE LWS_EXTERN void
lws_gendtls_schannel_set_client_addr(struct lws_gendtls_ctx *ctx,
                                     const struct sockaddr *sa, size_t sa_len);
#endif
 
#endif /* LWS_WITH_DTLS */