CAS Server Restful接口实现后台认证

IT_小白鼠

于 2024-06-10 19:12:12 发布

阅读量769

点赞数 7

分类专栏： cas 文章标签： java

本文链接：https://blog.csdn.net/qq_40874285/article/details/139580745

版权

cas 专栏收录该内容

3 篇文章 0 订阅

订阅专栏

背景

对于一些比较复杂定制化登录页的情况下，之前提到过可以自定义修改使用CAS Server提供的登录页这种操作已经明显跟不上复杂定制场景了，所以CAS Server也提供了支持Restful接口，支持服务端后台登陆，对于复杂登陆场景时，可以使用接口后台进行认证CAS Server。

引入

在CAS Server中，引入restful接口依赖包

<!-- rest -->
<dependency>
  <groupId>org.apereo.cas</groupId>
  <artifactId>cas-server-support-rest</artifactId>
  <version>6.5.9</version>
</dependency>

重启CAS Server服务，在日志中能够看到如下日志：

说明restful接口已经成功引入了。

接口介绍

可以打开Spring MVC的扫描接口日志打印，可以看到有如下接口：

接口	参数说明	接口说明
GET [/v1/tickets/{id:.+}]	使用PathVariable接收参数，参数为ST票据。	用于校验ST票据状态
POST [/v1/tickets/{tgtId:.+}]	使用PathVariable接收参数，参数为TGT；以及需要service作为表单参数使用application/x-www-form-urlencoded形式传递即可。	用于生成ST票据
POST [/v1/tickets]	与CAS Server的UsernamePasswordCredential参数有关，默认为username和password参数，使用application/x-www-form-urlencoded形式传参。	获取TGT
DELETE [/v1/tickets/{tgtId:.+}]	使用PathVariable接收参数，参数为TGT。	删除TGT信息
GET [/v1/tickets]	无。	不支持GET请求
POST [/v1/users]	与CAS Server的UsernamePasswordCredential参数有关，默认为username和password参数，使用application/x-www-form-urlencoded形式传参。	获取当前CAS Server登陆的用户信息

后台认证示例

以Java语言作为示例，实现后台认证共分为三个步骤：

通过/v1/tickets接口获取到TGT信息
根据返回的TGT信息获取到ST票据
拼接ST票据重定向到指定接口即可完成认证

获取TGT信息

示例代码：

CloseableHttpClient httpClient = HttpClients.createDefault();
        String tgtUrl = null;
        try {
            //1.获取tgt
            HttpPost httpPost = new HttpPost(casServerUrlPrefix + "/v1/tickets");
            // 使用默认账号密码作为示例
            List<BasicNameValuePair> data = new LinkedList<>();
            data.add(new BasicNameValuePair("username", "casuser"));
            data.add(new BasicNameValuePair("password", "mellon"));
            HttpEntity httpEntity = new UrlEncodedFormEntity(data);
            httpPost.setEntity(httpEntity);
            CloseableHttpResponse execute = httpClient.execute(httpPost);

            HttpEntity entity = execute.getEntity();
            String s = EntityUtils.toString(entity);
            tgtUrl = HtmlUtil.getAction(s);
            EntityUtils.consume(entity);
        } catch (Exception e) {
           // do nothing
        }

由于该接口返回的TGT信息如下：

<!DOCTYPE HTML PUBLIC \"-//IETF//DTD HTML 2.0//EN\"> <html>

<head>
    <title>201 CREATED</title>
</head>

<body>
    <h1>TGT Created</h1>
    <form
        action="http://localhost:8443/cas/v1/tickets/TGT-2-nx5h-5vzWsUzXBBNcY--WYT19d6FTuIQrv8G92Rx-3SCD2Gn3XWZbZMgFCUB4tzNYWg-DESKTOP-RV5J95A"
        method="POST">Service:<input type="text" name="service" value=""><br><input type="submit" value="Submit"></form>
</body>

</html>

所以需要从html中获取到action的TGT重定向信息，当前示例使用jsoup获取到TGT。

public class HtmlUtil {
    public static String getAction(String htmlContent) {
        Document parse = Jsoup.parse(htmlContent);
        Element body = parse.body();
        Elements form = body.getElementsByTag("form");
        Element element = form.get(0);
        return element.attr("action");
    }
}

获取ST票据

示例代码：

        String st = null;
        //2.获取ST
        try {
            HttpPost httpPost = new HttpPost(tgtUrl);
            List<BasicNameValuePair> data = new LinkedList<>();
            data.add(new BasicNameValuePair("service", serviceUrl));
            HttpEntity httpEntity = new UrlEncodedFormEntity(data);
            httpPost.setEntity(httpEntity);
            CloseableHttpResponse execute = httpClient.execute(httpPost);
            st = EntityUtils.toString(execute.getEntity());
            EntityUtils.consume(execute.getEntity());
        } catch (Exception e) {
            e.printStackTrace();
        }

需传递service重定向地址参数过去，该参数是用来绑定ST票据信息。

重定向地址

拿到ST票据信息之后，需拼接tickets={ST}参数并且页面重定向到上述serviceUrl接口，之前提到过解析ST时，或获取到重新向接口通过/p3/serviceValidate接口进行认证，如果重定向的接口并非service绑定的接口时，则CAS Server认证报错。

退出

使用CAS Server的页面登录，在退出的时候应该调用CAS Server的退出接口（/logout）。

在客户端服务中退出登陆，只要清除session即可；但是在清除客户端服务之后，再次访问客户端接口时，会跳转到CAS Server登录页面，但是由于CAS Server并没有退出，导致会直接重定向到访问客户端的接口，接口跳转如下：

图中，getData模拟客户端服务接口，由于CAS Server在登录的时候会写入Cookie，存在Cookie会导致重新登陆并且重定向回来。因此在客户端服务退出时，需调用CAS Server退出接口。

后台认证时，并未使用CAS Server登陆，如果重新访问CAS Server依旧是未登录状态，所以在退出的时候直接清除session即可。

IT_小白鼠

关注

7
点赞
踩
15

收藏

觉得还不错? 一键收藏
0
评论
CAS Server Restful接口实现后台认证

接口参数说明接口说明使用PathVariable接收参数，参数为ST票据。用于校验ST票据状态使用PathVariable接收参数，参数为TGT；以及需要service作为表单参数使用application/x-www-form-urlencoded形式传递即可。用于生成ST票据与CAS Server的UsernamePasswordCredential参数有关，默认为username和password参数，使用application/x-www-form-urlencoded形式传参。
复制链接

扫一扫