Class CSignedObject

class CSignedObject : public CBase;

Description

Base class for certificates.

Derivation

• CBase - Base class for all classes to be instantiated on the heap.

• CSignedObject - Base class for certificates.

Members

Defined in CSignedObject:

• DataElementEncoding(const TUint)constGets the encoded data for the specified encoded data element, in the (to be sign...
• Encoding()constGets the entire encoding.
• ExternalizeL(RWriteStream &)constExternalises the encoding of the entire object to a write stream.
• Fingerprint()constGets the fingerprint.
• InternalizeL(RReadStream &)Internalises the encoded object from a read stream.
• SetParametersL(const CSigningKeyParameters &)Sets the signing key parameters.
• Signature()constGets the digital signature.
• SignedDataL()constGets the signed data.
• SigningAlgorithm()constGets the signing algorithm ID used.
• VerifySignatureL(const TDesC8 &)constVerifies a signature using the specified encoded key.
• VerifySignatureL(const TDesC8 &,const TDesC8 &)constVerifies a signature using the specified encoded key and hash.
• iEncodingA heap descriptor representing the entire encoding.
• iFingerprintThe fingerprint.
• iKeyFactoryA pointer to a key factory object.
• iParametersThe signing key parameters
• iSignatureThe digital signature.
• iSigningAlgorithmThe signing algorithm ID.
• ~CSignedObject()Destructor.

Inherited from CBase:

• Delete(CBase *)Deletes the specified object.
• Extension_(TUint,TAny *&,TAny *)Extension function
• operator new(TUint)Allocates the object from the heap and then initialises its contents to binary z...
• operator new(TUint,TAny *)Initialises the object to binary zeroes.
• operator new(TUint,TLeave)Allocates the object from the heap and then initialises its contents to binary z...
• operator new(TUint,TLeave,TUint)Allocates the object from the heap and then initialises its contents to binary z...
• operator new(TUint,TUint)Allocates the object from the heap and then initialises its contents to binary z...

IMPORT_C ~CSignedObject();

Description

Destructor.

Frees all resources owned by the object.

IMPORT_C TBool VerifySignatureL(const TDesC8 &aEncodedKey) const;

Description

Verifies a signature using the specified encoded key.

Parameters

Return value

IMPORT_C TBool VerifySignatureL(const TDesC8 &aEncodedKey, const TDesC8 &aHash) const;

Description

Verifies a signature using the specified encoded key and hash.

Parameters

Return value

IMPORT_C const TPtrC8 Signature() const;

Description

Gets the digital signature.

Return value

IMPORT_C virtual const TPtrC8 SignedDataL() const=0;

Description

Gets the signed data.

Return value

IMPORT_C const TPtrC8 Fingerprint() const;

Description

Gets the fingerprint.

The fingerprint returned is the SHA1 hash of the encoding of the entire object.

Return value

IMPORT_C const TPtrC8 Encoding() const;

Description

Gets the entire encoding.

Return value

IMPORT_C const CSigningAlgorithmIdentifier& SigningAlgorithm() const;

Description

Gets the signing algorithm ID used.

Return value

IMPORT_C virtual void ExternalizeL(RWriteStream &aStream) const;

Description

Externalises the encoding of the entire object to a write stream.

The fingerprint and the signed data can be regenerated after restoration.

The presence of this function means that the standard templated operator<<(RWriteStream &,const T &) can be used to externalise objects of this class.

Parameters

IMPORT_C virtual void InternalizeL(RReadStream &aStream)=0;

Description

Internalises the encoded object from a read stream.

The class makes use of a specification-specific parser class for extracting the various elements, that is provided by a subclass of CSignedObject. For this reason this function is pure virtual.

The presence of this function means that the standard templated operator>>(RReadStream &,T &) can be used to internalise objects of this class.

Parameters

IMPORT_C void SetParametersL(const CSigningKeyParameters &aParameters);

Description

Sets the signing key parameters.

Parameters

IMPORT_C virtual const TPtrC8* DataElementEncoding(const TUint aIndex) const=0;

Description

Gets the encoded data for the specified encoded data element, in the (to be signed) tbsCertificate data structure, of the signed object.

Parameters

Return value

protected: TKeyFactory * iKeyFactory;

Description

A pointer to a key factory object.

protected: HBufC8 * iEncoding;

Description

A heap descriptor representing the entire encoding.

protected: HBufC8 * iSignature;

Description

The digital signature.

protected: HBufC8 * iFingerprint;

Description

The fingerprint.

The SHA1 hash of the encoding of the entire object.

protected: CSigningKeyParameters * iParameters;

Description

The signing key parameters

protected: CSigningAlgorithmIdentifier * iSigningAlgorithm;

Description

The signing algorithm ID.