ssl

ssl/tls 模块

Field Summary

Type Method and Description
const public const VERIFY_NONEVERIFY_NONEVERIFY_NONE

证书验证模式，不验证
const public const VERIFY_OPTIONALVERIFY_OPTIONALVERIFY_OPTIONAL

证书验证模式，可选验证，允许验证不通过
const public const VERIFY_REQUIREDVERIFY_REQUIREDVERIFY_REQUIRED

证书验证模式，要求验证，验证不通过则中断
const public const BADCERT_EXPIREDBADCERT_EXPIREDBADCERT_EXPIRED

证书验证结果，证书超时
const public const BADCERT_REVOKEDBADCERT_REVOKEDBADCERT_REVOKED

证书验证结果，证书被撤销
const public const BADCERT_CN_MISMATCHBADCERT_CN_MISMATCHBADCERT_CN_MISMATCH

证书验证结果，证书名错误
const public const BADCERT_NOT_TRUSTEDBADCERT_NOT_TRUSTEDBADCERT_NOT_TRUSTED

证书验证结果，证书不可信
const public const ssl3ssl3ssl3

ssl 协议版本 ssl 3.0
const public const tls1tls1tls1

ssl 协议版本 tls 1.0
const public const tls1_1tls1_1tls1_1

ssl 协议版本 tls 1.1
const public const tls1_2tls1_2tls1_2

ssl 协议版本 tls 1.2
readonly X509Cert public static readonly X509Cert cacaca

全局证书，用于 ssl 客户端模式验证服务器证书
Integer public static Integer verificationverificationverification

设定证书验证模式，缺省为 VERIFY_REQUIRED
Integer public static Integer min_versionmin_versionmin_version

设定最低版本支持，缺省 ssl3
Integer public static Integer max_versionmax_versionmax_version

设定最高版本支持，缺省 tls1_1

Method Summary

Type Method and Description
SslSocket new Socket()

创建一个 SslSocket 对象，参见 SslSocket
SslHandler new Handler()

创建一个 SslHandler 对象，参见 SslHandler
SslServer new Server()

创建一个 SslServer 对象，参见 SslServer
Stream connect(String url,Integer timeout)

创建一个 SslSocket 对象并建立连接
void setClientCert(X509Cert crt,PKey key)

设定缺省客户端证书
void loadClientCertFile(String crtFile,String keyFile,String password)

从文件中加载缺省客户端证书

Field Detail

VERIFY_NONE

const public const VERIFY_NONEVERIFY_NONEVERIFY_NONE

证书验证模式，不验证

VERIFY_OPTIONAL

const public const VERIFY_OPTIONALVERIFY_OPTIONALVERIFY_OPTIONAL

证书验证模式，可选验证，允许验证不通过

VERIFY_REQUIRED

const public const VERIFY_REQUIREDVERIFY_REQUIREDVERIFY_REQUIRED

证书验证模式，要求验证，验证不通过则中断

BADCERT_EXPIRED

const public const BADCERT_EXPIREDBADCERT_EXPIREDBADCERT_EXPIRED

证书验证结果，证书超时

BADCERT_REVOKED

const public const BADCERT_REVOKEDBADCERT_REVOKEDBADCERT_REVOKED

证书验证结果，证书被撤销

BADCERT_CN_MISMATCH

const public const BADCERT_CN_MISMATCHBADCERT_CN_MISMATCHBADCERT_CN_MISMATCH

证书验证结果，证书名错误

BADCERT_NOT_TRUSTED

const public const BADCERT_NOT_TRUSTEDBADCERT_NOT_TRUSTEDBADCERT_NOT_TRUSTED

证书验证结果，证书不可信

ssl3

const public const ssl3ssl3ssl3

ssl 协议版本 ssl 3.0

tls1

const public const tls1tls1tls1

ssl 协议版本 tls 1.0

tls1_1

const public const tls1_1tls1_1tls1_1

ssl 协议版本 tls 1.1

tls1_2

const public const tls1_2tls1_2tls1_2

ssl 协议版本 tls 1.2

ca

readonly X509Cert public static readonly X509Cert cacaca

全局证书，用于 ssl 客户端模式验证服务器证书

verification

Integer public static Integer verificationverificationverification

设定证书验证模式，缺省为 VERIFY_REQUIRED

min_version

Integer public static Integer min_versionmin_versionmin_version

设定最低版本支持，缺省 ssl3

max_version

Integer public static Integer max_versionmax_versionmax_version

设定最高版本支持，缺省 tls1_1

Method Detail

Socket

SslSocket new Socket()

创建一个 SslSocket 对象，参见 SslSocket

Handler

SslHandler new Handler()

创建一个 SslHandler 对象，参见 SslHandler

Server

SslServer new Server()

创建一个 SslServer 对象，参见 SslServer

connect

Stream connect(String url,Integer timeout)

创建一个 SslSocket 对象并建立连接

Parameters

  • url 指定连接的协议，可以是：ssl://host:port

  • timeout 指定超时时间，单位是毫秒，默认为0

Returns

返回连接成功的 SslSocket 对象

setClientCert

void setClientCert(X509Cert crt,PKey key)

设定缺省客户端证书

Parameters

  • crt X509Cert 证书，用于客户端验证服务器

  • key PKey 私钥，用于与客户端会话

loadClientCertFile

void loadClientCertFile(String crtFile,String keyFile,String password)

从文件中加载缺省客户端证书

Parameters

  • crtFile X509Cert 证书文件，用于客户端验证服务器

  • keyFile PKey 私钥文件，用于与客户端会话

  • password 解密密码