MSecurityPolicy Class Reference

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

class MSecurityPolicy
Public Member Functions
pure virtual voidCancelValidateUntrustedServerCert()
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 voidValidateUntrustedServerCert(TCertInfo &, TRequestStatus &)
Protected Member Functions
pure virtual voidReserved1()
pure virtual voidReserved2()

Detailed Description

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

Member Function Documentation

CancelValidateUntrustedServerCert ( )

voidCancelValidateUntrustedServerCert()[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(RStringFaPropertyName,
RString &aPropertyValue
)[pure virtual]

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

ParameterDescription
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.

Returns: 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.

Returns: 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.

Returns: 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.

Returns: 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 ( )

voidReserved1()[protected, pure virtual]

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

Reserved2 ( )

voidReserved2()[protected, pure virtual]

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

ValidateUntrustedServerCert ( TCertInfo &, TRequestStatus & )

voidValidateUntrustedServerCert(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.

ParameterDescription
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