北京信城通数码科技有限公司
2.3 接口说明
2.3.1 函数说明 2.3.1.1 类 AuthBroker
java.lang.Object
cn.itownet.sdk.cas.AuthBroker 所有已实现的接口:
AuthBrokerIF
方法摘要 static AuthBrokerIF loginCheck(HttpServletRequest request, HttpServletResponse response) 验证用户登录令牌,如果没有发现令牌,则重定向到门户进行登录, 登录成功后,再重新返回到本接口。 static AuthBrokerIF tokenCheck(HttpServletRequest request, HttpServletResponse response) 验证目前已经登录用户的令牌是否继续有效,当用户重新登录后,前次登录令牌将失效。 表3.1-1 2.3.1.1.1 loginCheck
public static final AuthBrokerIF loginCheck(HttpServletRequest request, HttpServletResponse response) throws java.lang.Exception
验证用户登录令牌,如果没有发现令牌,则重定向到门户进行登录, 登录成功后,再重新返回到本接口。 参数:
request - http请求对象 response - http响应对象
返回:
-如果验证成功,返回AuthBrokerIF实例,可以取相应的属性。 -如果为null,表示需要进行重定向,调用者只需返回即可。 -Exception,表示验证错误,不需要继续处理。
抛出:
CAS6.0认证服务器-接口使用手册-V2.0 第 11 页 共 35 页
北京信城通数码科技有限公司
java.lang.Exception
2.3.1.1.2 tokenCheck
public static final AuthBrokerIF tokenCheck(HttpServletRequest request, HttpServletResponse response) throws java.lang.Exception
验证目前已经登录用户的令牌是否继续有效,当用户重新登录后,前次登录令牌将失效。 参数:
request - http请求对象 response - http响应对象
返回:
-如果验证成功,返回AuthBrokerIF实例,可以取相应的属性。
-Exception,表示验证错误,说明本令牌已经失效,或没有找到令牌,可以进行错误处理。
抛出:
java.lang.Exception
2.3.1.2 接口 AuthBrokerIF
所有已知实现类: AuthBroker
public interface AuthBrokerIF
方法摘要 getC() java.lang.String get subject's country getCN() java.lang.String get subject's commonName getDN() java.lang.String get subject's DN getEntityID() java.lang.String get subject's entityID getL() java.lang.String get subject's locality getO() java.lang.String get subject's orgnization getOs() CAS6.0认证服务器-接口使用手册-V2.0 第 12 页 共 35 页
北京信城通数码科技有限公司
java.util.Vector get subject's orgnizations getOU() java.lang.String get subject's orgnizationUnit getOUs() java.util.Vector get subject's orgnizationUnits getSN() java.lang.String get certificate's serialNumber getSN0() java.lang.String 已过时。 getST() java.lang.String get subject's stateOrProvince 表3.1-2 2.3.1.2.1 getC
java.lang.String getC()
get subject's country
返回: country code
2.3.1.2.2 getST
java.lang.String getST()
get subject's stateOrProvince
返回: stateOrProvince
2.3.1.2.3 getL
java.lang.String getL()
get subject's locality
返回: city
2.3.1.2.4 getO
java.lang.String getO()
get subject's orgnization
返回:
CAS6.0认证服务器-接口使用手册-V2.0 第 13 页 共 35 页
北京信城通数码科技有限公司
orgnization
2.3.1.2.5 getOs
java.util.Vector getOs()
get subject's orgnizations
返回: all orgnizations
2.3.1.2.6 getOU
java.lang.String getOU()
get subject's orgnizationUnit
返回: orgnizationUnit
2.3.1.2.7 getOUs
java.util.Vector getOUs()
get subject's orgnizationUnits
返回:
all orgnizationUnits
2.3.1.2.8 getCN
java.lang.String getCN()
get subject's commonName
返回: common name
2.3.1.2.9 getDN
java.lang.String getDN()
get subject's DN
返回: distinguish name
2.3.1.2.10 getSN0
java.lang.String getSN0() 已过时。
CAS6.0认证服务器-接口使用手册-V2.0 第 14 页 共 35 页
北京信城通数码科技有限公司
Warning, deprecated, please use getEntiryID 返回: entity id
2.3.1.2.11 getSN
java.lang.String getSN()
get certificate's serialNumber
返回:
cert serial number
2.3.1.2.12 getEntityID
java.lang.String getEntityID()
get subject's entityID
返回: entity id
2.3.2 使用示例
import java.io.IOException; import java.io.PrintWriter;
import javax.servlet.ServletException;
import javax.servlet.http.HttpServletRequest; import javax.servlet.http.HttpServletResponse; /**
* Servlet implementation class for Servlet: RedirectTestServlet *
* @web.servlet name=\ display-name=\ *
* @web.servlet-mapping url-pattern=\ * */
public class RedirectTestServlet extends javax.servlet.http.HttpServlet
implements javax.servlet.Servlet { /*
CAS6.0认证服务器-接口使用手册-V2.0 第 15 页 共 35 页