集成OIDC中间件后NodeJS HTTPS服务报ERR_SSL_VERSION_OR_CIPHER_MISMATCH

问题诱因 #

• TLS版本不兼容：OKTA OIDC规范强制要求通信使用TLS 1.2及以上版本，若NodeJS HTTPS服务未显式指定最低TLS版本，旧版Node默认启用的低版本TLS协议会被OIDC中间件拦截，触发不匹配错误
• 密码套件不符合安全要求：OKTA侧禁止使用弱加密套件，若HTTPS服务配置的cipher列表包含过时的弱加密算法，会被OIDC中间件的安全校验拒绝
• 证书合规性不足：本地开发常用的自签名证书如果使用SHA1哈希、RSA密钥长度低于2048位，会不符合OIDC的证书校验规则，触发SSL错误
• Node版本过低：12.x以下的NodeJS版本默认TLS配置未适配现代加密规范，和OKTA OIDC的安全要求不兼容

排查步骤 #

• 第一步：显式指定HTTPS服务的最低TLS版本，配置示例如下：

const https = require('https');
const fs = require('fs');

const options = {
  key: fs.readFileSync('server-key.pem'),
  cert: fs.readFileSync('server-cert.pem'),
  // 新增TLS版本限制配置
  minVersion: 'TLSv1.2',
  maxVersion: 'TLSv1.3'
};

https.createServer(options, (req, res) => {
  res.writeHead(200);
  res.end('service running\n');
}).listen(443);

• 第二步：配置符合安全规范的加密套件，在HTTPS启动参数中加入ciphers字段，取值为现代加密套件列表：
  ciphers: 'ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305:DHE-RSA-AES128-GCM-SHA256:DHE-RSA-AES256-GCM-SHA384'
• 第三步：校验证书合规性，确认所用证书的哈希算法为SHA256及以上、RSA密钥长度≥2048位；仅开发环境可临时设置环境变量NODE_TLS_REJECT_UNAUTHORIZED=0跳过证书校验，生产环境禁止使用该配置
• 第四步：核对OIDC中间件配置，确认issuer字段为OKTA分配的正确域名，重定向URI协议为HTTPS，且域名、端口与实际启动的Node服务完全一致
• 第五步：检查NodeJS版本，建议升级到14.x及以上的LTS版本，避免旧版本默认加密配置不兼容的问题

内容的提问来源于stack exchange，提问作者creativated