1
.\" Copyright (C) 2006 International Business Machines Corporation
2
.\" Written by Anthony Bussani based on the Trusted Computing Group Software Stack Specification Version 1.2
12
.de Sp \" Vertical space (when we can't use .PP)
18
.ie \\n(.$>=3 .ne \\$3
22
.TH "Tspi_DAA_IssueInit" 3 "2006-09-04" "TSS 1.2"
24
TCG Software Stack Developer's Reference
26
Tspi_DAA_IssueInit \- initialize the Issuer for a join operation
31
.B #include <tss/tss_typedef.h>
32
.B #include <tss/tss_structs.h>
33
.B #include <tss/tspi.h>
35
.BI "TSPICALL Tspi_DAA_IssueInit("
36
.BI " TSS_HDAA " hDAA ","
37
.BI " TSS_HKEY " issuerAuthPK ","
38
.BI " TSS_HKEY " issuerKeyPair ","
39
.BI " TSS_DAA_IDENTITY_PROOF " identityProof ","
40
.BI " UINT32 " capitalUprimeLength ","
41
.BI " BYTE* " capitalUprime ","
42
.BI " UINT32 " daaCounter ","
43
.BI " UINT32* " nonceIssuerLength ","
44
.BI " BYTE** " nonceIssuer ","
45
.BI " UINT32* " authenticationChallengeLength ","
46
.BI " BYTE** " authenticationChallenge ","
47
.BI " TSS_DAA_JOIN_ISSUER_SESSION* " joinSession
56
\Tspi_DAA_IssueInit\fR
57
is a function that is part of the DAA Issuer component. It's the first function out of 2 in order
58
to issue a DAA Credential for a TCG Platform. It assumes that the endorsement key and its associated
59
credentials are from a genuine and valid TPM. (Verification of the credentials is a process defined
60
by the TCG Infrastructure WG.)
65
The \fIhDAA\fR parameter is used to specify the handle of the DAA object.
67
The \fIissuerAuthPKh\fR parameter is the root authentication (public) key of DAA Issuer.
69
The \fIissuerKeyPair\fR parameter is the handle of the main DAA Issuer key pair (private and public portion).
71
The \fIidentityProof\fR parameter is the structure containing endorsement, platform and conformance
72
credential of the TPM requesting the DAA Credential.
73
.SS capitalUprimeLength
74
The \fIcapitalUprimeLength\fR parameter is the length of capitalUprime which is .
76
The \fIcapitalUprime\fR parameter is U'.
78
The \fIdaaCounter\fR parameter is the DAA counter.
80
The \fInonceIssuerLength\fR parameter is the length of nonceIssuer (20 bytes).
82
The \fInonceIssuer\fR parameter is the nonce of the DAA Issuer.
83
.SS authenticationChallengeLength
84
The \fIauthenticationChallengeLength\fR parameter is the length of authenticationChallenge
85
(256 bytes - DAA_SIZE_NE1).
86
.SS authenticationChallenge
87
The \fIauthenticationChallenge\fR parameter is the second nonce of the DAA Issuer that is
88
encrypted by the endorsement public key. It is used as a challenge to authenticate the TPM.
90
The \fIjoinSession\fR parameter is the structure containing the DAA Join session information.
93
\fBTspi_DAA_IssueInit\fR returns TSS_SUCCESS on success, otherwise one of the
94
following values is returned:
96
.SM TSS_E_INVALID_HANDLE
97
Either the DAA is not valid.
99
.SM TSS_E_BAD_PARAMETER
101
.SM TSS_E_INTERNAL_ERROR
102
An internal SW error has been detected.
106
\fBTspi_DAA_IssueInit\fR conforms to the Trusted Computing Group
107
Software Specification version 1.2
112
\fBTspi_DAA_IssuerKeyVerification\fR(3)