xref: /xnu-11215.1.10/osfmk/corecrypto/cchmac_final.c (revision 8d741a5de7ff4191bf97d57b9f54c2f6d4a15585)
1*8d741a5dSApple OSS Distributions /* Copyright (c) (2010,2011,2015,2017-2019,2021) Apple Inc. All rights reserved.
2*8d741a5dSApple OSS Distributions  *
3*8d741a5dSApple OSS Distributions  * corecrypto is licensed under Apple Inc.’s Internal Use License Agreement (which
4*8d741a5dSApple OSS Distributions  * is contained in the License.txt file distributed with corecrypto) and only to
5*8d741a5dSApple OSS Distributions  * people who accept that license. IMPORTANT:  Any license rights granted to you by
6*8d741a5dSApple OSS Distributions  * Apple Inc. (if any) are limited to internal use within your organization only on
7*8d741a5dSApple OSS Distributions  * devices and computers you own or control, for the sole purpose of verifying the
8*8d741a5dSApple OSS Distributions  * security characteristics and correct functioning of the Apple Software.  You may
9*8d741a5dSApple OSS Distributions  * not, directly or indirectly, redistribute the Apple Software or any portions thereof.
10*8d741a5dSApple OSS Distributions  *
11*8d741a5dSApple OSS Distributions  * @APPLE_OSREFERENCE_LICENSE_HEADER_START@
12*8d741a5dSApple OSS Distributions  *
13*8d741a5dSApple OSS Distributions  * This file contains Original Code and/or Modifications of Original Code
14*8d741a5dSApple OSS Distributions  * as defined in and that are subject to the Apple Public Source License
15*8d741a5dSApple OSS Distributions  * Version 2.0 (the 'License'). You may not use this file except in
16*8d741a5dSApple OSS Distributions  * compliance with the License. The rights granted to you under the License
17*8d741a5dSApple OSS Distributions  * may not be used to create, or enable the creation or redistribution of,
18*8d741a5dSApple OSS Distributions  * unlawful or unlicensed copies of an Apple operating system, or to
19*8d741a5dSApple OSS Distributions  * circumvent, violate, or enable the circumvention or violation of, any
20*8d741a5dSApple OSS Distributions  * terms of an Apple operating system software license agreement.
21*8d741a5dSApple OSS Distributions  *
22*8d741a5dSApple OSS Distributions  * Please obtain a copy of the License at
23*8d741a5dSApple OSS Distributions  * http://www.opensource.apple.com/apsl/ and read it before using this file.
24*8d741a5dSApple OSS Distributions  *
25*8d741a5dSApple OSS Distributions  * The Original Code and all software distributed under the License are
26*8d741a5dSApple OSS Distributions  * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
27*8d741a5dSApple OSS Distributions  * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
28*8d741a5dSApple OSS Distributions  * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
29*8d741a5dSApple OSS Distributions  * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
30*8d741a5dSApple OSS Distributions  * Please see the License for the specific language governing rights and
31*8d741a5dSApple OSS Distributions  * limitations under the License.
32*8d741a5dSApple OSS Distributions  *
33*8d741a5dSApple OSS Distributions  * @APPLE_OSREFERENCE_LICENSE_HEADER_END@
34*8d741a5dSApple OSS Distributions  */
35*8d741a5dSApple OSS Distributions 
36*8d741a5dSApple OSS Distributions #include "cc_internal.h"
37*8d741a5dSApple OSS Distributions #include <corecrypto/ccdigest_priv.h>
38*8d741a5dSApple OSS Distributions #include <corecrypto/cchmac.h>
39*8d741a5dSApple OSS Distributions #include <corecrypto/ccn.h>
40*8d741a5dSApple OSS Distributions #include <corecrypto/cc_priv.h>
41*8d741a5dSApple OSS Distributions 
42*8d741a5dSApple OSS Distributions void
cchmac_final(const struct ccdigest_info * di,cchmac_ctx_t hc,unsigned char * mac)43*8d741a5dSApple OSS Distributions cchmac_final(const struct ccdigest_info *di, cchmac_ctx_t hc,
44*8d741a5dSApple OSS Distributions     unsigned char *mac)
45*8d741a5dSApple OSS Distributions {
46*8d741a5dSApple OSS Distributions 	CC_ENSURE_DIT_ENABLED
47*8d741a5dSApple OSS Distributions 
48*8d741a5dSApple OSS Distributions 
49*8d741a5dSApple OSS Distributions 	// Finalize the inner state of the data being HMAC'd, i.e., H((key \oplus ipad) || m)
50*8d741a5dSApple OSS Distributions 	ccdigest_final(di, cchmac_digest_ctx(di, hc), cchmac_data(di, hc));
51*8d741a5dSApple OSS Distributions 
52*8d741a5dSApple OSS Distributions 	// Set the HMAC output size based on the digest algorithm
53*8d741a5dSApple OSS Distributions 	cchmac_num(di, hc) = (unsigned int)di->output_size; /* typecast: output size will always fit in an unsigned int */
54*8d741a5dSApple OSS Distributions 	cchmac_nbits(di, hc) = di->block_size * 8;
55*8d741a5dSApple OSS Distributions 
56*8d741a5dSApple OSS Distributions 	// Copy the pre-computed compress(key \oplus opad) back to digest state,
57*8d741a5dSApple OSS Distributions 	// and then run through the digest once more to finish the HMAC
58*8d741a5dSApple OSS Distributions 	ccdigest_copy_state(di, cchmac_istate32(di, hc), cchmac_ostate32(di, hc));
59*8d741a5dSApple OSS Distributions 	ccdigest_final(di, cchmac_digest_ctx(di, hc), mac);
60*8d741a5dSApple OSS Distributions }
61