securesocketinterface.h File Reference

Detailed Description

Definition of the MSecureSocket class.

Enum TClientCertMode

Server client certificate mode. Specifies if client certificates will be asked for when in server mode, and also if they are optional or must be provided to complete the handshake successfully.

Since
v7.0
EnumeratorValueDescription
EClientCertModeIgnore

Client certificates won't be asked for during handshake negotiation.

EClientCertModeOptional

Client certificates will be requested, but are not compulsory, and the handshake will continue if the client doesn't supply one.

EClientCertModeRequired

Client certificates must be supplied, and the handshake will fail if the client does not provide a one.

Enum TDialogMode

Untrusted certificate dialog mode. When an untrusted certificate is received, the dialog mode determines if the handshake fails automatically, or if a dialog is displayed allowing the user the option of continuing anyway.

Since
v7.0
EnumeratorValueDescription
EDialogModeAttended

All untrusted certificates result in a user dialog.

EDialogModeUnattended

Untrusted certificates are canceled without user confirmation.

EDialogModeAllowAutomatic

Untrusted certificates are automatically allowed without user confirmation.

Enum TServerCertValidation

Untrusted certificate validations. These dialugue values are provisioned by the application to TLS. Incase multiple validation selection, respective enums are logically ORed into single 32bit integer and provisioned to TLS. 1. TLS triggers the provisioned dialog in EDialogModeUnattended mode and supresses other dialogue. 2. TLS report KErrNotSupported error in EDialogModeAttended mode.

EnumeratorValueDescription
ECertNoValidation0

No Validation

ECertChainHasNoRoot0x1

Certificate chain has no root

ECertSignatureInvalid0x2

Invalid signature

ECertDateOutOfRange0x4

Date out of range

ECertNameIsExcluded0x8

Name is excluded

ECertNameNotPermitted0x10

Name is not permitted

ECertNotCACert0x20

Not a CA certificate

ECertCertificateRevoked0x40

Certificate revoked

ECertUnrecognizedCriticalExtension0x80

Unrecognized critical extension

ECertNoBasicConstraintInCACert0x100

No basic constraint in CA certificate

ECertNoAcceptablePolicy0x200

No acceptable policy

ECertPathTooLong0x400

Path too long

ECertNegativePathLengthSpecified0x800

Negative path length specified

ECertNamesDontChain0x1000

Names do not chain

ECertRequiredPolicyNotFound0x2000

Required policy not found

ECertBadKeyUsage0x4000

Bad key usage

ECertRootCertNotSelfSigned0x8000

Root certificate not self-signed

ECertCriticalExtendedKeyUsage0x10000

Critical extended key usage

ECertCriticalCertPoliciesWithQualifiers0x20000

Critical certificate policies with qualifiers

ECertCriticalPolicyMapping0x40000

Critical policy mapping

ECertCriticalDeviceId0x80000

Critical Device Id

ECertCriticalSid0x100000

Critical Sid

ECertCriticalVid0x200000

Critical Vid

ECertCriticalCapabilities0x400000

Critical Capabilities

ECertAllValidations0x7FFFFF

Logically ORed value of all Certificate Validations