1Tspi_DAA_IssueSetup(3) Library Functions Manual Tspi_DAA_IssueSetup(3)
2
3
4
5 TCG Software Stack Developer's Reference
6
8 Tspi_DAA_IssueSetup - generate a DAA Issuer public and private key
9
11 #include <tss/tss_typedef.h>
12 #include <tss/tss_structs.h>
13 #include <tss/tspi.h>
14
15 TSPICALL Tspi_DAA_IssueSetup(
16 TSS_HDAA hDAA,
17 UINT32 issuerBaseNameLength,
18 BYTE* issuerBaseName,
19 UINT32 numberPlatformAttributes,
20 UINT32 numberIssuerAttributes,
21 TSS_HKEY* keyPair,
22 TSS_DAA_PK_PROOF** identity_proof
23 );
24
25
26
28 Tspi_DAA_IssueSetup is part of the DAA Issuer component. It defines the
29 generation of a DAA Issuer public and secret key. Further it defines
30 the generation of a non-interactive proof (using the Fiat-Shamir
31 heuristic) that the public keys were chosen correctly. The latter will
32 guarantee the security requirements of the platform (respectively, its
33 user), i.e., that the privacy and anonymity of signatures will hold.
34 The generation of the authentication keys of the DAA Issuer, which are
35 used to authenticate (main) DAA Issuer keys, is not defined by this
36 function. This is an optional function and does not require a TPM or a
37 TCS.
38
39
41 hDAA
42 The hDAA parameter is used to specify the handle of the DAA object.
43
44 issuerBaseNameLength
45 The issuerBaseNameLength parameter is the length of the issuerBaseName.
46
47 issuerBaseName
48 The issuerBaseName parameter is the unique name of the DAA Issuer.
49
50 numberPlatformAttributes
51 The numberPlatformAttributes parameter is the number of attributes that
52 the Platform can choose and which will not be visible to the Issuer.
53
54 numberIssuerAttributes
55 The numberIssuerAttributes parameter is number of attributes that the
56 Issuer can choose and which will be visible to both the Platform and
57 the Issuer.
58
59 keyPair
60 The keyPair parameter is the handle of the main DAA Issuer key pair
61 (private and public portion).
62
63 publicKeyProof
64 The publicKeyProof parameter is the Handle of the proof of the main DAA
65 Issuer public key.
66
67
69 Tspi_DAA_IssueSetup returns TSS_SUCCESS on success, otherwise one of
70 the following values is returned:
71
72 TSS_E_INVALID_HANDLE
73 Either the DAA is not valid.
74
75 TSS_E_BAD_PARAMETER
76
77 TSS_E_INTERNAL_ERROR
78 An internal SW error has been detected.
79
80
82 Tspi_DAA_IssueSetup conforms to the Trusted Computing Group Software
83 Specification version 1.2
84
85
87 Tspi_DAA_IssuerKeyVerification(3)
88
89
90
91
92TSS 1.2 2006-09-04 Tspi_DAA_IssueSetup(3)