应用系统接入接口开发

根据上面的接口交互描述，我们可以看到，应用系统要接入单点登录系统，实现通行证机制，主要要实现以下接口功能。

用户身份认证

检查用户是否为合法用户，否则，向Service认证中心发送认证请求。

这里用了一个页面基类来实现身份验证的功能，所有需要做验证的页面，只需要继承该类即可，当然，也可以用这个代码实现一个用户自定义控件，放到需要做验证的页面上即可。

 

//<summary>

//====================

//应用系统验证（页面）的基类

//====================

//</summary>

publicclass ValidatePageBase : System.Web.UI.Page

{

    protected override void OnInit(EventArgs e)

    {

        base.OnInit(e);

        CustomerValidate();

    }

    public void CustomerValidate()

{

      bool Pass =(bool)Session["Pass"];//当前状态

      if (!Pass)

      {

            string Security =Assistant.GetSecurity();//安全码

            Session["Security"] =Security;

            Session["ReturnUrl"] =Request.RawUrl;//要访问的页面    

 

            //分配给当前应用系统的API代码

            string apikey =Assistant.GetConfigString("apikey");

            //认证服务器验证地址

            string posturl =Assistant.GetConfigString("ServiceValidate");

            posturl = UrlOper.AddParam(posturl,"apikey", apikey);

            posturl = UrlOper.AddParam(posturl,"security", Security);

            //向认证服务器发送验证请求

            Response.Redirect(posturl);

      }

}   

}

接收状态同步

在认证服务器确认用户身份通过后，调用该接口更新当前应用系统用户状态。应用系统接收这些参数，进行校验处理后，更新本地的用户状态。

 

//<summary>

//====================

// （接收）状态同步页面的基类

//====================

//</summary>

publicclass SynPageBase : System.Web.UI.Page

{

    #region 获取参数

    // <summary>

    // 接收本地应用系统的UserName

    // </summary>

    public virtual string InUserName

    {

        get

        {

            if ((Request["un"] !=null) && (Request["un"].ToString() != ""))

            {

                returnRequest["un"].Trim();

            }

            return "";

        }

    }

    // <summary>

    // 接收登录标志Pass

    // </summary>

    public virtual string InPass

    {

        get

        {

            if ((Request["pass"] !=null) && (Request["pass"].ToString() != ""))

            {

                returnRequest["pass"].Trim();

            }

            return "";

        }

    }

    // <summary>

    // 接收安全码Security

    // </summary>

    public virtual string InSecurity

    {

        get

        {

            if ((Request["security"]!= null) &&

                (Request["security"].ToString()!= ""))

            {

                returnRequest["security"].Trim();

            }

            return "";

        }

    }

    #endregion

    protected override void OnInit(EventArgs e)

    {

        base.OnInit(e);

        CustomerValidate();

    }

    protected virtual void CustomerValidate()

    {

        string Security =Session["Security"].ToString();

        if (Security != "")

        {

            //安全码校验是否一致

            if(Assistant.HashEncoding(Security) == InSecurity)

            {

                if (InPass.ToLower() =="true") //登录状态是否登录

                {

                    根据InUserName，进行直接登录///

                   //FormsAuthentication.SetAuthCookie(InUserName, false);

                   Session["UserName"] = InUserName;

                    Session["Pass"] =true;

                   ///

                    //返回认证前要访问的地址

                   Response.Redirect(Session["ReturnUrl"].ToString());

                }

            }

            else //请求和应答的安全码是不匹配的

            {

                Response.Write("数据不一致错误！");

            }

        }

        else

        {

            if (Session["ReturnUrl"]!= null &&

                Session["ReturnUrl"].ToString()!= "")

            {

               Response.Redirect(Session["ReturnUrl"].ToString());

            }

           Response.Redirect("index.aspx");

        }

    }      

}

用户注销

通过执行Logout.aspx页面，实现退出当前应用系统的登录。认证服务中心注销时即调用该页面。

 

publicpartial class Logout : System.Web.UI.Page

{

    protected override void OnInit(EventArgs e)

    {

        base.OnInit(e);

        ClearSession();

    }

    private void ClearSession()

    {

        Session.Clear();

        Session.Abandon();       

    }

}

需要说明的是，只退出当前应用的登录是不起作用的，需要把Service认证中心的登录信息注销才可以。若要注销所有应用中的登录信息，只需要转到Service认证中心的注销页即可。例如：

Response.Redirect(ConfigurationSettings.AppSettings["ServiceUrl"]+

  "/logout.aspx");

更新认证服务器状态

我们知道，页面在一段时间内不刷新，Session就会超时失效，在我们一直访问应用系统（如Blog或BBS）的时候，怎么才能保证Service的Session不会失效呢？很简单，我们可以通过不断调用Service认证服务器的页面来保持Session有效。通过在应用系统（如Blog或BBS）所有的页面内都用＜iframe＞的方式嵌套Service认证服务器的某个页面，就能保证Service和应用系统（如Blog或BBS）的页面同时刷新。需要注意的一点是，Service的Session必须大于所有应用系统（如Blog或BBS）的Session超时时间，这个可以在Web.config里进行配置。

我们可以用这段＜iframe＞代码实现一个用户控件方式，放到所有的页面会更容易维护。页面代码如下：

<%@ Control Language="C#"AutoEventWireup="true" CodeBehind=

      "SynServerIFrame.ascx.cs"Inherits="Blog.SynServerIFrame" %>

<iframewidth=0 height=0 src='<%=ServiceUrl%>/SessionState.aspx'></iframe>

C#代码如下：

publicpartial class SynServerIFrame : System.Web.UI.UserControl

{

    public string ServiceUrl=ConfigurationSettings.AppSettings["ServiceUrl"];

}

通过实现以上接口和代码，我们的应用系统就已经支持单点登录功能了。我们可以运行测试，直接访问应用系统的页面，会自动转到Service认证服务器进行登录。一旦登录成功，则访问任何一个系统System内的应用系统都将不再需要任何登录，并且不管有多少个网站应用，只要这些网站系统都符合接口标准，则这些网站就都能保持Service的用户状态，同时能通过Service获得用户的状态，而不需要再登录。也就是说，我们实现了SSO（单点登录）。

 

 

本文节选自《项目中的.NET》一书

李天平 编著

电子工业出版社出版