当需要使用OpenSSL配置文件调用KAE时,需要在配置文件openssl.cnf中添加KAE相关配置参数。通过配置文件方式使用KAE,可以使用户的APP在非常小的修改量情况下使用加速器功能。
如下所示,仅需调用一次此初始化API即可完成相应的配置工作:
OPENSSL_init_crypto(OPENSSL_INIT_LOAD_CONFIG, NULL); //加载配置文件并初始化
若加解密库为Tongsuo,使用方法和OpenSSL一致。
如果用到openssl req -new -x509命令生成证书功能,请参见使用openssl req -new -x509命令生成证书失败中的方法二完成openssl.cnf文件的配置。
新建openssl.cnf需要添加如下配置信息。
openssl_conf=openssl_def [openssl_def] engines=engine_section [engine_section] kae=kae_section [kae_section] engine_id=kae #openssl版本为1.1.1x dynamic_path=/usr/local/lib/engines-1.1/kae.so #openssl版本为3.0.x设置为如下路径 #dynamic_path=/usr/local/lib/engines-3.0/kae.so KAE_CMD_ENABLE_ASYNC=1 KAE_CMD_ENABLE_SM3=1 KAE_CMD_ENABLE_SM4=1 default_algorithms=ALL init=1
设置OPENSSL_CONF环境变量:
1 | export OPENSSL_CONF=/home/app/openssl.cnf #该路径为openssl.cnf存放路径 |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 | #include <stdio.h> #include <stdlib.h> /* OpenSSL headers */ #include <openssl/bio.h> #include <openssl/err.h> #include <openssl/engine.h> int main(int argc, char **argv) { /* Initializing OpenSSL */ ERR_load_BIO_strings(); /* Load openssl configure */ OPENSSL_init_crypto(OPENSSL_INIT_LOAD_CONFIG, NULL); ENGINE *e = ENGINE_by_id("kae"); /*指定KAE加速引擎用于RSA加解密,如果初始时使用ENGINE_set_default_RSA(ENGINE *e);则无需传入e*/ RSA *rsa = RSA_new_method(e); /*The user code*/ …… ENGINE_free(e); } |