- 开发Actor协同模块; (参考TRSIDS4.0 协作应用集成手册【asp.net】)
- ASP.Net协作应用集成到IDS之前,需要开发Actor类实现协作应用回调接口中定义的本地登录、退出、用户信息同步等回调接口方法,协同IDS完成SSO.Actor类需要继承并重写实现抽象TRS.IDS.DotNetAgent.Actor.AbstractApplicationActor的各个方法,并且Actor开发工程必须引用TRSIDSAspDotNetAgent.dll.
根据实际情况覆盖重写上述方法,确定无误之后,生成一个CoApplication.dll,并将其放入TRSIDSAgent文件夹中,
- 配置TRSIDSAgent.ini文件
修改内容:该文件的有2部分需要根据实际情况做相应的处理和配置
1)IDS这部分属性的配置
##TRSIDS身份服务器后台SSLServer的主机名(就是你安装IDS系统的那台机器的IP)
TRSIDSHost=172.18.84.119
##TRSIDS身份服务器后台通信的端口,默认为2005(对应安装时IDS系统的端口)
TRSIDSPort=2005
2)协作应用(数图)属性【CoApplication】
##协作应用名.必填, 并且必须和身份服务器上注册的协作应用名保持一致(IDS后台应用名称一致)。
CoApplicationName=apabi
##是否允许匿名访问,y为允许,n为不允许
isAllowAnonymity=n
##协作应用用户注销后调转的页面链接,
如CoAppDefaultURL=http://192.9.200.134/aspnetdemo/index.aspx//
CoAppDefaultURL =http://172.18.84.61:8011/Usp
##协作应用的根URL,包括上下文,
如CoAppRootURL=http://127.0.0.1/aspnetdemo
CoAppRootURL = http://172.18.84.61:8011/usp
loginAction.uri=http://172.18.84.61:8011/Usp/TRSIDSAgent/URLValidation.aspx
- 部署安装TRS IDS的Agent
(1) 复制TRS IDS ASP.Net Agent安装介质中的TRSIDSAgent文件夹,到协作应用的根目录下。
(2)复制TRS IDS ASP.Net Agent安装介质中TRSIDSAgent子目录下的log4net.dll和TRSIDSAspDotNetAgent.dll到协作应用的bin目录下。
(3)如果你的项目中引用了log4net且版本高于TRSIDSAgent子目录下的log4net.dll,此时需要将TRSIDSAgent子目录下的log4net.dll替换原有的,添加引用到你的项目中
(4)把前面生成的CoApplication.dll文件,放置到该TRSIDSAgent文件夹中。
- 配置Web.config文件
由于IIS从7.0版本支持两种管道模式:一种是IIS 7.0最新提供的集成管道模式,另一种是经典管道模式,经典管道模式是由先前版本的IIS提供的。
因此TRSIDS ASP.NET Agent从4.0版本开始,不仅支持4.0版本以前版本的经典托管管道模式,而且支持集成托管管道模式。
(1) 经典托管管道模式
在 <system.web></system.web>节点下,添加如下<httpModules></httpModules>子节点。如下:
<system.web>
<httpModules>
<add type="TRS.IDS.DotNetAgent.TRSIDSHttpModule,TRSIDSAspDotNetAgent" name="TRSIDSHttpModule"/>
</httpModules>
</system.web>
如果Web.config文件中已经存在<httpModules></httpModules>子节点,则只需在该<httpModules></httpModules>节点下,添加<add>子节点即可。如下:
<httpModules>
<add type="TRS.IDS.DotNetAgent.TRSIDSHttpModule,TRSIDSAspDotNetAgent" name="TRSIDSHttpModule"/>
</httpModules>
(2) 集成托管管道模式
在 <system.web></system.web>节点下,将impersonate参数设置为false。如下:
<system.web>
<identity impersonate="false" />
</system.web>
在<system.webServer> </system.webServer>节点下,添加如下<modules> </modules>子节点。如下:
<system.webServer>
<modules>
<add type="TRS.IDS.DotNetAgent.TRSIDSHttpModule,TRSIDSAspDotNetAgent" name="TRSIDSHttpModule" />
</modules>
</system.webServer>
注:若从经典模式改为集成模式,需要将原先设置的<httpModules></httpModules>子节点删除。
-
配置日志输出文件
log4net.config控制TRS IDS ASP.Net Agent日志输出格式。您只需配置<file value="日志输出完整路径,包括日志文件名" />节点的值即可,该项用来指明运行日志输出的路径。如:
<file value="D:\asp.netdemo\TRSIDSAgent\log4net.log" />
若配置为<file value=" log4net.log"/>则默认在协作应用根目录下。(注意此处文件的路径根据实际情况做相应的处理,否则,生成的日志会出现在你想不到的地方 ps 开个玩笑)
2.IDS系统后台协作应用配置
注册协作应用
出于安全的考虑,只有在TRS IDS上注册了的协作应用才能够使用TRS IDS的服务。
注册的过程参见《TRSIDS4.0 管理员使用手册》添加协作应用有关内容。
注意:
1、 ASP.NET协作应用会话名称一般设置为:ASP.NET_SessionId。
2、 ASP.Net协作应用的“IDS请求URL”须指定为
应用根目录/TRSIDSAgent/URLValidation.aspx
如:http://192.9.200.249/demo/TRSIDSAgent/URLValidation.aspx。
另外:正确集成实现单点登录,需要在IDS管理台正确配置SSO URL。
SSO URL必须配置为与实际TRS IDS访问地址相符的URL,否则所有的应用都无法实现SSO。配置方法为:点击IDS系统菜单,然后点击设置,参考页面SSO URL配置说明,配置完成后系统会默认在后面加上/LoginServlet。