tspi_tpm_daa_joininit(3) [debian man page]

Tspi_TPM_DAA_JoinInit(3)				     Library Functions Manual					  Tspi_TPM_DAA_JoinInit(3)

						     TCG Software Stack Developer's Reference

NAME

       Tspi_TPM_DAA_JoinInit - start the DAA Join process

SYNOPSIS

       #include <tss/tss_typedef.h>
       #include <tss/tss_structs.h>
       #include <tss/tspi.h>

       TSPICALL Tspi_TPM_DAA_JoinInit(
	   TSS_HDAA		     hDAA,
	   TSS_HTPM		     hTPM,
	   TSS_HKEY		     issuer_pk,
	   UINT32		     issuer_authentication_PKLength,
	   TSS_HKEY*		     issuer_authentication_PK,
	   UINT32		     issuer_authentication_PK_signaturesLength,
	   BYTE**		     issuer_authentication_PK_signatures,
	   UINT32*		     capital_UprimeLength,
	   BYTE**		     capital_Uprime,
	   TSS_DAA_IDENTITY_PROOF*   identity_proof,
	   TSS_DAA_JOIN_SESSION*     join_session
       );

DESCRIPTION

       Tspi_TPM_DAA_JoinInit  is the first out of 3 functions to execute in order to receive a DAA Credential. It verifies the keys of the DAA Is-
       suer and computes the TPM DAA public key.

PARAMETERS

   hDAA
       The hDAA parameter is used to specify the handle of the DAA object.

   hTPM
       The hTPM parameter is the handle to the TPM object.

   issuer_pk
       The issuer_pk parameter is the of the DAA Issuer public key.

   issuer_authentication_PKLength
       The issuer_authentication_PKLength parameter is the length of the array of issuerAuthPKs.

   issuer_authentication_PK
       The issuer_authentication_PK parameter is an array of RSA public keys (key chain) of
	the DAA Issuer used to authenticate the DAA Issuer public key. The size of the modulus must
	be TPM_DAA_SIZE_issuerModulus (256).

   issuer_authentication_PK_signaturesLength
       The issuer_authentication_PK_signaturesLength parameter is the length of the array of
	issuerAuthPKSignatures. It is equal to issuerAuthPKsLength. The length of an element of the
	array is TPM_DAA_SIZE_issuerModulus (256).

   issuer_authentication_PK_signatures
       The issuer_authentication_PK_signatures parameter is the array of byte arrays representing
	signatures on the modulus of the above key chain (issuerAuthPKs) in more details, the array has
	the following content (S(K[1],K[0]),S(K[2],N[1]),..S(K[ k ],K[n-1]), S(TPM_DAA_ISSUER,K[ k ])),
	where S(msg,privateKey) denotes the signature function with msg being signed by the privateKey.

   capital_UprimeLength
       The capital_UprimeLength parameter is the length of capitalUprime which is ln/8. ln is defined as the size of the RSA modulus (2048).

   capital_Uprime
       The capital_Uprime parameter is U'.

   identityProof
       The identityProof parameter is a structure containing the endorsement, platform and conformance
	credential.

   joinSession
       The joinSession parameter is a structure containing DAA Join session information.

RETURN CODES

       Tspi_TPM_DAA_JoinInit returns TSS_SUCCESS on success, otherwise one of the following values is returned:

       TSS_E_INVALID_HANDLE
	      Either the DAA or the TPM handler is not valid.

       TSS_E_BAD_PARAMETER

       TSS_E_INTERNAL_ERROR
	      An internal SW error has been detected.

       TSS_E_DAA_ISSUER_KEY_ERROR

CONFORMING TO

       Tspi_TPM_DAA_JoinInit conforms to the Trusted Computing Group Software Specification version 1.2

SEE ALSO

       Tspi_TPM_DAA_JoinCreateDaaPubKey(3) Tspi_TPM_DAA_JoinStoreCredential(3)

TSS 1.2 							    2006-09-04						  Tspi_TPM_DAA_JoinInit(3)

Check Out this Related Man Page

Tspi_TPM_DAA_Sign(3)					     Library Functions Manual					      Tspi_TPM_DAA_Sign(3)

						     TCG Software Stack Developer's Reference

NAME

       Tspi_TPM_DAA_Sign - creates a DAA Signature that proofs ownership of the DAA Credential

SYNOPSIS

       #include <tss/tss_typedef.h>
       #include <tss/tss_structs.h>
       #include <tss/tspi.h>

       TSS_RESULT Tspi_TPM_DAA_Sign(
	   TSS_HDAA		       hDAA,
	   TSS_HTPM		       hTPM,
	   TSS_HKEY		       hDaaCredential,
	   TSS_DAA_SELECTED_ATTRIB     revealAttributes,
	   UINT32		       verifierBaseNameLength,
	   BYTE*		       verifierBaseName,
	   UINT32		       verifierNonceLength,
	   BYTE*		       verifierNonce,
	   TSS_DAA_SIGN_DATA	       signData,
	   TSS_DAA_SIGNATURE*	       daaSignature
       );

DESCRIPTION

       Tspi_TPM_DAA_Sign  creates a DAA Signature that proofs ownership of the DAA Credential and includes a signature on either a public AIK or a
       message. If anonymity revocation is enabled, the value Nv is not provided in the clear anymore  but  encrypted  under  the  public  key	of
       anonymity revocation authority, a trusted third party (TTP). Thus the DAA Verifier cannot check for revocation or link a transaction/signa-
       ture to prior ones. Depending on how is chosen, the protocol either allows implementing anonymity revocation (i.e., using the DAA  Issuer's
       long-term  base name  as the DAA Verifier's base name ), or having the TTP doing the linking of different signatures for the same DAA Veri-
       fier (i.e., using the DAA Verifier's base name ).

PARAMETERS

   hDAA
       The hDAA parameter is used to specify the handle of the DAA object.

   hTPM
       The hTPM parameter is the handle to the TPM object.

   hDaaCredential
       The hDaaCredential parameter is the Handle of the DAA Credential.

   revealAttributes
       The revealAttributes parameter is the attributes which the credential owner wants to reveal to the DAA Verifier.

   verifierBaseNameLength
       The verifierBaseNameLength parameter is the Length of verifierBaseName.

   verifierBaseName
       The verifierBaseName parameter is the base name chosen by the DAA Verifier. If it equals to null, the platform chooses a random base name.

   verifierNonceLength
       The verifierNonceLength parameter is the length of verifierNonceName (20 bytes).

   verifierNonce
       The verifierNonce parameter is the nonce created by the DAA Verifier.

   signData
       The signData parameter is the handle of the received DAA Credential.

   daaSignature
       The daaSignature parameter is the DAA signature containing the proof of ownership of the DAA Credential, as well as a signature	on  either
       an AIK or a message.

RETURN CODES

       Tspi_TPM_DAA_Sign returns TSS_SUCCESS on success, otherwise one of the following values is returned:

       TSS_E_INVALID_HANDLE
	      Either the DAA or the TPM handler is not valid.

       TSS_E_BAD_PARAMETER

       TSS_E_INTERNAL_ERROR
	      An internal SW error has been detected.

CONFORMING TO

       Tspi_TPM_DAA_Sign conforms to the Trusted Computing Group Software Specification version 1.2

SEE ALSO

TSS 1.2 							    2006-09-04						      Tspi_TPM_DAA_Sign(3)

Linux and UNIX Man Pages

tspi_tpm_daa_joininit(3) [debian man page]

Check Out this Related Man Page