Enumeration

SSLProtocol

An enumeration of valid SSL protocol versions.

Declaration

typedef enum SSLProtocol : int {
    ...
} SSLProtocol;

Overview

The descriptions given here apply to the functions SSLSetProtocolVersion and SSLGetProtocolVersion. For the functions SSLSetProtocolVersionEnabled and SSLGetProtocolVersionEnabled, only the following values are used. For these functions, each constant except kSSLProtocolAll specifies a single protocol version.

Topics

SSL Protocols

kSSLProtocolUnknown

Specifies that no protocol has been or should be negotiated or specified; use default.

Deprecated
kSSLProtocol2

Specifies that only the SSL 2.0 protocol may be negotiated. Deprecated in iOS.

Deprecated
kSSLProtocol3

Specifies that the SSL 3.0 protocol is preferred; the SSL 2.0 protocol may be negotiated if the peer cannot use the SSL 3.0 protocol.

Deprecated
kSSLProtocol3Only

Specifies that only the SSL 3.0 protocol may be negotiated; fails if the peer tries to negotiate the SSL 2.0 protocol. Deprecated in iOS.

Deprecated
kSSLProtocolAll

Specifies all supported versions. Deprecated in iOS.

Deprecated

TLS Protocols

kTLSProtocol1

Specifies that the TLS 1.0 protocol is preferred but lower versions may be negotiated.

Deprecated
kTLSProtocol1Only

Specifies that only the TLS 1.0 protocol may be negotiated. Deprecated in iOS.

Deprecated
kTLSProtocol11

Specifies that the TLS 1.1 protocol is preferred but lower versions may be negotiated.

Deprecated
kTLSProtocol12

Specifies that the TLS 1.2 protocol is preferred but lower versions may be negotiated.

Deprecated
kTLSProtocol13

Specifies that the TLS 1.3 protocol is preferred but lower versions may be negotiated.

Deprecated
kTLSProtocolMaxSupported

The maximum system supported version.

Deprecated

DTLS Protocols

kDTLSProtocol1

Specifies the DTLS 1.0 protocol.

Deprecated
kDTLSProtocol12

Specifies the DTLS 1.2 protocol.

Deprecated

See Also

Versions

SSLSetProtocolVersionMax

Sets the maximum protocol version allowed by the application for a given SSL context.

Deprecated
SSLSetProtocolVersionMin

Sets the minimum protocol version allowed by the application for a given SSL context.

Deprecated
SSLGetProtocolVersionMax

Gets the maximum protocol version allowed by the application for a given SSL context.

Deprecated
SSLGetProtocolVersionMin

Gets the minimum protocol version allowed by the application for a given SSL context.

Deprecated
SSLGetNegotiatedProtocolVersion

Obtains the negotiated protocol version of the active session.

Deprecated
tls_protocol_version_t

The collection of supported TLS and DTLS versions.

Beta

Beta Software

This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.

Learn more about using Apple's beta software