WSO2 Identity Server三步认证配置异常求助：账号密码→SMS OTP→Email OTP

核心配置修正 #

1. 调整服务提供商的认证步骤配置 #

• 在服务提供商的本地与出站认证配置中，严格按以下逻辑设置三步认证：
  1. 第一步选择Basic Authenticator（账号密码认证），设置为必填
  2. 第二步选择SMS OTP Authenticator，设置为必填，同时开启Subject Identifier Step（确保该步骤完成后传递用户主体到下一步）
  3. 第三步选择Email OTP Authenticator，设置为必填，同样开启Subject Identifier Step
• 注意：所有步骤必须设为强制认证，不能选可选，否则系统会跳过后续步骤

2. 检查身份提供商的OTP配置 #

• 针对SMS和Email OTP身份提供商，确认以下项：
  • 已正确配置短信网关/邮件服务器的连接参数（如API密钥、SMTP地址等）
  • OTP生成规则（长度、有效期）无冲突，验证逻辑正常
  • 两个OTP认证器的User Store Claim分别指向正确的用户属性（短信对应mobile，邮箱对应email）

3. 修复commonauth空白页问题 #

空白页一般由认证会话传递异常导致，按以下操作修复：

• 打开<IS_HOME>/repository/conf/deployment.toml，添加或修改配置：

  [authentication.session]
  enable_session_persistence = true
  session_timeout = 1800
  

• 重启WSO2 IS服务，清除浏览器缓存后重新测试

4. 验证自定义认证脚本（若有） #

如果使用了自定义认证脚本，检查是否存在跳过后续步骤的逻辑：

• 登录管理控制台，进入Identity > Authentication > Scripts
• 查看关联该服务提供商的认证脚本，确保没有在完成前两步后直接返回认证成功的代码

测试流程 #

1. 访问服务提供商登录入口，输入账号密码完成第一步
2. 输入收到的SMS OTP完成第二步
3. 输入收到的Email OTP完成第三步，确认成功跳转到目标应用

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