1 /* Microsoft Reference Implementation for TPM 2.0
2 *
3 * The copyright in this software is being made available under the BSD License,
4 * included below. This software may be subject to other third party and
5 * contributor rights, including patent rights, and no such rights are granted
6 * under this license.
7 *
8 * Copyright (c) Microsoft Corporation
9 *
10 * All rights reserved.
11 *
12 * BSD License
13 *
14 * Redistribution and use in source and binary forms, with or without modification,
15 * are permitted provided that the following conditions are met:
16 *
17 * Redistributions of source code must retain the above copyright notice, this list
18 * of conditions and the following disclaimer.
19 *
20 * Redistributions in binary form must reproduce the above copyright notice, this
21 * list of conditions and the following disclaimer in the documentation and/or
22 * other materials provided with the distribution.
23 *
24 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS ""AS IS""
25 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
26 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
27 * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR
28 * ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
29 * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
30 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
31 * ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
32 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
33 * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
34 */
35 #include "Tpm.h"
36 #include "Attest_spt_fp.h"
37 #include "Quote_fp.h"
38
39 #if CC_Quote // Conditional expansion of this file
40
41 /*(See part 3 specification)
42 // quote PCR values
43 */
44 // Return Type: TPM_RC
45 // TPM_RC_KEY 'signHandle' does not reference a signing key;
46 // TPM_RC_SCHEME the scheme is not compatible with sign key type,
47 // or input scheme is not compatible with default
48 // scheme, or the chosen scheme is not a valid
49 // sign scheme
50 TPM_RC
TPM2_Quote(Quote_In * in,Quote_Out * out)51 TPM2_Quote(
52 Quote_In *in, // IN: input parameter list
53 Quote_Out *out // OUT: output parameter list
54 )
55 {
56 TPMI_ALG_HASH hashAlg;
57 TPMS_ATTEST quoted;
58 OBJECT *signObject = HandleToObject(in->signHandle);
59 // Input Validation
60 if(!IsSigningObject(signObject))
61 return TPM_RCS_KEY + RC_Quote_signHandle;
62 if(!CryptSelectSignScheme(signObject, &in->inScheme))
63 return TPM_RCS_SCHEME + RC_Quote_inScheme;
64
65 // Command Output
66
67 // Filling in attest information
68 // Common fields
69 // FillInAttestInfo may return TPM_RC_SCHEME or TPM_RC_KEY
70 FillInAttestInfo(in->signHandle, &in->inScheme, &in->qualifyingData, "ed);
71
72 // Quote specific fields
73 // Attestation type
74 quoted.type = TPM_ST_ATTEST_QUOTE;
75
76 // Get hash algorithm in sign scheme. This hash algorithm is used to
77 // compute PCR digest. If there is no algorithm, then the PCR cannot
78 // be digested and this command returns TPM_RC_SCHEME
79 hashAlg = in->inScheme.details.any.hashAlg;
80
81 if(hashAlg == TPM_ALG_NULL)
82 return TPM_RCS_SCHEME + RC_Quote_inScheme;
83
84 // Compute PCR digest
85 PCRComputeCurrentDigest(hashAlg, &in->PCRselect,
86 "ed.attested.quote.pcrDigest);
87
88 // Copy PCR select. "PCRselect" is modified in PCRComputeCurrentDigest
89 // function
90 quoted.attested.quote.pcrSelect = in->PCRselect;
91
92 // Sign attestation structure. A NULL signature will be returned if
93 // signObject is NULL.
94 return SignAttestInfo(signObject, &in->inScheme, "ed, &in->qualifyingData,
95 &out->quoted, &out->signature);
96 }
97
98 #endif // CC_Quote