应用系统接入接口开发

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

用户身份认证

检查用户是否为合法用户,否则,向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》一书

李天平 编著

电子工业出版社出版

你可能感兴趣的:(接口)