/* $OpenBSD: ssl_tlsext.c,v 1.6 2017/08/11 20:14:13 doug Exp $ */ /* * Copyright (c) 2016, 2017 Joel Sing * Copyright (c) 2017 Doug Hogan * * Permission to use, copy, modify, and distribute this software for any * purpose with or without fee is hereby granted, provided that the above * copyright notice and this permission notice appear in all copies. * * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF * OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. */ #include "ssl_locl.h" #include "bytestring.h" #include "ssl_tlsext.h" /* * Supported Elliptic Curves - RFC 4492 section 5.1.1 */ int tlsext_ec_clienthello_needs(SSL *s) { return ssl_has_ecc_ciphers(s); } int tlsext_ec_clienthello_build(SSL *s, CBB *cbb) { CBB curvelist; size_t curves_len; int i; const uint16_t *curves; tls1_get_curvelist(s, 0, &curves, &curves_len); if (curves_len == 0) { SSLerror(s, ERR_R_INTERNAL_ERROR); return 0; } if (!CBB_add_u16_length_prefixed(cbb, &curvelist)) return 0; for (i = 0; i < curves_len; i++) { if (!CBB_add_u16(&curvelist, curves[i])) return 0; } if (!CBB_flush(cbb)) return 0; return 1; } int tlsext_ec_clienthello_parse(SSL *s, CBS *cbs, int *alert) { CBS curvelist; size_t curves_len; if (!CBS_get_u16_length_prefixed(cbs, &curvelist)) goto err; if (CBS_len(cbs) != 0) goto err; curves_len = CBS_len(&curvelist); if (curves_len == 0 || curves_len % 2 != 0) goto err; curves_len /= 2; if (!s->internal->hit) { int i; uint16_t *curves; if (SSI(s)->tlsext_supportedgroups != NULL) goto err; if ((curves = reallocarray(NULL, curves_len, sizeof(uint16_t))) == NULL) { *alert = TLS1_AD_INTERNAL_ERROR; return 0; } for (i = 0; i < curves_len; i++) { if (!CBS_get_u16(&curvelist, &curves[i])) { free(curves); goto err; } } if (CBS_len(&curvelist) != 0) { free(curves); goto err; } SSI(s)->tlsext_supportedgroups = curves; SSI(s)->tlsext_supportedgroups_length = curves_len; } return 1; err: *alert = TLS1_AD_DECODE_ERROR; return 0; } /* This extension is never used by the server. */ int tlsext_ec_serverhello_needs(SSL *s) { return 0; } int tlsext_ec_serverhello_build(SSL *s, CBB *cbb) { return 0; } int tlsext_ec_serverhello_parse(SSL *s, CBS *cbs, int *alert) { return 0; } /* * Supported Point Formats Extension - RFC 4492 section 5.1.2 */ static int tlsext_ecpf_build(SSL *s, CBB *cbb) { CBB ecpf; size_t formats_len; const uint8_t *formats; tls1_get_formatlist(s, 0, &formats, &formats_len); if (formats_len == 0) { SSLerror(s, ERR_R_INTERNAL_ERROR); return 0; } if (!CBB_add_u8_length_prefixed(cbb, &ecpf)) return 0; if (!CBB_add_bytes(&ecpf, formats, formats_len)) return 0; if (!CBB_flush(cbb)) return 0; return 1; } static int tlsext_ecpf_parse(SSL *s, CBS *cbs, int *alert) { CBS ecpf; if (!CBS_get_u8_length_prefixed(cbs, &ecpf)) goto err; if (CBS_len(&ecpf) == 0) goto err; if (CBS_len(cbs) != 0) goto err; /* Must contain uncompressed (0) */ if (!CBS_contains_zero_byte(&ecpf)) { SSLerror(s, SSL_R_TLS_INVALID_ECPOINTFORMAT_LIST); goto err; } if (!s->internal->hit) { if (!CBS_stow(&ecpf, &(SSI(s)->tlsext_ecpointformatlist), &(SSI(s)->tlsext_ecpointformatlist_length))) goto err; } return 1; err: *alert = TLS1_AD_INTERNAL_ERROR; return 0; } int tlsext_ecpf_clienthello_needs(SSL *s) { return ssl_has_ecc_ciphers(s); } int tlsext_ecpf_clienthello_build(SSL *s, CBB *cbb) { return tlsext_ecpf_build(s, cbb); } int tlsext_ecpf_clienthello_parse(SSL *s, CBS *cbs, int *alert) { return tlsext_ecpf_parse(s, cbs, alert); } int tlsext_ecpf_serverhello_needs(SSL *s) { if (s->version == DTLS1_VERSION) return 0; return ssl_using_ecc_cipher(s); } int tlsext_ecpf_serverhello_build(SSL *s, CBB *cbb) { return tlsext_ecpf_build(s, cbb); } int tlsext_ecpf_serverhello_parse(SSL *s, CBS *cbs, int *alert) { return tlsext_ecpf_parse(s, cbs, alert); } /* * Renegotiation Indication - RFC 5746. */ int tlsext_ri_clienthello_needs(SSL *s) { return (s->internal->renegotiate); } int tlsext_ri_clienthello_build(SSL *s, CBB *cbb) { CBB reneg; if (!CBB_add_u8_length_prefixed(cbb, &reneg)) return 0; if (!CBB_add_bytes(&reneg, S3I(s)->previous_client_finished, S3I(s)->previous_client_finished_len)) return 0; if (!CBB_flush(cbb)) return 0; return 1; } int tlsext_ri_clienthello_parse(SSL *s, CBS *cbs, int *alert) { CBS reneg; if (!CBS_get_u8_length_prefixed(cbs, &reneg)) goto err; if (CBS_len(cbs) != 0) goto err; if (!CBS_mem_equal(&reneg, S3I(s)->previous_client_finished, S3I(s)->previous_client_finished_len)) { SSLerror(s, SSL_R_RENEGOTIATION_MISMATCH); *alert = SSL_AD_HANDSHAKE_FAILURE; return 0; } S3I(s)->renegotiate_seen = 1; S3I(s)->send_connection_binding = 1; return 1; err: SSLerror(s, SSL_R_RENEGOTIATION_ENCODING_ERR); *alert = SSL_AD_DECODE_ERROR; return 0; } int tlsext_ri_serverhello_needs(SSL *s) { return (S3I(s)->send_connection_binding); } int tlsext_ri_serverhello_build(SSL *s, CBB *cbb) { CBB reneg; if (!CBB_add_u8_length_prefixed(cbb, &reneg)) return 0; if (!CBB_add_bytes(&reneg, S3I(s)->previous_client_finished, S3I(s)->previous_client_finished_len)) return 0; if (!CBB_add_bytes(&reneg, S3I(s)->previous_server_finished, S3I(s)->previous_server_finished_len)) return 0; if (!CBB_flush(cbb)) return 0; return 1; } int tlsext_ri_serverhello_parse(SSL *s, CBS *cbs, int *alert) { CBS reneg, prev_client, prev_server; /* * Ensure that the previous client and server values are both not * present, or that they are both present. */ if ((S3I(s)->previous_client_finished_len == 0 && S3I(s)->previous_server_finished_len != 0) || (S3I(s)->previous_client_finished_len != 0 && S3I(s)->previous_server_finished_len == 0)) { *alert = TLS1_AD_INTERNAL_ERROR; return 0; } if (!CBS_get_u8_length_prefixed(cbs, &reneg)) goto err; if (!CBS_get_bytes(&reneg, &prev_client, S3I(s)->previous_client_finished_len)) goto err; if (!CBS_get_bytes(&reneg, &prev_server, S3I(s)->previous_server_finished_len)) goto err; if (CBS_len(&reneg) != 0) goto err; if (CBS_len(cbs) != 0) goto err; if (!CBS_mem_equal(&prev_client, S3I(s)->previous_client_finished, S3I(s)->previous_client_finished_len)) { SSLerror(s, SSL_R_RENEGOTIATION_MISMATCH); *alert = SSL_AD_HANDSHAKE_FAILURE; return 0; } if (!CBS_mem_equal(&prev_server, S3I(s)->previous_server_finished, S3I(s)->previous_server_finished_len)) { SSLerror(s, SSL_R_RENEGOTIATION_MISMATCH); *alert = SSL_AD_HANDSHAKE_FAILURE; return 0; } S3I(s)->renegotiate_seen = 1; S3I(s)->send_connection_binding = 1; return 1; err: SSLerror(s, SSL_R_RENEGOTIATION_ENCODING_ERR); *alert = SSL_AD_DECODE_ERROR; return 0; } /* * Server Name Indication - RFC 6066, section 3. */ int tlsext_sni_clienthello_needs(SSL *s) { return (s->tlsext_hostname != NULL); } int tlsext_sni_clienthello_build(SSL *s, CBB *cbb) { CBB server_name_list, host_name; if (!CBB_add_u16_length_prefixed(cbb, &server_name_list)) return 0; if (!CBB_add_u8(&server_name_list, TLSEXT_NAMETYPE_host_name)) return 0; if (!CBB_add_u16_length_prefixed(&server_name_list, &host_name)) return 0; if (!CBB_add_bytes(&host_name, (const uint8_t *)s->tlsext_hostname, strlen(s->tlsext_hostname))) return 0; if (!CBB_flush(cbb)) return 0; return 1; } int tlsext_sni_clienthello_parse(SSL *s, CBS *cbs, int *alert) { CBS server_name_list, host_name; uint8_t name_type; if (!CBS_get_u16_length_prefixed(cbs, &server_name_list)) goto err; /* * RFC 6066 section 3 forbids multiple host names with the same type. * Additionally, only one type (host_name) is specified. */ if (!CBS_get_u8(&server_name_list, &name_type)) goto err; if (name_type != TLSEXT_NAMETYPE_host_name) goto err; if (!CBS_get_u16_length_prefixed(&server_name_list, &host_name)) goto err; if (CBS_len(&host_name) == 0 || CBS_len(&host_name) > TLSEXT_MAXLEN_host_name || CBS_contains_zero_byte(&host_name)) { *alert = TLS1_AD_UNRECOGNIZED_NAME; return 0; } if (s->internal->hit) { if (s->session->tlsext_hostname == NULL) { *alert = TLS1_AD_UNRECOGNIZED_NAME; return 0; } if (!CBS_mem_equal(&host_name, s->session->tlsext_hostname, strlen(s->session->tlsext_hostname))) { *alert = TLS1_AD_UNRECOGNIZED_NAME; return 0; } } else { if (s->session->tlsext_hostname != NULL) goto err; if (!CBS_strdup(&host_name, &s->session->tlsext_hostname)) { *alert = TLS1_AD_INTERNAL_ERROR; return 0; } } if (CBS_len(&server_name_list) != 0) goto err; if (CBS_len(cbs) != 0) goto err; return 1; err: *alert = SSL_AD_DECODE_ERROR; return 0; } int tlsext_sni_serverhello_needs(SSL *s) { return (s->session->tlsext_hostname != NULL); } int tlsext_sni_serverhello_build(SSL *s, CBB *cbb) { return 1; } int tlsext_sni_serverhello_parse(SSL *s, CBS *cbs, int *alert) { if (s->tlsext_hostname == NULL || CBS_len(cbs) != 0) { *alert = TLS1_AD_UNRECOGNIZED_NAME; return 0; } if (s->internal->hit) { if (s->session->tlsext_hostname == NULL) { *alert = TLS1_AD_UNRECOGNIZED_NAME; return 0; } if (strcmp(s->tlsext_hostname, s->session->tlsext_hostname) != 0) { *alert = TLS1_AD_UNRECOGNIZED_NAME; return 0; } } else { if (s->session->tlsext_hostname != NULL) { *alert = SSL_AD_DECODE_ERROR; return 0; } if ((s->session->tlsext_hostname = strdup(s->tlsext_hostname)) == NULL) { *alert = TLS1_AD_INTERNAL_ERROR; return 0; } } return 1; } struct tls_extension { uint16_t type; int (*clienthello_needs)(SSL *s); int (*clienthello_build)(SSL *s, CBB *cbb); int (*clienthello_parse)(SSL *s, CBS *cbs, int *alert); int (*serverhello_needs)(SSL *s); int (*serverhello_build)(SSL *s, CBB *cbb); int (*serverhello_parse)(SSL *s, CBS *cbs, int *alert); }; static struct tls_extension tls_extensions[] = { { .type = TLSEXT_TYPE_server_name, .clienthello_needs = tlsext_sni_clienthello_needs, .clienthello_build = tlsext_sni_clienthello_build, .clienthello_parse = tlsext_sni_clienthello_parse, .serverhello_needs = tlsext_sni_serverhello_needs, .serverhello_build = tlsext_sni_serverhello_build, .serverhello_parse = tlsext_sni_serverhello_parse, }, { .type = TLSEXT_TYPE_renegotiate, .clienthello_needs = tlsext_ri_clienthello_needs, .clienthello_build = tlsext_ri_clienthello_build, .clienthello_parse = tlsext_ri_clienthello_parse, .serverhello_needs = tlsext_ri_serverhello_needs, .serverhello_build = tlsext_ri_serverhello_build, .serverhello_parse = tlsext_ri_serverhello_parse, }, { .type = TLSEXT_TYPE_ec_point_formats, .clienthello_needs = tlsext_ecpf_clienthello_needs, .clienthello_build = tlsext_ecpf_clienthello_build, .clienthello_parse = tlsext_ecpf_clienthello_parse, .serverhello_needs = tlsext_ecpf_serverhello_needs, .serverhello_build = tlsext_ecpf_serverhello_build, .serverhello_parse = tlsext_ecpf_serverhello_parse, }, { .type = TLSEXT_TYPE_elliptic_curves, .clienthello_needs = tlsext_ec_clienthello_needs, .clienthello_build = tlsext_ec_clienthello_build, .clienthello_parse = tlsext_ec_clienthello_parse, .serverhello_needs = tlsext_ec_serverhello_needs, .serverhello_build = tlsext_ec_serverhello_build, .serverhello_parse = tlsext_ec_serverhello_parse, }, }; #define N_TLS_EXTENSIONS (sizeof(tls_extensions) / sizeof(*tls_extensions)) int tlsext_clienthello_build(SSL *s, CBB *cbb) { struct tls_extension *tlsext; CBB extension_data; size_t i; memset(&extension_data, 0, sizeof(extension_data)); for (i = 0; i < N_TLS_EXTENSIONS; i++) { tlsext = &tls_extensions[i]; if (!tlsext->clienthello_needs(s)) continue; if (!CBB_add_u16(cbb, tlsext->type)) return 0; if (!CBB_add_u16_length_prefixed(cbb, &extension_data)) return 0; if (!tls_extensions[i].clienthello_build(s, &extension_data)) return 0; if (!CBB_flush(cbb)) return 0; } return 1; } int tlsext_clienthello_parse_one(SSL *s, CBS *cbs, uint16_t type, int *alert) { struct tls_extension *tlsext; size_t i; for (i = 0; i < N_TLS_EXTENSIONS; i++) { tlsext = &tls_extensions[i]; if (tlsext->type != type) continue; if (!tlsext->clienthello_parse(s, cbs, alert)) return 0; if (CBS_len(cbs) != 0) { *alert = SSL_AD_DECODE_ERROR; return 0; } return 1; } /* Not found. */ return 2; } int tlsext_serverhello_build(SSL *s, CBB *cbb) { struct tls_extension *tlsext; CBB extension_data; size_t i; memset(&extension_data, 0, sizeof(extension_data)); for (i = 0; i < N_TLS_EXTENSIONS; i++) { tlsext = &tls_extensions[i]; if (!tlsext->serverhello_needs(s)) continue; if (!CBB_add_u16(cbb, tlsext->type)) return 0; if (!CBB_add_u16_length_prefixed(cbb, &extension_data)) return 0; if (!tlsext->serverhello_build(s, &extension_data)) return 0; if (!CBB_flush(cbb)) return 0; } return 1; } int tlsext_serverhello_parse_one(SSL *s, CBS *cbs, uint16_t type, int *alert) { struct tls_extension *tlsext; size_t i; for (i = 0; i < N_TLS_EXTENSIONS; i++) { tlsext = &tls_extensions[i]; if (tlsext->type != type) continue; if (!tlsext->serverhello_parse(s, cbs, alert)) return 0; if (CBS_len(cbs) != 0) { *alert = SSL_AD_DECODE_ERROR; return 0; } return 1; } /* Not found. */ return 2; }