1Tspi_TPM_DAA_JoinCreateDaaPuLbiKberya(r3y)FunctionsTsMpain_uTaPlM_DAA_JoinCreateDaaPubKey(3)
2
3
4
5                   TCG Software Stack Developer's Reference
6

NAME

8       Tspi_TPM_DAA_JoinCreateDaaPubKey  - computes the credential request for
9       the DAA Issuer
10

SYNOPSIS

12       #include <tss/tss_typedef.h>
13       #include <tss/tss_structs.h>
14       #include <tss/tspi.h>
15
16       TSS_RESULT Tspi_TPM_DAA_JoinCreateDaaPubKey(
17           TSS_HDAA                    hDAA,
18           TSS_HTPM                    hTPM,
19           UINT32                      authenticationChallengeLength,
20           BYTE*                       authenticationChallenge,
21           UINT32                      nonceIssuerLength,
22           BYTE*                       nonceIssuer,
23           UINT32                      attributesPlatformLength,
24           BYTE**                      attributesPlatform,
25           TSS_DAA_JOIN_SESSION*       joinSession,
26           TSS_DAA_CREDENTIAL_REQUEST* credentialRequest
27       );
28
29
30

DESCRIPTION

32       Tspi_TPM_DAA_JoinCreateDaaPubKey     is     the     second     (between
33       Tspi_TPM_DAA_JoinInit() and Tspi_TPM_DAA_JoinStoreCredential())
34        out  of  3  functions to execute in order to receive a DAA Credential.
35       It computes the credential request for the DAA Issuer, which  also  in‐
36       cludes the Platforms's DAA public key and the attributes that were cho‐
37       sen by the Platform, and which are not visible to the DAA  Issuer.  The
38       Platform can commit to the attribute values it has chosen.
39

PARAMETERS

41   hDAA
42       The hDAA parameter is used to specify the handle of the DAA object.
43
44   hTPM
45       The hTPM parameter is the handle to the TPM object.
46
47   authenticationChallengeLength
48       The  authenticationChallengeLength  parameter  is length of authentica‐
49       tionChallenge (256 bytes - DAA_SIZE_NE1).
50
51   authenticationChallenge
52       The authenticationChallenge parameter is the second nonce  of  the  DAA
53       Issuer  that is encrypted by the endorsement public key.  It is used as
54       a challenge to authenticate the underlying TPM.
55
56   nonceIssuerLength
57       The nonceIssuerLength  parameter  is  the  length  of  nonceIssuer  (20
58       bytes).
59
60   nonceIssuer
61       The nonceIssuer parameter is the nonce of the DAA Issuer.
62
63   attributesPlatformLength
64       The  attributesPlatformLength parameter is length of attributesPlatform
65       array, which is determined by the DAA Issuer public key (). The  length
66       of  a  single  attribute  is ln/8. ln is defined as the size of the RSA
67       modulus (2048).
68
69   attributesPlatform
70       The attributesPlatform parameter is an array of attributes to be encod‐
71       ed into the DAA Credential not visible to the DAA Issuer.
72
73   joinSession
74       The  joinSession  parameter is a structure containing the DAA Join ses‐
75       sion information.
76
77   credentialRequest
78       The credentialRequest parameter is the credential request of the  Plat‐
79       form,  it  contains the blinded DAA public key of the platform on which
80       the DAA Issuer will issue the credential the blinded attributes  chosen
81       by the Platform.
82
83

RETURN CODES

85       Tspi_TPM_DAA_JoinCreateDaaPubKey returns TSS_SUCCESS on success, other‐
86       wise one of the following values is returned:
87
88       TSS_E_INVALID_HANDLE
89              Either the DAA is not valid.
90
91       TSS_E_BAD_PARAMETER
92
93       TSS_E_INTERNAL_ERROR
94              An internal SW error has been detected.
95
96

CONFORMING TO

98       Tspi_TPM_DAA_JoinCreateDaaPubKey  conforms  to  the  Trusted  Computing
99       Group Software Specification version 1.2
100
101

SEE ALSO

103       Tspi_TPM_DAA_JoinInit(3) Tspi_TPM_DAA_JoinStoreCredential(3)
104
105
106
107
108TSS 1.2                           2006-09-04Tspi_TPM_DAA_JoinCreateDaaPubKey(3)
Impressum