You need to enable JavaScript to run this app. 如何配置ASP.NET应用使用Sustainsys.Saml2对接Okta实现SAML单点登录
优惠活动
大模型
产品
解决方案
定价
更多

如何配置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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.16 07:45:07