MSecurityPolicy Class Reference

#include <mw/http/framework/csecuritypolicy.h>

class MSecurityPolicy

Public Member Functions
pure virtual void	CancelValidateUntrustedServerCert()
pure virtual TInt	GetNamedPolicyProperty(RStringF, RString &)
pure virtual const TDesC8 &	GetTlsCipherSuites()
pure virtual const RArray< TWtlsCipherSuite > &	GetWtlsCipherSuites()
pure virtual const RArray< TWtlsKeyExchangeSuite > &	GetWtlsKeyExchangeSuites()
pure virtual void	ValidateUntrustedServerCert(TCertInfo &, TRequestStatus &)

Protected Member Functions
pure virtual void	Reserved1()
pure virtual void	Reserved2()

Detailed Description

The Security Policy Interface. This interface class must be the base class of a security policy plug-in.

Member Function Documentation

CancelValidateUntrustedServerCert ( )

void

CancelValidateUntrustedServerCert

(

)

[pure virtual]

Intended Usage: Cancel a previous request to ask the client to accept or reject an untrusted WTLS server certificate.

GetNamedPolicyProperty ( RStringF, RString & )

TInt	GetNamedPolicyProperty	(	RStringF	aPropertyName,
			RString &	aPropertyValue
		)	[pure virtual]

Intended Usage: Obtain arbitrary, named security policy properties, in a generic 'stringified' form.

Parameters
aPropertyName	(in) The policy property name.
aPropertyValue	(out) The property value. Parsing of the value is left to the caller. The caller must close the RString.

Return Value: An error code: KErrNone if the property exists or KErrNotFound if it doesn't.

GetTlsCipherSuites ( )

const TDesC8 &

GetTlsCipherSuites

(

)

[pure virtual]

Intended Usage: Obtain a list of TLS cipher suites. Not applicable to WTLS clients.

Return Value: An descriptor containing a list of the TLS cipher suites. Each cipher suite is a 2 byte pair

GetWtlsCipherSuites ( )

const RArray< TWtlsCipherSuite > &

GetWtlsCipherSuites

(

)

[pure virtual]

Intended Usage: Obtain an array of WTLS cipher suites. Not applicable to TLS clients.

Return Value: An array of cipher suites, consisting of paired bulk encryption algorithms and MAC algorithms. The array must be ordered with strongest cipher suites at the start.

GetWtlsKeyExchangeSuites ( )

const RArray< TWtlsKeyExchangeSuite > &

GetWtlsKeyExchangeSuites

(

)

[pure virtual]

Intended Usage: Obtain the WTLS key exchange suites. Not applicable to TLS clients.

Return Value: An array of the WTLS key exchange suites. The array must be ordered with authenticating key exchange suites at the start followed by anonymous key exchange suites if desired. Within each group of keys longer keys should precede shorter ones.

Reserved1 ( )

void

Reserved1

(

)

[protected, pure virtual]

Intended Usage: Reserve a slot in the v-table to preserve future BC

Reserved2 ( )

void

Reserved2

(

)

[protected, pure virtual]

Intended Usage: Reserve a slot in the v-table to preserve future BC

ValidateUntrustedServerCert ( TCertInfo &, TRequestStatus & )

void	ValidateUntrustedServerCert	(	TCertInfo &	aServerCert,
			TRequestStatus &	aStatus
		)	const [pure virtual]

Intended Usage: Ask the client to accept or reject a certificate. Not applicable to TLS, as the SSL layer does this itself. The call is asynchronous, returning the result via the TRequestStatus.

Parameters
aServerCert	(in) A structure containing the certificate details.
aStatus	(out) A status flag used to indicate errors. A value of 0 is used to indicate that the cert is untrusted and 1 that it is trusted