1Tspi_DAA_VerifySignature(3)Library Functions ManualTspi_DAA_VerifySignature(3)
2
3
4
5                   TCG Software Stack Developer's Reference
6

NAME

8       Tspi_DAA_VerifySignature - creates a challenge for the TCG platform
9

SYNOPSIS

11       #include <tss/tss_typedef.h>
12       #include <tss/tss_structs.h>
13       #include <tss/tspi.h>
14
15       TSPICALL Tspi_DAA_VerifySignature(
16           TSS_HDAA                    hDAA,
17           TSS_DAA_SIGNATURE           daaSignature,
18           TSS_HKEY                    hPubKeyIssuer,
19           TSS_DAA_SIGN_DATA           signData,
20           UINT32                      attributesLength,
21           BYTE**                      attributes,
22           UINT32                      nonceVerifierLength,
23           BYTE*                       nonceVerifier,
24           UINT32                      baseNameLength,
25           BYTE*                       baseName,
26           TSS_BOOL*                   isCorrect
27       );
28
29
30

DESCRIPTION

32       Tspi_DAA_VerifySignature  is  part  of the DAA Verifier component. It's
33       the last function out of 2 in order to verify a DAA Credential of a TCG
34       platform. It verifies the DAA Credential and detects public rogue TPMs.
35       This is an optional function and does not require a TPM or a TCS.
36
37

PARAMETERS

39   hDAA
40       The hDAA parameter is used to specify the handle of the DAA object.
41
42   daaSignature
43       The daaSignature parameter is the DAA signature contains proof of  own‐
44       ership  of  the DAA Credential, as well as a signature on either an AIK
45       or a message.
46
47   hPubKeyIssuer
48       The hPubKeyIssuer parameter is the handle of the DAA public key of  the
49       DAA Issuer of the credential.
50
51   signData
52       The signData parameter defines what data is signed (AIK or message).
53
54   attributesLength
55       The  attributesLength  parameter is the Length of attributes array that
56       is determined by the DAA Issuer public key (lh+li).  The  length  of  a
57       single attribute is lf/8.
58
59   attributes
60       The  attributes parameter is the array of attributes which the DAA Cre‐
61       dential owner reveals.
62
63   nonceVerifierLength
64       The nonceVerifierLength parameter is the length  of  nonceVerifier  (20
65       bytes).
66
67   nonceVerifier
68       The  nonceVerifier parameter is the nonce that was computed in the pre‐
69       vious function (Tspi_VerifyInit).
70
71   baseNameLength
72       The baseNameLength parameter the length of the baseName.
73
74   baseName
75       The baseName parameter is the base name that was  chosen  for  the  DAA
76       Signature.
77
78   isCorrect
79       The  isCorrect  parameter denotes if the verification of the DAA Signa‐
80       ture was successful.
81
82

RETURN CODES

84       Tspi_DAA_VerifySignature returns TSS_SUCCESS on success, otherwise  one
85       of the following values is returned:
86
87       TSS_E_BAD_PARAMETER
88
89       TSS_E_INTERNAL_ERROR
90              An internal SW error has been detected.
91
92
93       CONFORMING TO
94
95       Tspi_DAA_VerifySignature  conforms to the Trusted Computing Group Soft‐
96       ware Specification version 1.2
97
98

SEE ALSO

100       Tspi_DAA_IssuerKeyVerification(3)
101
102
103
104
105TSS 1.2                           2006-09-04       Tspi_DAA_VerifySignature(3)
Impressum