Tspi_DAA_IssueCredential

Section: C Library Functions (3)
Updated: 2006-09-04
Index Return to Main Contents

TCG Software Stack Developer's Reference

NAME

Tspi_DAA_IssueCredential - issue a DAA credential for a TCG platform

SYNOPSIS

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

TSPICALL Tspi_DAA_IssueCredential(
    TSS_HDAA                    hDAA,
    UINT32                      attributesIssuerLength,
    BYTE**                      attributesIssuer,
    TSS_DAA_CREDENTIAL_REQUEST  credentialRequest,
    TSS_DAA_JOIN_ISSUER_SESSION joinSession,
    TSS_DAA_CRED_ISSUER*        credIssuer
);

DESCRIPTION

Tspi_DAA_IssueCredential is part of the DAA Issuer component. It's the last function out of 2 in order to issue a DAA Credential for a TCG Platform. It detects rogue TPM according to published rogue TPM DAA keys. This is an optional function and does not require a TPM or a TCS.

PARAMETERS

hDAA

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

attributesIssuerLength

The attributesIssuerLength parameter is the length of the attributesIssuer array, which is determined by the DAA Issuer public key (li). The length of a single attribute is if/8.

attributesIssuer

The attributesIssuer parameter is the array of attributes to be encoded into the DAA Credential visible to the DAA Issuer .

credentialRequest

The credentialRequest parameter is the credential request of the Platform, it contains the blinded DAA public key of the platform on which the DAA Issuer will issue the credential the blinded attributes chosen by the Platform.

joinSession

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

credIssuer

The credIssuer parameter is the structure containing the DAA Credential issued by the DAA Issuer, the proof of correctness of the credential and the attributes chosen by the DAA Issuer.

RETURN CODES

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

TSS_E_BAD_PARAMETER
TSS_E_INTERNAL_ERROR: An internal SW error has been detected.
TSS_E_DAA_AUTHENTICATION_ERROR: The authentication proof of the TPM is incorrect.
TSS_E_DAA_PSEUDONYM_ERROR: The TPM is rogue.
TSS_E_DAA_CREDENTIAL_REQUEST_PROOF_ERROR: The proof of the credential request is incorrect.

CONFORMING TO

Tspi_DAA_IssueCredential conforms to the Trusted Computing Group Software Specification version 1.2