diff -r 000000000000 -r 2c201484c85f cryptoservices/certificateandkeymgmt/inc/x509constraintext.h --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/cryptoservices/certificateandkeymgmt/inc/x509constraintext.h Wed Jul 08 11:25:26 2009 +0100 @@ -0,0 +1,230 @@ +/* +* Copyright (c) 2005-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: +* Symbian specific X509.v3 certificate extensions that constrain the +* the devices, secure ids, vendor ids and capabilities for which +* a software install signing certificate is valid. +* +*/ + + + + +/** + @file + @internalTechnology +*/ + +#ifndef __X509CONSTRAINTEXT_H__ +#define __X509CONSTRAINTEXT_H__ + +#include +#include + +class CX509IntListExt : public CX509ExtensionBase +/** +A Symbian specific X.509 v3 certificate extension that contains an arbitrary +list of 32 bit integers. + +@internalTechnology +@released +*/ + { +public: + /** + Creates a new CX509IntListExt object from the binary (DER) encoded + representation of a sequence of integers. + + @param aBinaryData The encoded binary representation. + @return The new CX509IntListExt object. + */ + IMPORT_C static CX509IntListExt* NewL(const TDesC8& aBinaryData); + + /** + Creates a new CX509IntListExt object from the binary (DER) encoded + representation of a sequence of integers, and puts a pointer to it + onto the cleanup stack. + + @param aBinaryData The encoded binary representation. + @return The new CX509IntListExt object. + */ + IMPORT_C static CX509IntListExt* NewLC(const TDesC8& aBinaryData); + + /** + Destructor. + Frees all resources owned by the object. + */ + ~CX509IntListExt(); + + /** + Gets a reference to the array of decoded integers. + Ownership is not transferred. + @return A reference to the array of decoded integers. + */ + IMPORT_C const RArray& IntArray() const; + +protected: + /** Second-phase constructor. + * + * @param aBinaryData The encoded binary representation. + * @param aPos The position from which to start decoding. */ + void ConstructL(const TDesC8& aBinaryData, TInt& aPos); + + /** + Decodes the binary representation of a sequence of integers. + + @param aBinaryData The encoded binary representation. This is the same as + passed to ConstructL(). + @param aPos The position from which to start decoding. Note that + the value passed points, in effect, to the content, + bypassing the header data. + */ + void DoConstructL(const TDesC8& aBinaryData, TInt& aPos); + +private: + /** The decoded array of integers. */ + RArray iIntArray; + }; + +class CX509Utf8StringListExt : public CX509ExtensionBase +/** +A Symbian specific X.509 v3 certificate extension that contains an arbitrary +list of UTF-8 strings. + +@internalTechnology +@released +*/ + { +public: + /** + Creates a new CX509Utf8StringListExt object from the binary (DER) encoded + representation of a sequence of integers. + + @param aBinaryData The encoded binary representation. + @return The new CX509Utf8StringListExt object. + */ + IMPORT_C static CX509Utf8StringListExt* NewL(const TDesC8& aBinaryData); + + /** + Creates a new CX509Utf8StringListExt object from the binary (DER) encoded + representation of a sequence of integers, and puts a pointer to it + onto the cleanup stack. + + @param aBinaryData The encoded binary representation. + @return The new CX509Utf8StringListExt object. + */ + IMPORT_C static CX509Utf8StringListExt* NewLC(const TDesC8& aBinaryData); + + /** + Destructor. + Frees all resources owned by the object. + */ + ~CX509Utf8StringListExt(); + + /** + Gets a reference to the array of decoded strings (UTF-16). + Ownership is not transferred. + @return A reference to the array of decoded strings in UTF-16. + */ + IMPORT_C const RPointerArray& StringArray() const; + +protected: + /** Second-phase constructor. + @param aBinaryData The encoded binary representation. + @param aPos The position from which to start decoding. + */ + void ConstructL(const TDesC8& aBinaryData, TInt& aPos); + + /** + Decodes the binary representation of a sequence of UTF-8 strings. The + strings are converted and stored internal as UTF-8. + + @param aBinaryData The encoded binary representation. This is the same as + passed to ConstructL(). + @param aPos The position from which to start decoding. Note that + the value passed points, in effect, to the content, + bypassing the header data. + */ + void DoConstructL(const TDesC8& aBinaryData, TInt& aPos); + +private: + /** The decoded array of strings in UTF-16. */ + RPointerArray iStringArray; + }; + +/** +A Symbian specific X.509 v3 certificate extension that contains a capability +set encoded as a bit string. + +@internalTechnology +@released +*/ +class CX509CapabilitySetExt : public CX509ExtensionBase + { +public: + /** + Creates a new CX509CapabilitySetExt object from the binary (DER) encoded + representation of a sequence of integers. + + @param aBinaryData The encoded binary representation. + @return The new CX509CapabilitySetExt object. + */ + IMPORT_C static CX509CapabilitySetExt* NewL(const TDesC8& aBinaryData); + + /** + Creates a new CX509CapabilitySetExt object from the binary (DER) encoded + representation of a sequence of integers, and puts a pointer to it + onto the cleanup stack. + + @param aBinaryData The encoded binary representation. + @return The new CX509CapabilitySetExt object. + */ + IMPORT_C static CX509CapabilitySetExt* NewLC(const TDesC8& aBinaryData); + + /** + Destructor. + Frees all resources owned by the object. + */ + ~CX509CapabilitySetExt(); + + /** Gets a reference to the capability set. + @return the capability set represented by the bit string. + */ + IMPORT_C const TCapabilitySet& CapabilitySet() const; + +protected: + /** Second-phase constructor. + + @param aBinaryData The encoded binary representation. + @param aPos The position from which to start decoding. + */ + void ConstructL(const TDesC8& aBinaryData, TInt& aPos); + + /** + Constructs the a TCapabilitySet from a DER encoded bit string. + + @param aBinaryData The encoded binary representation. This is the same as + passed to ConstructL(). + @param aPos The position from which to start decoding. Note that + the value passed points, in effect, to the content, + bypassing the header data. + */ + void DoConstructL(const TDesC8& aBinaryData, TInt& aPos); + +private: + /** The decoded capability set */ + TCapabilitySet iCapabilitySet; + }; + +#endif