美文网首页ApiBoot 核心技术Spring Boot 核心技术
看完这篇文章,你如果还不知道怎么设置Oauth2令牌过期时间算我

看完这篇文章,你如果还不知道怎么设置Oauth2令牌过期时间算我

作者: 恒宇少年 | 来源:发表于2019-12-12 09:03 被阅读0次

    OAuth2所生成的AccessToken以及RefreshToken都存在过期时间,当在有效期内才可以拿来作为会话身份发起请求,否者认证中心会直接拦截无效请求提示已过期,那么我们怎么修改这个过期时间来满足我们的业务场景呢?

    目前一线大厂所使用的的AccessToken的有效期一般都是7200秒,也就是2小时,而且有获取的次数限制,所以发起请求的一方必须通过一定的形式保存到本地,以方便下一次发起请求时,写入请求的header或者作为参数携带。

    本章来讲解下使用ApiBoot OAuth组件该怎么去设置AccessToken的过期时间,针对memory(内存方式)、jdbc(数据库)这两种方式来讲解,更多使用请参考官方文档:

    ApiBoot Security OAuth组件系列文章

    默认有效时长

    ApiBoot OAuthmemory存储方式下为每一个客户端都提供了一个默认的AccessToken有效时长,该配置在org.minbox.framework.api.boot.autoconfigure.oauth.ApiBootOauthProperties,相关源码如下所示:

    /**
     * Oauth2 Client
     * Used to configure multiple clients
     */
    @Data
    public static class Client {
        /**
         * oauth2 client id
         */
        private String clientId = "ApiBoot";
        /**
         * oauth2 client secret
         */
        private String clientSecret = "ApiBootSecret";
        /**
         * oauth2 client grant types
         * default value is "password,refresh_token"
         */
        private String[] grantTypes = new String[]{"password", "refresh_token"};
        /**
         * oauth2 client scope
         * default value is "api"
         */
        private String[] scopes = new String[]{"api"};
        /**
         * oauth2 application resource id
         * default value is "api"
         */
        private String[] resourceId = new String[]{"api"};
        /**
         * oauth2 access token validity seconds
         * default value is 7200 second
         */
        private int accessTokenValiditySeconds = 7200;
    }
    

    ClientApiBootOauthProperties的一个内部类,主要是提供了OAuth2 客户端的相关配置字段,通过spring-boot-configuration-processor依赖将该类自动解析成配置元数据,这样我们在application.yml输入api.xxx时可以得到相应的提示。

    Client内部类中有一个字段accessTokenValiditySeconds,通过该字段我们来修改该客户端下所有用户生成的AccessToken默认过期时长,值得注意的是,这里的配置值时间单位是7200秒 = 2小时

    内存方式

    在上面说到了,内存方式时ApiBoot OAuth会使用ApiBootOauthProperties#Client内部类的accessTokenValiditySeconds字段来配置过期时间,所以我们只需要在application.yml添加如下配置即可:

    api:
      boot:
        oauth:
          clients:
            - clientId: minbox
              clientSecret: chapter
              # 配置客户端Token过期时长,单位:秒
              accessTokenValiditySeconds: 43200
        security:
          users:
            - username: yuqiyu
              password: 123123
    

    在上面配置中,我们添加了一个在内存存储的minbox客户端,设置accessTokenValiditySeconds过期时间字段为43200秒 = 12小时

    JDBC方式

    JDBC方式是ApiBoot OAuth无法控制的,因为OAuth2当使用JDBC方式进行存储客户端、令牌等信息时,都是通过OAuth2提供的固定的表进行操作,正因为如此我们只需要修改oauth_client_details表内每一条client信息的access_token_validity字段的值即可,时间单位同样也是,如下图所示:

    OAuth2提供的MySQL版本的建表语句请访问ApiBoot OAuth Starter查看。

    运行测试

    下面来测试下修改后的过期时间是否已经生效,我们先来启动本章的项目示例。

    通过CURL的方式获取AccessToken,如下所示:

    ➜ ~ curl -X POST minbox:chapter@localhost:9090/oauth/token -d 'grant_type=password&username=yuqiyu&password=123123'
    {"access_token":"41127985-1b31-4413-ac9f-30d5e26f4aaf","token_type":"bearer","refresh_token":"0a39ca6a-8697-4f80-9bb1-ac59894a45dd","expires_in":43199,"scope":"api"}
    

    通过PostMan方式获取AccessToken如下图所示:

    我们根据结果可以看到,由原本默认的7200修改成了我们在application.yml配置的43200(结果中的43199是因为生成token耗时差导致的)。

    敲黑板,划重点

    ApiBoot的宗旨就是化繁为简,能使用配置简单搞定的事情,绝不拖泥带水,赶快分享下本篇文章吧,让更多人得到帮助,非常感谢~~~

    ApiBoot OAuth可以一次配置多个客户端,并且为每一个客户端配置不同的过期时间。

    签到送书活动进行中

    自律改变人生,恒宇少年回馈粉丝,给大家的福利,请访问https://blog.yuqiyu.com/welfare/了解详情。

    代码示例

    如果您喜欢本篇文章请为源码仓库点个Star,您的点赞是对我最大的支持,谢谢!!!
    本篇文章示例源码可以通过以下途径获取,目录为apiboot-oauth-set-token-expire-time

    作者个人 博客
    使用开源框架 ApiBoot 助你成为Api接口服务架构师

    相关文章

      网友评论

        本文标题:看完这篇文章,你如果还不知道怎么设置Oauth2令牌过期时间算我

        本文链接:https://www.haomeiwen.com/subject/cwezgctx.html