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

NAME

8       Tspi_TPM_DAA_JoinInit - start the DAA Join process
9

SYNOPSIS

11       #include <tss/tss_typedef.h>
12       #include <tss/tss_structs.h>
13       #include <tss/tspi.h>
14
15       TSPICALL Tspi_TPM_DAA_JoinInit(
16           TSS_HDAA                  hDAA,
17           TSS_HTPM                  hTPM,
18           TSS_HKEY                  issuer_pk,
19           UINT32                    issuer_authentication_PKLength,
20           TSS_HKEY*                 issuer_authentication_PK,
21           UINT32                    issuer_authentication_PK_signaturesLength,
22           BYTE**                    issuer_authentication_PK_signatures,
23           UINT32*                   capital_UprimeLength,
24           BYTE**                    capital_Uprime,
25           TSS_DAA_IDENTITY_PROOF*   identity_proof,
26           TSS_DAA_JOIN_SESSION*     join_session
27       );
28
29
30

DESCRIPTION

32       Tspi_TPM_DAA_JoinInit is the first out of 3 functions to execute in or‐
33       der to receive a DAA Credential. It verifies the keys of the DAA Issuer
34       and computes the TPM DAA public key.
35
36

PARAMETERS

38   hDAA
39       The hDAA parameter is used to specify the handle of the DAA object.
40
41   hTPM
42       The hTPM parameter is the handle to the TPM object.
43
44   issuer_pk
45       The issuer_pk parameter is the of the DAA Issuer public key.
46
47   issuer_authentication_PKLength
48       The issuer_authentication_PKLength parameter is the length of the array
49       of issuerAuthPKs.
50
51   issuer_authentication_PK
52       The issuer_authentication_PK parameter is an array of RSA  public  keys
53       (key chain) of
54        the  DAA  Issuer  used  to authenticate the DAA Issuer public key. The
55       size of the modulus must
56        be TPM_DAA_SIZE_issuerModulus (256).
57
58   issuer_authentication_PK_signaturesLength
59       The issuer_authentication_PK_signaturesLength parameter is  the  length
60       of the array of
61        issuerAuthPKSignatures. It is equal to issuerAuthPKsLength. The length
62       of an element of the
63        array is TPM_DAA_SIZE_issuerModulus (256).
64
65   issuer_authentication_PK_signatures
66       The issuer_authentication_PK_signatures parameter is the array of  byte
67       arrays representing
68        signatures  on  the  modulus of the above key chain (issuerAuthPKs) in
69       more details, the array has
70        the following content (S(K[1],K[0]),S(K[2],N[1]),..S(K[  k  ],K[n-1]),
71       S(TPM_DAA_ISSUER,K[ k ])),
72        where  S(msg,privateKey) denotes the signature function with msg being
73       signed by the privateKey.
74
75   capital_UprimeLength
76       The capital_UprimeLength parameter is the length of capitalUprime which
77       is ln/8. ln is defined as the size of the RSA modulus (2048).
78
79   capital_Uprime
80       The capital_Uprime parameter is U'.
81
82   identityProof
83       The  identityProof parameter is a structure containing the endorsement,
84       platform and conformance
85        credential.
86
87   joinSession
88       The joinSession parameter is a structure containing  DAA  Join  session
89       information.
90
91

RETURN CODES

93       Tspi_TPM_DAA_JoinInit  returns TSS_SUCCESS on success, otherwise one of
94       the following values is returned:
95
96       TSS_E_INVALID_HANDLE
97              Either the DAA or the TPM handler is not valid.
98
99       TSS_E_BAD_PARAMETER
100
101       TSS_E_INTERNAL_ERROR
102              An internal SW error has been detected.
103
104       TSS_E_DAA_ISSUER_KEY_ERROR
105
106

CONFORMING TO

108       Tspi_TPM_DAA_JoinInit conforms to the Trusted Computing Group  Software
109       Specification version 1.2
110
111

SEE ALSO

113       Tspi_TPM_DAA_JoinCreateDaaPubKey(3) Tspi_TPM_DAA_JoinStoreCredential(3)
114
115
116
117
118TSS 1.2                           2006-09-04          Tspi_TPM_DAA_JoinInit(3)