Class MSecurityPolicy

class MSecurityPolicy;

Description

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

Members

Defined in MSecurityPolicy:
CancelValidateUntrustedServerCert(), GetNamedPolicyProperty(), GetTlsCipherSuites(), GetWtlsCipherSuites(), GetWtlsKeyExchangeSuites(), Reserved1(), Reserved2(), ValidateUntrustedServerCert()

virtual void ValidateUntrustedServerCert(TCertInfo &aServerCert, TRequestStatus &aStatus) const=0;

Description

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

TCertInfo &aServerCert (in) A structure containing the certificate details. TRequestStatus &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

virtual void CancelValidateUntrustedServerCert()=0;

Description

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

virtual const RArray< TWtlsCipherSuite > &GetWtlsCipherSuites()=0;

Description

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

Return value

const RArray< TWtlsCipherSuite > & 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.

virtual const TDesC8 &GetTlsCipherSuites()=0;

Description

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

Return value

const TDesC8 & An descriptor containing a list of the TLS cipher suites. Each cipher suite is a 2 byte pair

virtual const RArray< TWtlsKeyExchangeSuite > &GetWtlsKeyExchangeSuites()=0;

Description

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

Return value

const RArray< TWtlsKeyExchangeSuite > & 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.

virtual TInt GetNamedPolicyProperty(RStringF aPropertyName, RString &aPropertyValue)=0;

Description

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

Parameters

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

Return value

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

protected: virtual void Reserved1()=0;

Description

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

protected: virtual void Reserved2()=0;

Description

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