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