SpringBootAdmin集成Turbine、使用Spring Boot Security添加安全验证

以你之姓@ 2021-08-29 13:38 301阅读 0赞

SpringBootAdmin集成Turbine

Hystrix Dashboard是一个监控熔断器状况的组件,而Turbine是一个可以聚合多个HystrixDashboard的组件。在Spring Boot Admin 中,可以很方便地集成Turbine组件。集成Turbine组件非常简单,只需要引入相关的依赖并做简单的配置即可。

首先需要两个Eureka Client 工程,在这两个Eureka Client的工程中实现Hystrix熔断器和Hystrix Dashboard组件。然后,需要一个Turbine工程,在这个工程中聚合两个Eureka Client的Hystrix DashBoard。最后,在Spring Boot AdminServer中集成Turbine组件,这样就可以将Turbine界面显示的信息整合在Spring Boot AdminServer中,方便统一查看和管理。

改造Eureka Client
eureka-client-one工程需要集成Hystrix和Hystrix DashBoard 组件。在eureka-client-one工程的pom文件引入Hystrix的起步依赖spring-cloud-starter-hystrix和Hystrix Dashboard的起步依赖spring- cloud-starter-hystrixdashboard,代码如下:

  1. <dependency>
  2. <groupId>org.springframework.cloud</groupId>
  3. <artifactId>spring-cloud-starter-hystrix-dashboard</artifactId>
  4. </dependency>
  5. <dependency>
  6. <groupId>org.springframework.cloud</groupId>
  7. <artifactId>spring-cloud-starter-hystrix</artifactId>
  8. </dependency>

在程序启动类EurekaClientOneApplication加上@EnableHystrix注解,开启Hystrix 的功能,加L@EnableHystrixDashboard注解,开启熔断器监控Hystrix Dashboard 的功能,代码清单如下:

  1. @SpringBootApplication
  2. @EnableEurekaClient
  3. @EnableHystrix
  4. @EnableHystrixDashboard
  5. public class EurekaClientOneApplication {
  6. public static void main(String[] args) {
  7. SpringApplication.run(EurekaClientOneApplication.class, args);
  8. }
  9. }

写一个API接口“hi”,在方法上加上@HystrixCommand注解,该注解用于创建一个熔断器,并指明fallbackMethod (回退方法)为“hiError” 方法。在hiError()方法中,直接返回一个字符串,代码如下:

  1. @RestController
  2. public class HiController {
  3. @Value("${server.port}")
  4. String port;
  5. @GetMapping("/hi")
  6. @HystrixCommand(fallbackMethod = "hiError")
  7. public String home(@RequestParam String name) {
  8. return "hi " + name + ",i am lucy and from port:" + port;
  9. }
  10. public String hiError(String name) {
  11. return "hi, " + name + ",sorry, error!";
  12. }
  13. }

这样eukre-client-one就被改造成了-一个具有熔断器功能的Eureka Client,并且在API接口“/hi”使用到了熔断器。

另行构建Eureka Client:
在主Maven目录下创建另外一个Eureka Client 的Module工程,该工程取名为eureka-client-two。它的依赖同eureka-client-one,并且同样也对外也暴露一个 API接口“/hi”,在这个API接口中也使用到了熔断器。

eureka-client-two 工程与eureka-client-one工程的代码类似,与eureka-client-one工程不同的是,需要在eureka-client-two工程的配置文件application.yml中指明程序的名称为eureka-client-two,程序的端口号为8763,日志输出路径为“logs/eureka-client-two.log”。eureka-client-two 工程的配置文件application.yml代码清单如下:

  1. server:
  2. port: 8763
  3. spring:
  4. application:
  5. name: eureka-client-two
  6. eureka:
  7. client:
  8. service-url:
  9. defaultZone: http://localhost:8761/eureka/
  10. logging:
  11. file: "logs/eureka-client-two.log"
  12. management:
  13. security:
  14. enabled: false

构建Turbine工程:
在主maven工程下创建一个 Module工程,取名为turbine-service。turbine-service 工程提供了Turbine组件的功能,聚合了eureka-client-one和eureka-client-two工程的Hystrix Dashboard组件。

turbine-service 工程的pom文件继承主Maven工程的 pom 文件,引入了Turbine功能依赖,包括spring-cloud-starter-turbine和spring-cloud-netlix-turbine,并引入了Actuator 的起步依赖spring-boot-starter-actuator和Jolokia的依赖jolokia-core。turbine-service 工程的pom文件代码清单如下:

  1. <dependencies>
  2. <dependency>
  3. <groupId>org.springframework.cloud</groupId>
  4. <artifactId>spring-cloud-starter-turbine</artifactId>
  5. </dependency>
  6. <dependency>
  7. <groupId>org.springframework.cloud</groupId>
  8. <artifactId>spring-cloud-netflix-turbine</artifactId>
  9. </dependency>
  10. <dependency>
  11. <groupId>org.springframework.boot</groupId>
  12. <artifactId>spring-boot-starter-actuator</artifactId>
  13. </dependency>
  14. <dependency>
  15. <groupId>org.jolokia</groupId>
  16. <artifactId>jolokia-core</artifactId>
  17. </dependency>
  18. </dependencies>

在turbine-service工程的配置文件application.yml中做程序的相关的配置,包括配置程序的名称为service-turbine, 端口号为8769, 服务注册地址为http://localhost:8761/eureka/

该工程聚合监控了eureka-client-one 和eureka-client-two工程的Hystrix Dashboard,集群配置采用默认。配置文件application.yml的代码清单如下:

  1. server:
  2. port: 8769
  3. spring:
  4. application:
  5. name: service-turbine
  6. turbine:
  7. aggregator:
  8. clusterConfig: default
  9. app-config: eureka-client-one,eureka-client-two
  10. cluster-name-expression: new String("default")
  11. management:
  12. security:
  13. enabled: false
  14. eureka:
  15. client:
  16. service-url:
  17. defaultZone: http://localhost:8761/eureka/

在程序的入口类TurbineServiceApplication加上@EnableTurbine注解,开启Turbine 的功能,代码如下:

  1. @EnableTurbine
  2. @SpringBootApplication
  3. public class TurbineServiceApplication {
  4. public static void main(String[] args) {
  5. SpringApplication.run(TurbineServiceApplication.class, args);
  6. }
  7. }

在Admin Server中集成Turbine:
最后需要在Spring Boot Admin Server中集成Turbine。在admin-server工程的pom文件引入相关依赖,需要引入以下4个依赖,代码清单如下:

  1. <dependency>
  2. <groupId>de.codecentric</groupId>
  3. <artifactId>spring-boot-admin-server-ui-turbine</artifactId>
  4. <version>1.5.1</version>
  5. </dependency>
  6. <dependency>
  7. <groupId>de.codecentric</groupId>
  8. <artifactId>spring-boot-admin-server-ui-hystrix</artifactId>
  9. <version>1.5.1</version>
  10. </dependency>
  11. <dependency>
  12. <groupId>org.springframework.cloud</groupId>
  13. <artifactId>spring-cloud-starter-turbine</artifactId>
  14. </dependency>
  15. <dependency>
  16. <groupId>org.springframework.cloud</groupId>
  17. <artifactId>spring-cloud-starter-hystrix-dashboard</artifactId>
  18. </dependency>
  19. <dependency>
  20. <groupId>org.springframework.cloud</groupId>
  21. <artifactId>spring-cloud-starter-hystrix</artifactId>
  22. </dependency>

在admin-server 工程的配置文件application.yml 中配置Turbine,通过spring.boot.admin.turbine.clusters来配置集群的情况,本案例的集群情况使用默认的即可。通过spring.boot.admin.turbine.location来配置Turbine的服务名,本案例Turbine的服务名为service-turbine, 代码清单如下:

  1. server:
  2. port: 5000
  3. spring:
  4. application:
  5. name: service-admin
  6. boot:
  7. admin:
  8. routes:
  9. endpoints: env,metrics,dump,jolokia,info,configprops,trace,logfile,refresh,flyway,liquibase,heapdump,loggers,auditevents,hystrix.stream
  10. turbine:
  11. clusters: default
  12. location: service-turbine
  13. management:
  14. security:
  15. enabled: false
  16. logging:
  17. file: "logs/boot-admin-sample.log"

在程序的启动类AdminServerApplication加上@EnableTurbine注解开启Turbine功能,加上@EnableHystrixDashboard注解开启Hystrix Dashboard 的功能,加上@EnableHystrix注解开启Hystrix功能。代码清单如下:

  1. @SpringBootApplication
  2. @EnableAdminServer
  3. @EnableTurbine
  4. @EnableHystrix
  5. @EnableHystrixDashboard
  6. public class AdminServerApplication {
  7. public static void main(String[] args) {
  8. SpringApplication.run(AdminServerApplication.class, args);
  9. }
  10. }

依次启动工程 eureka-server、eureka-client-one 、eureka-client-two 、turbine-service 和admin-server这5个工程,在浏览器上访问admin-server的主页htp://ocalalhost:5000,浏览器显示如图所示。这个界面与12.1 节中案例的界面相比多了一一个“TURBINE”的选项按钮。

在这里插入图片描述

依次请求http://localhost:8762/hi?name=forezp 和http://localhost:8763/hi?name=forezp, 这两个API接口带有熔断器的功能。
在这里插入图片描述
在这里插入图片描述

请求完毕大约1分钟后,admin-server的主页的Turbine页面显示如下图所示。注意:如果浏览器的“TURBINE”选项按钮没有显示出来,可以尝试清空浏览器缓存再访问。

在这里插入图片描述

在SpringBootAdmin中添加安全登录界面

SpringBootAdmin提供了非常良好的组件化界面,例如在上一节就很方便地集成了Turbine的界面。在生产环境中,不希望通过网址直接访问Spring Boot Admin Server的主页界面,因为这个界面包含了太多的服务信息,必须对这个界面的访问进行安全验证。

SpringBootAdmin提供了登录界面的组件,并且和Spring Boot Security 相结合,需要用户登录才能访问Spring Boot Admin Server的界面。

下面来进行具体的案例讲解,本节的案例在上一节的案例基础之上进行改造。在admin-server工程的pom文件加上相关的依赖,包括登录界面组件的依赖spring-boot-admin-server-ui-login,以及Spring Boot Security的起步依赖spring-boot-starter-security,代码清单如下:

  1. <dependency>
  2. <groupId>de.codecentric</groupId>
  3. <artifactId>spring-boot-admin-server-ui-login</artifactId>
  4. <version>1.5.0</version>
  5. </dependency>
  6. <dependency>
  7. <groupId>org.springframework.boot</groupId>
  8. <artifactId>spring-boot-starter-security</artifactId>
  9. </dependency>

在工程的配置文件application.yml中做以下的配置,创建一个security的user用户,它的用户名为admin,密码为123456通过eureka.instance.metadate-map 配置带上该security的user用户的信息,因为在工程的pom文件加上Spring Boot Security 的起步依赖以后,该项目的所有资源(包括静态资源html、css, 以及API接口等)都是受保护的,需要加上该管理员信息进行安全验证才能访问,代码如下:

  1. security:
  2. user:
  3. name: admin
  4. password: 123456
  5. eureka:
  6. instance:
  7. metadata-map:
  8. user.name: admin
  9. user.password: 123456

然后,在程序中配置Spring Boot Security, 写SecurityConfig 的配置类,该配置类继承WebSecurityConfigurerAdapter,并复写了configure(HttpSecurity http)方法。

在该方法下做了各种配置,例如配置了登录界面为“/login.htm1”, 登出界面为“/logout”。这些页面以及静态资:

  1. @Configuration
  2. public class SecurityConfig extends WebSecurityConfigurerAdapter {
  3. @Override
  4. protected void configure(HttpSecurity http) throws Exception {
  5. http.formLogin().loginPage("/login.html")
  6. .loginProcessingUrl("/login").permitAll();
  7. http.logout().logoutUrl("/logout");
  8. http.csrf().disable();
  9. http.authorizeRequests()
  10. .antMatchers("/login.html", "/**/**.css", "/img/**", "/third-party/**")
  11. .permitAll();
  12. http.authorizeRequests().antMatchers("/**").authenticated();
  13. http.httpBasic();
  14. }

重新启动admin-server工程,在浏览器中访问http://localhost:5000/,浏览器显示的界面如下图所示。
在这里插入图片描述
在界面上输入用户名为amidn,密码为123456,单击”Login”按钮,登录成功就会跳转到Spring Boot Admin的主页。

在这里插入图片描述

发表评论

表情:
评论列表 (有 0 条评论,301人围观)

还没有评论,来说两句吧...

相关阅读