cas-server之认证核心接口AuthenticationManager

该接口是cas-server认证入口,但从唯一实现类来看,它并不是认证执行者,执行者是AuthenticationHandler,该接口控制认证流程,包括异常处理和结果封装,将认证结果封装成Authentication返回。

public interface AuthenticationManager {
     //有一个Credential认证成功返回Authentication,所有Credential都认证失败抛出AuthenticationException
    Authentication authenticate(AuthenticationTransaction authenticationTransaction) throws AuthenticationException;
}

唯一实现PolicyBasedAuthenticationManager

核心代码

AuthenticationBuilder builder = new DefaultAuthenticationBuilder(NullPrincipal.getInstance());
builder.addCredential(new BasicCredentialMetaData(credential));
//执行认证
HandlerResult result = authenticationHandler.authenticate(credential);
//一个credential认证成功
builder.addSuccess(authenticationHandler.getName(), result);
//一个credential认证失败
builder.addFailure(authenticationHandler.getName(), e.getClass());

//credential解析,Principal才是客户真正需要的
Principal principal = principalResolver.resolve(credential);
builder.setPrincipal(principal);

//构建authentication  
Authentication authentication  = builder.build();

//那些情况抛出AuthenticationException?
//一个credential都没认证成功
if (builder.getSuccesses().isEmpty()) {
  throw new AuthenticationException(builder.getFailures(), builder.getSuccesses());
 }
//不满足认证安全策略
if (!this.authenticationPolicy.isSatisfiedBy(builder.build())) {
    throw new AuthenticationException(builder.getFailures(), builder.getSuccesses());
}
//空Principal
if (principal instanceof NullPrincipal) {
    throw new UnresolvedPrincipalException(authentication);
 }

相关接口

Principal

客户端拿着serviceTicket来验证时,验证通过,服务器会返回一个Principal实现,默认只返回Principal的id,也可以附带返回attributes,需要自己修改xml(jsp)

  • SimplePrincipal
    简单实现,有id和attributes,没有其他东西
  • NullPrincipal
    一个空实现,id固定为字符串nobody,attributes为一个EmptyMap实例
  • WebApplicationService
    这个实现Principal比较奇怪,跟Principal的含义没半毛钱关系,只是要用到id属性,关于WebApplicationService 后面再写

Credential

可以把它看成用户登录时输入登录信息的实体,实际上它就是表示这个意思。看看实现就知道了

  • UsernamePasswordCredential
    包含username、password基本的登录信息,系统默认用这个,可看WEB-INF/webflow/login/login-webflow.xml
  • RememberMeUsernamePasswordCredential
    继承UsernamePasswordCredential ,增加了rememberMe,是不是登录时候的那些东西
  • BasicIdentifiableCredential
    这个更简洁,只有一个id属性,系统没有那个地方用到它
  • OneTimePasswordCredential
    一次性密码,系统也没有地方使用
  • HttpBasedServiceCredential
    通过回调callbackUrl来验证,回调成功表示验证通过,该Credential 绑定了关联的registeredService,getId返回的是callbackUrl字符串。

AuthenticationHandler

认证的执行者,类似dao,会跟数据源打交道

  • HttpBasedServiceCredentialsAuthenticationHandler
    代理认证,用于HttpBasedServiceCredential认证,里面有一个HttpClient(注入),当RegisteredService的ProxyPolicy接受CallbackUrl且HttpClient请求CallbackUrl成功(返回指定的code)表示认证通过
  • AbstractUsernamePasswordAuthenticationHandler
    抽象类,用于UsernamePasswordCredential的认证,子类一般会使用外部数据源查库,如使用JDBC,只需依赖cas-server-support-jdbc支持。
  • JaasAuthenticationHandler
    使用JAAS认证,用的不多,具体配置可以看源码
  • AcceptUsersAuthenticationHandler
    接受一个静态的用户数据验证,默认去cas.properties中accept.authn.users值进行校验,系统默认用这种方式,实际中肯定要换成第三方数据源的。

PrincipalResolver

从给定的credential解析出一个Principal

  • PersonDirectoryPrincipalResolver
    使用Jasig Person Directory库解析,当客户端除了需要id外,还需要更多的用户属性时,推荐使用这个。通过使用IPersonAttributeDao返回Map<String, List<Object>>里面可存放关联的属性。默认的实现StubPersonAttributeDao只是简单的维护了一个静态backingMap,实际中建议连接数据源进行动态查询,具体可看IPersonAttributeDao实现。
  • BasicPrincipalResolver
    解析工作完全委托给PrincipalFactory,自己什么也不做

AuthenticationPolicy

安全策略检查,相当于这里设置最后一道关卡,检查Authentication的合法性,如果没有特别的需求用默认的即可

  • AnyAuthenticationPolicy
    类里有一个标志位tryAll,取cas.properties中cas.authn.policy.any.tryall值,默认false
    true:Authentication在Credentials数量必须等于Successes+Failures的数量
    false:Successes不为空就行
  • NotPreventedAuthenticationPolicy
    继承AnyAuthenticationPolicy
  • AllAuthenticationPolicy,增加了一个条件
  public boolean isSatisfiedBy(final Authentication authentication) {
        for (final String handler : authentication.getFailures().keySet()) {
            if (authentication.getFailures().get(handler).isAssignableFrom(PreventedException.class)) {
                return false;
            }
        }
        return super.isSatisfiedBy(authentication);
    }
  • RequiredHandlerAuthenticationPolicy
//requiredHandlerName值取cas.properties中cas.authn.policy.req.handlername,默认handlerName,tryAll取cas.authn.policy.req.tryall,默认false
public boolean isSatisfiedBy(final Authentication authn) {
        boolean credsOk = true;
        if (this.tryAll) {
            credsOk = authn.getCredentials().size() == authn.getSuccesses().size() + authn.getFailures().size();
        }
        return credsOk && StringUtils.isNotBlank(this.requiredHandlerName) && authn.getSuccesses().containsKey(this.requiredHandlerName);
    }
  • ContextualAuthenticationPolicy
    接口,更复杂的校验,如获取某一个策略Context检验Authentication,具体Context看具体实现

至此cas-server的Credential 认证部分就这些内容了,看起来比较简单,但这种架构设计非常值得我们学习,相信在大部分业务场景中都会用到,这里cas-server提供了良好的扩展性,方便第三方库集成。主要还是用到了面向接口编程。

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 217,826评论 6 506
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 92,968评论 3 395
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 164,234评论 0 354
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 58,562评论 1 293
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 67,611评论 6 392
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,482评论 1 302
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,271评论 3 418
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 39,166评论 0 276
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,608评论 1 314
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,814评论 3 336
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,926评论 1 348
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,644评论 5 346
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,249评论 3 329
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,866评论 0 22
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,991评论 1 269
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 48,063评论 3 370
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,871评论 2 354

推荐阅读更多精彩内容

  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 134,656评论 18 139
  • 这篇文章介绍了Mobile BI(移动商务智能)使用过程中涉及的各种身份认证的方式,主要目的是对这些方式的原理进行...
    雨_树阅读 2,018评论 1 2
  • ticket是Server端与client端通信的票据,有了ticket服务才知道你是首次请求认证还是认证通过来验...
    a乐乐_1234阅读 12,373评论 0 1
  • CAS,Central Authentication Service—中央认证服务,是Yale 大学发起的一个企业...
    ackier阅读 1,639评论 0 0
  • 作为不爱做选择的人,我直接在客户端把电影那一栏按好评度排名,选择了一个名字清奇的作品,第八日的蝉。跟着并不明快的节...
    Elly奇阅读 534评论 0 0