外部业务框架(非IBPS3.x框架开发)如何接入IBPS-V3接口权限

接入说明

  1. 本文档适用于IBPS-v3.2.0及以上版本;
  2. 注册到IBPS-V3服务发现;
  3. 引入IBPS-V3权限客户端依赖;
  4. 添加swagger、权限相关配置;
  5. 在IBPS-V3系统-系统管理-接口授权进行接口授权;

接入步骤

添加依赖
  1. 服务发现

     <dependency>
         <groupId>com.lc.ibps.cloud</groupId>
         <artifactId>ibps-basic-discovery</artifactId>
         <version>当前版本号</version>
     </dependency>
  2. 公共依赖

    <dependency>
        <groupId>com.lc.ibps.cloud</groupId>
        <artifactId>ibps-basic-response</artifactId>
        <version>当前版本号</version>
        <exclusions>
            <exclusion>
                <groupId>*</groupId>
                <artifactId>*</artifactId>
            </exclusion>
        </exclusions>
    </dependency>
  1. 权限客户端

     <dependency>
         <groupId>com.lc.ibps.cloud</groupId>
         <artifactId>ibps-oauth-client2</artifactId>
         <version>当前版本号</version>
         <exclusions>
             <exclusion>
                 <groupId>net.oschina.j2cache</groupId>
                    <artifactId>j2cache-mybatis</artifactId>
             </exclusion>
         </exclusions>
     </dependency>
     <dependency>
         <groupId>com.lc.ibps.provider.base</groupId>
         <artifactId>ibps-provider-platform-client</artifactId>
         <version>当前版本号</version>
     </dependency>
     <dependency>
         <groupId>com.lc.ibps.base</groupId>
         <artifactId>ibps-base-web</artifactId>
         <version>当前版本号</version>
     </dependency>
  2. 添加swagger依赖

     <dependency>
         <groupId>com.lc.ibps.cloud</groupId>
         <artifactId>ibps-basic-swagger</artifactId>
         <version>当前版本号</version>
     </dependency>
添加配置
  1. 服务发现

    • 请参考application-dev-consul.yml或application-dev-eureka.yml或application-dev-zookeeper.yml配置服务发现链接;
接口授权配置
  1. 添加swagger配置
swagger:
  terms-of-service-url : http://www.bpmhome.cn
  contact-name: 广州流辰信息技术有限公司
  contact-url: http://www.bpmhome.cn
  contact-email: <联系邮箱>
  version: <当前版本>
  base-package: <扫描包名,可配置多个使用英文逗号分割即可>
  docs: v2/api-docs
  string-extensions:
    - name: appId
      value: ${spring.application.name}
  1. IBPS-V3会自动导入接口;
  2. 在系统界面,系统管理-接口授权,对业务系统的接口进行授权即可;
其他配置
  • 关闭IBPS3框架中Mybatis的bean注入

    com:
    lc:
      db:
        mybatis:
          enabled: false
  • ID生成策略信息

    id:
    # 工作ID (0~31)
    workerId: ${ID_WORKER_ID:0}
    # 数据中心ID (0~31)
    datacenterId: ${ID_DATACENTER_ID:0}
  • bean注入配置

    • 复制Demo工程中的ibps-context.xml、ibps-resources.xml到项目的conf目录下。
    • 在非启动类的Configure类中使用@ImportResource(locations={"classpath:conf/ibps-context.xml"})引入bean注入配置。
  • FeignClient注入配置

    • 在启动类的@EnableFeignClients注解添加配置(basePackages = {“com.lc.ibps”, “cn.lc.ibps”})//TODO 配置基础包名!重要步骤!!!。包名按需修改
授权文件配置
  • 授权文件引入

将授权文件ibpsPublic.store、ibpsVfy.lic、license.passwdv3.2.0复制到项目的conf目录下。

  • 授权密码配置
    license: xxxx # 和授权文件同级目录有一个名字随机的文件,文件名即授权密码,v3.1.10及以下版本使用

maven私服请切换至自己的服务;
Demo工程详见源码中的provider-skeleton-other目录;

FAQ

请求/user/context地址出现access_token值重复?

解决方案:检查是否引入spring-boot-starter-tomcat,里面定义了filter导致header重复设置;

文档更新时间: 2020-07-07 17:27   作者:Eddy