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