嵌入式 OpenSSL 常用函数——SSL/TLS编程

2019-07-12 20:40发布

SSL/TLS协议已经广泛应用于电子商务中, 用来保证信息传输的安全性。 利用OpenSSL进行了安全套接字编程和普通套接字编程类似。 主要函数 1、  初始化SSL算法库函数 IntSSL_Library_init(void); #defineOpenSSL_add_ssl_algorithms()            SSL_Library_init() #defineSSLeasy_add_ssl_algorithms()              SSL_Library_init() 功能:初始化SSL算法库函数, 调用SSL系列函数之前必须调用此函数。 返回值:1成功,0失败 2、  初始化SSL上下文环境变量函数 SSL_CTX*SSL_CTX_new(SSL_METHOD *meth); 功能:初始化SSL_CTX结构体, 设置SSL协议算法。 参数: SSLv2_server_method(void) SSLV2.0协议,用于服务器 SSLv2_client_method(void) SSLV2.0协议,用于客户端 SSLv3_server_method(void) SSLV3.0协议,用于服务器 SSLv3_client_method(void) SSLV3.0协议,用于客户端 SSLv23_server_method(void) SSLV3.0协议,用于服务器,支持2。0 SSLv23_client_method(void) SSLV3.0协议,用于客户端,支持2。0 TLSv1_server_method(void) SSLV2.0协议,用于服务器 TLSv1_client_method(void) TLSV1.0协议, 用于客户端   返回值:调用成功返回SSL_CTX结构体指针, 否则返回NULL 3、  释放SSL上下文环境变量函数 VoidSSL_CTX_free(SSL_CTX *ctx); 4、  设置SSL证书函数 IntSSL_CTX_use_certificate_file(SSL_CTX *ctx, const char *file, inttype); 功能:以文件的形式设置SSL证书。 对于服务器,用来设置服务器证书。对于客户端, 用来设置客户端证书。 参数:file:[IN]证书文件路径。 Type:[IN] 证书的编码类型。支持SSL_FILETYPE_PEM(PEM格式,即Base64编码格式的文件),SSL_FILETYPE_ASN1(ASN1格式,即DER编码的文件) 返回值:1成功。0失败。 5、  设置SSL私钥函数 IntSSL_CTX_use_PrivateKey_file(SSL_CTX *ctx, const char *file, inttype); 函数功能:以文件的形式设置SSL私钥。 6、  设置SSL证书函数 IntSSL_CTX_use_certificate(SSL_CTX *ctx, X509 *x); 功能:设置证书,功能和SSL_CTX_use_certificate_file函数一样。 7、  设置SSL私钥函数。 功能和SSL_CTX_use_PrivateKey_file函数一样 IntSSL_CTX_use_PrivateKey(SSL_CTX *ctx, EVP_PKEY *pkey); 8、  检查SSL私钥函数 IntSSL_CTX_check_private_key(const SSL_CTX *ctx); 功能:检查私钥, 检查私钥是否和证书匹配。此函数必须在设置了证书和私钥后才能调用。 9、  新建SSL句柄函数 SSL*SSL_new(SSL_CTX *ctx); 功能:为一个新SSL链接建立SSL*结构体变量。 10、              释放SSL句柄函数 Void SSL_free(SSL*ssl); 11、              设置socket句柄函数 Int SSL_set_fd(SSL*s, int fd); 功能:为SSL结构体设置socket句柄 参数:fd:[IN]socket链接句柄 12、              建立SSL链接 IntSSL_connect(SSL *ssl); 功能:建立SSL链接,用于客户端。 13、              接受SSL链接 Int SSL_accept(SSL*ssl); 14、              获得SSL链接使用的证书 X509*SSL_get_peer_certificate(const SSL *s); 返回值:操作成功返回X509证书,否则返回NULL。 15、              发送和读取SSL数据 Int SSL_write(SSL*ssl, const void *buf, int num); Int SSL_read(SSL*ssl, void *buf, int num); 返回值:返回实际读或写的数据长度。     注:上面资源大多源自《精通PKI网络安全论证技术与编程实现》一书。