如何配置ASP.NET应用使用Sustainsys.Saml2对接Okta实现SAML单点登录
Sustainsys.Saml2.HttpModule 对接 Okta 最小化 web.config 示例
前置准备
- 已将从Okta下载的X509证书上传到站点的
App_Data目录,或转换为Base64编码格式备用 - 已确认项目已通过Nuget安装2.8.0版本的
Sustainsys.Saml2和Sustainsys.Saml2.HttpModule包
完整最小配置示例
<?xml version="1.0" encoding="utf-8"?> <configuration> <!-- 第一步:注册Saml2配置节 --> <configSections> <section name="sustainsys.saml2" type="Sustainsys.Saml2.Configuration.SustainsysSaml2Section, Sustainsys.Saml2" /> </configSections> <system.web> <compilation debug="true" targetFramework="4.7.2" /> <httpRuntime targetFramework="4.7.2" /> <!-- 启用Forms身份验证 --> <authentication mode="Forms" /> </system.web> <system.webServer> <!-- 第二步:注册Saml2 HttpModule --> <modules> <add name="SustainsysSaml2" type="Sustainsys.Saml2.HttpModule.Saml2AuthenticationModule, Sustainsys.Saml2.HttpModule" preCondition="managedHandler" /> </modules> </system.webServer> <!-- 第三步:Saml2核心配置 --> <sustainsys.saml2 entityId="https://localhost:44334/Saml2" returnUrl="https://localhost:44334/"> <identityProviders> <add entityId="替换为你获取的Okta身份提供商Issuer" signOnUrl="替换为你获取的Okta单点登录URL" allowUnsolicitedAuthnResponse="true" binding="HttpRedirect"> <!-- 两种证书配置方式二选一即可 --> <!-- 方式1:直接引用App_Data下的证书文件 --> <signingCertificate fileName="~/App_Data/替换为你的Okta证书文件名.cer" /> <!-- 方式2:直接填写证书Base64内容 --> <!-- <signingCertificate base64Encoded="替换为你转换后的证书Base64内容" /> --> </add> </identityProviders> <!-- 配置Name ID格式为x509SubjectName --> <nameIdPolicy allowCreate="true" format="urn:oasis:names:tc:SAML:1.1:nameid-format:x509SubjectName" /> </sustainsys.saml2> </configuration>
配置说明
- 配置中的
entityId对应你提供的受众限制参数,Acs路径为组件内置的https://localhost:44334/Saml2/Acs,均无需额外修改 returnUrl为用户SSO登录成功后默认跳转的站点首页地址,可根据实际业务需求调整- 无需额外编写业务代码,配置完成后访问站点受保护资源会自动跳转至Okta登录页
内容的提问来源于stack exchange,提问作者Steve Rogers
相关产品推荐
相关产品推荐

