Home | History | Annotate | Download | only in openssh
      1 /* $OpenBSD: mac.c,v 1.32 2015/01/15 18:32:54 naddy Exp $ */
      2 /*
      3  * Copyright (c) 2001 Markus Friedl.  All rights reserved.
      4  *
      5  * Redistribution and use in source and binary forms, with or without
      6  * modification, are permitted provided that the following conditions
      7  * are met:
      8  * 1. Redistributions of source code must retain the above copyright
      9  *    notice, this list of conditions and the following disclaimer.
     10  * 2. Redistributions in binary form must reproduce the above copyright
     11  *    notice, this list of conditions and the following disclaimer in the
     12  *    documentation and/or other materials provided with the distribution.
     13  *
     14  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
     15  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
     16  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
     17  * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
     18  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
     19  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
     20  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
     21  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
     22  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
     23  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
     24  */
     25 
     26 #include "includes.h"
     27 
     28 #include <sys/types.h>
     29 
     30 #include <string.h>
     31 #include <stdio.h>
     32 
     33 #include "digest.h"
     34 #include "hmac.h"
     35 #include "umac.h"
     36 #include "mac.h"
     37 #include "misc.h"
     38 #include "ssherr.h"
     39 #include "sshbuf.h"
     40 
     41 #include "openbsd-compat/openssl-compat.h"
     42 
     43 #define SSH_DIGEST	1	/* SSH_DIGEST_XXX */
     44 #define SSH_UMAC	2	/* UMAC (not integrated with OpenSSL) */
     45 #define SSH_UMAC128	3
     46 
     47 struct macalg {
     48 	char		*name;
     49 	int		type;
     50 	int		alg;
     51 	int		truncatebits;	/* truncate digest if != 0 */
     52 	int		key_len;	/* just for UMAC */
     53 	int		len;		/* just for UMAC */
     54 	int		etm;		/* Encrypt-then-MAC */
     55 };
     56 
     57 static const struct macalg macs[] = {
     58 	/* Encrypt-and-MAC (encrypt-and-authenticate) variants */
     59 	{ "hmac-sha1",				SSH_DIGEST, SSH_DIGEST_SHA1, 0, 0, 0, 0 },
     60 	{ "hmac-sha1-96",			SSH_DIGEST, SSH_DIGEST_SHA1, 96, 0, 0, 0 },
     61 #ifdef HAVE_EVP_SHA256
     62 	{ "hmac-sha2-256",			SSH_DIGEST, SSH_DIGEST_SHA256, 0, 0, 0, 0 },
     63 	{ "hmac-sha2-512",			SSH_DIGEST, SSH_DIGEST_SHA512, 0, 0, 0, 0 },
     64 #endif
     65 	{ "hmac-md5",				SSH_DIGEST, SSH_DIGEST_MD5, 0, 0, 0, 0 },
     66 	{ "hmac-md5-96",			SSH_DIGEST, SSH_DIGEST_MD5, 96, 0, 0, 0 },
     67 #if defined(HAVE_EVP_RIPEMD)
     68 	{ "hmac-ripemd160",			SSH_DIGEST, SSH_DIGEST_RIPEMD160, 0, 0, 0, 0 },
     69 	{ "hmac-ripemd160 (at) openssh.com",		SSH_DIGEST, SSH_DIGEST_RIPEMD160, 0, 0, 0, 0 },
     70 #endif
     71 	{ "umac-64 (at) openssh.com",		SSH_UMAC, 0, 0, 128, 64, 0 },
     72 	{ "umac-128 (at) openssh.com",		SSH_UMAC128, 0, 0, 128, 128, 0 },
     73 
     74 	/* Encrypt-then-MAC variants */
     75 	{ "hmac-sha1-etm (at) openssh.com",		SSH_DIGEST, SSH_DIGEST_SHA1, 0, 0, 0, 1 },
     76 	{ "hmac-sha1-96-etm (at) openssh.com",	SSH_DIGEST, SSH_DIGEST_SHA1, 96, 0, 0, 1 },
     77 #ifdef HAVE_EVP_SHA256
     78 	{ "hmac-sha2-256-etm (at) openssh.com",	SSH_DIGEST, SSH_DIGEST_SHA256, 0, 0, 0, 1 },
     79 	{ "hmac-sha2-512-etm (at) openssh.com",	SSH_DIGEST, SSH_DIGEST_SHA512, 0, 0, 0, 1 },
     80 #endif
     81 	{ "hmac-md5-etm (at) openssh.com",		SSH_DIGEST, SSH_DIGEST_MD5, 0, 0, 0, 1 },
     82 	{ "hmac-md5-96-etm (at) openssh.com",	SSH_DIGEST, SSH_DIGEST_MD5, 96, 0, 0, 1 },
     83 	{ "hmac-ripemd160-etm (at) openssh.com",	SSH_DIGEST, SSH_DIGEST_RIPEMD160, 0, 0, 0, 1 },
     84 	{ "umac-64-etm (at) openssh.com",		SSH_UMAC, 0, 0, 128, 64, 1 },
     85 	{ "umac-128-etm (at) openssh.com",		SSH_UMAC128, 0, 0, 128, 128, 1 },
     86 
     87 	{ NULL,					0, 0, 0, 0, 0, 0 }
     88 };
     89 
     90 /* Returns a list of supported MACs separated by the specified char. */
     91 char *
     92 mac_alg_list(char sep)
     93 {
     94 	char *ret = NULL, *tmp;
     95 	size_t nlen, rlen = 0;
     96 	const struct macalg *m;
     97 
     98 	for (m = macs; m->name != NULL; m++) {
     99 		if (ret != NULL)
    100 			ret[rlen++] = sep;
    101 		nlen = strlen(m->name);
    102 		if ((tmp = realloc(ret, rlen + nlen + 2)) == NULL) {
    103 			free(ret);
    104 			return NULL;
    105 		}
    106 		ret = tmp;
    107 		memcpy(ret + rlen, m->name, nlen + 1);
    108 		rlen += nlen;
    109 	}
    110 	return ret;
    111 }
    112 
    113 static int
    114 mac_setup_by_alg(struct sshmac *mac, const struct macalg *macalg)
    115 {
    116 	mac->type = macalg->type;
    117 	if (mac->type == SSH_DIGEST) {
    118 		if ((mac->hmac_ctx = ssh_hmac_start(macalg->alg)) == NULL)
    119 			return SSH_ERR_ALLOC_FAIL;
    120 		mac->key_len = mac->mac_len = ssh_hmac_bytes(macalg->alg);
    121 	} else {
    122 		mac->mac_len = macalg->len / 8;
    123 		mac->key_len = macalg->key_len / 8;
    124 		mac->umac_ctx = NULL;
    125 	}
    126 	if (macalg->truncatebits != 0)
    127 		mac->mac_len = macalg->truncatebits / 8;
    128 	mac->etm = macalg->etm;
    129 	return 0;
    130 }
    131 
    132 int
    133 mac_setup(struct sshmac *mac, char *name)
    134 {
    135 	const struct macalg *m;
    136 
    137 	for (m = macs; m->name != NULL; m++) {
    138 		if (strcmp(name, m->name) != 0)
    139 			continue;
    140 		if (mac != NULL)
    141 			return mac_setup_by_alg(mac, m);
    142 		return 0;
    143 	}
    144 	return SSH_ERR_INVALID_ARGUMENT;
    145 }
    146 
    147 int
    148 mac_init(struct sshmac *mac)
    149 {
    150 	if (mac->key == NULL)
    151 		return SSH_ERR_INVALID_ARGUMENT;
    152 	switch (mac->type) {
    153 	case SSH_DIGEST:
    154 		if (mac->hmac_ctx == NULL ||
    155 		    ssh_hmac_init(mac->hmac_ctx, mac->key, mac->key_len) < 0)
    156 			return SSH_ERR_INVALID_ARGUMENT;
    157 		return 0;
    158 	case SSH_UMAC:
    159 		if ((mac->umac_ctx = umac_new(mac->key)) == NULL)
    160 			return SSH_ERR_ALLOC_FAIL;
    161 		return 0;
    162 	case SSH_UMAC128:
    163 		if ((mac->umac_ctx = umac128_new(mac->key)) == NULL)
    164 			return SSH_ERR_ALLOC_FAIL;
    165 		return 0;
    166 	default:
    167 		return SSH_ERR_INVALID_ARGUMENT;
    168 	}
    169 }
    170 
    171 int
    172 mac_compute(struct sshmac *mac, u_int32_t seqno, const u_char *data, int datalen,
    173     u_char *digest, size_t dlen)
    174 {
    175 	static union {
    176 		u_char m[SSH_DIGEST_MAX_LENGTH];
    177 		u_int64_t for_align;
    178 	} u;
    179 	u_char b[4];
    180 	u_char nonce[8];
    181 
    182 	if (mac->mac_len > sizeof(u))
    183 		return SSH_ERR_INTERNAL_ERROR;
    184 
    185 	switch (mac->type) {
    186 	case SSH_DIGEST:
    187 		put_u32(b, seqno);
    188 		/* reset HMAC context */
    189 		if (ssh_hmac_init(mac->hmac_ctx, NULL, 0) < 0 ||
    190 		    ssh_hmac_update(mac->hmac_ctx, b, sizeof(b)) < 0 ||
    191 		    ssh_hmac_update(mac->hmac_ctx, data, datalen) < 0 ||
    192 		    ssh_hmac_final(mac->hmac_ctx, u.m, sizeof(u.m)) < 0)
    193 			return SSH_ERR_LIBCRYPTO_ERROR;
    194 		break;
    195 	case SSH_UMAC:
    196 		POKE_U64(nonce, seqno);
    197 		umac_update(mac->umac_ctx, data, datalen);
    198 		umac_final(mac->umac_ctx, u.m, nonce);
    199 		break;
    200 	case SSH_UMAC128:
    201 		put_u64(nonce, seqno);
    202 		umac128_update(mac->umac_ctx, data, datalen);
    203 		umac128_final(mac->umac_ctx, u.m, nonce);
    204 		break;
    205 	default:
    206 		return SSH_ERR_INVALID_ARGUMENT;
    207 	}
    208 	if (digest != NULL) {
    209 		if (dlen > mac->mac_len)
    210 			dlen = mac->mac_len;
    211 		memcpy(digest, u.m, dlen);
    212 	}
    213 	return 0;
    214 }
    215 
    216 void
    217 mac_clear(struct sshmac *mac)
    218 {
    219 	if (mac->type == SSH_UMAC) {
    220 		if (mac->umac_ctx != NULL)
    221 			umac_delete(mac->umac_ctx);
    222 	} else if (mac->type == SSH_UMAC128) {
    223 		if (mac->umac_ctx != NULL)
    224 			umac128_delete(mac->umac_ctx);
    225 	} else if (mac->hmac_ctx != NULL)
    226 		ssh_hmac_free(mac->hmac_ctx);
    227 	mac->hmac_ctx = NULL;
    228 	mac->umac_ctx = NULL;
    229 }
    230 
    231 /* XXX copied from ciphers_valid */
    232 #define	MAC_SEP	","
    233 int
    234 mac_valid(const char *names)
    235 {
    236 	char *maclist, *cp, *p;
    237 
    238 	if (names == NULL || strcmp(names, "") == 0)
    239 		return 0;
    240 	if ((maclist = cp = strdup(names)) == NULL)
    241 		return 0;
    242 	for ((p = strsep(&cp, MAC_SEP)); p && *p != '\0';
    243 	    (p = strsep(&cp, MAC_SEP))) {
    244 		if (mac_setup(NULL, p) < 0) {
    245 			free(maclist);
    246 			return 0;
    247 		}
    248 	}
    249 	free(maclist);
    250 	return 1;
    251 }
    252