QoderWake加密通信设置：在公网环境下配置SSL加密传输

QoderWake公网SSL加密配置有四种方法：一、Nginx反向代理TLS终止；二、服务端直连启用TLS；三、SASL_SSL增强认证与加密；四、国密GMSSL适配信创环境。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如果您在公网环境下使用QoderWake服务，但通信数据以明文方式传输，则存在被监听、篡改或中间人攻击的风险。以下是为QoderWake配置SSL加密传输的多种可行方法：

一、通过Nginx反向代理启用TLS终止

该方法将SSL/TLS解密操作卸载到Nginx层，QoderWake后端仍以HTTP方式运行，降低服务改造复杂度，同时获得浏览器级信任链和自动证书续期能力。

1、确保QoderWake已部署并可通过http://127.0.0.1:8080正常访问。

2、安装Nginx与certbot：sudo apt update && sudo apt install nginx python3-certbot-nginx（Ubuntu/Debian）。

3、配置Nginx站点文件，将server_name替换为您的已备案域名，例如qoderwake.example.com。

4、执行sudo certbot --nginx -d qoderwake.example.com，按提示完成域名所有权验证及证书自动部署。

5、确认Nginx配置中包含proxy_pass http://127.0.0.1:8080;，且所有location块均启用proxy_set_header传递原始协议头。

6、重启Nginx：sudo systemctl restart nginx，随后访问https://qoderwake.example.com验证HTTPS生效。

二、在QoderWake服务端直连启用TLS

该方法使QoderWake自身直接处理TLS握手与加解密，适用于无法部署反向代理或需端到端加密审计的场景，要求服务支持自定义SSL上下文配置。

1、生成TLS证书对：openssl req -x509 -newkey rsa:4096 -nodes -out fullchain.pem -keyout privkey.pem -days 365。

2、将fullchain.pem与privkey.pem放置于QoderWake可读路径，如/etc/qoderwake/ssl/。

3、修改QoderWake启动参数或配置文件，启用HTTPS模式，并指定证书路径：--https-enabled true --cert-file /etc/qoderwake/ssl/fullchain.pem --key-file /etc/qoderwake/ssl/privkey.pem --https-port 443。

4、确保防火墙放行443端口：sudo ufw allow 443。

5、重启QoderWake服务，使用curl -I https://qoderwake.example.com检查响应头中是否含HTTP/2及有效证书信息。

QoderWake

阿里巴巴Qoder平台推出的全天候AI数字员工

下载

三、采用SASL_SSL机制增强身份认证与信道加密

该方法在TLS加密基础上叠加SASL（Simple Authentication and Security Layer）认证，适用于需对接Kafka等消息中间件或要求双向身份核验的公网集成场景。

1、为QoderWake配置SASL用户凭证，创建sasl_users.txt文件并使用scram-sha-256哈希存储凭据。

2、启用SASL_SSL支持模块，确保Java环境已安装JCE Unlimited Strength策略文件（若使用Java版QoderWake）。

3、在客户端连接字符串中显式声明安全协议：SASL_SSL://qoderwake.example.com:9093。

4、配置客户端JAAS文件，指定org.apache.kafka.common.security.scram.ScramLoginModule及对应用户名密码。

5、启动QoderWake时加载JAAS配置：KAFKA_OPTS="-Djava.security.auth.login.config=/path/to/kafka_client_jaas.conf"。

6、验证连接日志中出现Authenticated principal与SSL handshake completed双重成功标识。

四、使用国密GMSSL协议适配信创环境

该方法专用于满足国产密码合规要求的政务、金融等信创场景，采用SM2签名+SM4加密套件，需服务端与客户端同步支持GMSSL扩展。

1、申请符合GM/T 0015-2012标准的SM2国密证书，获取签名证书、加密证书及对应SM2私钥文件。

2、编译支持OpenSSL国密引擎的QoderWake运行时，或使用已内置GMSSL支持的发行版（如OpenEuler 22.03 LTS SP3）。

3、配置服务端启用TLCP协议栈，在启动参数中添加：--tls-protocol TLCP --sm2-cert /etc/qoderwake/sm2_sign.crt --sm4-key /etc/qoderwake/sm4.key。

4、确保客户端使用兼容GMSSL的SDK（如BabaSSL或国密版OkHttp），并设置SSLSocketFactory加载SM2信任库。

5、通过openssl s_client -connect qoderwake.example.com:443 -tlcp命令验证TLCP握手是否成功建立。