secureswitools/swisistools/source/signsislib/certificateinfo.h
author Simon Howkins <simonh@symbian.org>
Mon, 22 Nov 2010 12:04:39 +0000
branchRCL_3
changeset 84 e6c5e34cd9b9
parent 0 ba25891c3a9e
permissions -rw-r--r--
Adjusted to avoid exports, etc, from a top-level bld.inf

/*
* Copyright (c) 2008-2009 Nokia Corporation and/or its subsidiary(-ies).
* All rights reserved.
* This component and the accompanying materials are made available
* under the terms of the License "Eclipse Public License v1.0"
* which accompanies this distribution, and is available
* at the URL "http://www.eclipse.org/legal/epl-v10.html".
*
* Initial Contributors:
* Nokia Corporation - initial contribution.
*
* Contributors:
*
* Description: 
*
*/


/**
 @file 
 @publishedPartner
 @released
*/

#ifndef __CERTIFICATEINFO_H__
#define __CERTIFICATEINFO_H__

#include <openssl/x509.h>
#include "sisdatetime.h"

// Forward declarations
struct TConfValue
	{
	std::string	iName;
	std::string	iValue;
	};

struct TExtension
	{
	std::string				iExtensionName;
	bool					iIsCritical;
	bool					iIsMultiLine;
	std::string				iValue;
	std::vector<TConfValue>	iValueList;
	};

enum TPublicKeyType
	{
	EUnknownKey,
	EPubKeyDSA,
	EPubKeyRSA
	};

/**
 * This class extracts certificate details from a X509 certificate.
 */
class CCertificateInfo
	{
	friend class CCertificateChain;

public:
	/**
	 * Constructor will take X509 class pointer. Then it will
	 * extract certificate details from the class.
	 */
	explicit CCertificateInfo (X509* aCertificate);
	/**
	 * Free up owned resources
	 */
	~CCertificateInfo();
	
public:
	/**
	 * Get the instance of X509 certificate class.
	 */
	inline const X509* Certificate() const;
	/**
	 * Issuer Name - Issuer of the certificate.
	 * @param aGetFullName If true it will return detail name else only
	 * 			common name (CN) will be returned.
	 * @return Issuer name
	 */
	std::wstring IssuerName(bool aGetFullName = false) const;
	/**
	 * Subject Name - Name of the entity to whom the certificate was issued.
	 * @param aGetFullName If true it will return detail name else only
	 * 			common name (CN) will be returned.
	 * @return Subject name
	 */
	std::wstring SubjectName(bool aGetFullName = false) const;
	/**
	 * Get the time from which the certificate is valid.
	 */
	const CSISDateTime& ValidFrom() const;
	/**
	 * Get the time till which the certificate is valid.
	 */
	const CSISDateTime& ValidTo() const;
	/**
	 * Certificate version. Version number starts with 0.
	 * Therefore certifcate having version 1 will return (0),
	 * certificate with version 3 will return 2.
	 * @return Certificate version.
	 */
	int Version() const;
	/**
	 * Serial number of the certificate
	 */
	std::string SerialNumber() const;
	/**
	 * Algorithm used to sign the certificate.
	 */
	std::string SignatureAlgo() const;
	/**
	 * Algorithm used for key generation
	 */
	std::string PublicKeyAlgo() const;
	/**
	 * Function to retrieve extensions present in the certificate.
	 * @return vector of TExtension class. TExtension class provide detail information 
	 * 			of extension. 
	 */
	const std::vector<TExtension>& Extensions() const;
	/**
	 * Return the public key type.
	 */
	inline TPublicKeyType PublicKeyType() const;
	/**
	 * This function will write the public key into the stream provided.
	 * @param aStream where the public key information need to be written.
	 * @param aIndent Indentation size.
	 */
	void PrintPublicKey(std::ostream& aStream, int aIndent = 0) const;
	/**
	 * This function will write the signature into the stream provided.
	 * @param aStream where the signature need to be written.
	 * @param aIndent Indentation size.
	 */
	void PrintSignature(std::ostream& aStream, int aIndent = 0) const;
	/**
	 * Write the certificate into a file.
	 * @param aCertFileName Certificate file name
	 */ 
	void ExtractCertificate(std::string& aCertFileName) const;
	/**
	 * Check if a particular NID is present in the certificate.
	 * @return true if the NID is present else false.
	 */
	bool IsNIDPresent(int aNID) const;
	
private: // Private Member Functions
	void ConstructL();
	int GetNameEntry(X509_NAME* aName, char *aKey, wchar_t** aNameEntry) const;
	std::wstring GetDistinguishedName(X509_NAME *x509Name, bool aGetFullName) const;
	void SetDateTime(CSISDateTime& dateTime, ASN1_TIME* aASNTime);
	void ExtractExtensions();
	void ExtractConfValues(STACK_OF(CONF_VALUE) *confList, TExtension& aExtInfo);
	std::string Get_ASN1_STRING_Data(ASN1_STRING *aASN1String);
	
private:
	X509*					iCertificate;
	CSISDateTime			iValidFrom;
	CSISDateTime			iValidTo;
	TPublicKeyType			iPublicKeyType;	
	std::vector<TExtension>	iExtensions;
	};

inline const X509* CCertificateInfo::Certificate() const
	{
	return iCertificate;
	}

inline TPublicKeyType CCertificateInfo::PublicKeyType() const
	{
	return iPublicKeyType;
	}



#endif // __CERTIFICATEINFO_H__