.NET应用和AEAI CAS集成详解

1 概述

数通畅联某综合SOA集成项目的统一身份认证工作，需要第三方系统配合进行单点登录的配置改造，在项目中有需要进行单点登录配置的.NET应用系统，本文专门记录.NET应用和AEAI CAS的集成过程步骤，为后续类似的统一认证配置实现提供参考指导。

2 预期读者

数通畅联新员工 

广大技术爱好者

3 环境信息

操作系统：Windows Server 2008

第三方系统.NET Framework 版本：V4.0

4 名词解释

AEAI CAS：是数通畅联基于开源Jasig CAS扩展开发提供的统一认证平台，经过多年的实践和积累，通过提供统一的认证服务、授权服务、集中管理用户信息；AEAI CAS统一身份认证平台功能包括：账号同步模块及接口、单点登录客户端配置、账号密码管理功能。AEAI CAS的功能架构如下图：

.Net: .NET是微软的新一代技术平台，为敏捷商务构建互联互通的应用系统，这些系统是基于标准的，联通的，适应变化的，稳定的和高性能的。从技术的角度，一个.NET应用是一个运行于.NET Framework之上的应用程序。如果一个应用程序跟.NET Framework无关，它就不能叫做.NET程序。比如，仅仅使用了XML并不就是.NET应用，仅仅使用SOAP SDK调用一个Web Service也不是.NET应用。.NET是基于Windows操作系统运行的操作平台，应用于互联网的分布式。

5 配置过程

5.1 添加动态链接库

在进行CAS认证配置前，需要先添加CAS 的客户端文件即相关的动态链接库.dll文件，放置于.NET应用的bin目录，如下图：

5.2 配置web.config

在修改web.config文件之前，先了解web.config文件中一些标签的含义。

5.2.1 web.config详解

Web.config 文件是一个XML文本文件，它用来储存 ASP.NET Web 应用程序的配置信息（如最常用的设置ASP.NET Web 应用程序的身份验证方式），它可以出现在应用程序的每一个目录中。当你通过.NET新建一个Web应用程序后，默认情况下会在根目录自动创建一个默认的Web.config文件，包括默认的配置设置，所有的子目录都继承它的配置设置。如果你想修改子目录的配置设置，你可以在该子目录下新建一个Web.config文件。它可以提供除从父目录继承的配置信息以外的配置信息，也可以重写或修改父目录中定义的设置。

1.web.config

是以XML文件规范存储,配置文件分为以下格式:

a)configSections 位于配置文件的顶部配置节处理程序声明；

b)appSetting 可以定义应用程序的全局常量设置等信息；

c)system.Web 控制Asp.net运行时的行为；

d)sectionGroup 可以自定义分组，可以放到内部或其它标记的内部；

2.配置节的每一节

a)configuration 根元素，其它节都是在它的内部.

b)appSetting 此节用于定义应用程序设置项。

对一些不确定设置，还可以让用户根据自己实际情况自己设置  例如：

c)compilation

d)customErrors

e)globalization

f)sessionState

g) authentication

3.重点节点

a)authentication

作用：配置 ASP.NET 身份验证支持（为Windows、Forms、PassPort、None四种）。该元素只能在计算机、站点或应用程序级别声明。

< authentication> 元素必需与 节配合使用。

示例：以下示例为基于窗体（Forms）的身份验证配置站点，当没有登陆的用户访问需要身份验证的网页，网页自动跳转到登陆网页。

b)authorization

作用：控制对 URL 资源的客户端访问（如允许匿名用户访问）。此元素可以在任何级别（计算机、站点、应用程序、子目录或页）上声明。必需与 节配合使用。 示例：以下示例禁止匿名用户的访问

c)sessionState

为当前应用程序配置会话状态设置（如设置是否启用会话状态，会话状态保存位置）。

5.2.2 CAS配置具体步骤

在web.config中添加CAS的相关配置信息 1.首先在configSections节下添加配置信息

2.然后在根节点configuration下添加

3.然后进行Forms的认证配置

4.然后在system.webServer下的modules节点下添加

5.最后在httpModules节下添加

5.2.3 相关问题及解决办法 

问题一：配置后，经过单点登录的拦截遇到循环重定向问题 解决：

1.去掉authentication 下forms元素的path属性（无效）

2.sessionState属性配置调整（无效）

3.放入测试Default/Master页面等

4.deployContext.xml要添加allowedToProxy="true"属性，但是服务器仍然有问题。

问题原因：原来是认证过程中cas服务器端也要请求cas客户端，类似双向握手；把认证的地址改为配置的serverName改为外网地址，而不是localhost就可以了，因为如果是localhost，在正式服务器上的cas服务器端就找不到cas客户端了。 

问题二：登录系统时的URL后需要添加“/”才能进入，否则出现循环重定向的问题 解决：去掉path属性解决问题

5.3 C#获取认证用户

统一身份认证配置完毕后需要，需要在.NET的C#中获取登录用户名，可以采用如下方式来获取： string userName = HttpContext.Current.User.Identity.Name;

6 相关说明

6.1 参考链接 1

.web.config详解参考 http://www.cnblogs.com/doublemm/archive/2011/08/25/2153235.html

2.sessionState属性详解 http://www.cnblogs.com/xinhaijulan/archive/2010/08/21/1805116.html

6.2 附件说明

附件为配置所需动态链接库文件、完整的web.config样例文件以及样例工程用于参考，其中：DotNetCasClient是CAS的的C#工程，ExampleWebSite是样例工程，对应实际项目。

文档及附件下载