OneLogin SP配置下RelayState参数位置及配置问题咨询

1. RelayState参数的配置位置 #

你在onelogin.saml.properties里找不到RelayState配置是正常的，这个参数本身就不是静态写在properties配置文件里的，分两种场景对应不同的配置位置：

• SP发起SSO的场景：RelayState是发起认证请求时动态传入的参数，不属于全局固定配置。使用官方Java SDK时，在调用生成SAML AuthnRequest的方法时直接传入目标RelayState值即可，SDK会自动完成参数编码、拼接，IdP认证完成后会原样回传该值，SDK解析SAML响应时也会自动提取这个参数，不需要提前在properties里做映射。
• IdP发起SSO的场景：RelayState配置在OneLogin管理后台的应用维度配置里，进入对应SAML应用的Configuration配置页，在ACS URL配置的同区块就能找到RelayState输入框，这里填写的值就是IdP侧发起SSO请求时默认携带的RelayState值。

2. RelayState的自定义修改与禁用支持 #

• 自定义修改完全支持：SP发起SSO时，你可以根据业务场景动态传入任意合法的RelayState值（比如用户发起认证前访问的业务页面路径，用来做认证后的无感跳转），只要符合SAML规范的长度要求（建议不超过80字节，避免被部分IdP截断）即可，不需要修改任何properties配置；IdP发起SSO的场景，直接修改后台应用配置页里RelayState输入框的内容保存就生效，支持填写任意站内有效跳转路径。
• 支持禁用RelayState：RelayState是SAML 2.0规范里的可选参数，没有强制携带要求。SP发起流程时，调用SDK生成认证请求的方法时不传RelayState参数，最终生成的SAML请求里就不会携带该字段；IdP发起流程时，把OneLogin后台对应应用配置里的RelayState输入框清空保存，IdP发起请求时就不会附带这个参数。

注意：如果你的业务代码里写了依赖RelayState的跳转校验、状态校验逻辑，禁用前要先调整对应逻辑，避免出现认证后跳转失败、校验报错的问题。

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