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 "Certify_fp.h"
38
39 #if CC_Certify // Conditional expansion of this file
40
41 /*(See part 3 specification)
42 // prove an object with a specific Name is loaded in the TPM
43 */
44 // Return Type: TPM_RC
45 // TPM_RC_KEY key referenced by 'signHandle' is not a signing key
46 // TPM_RC_SCHEME 'inScheme' is not compatible with 'signHandle'
47 // TPM_RC_VALUE digest generated for 'inScheme' is greater or has larger
48 // size than the modulus of 'signHandle', or the buffer for
49 // the result in 'signature' is too small (for an RSA key);
50 // invalid commit status (for an ECC key with a split scheme)
51 TPM_RC
TPM2_Certify(Certify_In * in,Certify_Out * out)52 TPM2_Certify(
53 Certify_In *in, // IN: input parameter list
54 Certify_Out *out // OUT: output parameter list
55 )
56 {
57 TPMS_ATTEST certifyInfo;
58 OBJECT *signObject = HandleToObject(in->signHandle);
59 OBJECT *certifiedObject = HandleToObject(in->objectHandle);
60 // Input validation
61 if(!IsSigningObject(signObject))
62 return TPM_RCS_KEY + RC_Certify_signHandle;
63 if(!CryptSelectSignScheme(signObject, &in->inScheme))
64 return TPM_RCS_SCHEME + RC_Certify_inScheme;
65
66 // Command Output
67 // Filling in attest information
68 // Common fields
69 FillInAttestInfo(in->signHandle, &in->inScheme, &in->qualifyingData,
70 &certifyInfo);
71
72 // Certify specific fields
73 certifyInfo.type = TPM_ST_ATTEST_CERTIFY;
74 // NOTE: the certified object is not allowed to be TPM_ALG_NULL so
75 // 'certifiedObject' will never be NULL
76 certifyInfo.attested.certify.name = certifiedObject->name;
77
78 // When using an anonymous signing scheme, need to set the qualified Name to the
79 // empty buffer to avoid correlation between keys
80 if(CryptIsSchemeAnonymous(in->inScheme.scheme))
81 certifyInfo.attested.certify.qualifiedName.t.size = 0;
82 else
83 certifyInfo.attested.certify.qualifiedName = certifiedObject->qualifiedName;
84
85
86 // Sign attestation structure. A NULL signature will be returned if
87 // signHandle is TPM_RH_NULL. A TPM_RC_NV_UNAVAILABLE, TPM_RC_NV_RATE,
88 // TPM_RC_VALUE, TPM_RC_SCHEME or TPM_RC_ATTRIBUTES error may be returned
89 // by SignAttestInfo()
90 return SignAttestInfo(signObject, &in->inScheme, &certifyInfo,
91 &in->qualifyingData, &out->certifyInfo, &out->signature);
92 }
93
94 #endif // CC_Certify