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

NAME

8       Tspi_DAA_IssueInit - initialize the Issuer for a join operation
9

SYNOPSIS

11       #include <tss/tss_typedef.h>
12       #include <tss/tss_structs.h>
13       #include <tss/tspi.h>
14
15       TSPICALL Tspi_DAA_IssueInit(
16           TSS_HDAA                      hDAA,
17           TSS_HKEY                      issuerAuthPK,
18           TSS_HKEY                      issuerKeyPair,
19           TSS_DAA_IDENTITY_PROOF        identityProof,
20           UINT32                        capitalUprimeLength,
21           BYTE*                         capitalUprime,
22           UINT32                        daaCounter,
23           UINT32*                       nonceIssuerLength,
24           BYTE**                        nonceIssuer,
25           UINT32*                       authenticationChallengeLength,
26           BYTE**                        authenticationChallenge,
27           TSS_DAA_JOIN_ISSUER_SESSION*  joinSession
28       );
29
30
31

DESCRIPTION

33       Tspi_DAA_IssueInit  is a function that is part of the DAA Issuer compo‐
34       nent. It's the first function out of 2 in order to issue a DAA  Creden‐
35       tial  for  a  TCG Platform. It assumes that the endorsement key and its
36       associated credentials are from a genuine and valid TPM.  (Verification
37       of the credentials is a process defined by the TCG Infrastructure WG.)
38
39

PARAMETERS

41   hDAA
42       The hDAA parameter is used to specify the handle of the DAA object.
43
44   issuerAuthPK
45       The  issuerAuthPKh parameter is the root authentication (public) key of
46       DAA Issuer.
47
48   issuerKeyPair
49       The issuerKeyPair parameter is the handle of the main  DAA  Issuer  key
50       pair (private and public portion).
51
52   identityProof
53       The  identityProof  parameter  is the structure containing endorsement,
54       platform and conformance credential of the TPM requesting the DAA  Cre‐
55       dential.
56
57   capitalUprimeLength
58       The  capitalUprimeLength parameter is the length of capitalUprime which
59       is .
60
61   capitalUprime
62       The capitalUprime parameter is U'.
63
64   daaCounter
65       The daaCounter parameter is the DAA counter.
66
67   nonceIssuerLength
68       The nonceIssuerLength  parameter  is  the  length  of  nonceIssuer  (20
69       bytes).
70
71   nonceIssuer
72       The nonceIssuer parameter is the nonce of the DAA Issuer.
73
74   authenticationChallengeLength
75       The  authenticationChallengeLength parameter is the length of authenti‐
76       cationChallenge (256 bytes - DAA_SIZE_NE1).
77
78   authenticationChallenge
79       The authenticationChallenge parameter is the second nonce  of  the  DAA
80       Issuer that is encrypted by the endorsement public key. It is used as a
81       challenge to authenticate the TPM.
82
83   joinSession
84       The joinSession parameter is the structure containing the DAA Join ses‐
85       sion information.
86

RETURN CODES

88       Tspi_DAA_IssueInit returns TSS_SUCCESS on success, otherwise one of the
89       following values is returned:
90
91       TSS_E_INVALID_HANDLE
92              Either the DAA is not valid.
93
94       TSS_E_BAD_PARAMETER
95
96       TSS_E_INTERNAL_ERROR
97              An internal SW error has been detected.
98
99

CONFORMING TO

101       Tspi_DAA_IssueInit conforms to the  Trusted  Computing  Group  Software
102       Specification version 1.2
103
104

SEE ALSO

106       Tspi_DAA_IssuerKeyVerification(3)
107
108
109
110
111TSS 1.2                           2006-09-04             Tspi_DAA_IssueInit(3)
Impressum