Sentinel 授权规则&&规则持久化

2023-10-17 15:07:04 浏览数 (2)

本篇博客我们来学习授权规则,授权规则是对请求者的一种身份的判断。

1、授权规则

授权规则是对请求者的身份做一个判断。你有没有权限来访问我?那就有人可能会说这个功能,好像以前我们在学习微服务的时候讲过网关他不就是把门的吗?

所有请求都要经过网关,网关去做身份的认证,看你有没有权限访问,我怎么到这儿又要整一个呢?

所有请求经过网关路由的微服务,这个时候网关当然可以对请求做身份的认证了。但是万一啊,你们公司里出了个内鬼,他把你们微服务的地址泄露给了外边的那些不怀好意的人。

那这些哥们儿啊,他们是不是就可以绕过网关直接访问微服务了?那你网关里做的安全校验再严密,还有用吗?你的微服务赤裸裸的暴露在别人面前。

所以呢,我们Sentinel的授权规则可以解决这个问题,因为它可以去验证你的请求是从哪来的。

如果说你是从网关过来的,我让你走,如果你是从别的地方过来的呢,我拦截你,这不就解决了吗?

1.1.基本规则

而Sentinel的授权规则里啊,配置也比较简单,主要就是白名单和黑名单两种白名单。

  • 白名单:来源(origin)在白名单内的调用者允许访问
  • 黑名单:来源(origin)在黑名单内的调用者不允许访问

那下边呢,是一个配置的示例。

大家可以看到资源名称就是受保护的那个资源,流控应用。就是名单了。

如果你勾选白名单,这儿就是许可的调用者。比如说呀,我现在只允许从网关来的请求访问orderService。

如果呢,你是从浏览器过来的,我就禁止你访问。那这个时候啊,资源名填的就是order service里边的受保护资源,比方说我们之前的那个order里的 {orderID}。那流控应用里填的呢,就是你允许的调用者的名字了。那这里我们允许网关禁止浏览器,那这是不是要填网关的名字Geteway呢?

并不是啊,这里比较特殊,在sentinel里边,这里让填的调用者名称。

其实是origin。你的请求来源名称。

1.2 如何获取origin

那么,这个请求来源是怎么得到的呢?在我们的Sentinel 里边有一个接口啊,叫RequestOriginParser。

代码语言:javascript复制
public interface RequestOriginParser {
    /**
     * 从请求request对象中获取origin,获取方式自定义
     */
    String parseOrigin(HttpServletRequest request);
}

请求来源解析器。

它里边有一个方法叫parseOrigin。它的参数是HttpServletRequest,那这个方法的作用就是从你这个请求的request对象里。想办法解析出origin的值,也就是来源者的名称。

不过可惜的是啊,在默认情况下sentinel这个方法的返回结果永远是default。

也就是说。你从网关过来也好,从浏览器过来也好。它的来源名称都叫default。sentinel根本没有办法去区分这两个请求。

你这怎么填?所以呀,我们必须想办法自己实现这个接口编写,它的业务逻辑,然后让从网关过来的请求和从浏览器过来的请求返回不同的结果。

那这样来它们的来源名称就不一样了?我们不就可以去编写授权规则了。但是这个业务逻辑该怎么写?

其实业务逻辑很好写,你无论是从请求头也好,还是从请求参数也好,cookie也好,只要你能够去区分。浏览器和网关不就行了吗?

比如说我这写了一个示例啊。

代码语言:javascript复制
package com.jie.order.sentinel;

import com.alibaba.csp.sentinel.adapter.spring.webmvc.callback.RequestOriginParser;
import org.springframework.stereotype.Component;
import org.springframework.util.StringUtils;

import javax.servlet.http.HttpServletRequest;

/**
 * 通过解析请求头中的Origin字段,获取请求来源信息
 */
@Component
public class HeaderOriginParser implements RequestOriginParser {

    /**
     * 解析请求头中的Origin字段,获取请求来源信息
     * @param request HTTP请求
     * @return 请求来源信息
     */
    @Override
    public String parseOrigin(HttpServletRequest request) {
        // 1.获取请求头中的Origin字段
        String origin = request.getHeader("origin");
        // 2.如果请求头中的Origin字段为空,则设置默认值为"blank"
        if (StringUtils.isEmpty(origin)) {
            origin = "blank";
        }
        // 3.返回请求来源信息
        return origin;
    }
}

名字叫HeaderOriginParser,这个类实现了RequestOriginParser接口,并重写了其中的parseOrigin方法。

parseOrigin方法的参数是一个HttpServletRequest对象,表示HTTP请求,它会获取请求头中的Origin字段,并返回该字段的值作为请求来源信息。

如果为空啊,我就返回blank。 如果不为空,我就把origin这个头的结果,作为来源名称返回。

如果浏览器获取的origin头与网关过来的请求。

获取的origin头不一样,那它们的来源名称是不是就不一样啊?我是不是就能编写授权规则了?那它们两个到底一样不一样呢?

事实上啊,网关也好,浏览器也好,默认都没有这个头,因为是我瞎编的。

1.3.给网关添加请求头

那现在那如果我给网关过来的请求,加上这样的头,那这里是不是就能有了?是不是就区分开了?所以这个规则是什么不重要,只要你约定好将来呢,我们给网关开点特权加一下就行。那问题来了,我们怎么给网关过来的请求都带上这个头呢?

大家还记不记得以前学习网关时学过一个过滤器啊?

SpringCloud 之 Gateway 服务网关_gateway mono_阿杰的代码空间的博客-CSDN博客

名字叫AddRequestHeader。

那么,加上这个过滤器以后啊,凡是通过网关路由到微服务的请求,必然会带上请求头。那这个头呢,是这么定义的啊。

代码语言:javascript复制
spring:
  cloud:
    gateway:
      default-filters:
        - AddRequestHeader=origin,gateway

逗号隔开,前面是头的名字,后面头的值,所以呢,我这个请求头的名字叫origin,值就是gateway。

现在我们明确的知道了,经过网关的所有请求,一定会带上这样的头,那它的来源名称一定是叫gateWay,而从浏览器过来的就不一定了吧?

1.4 配置授权规则

那这样两者是不是就区分开了?那因此我们授权规则里边白名单,该填谁?

配置如下:

是不是填gateway?

诶,很好啊,所以是其实你这个头里边的值是什么?这就填什么啊,

因此呢,这个只要约定好就可以了,不是说非得这么写啊。 当然了,你这里怎么填的?怎么规定的?千万不能暴露给外界的人,别人知道了就能伪造请求头了。

1.5 测试

现在,我们直接跳过网关,访问order-service服务:

通过网关访问:

2 、自定义异常结果

刚刚呢,我们演示完了这个授权规则哦,那我们发现当我们被授权拦截时,页面上拿到的是个异常。

而且结果竟然是flow limiting限流的异常。这不就有问题了吗?你明明是授权拦截,你给人家返回了一个限流异常,这用户就一脸懵逼了。

而且不仅仅是授权啊,事实上我们所讲的限流也好,降级也好,各种异常,最终拿到的都是这个限流。

不够友好,结果不够清楚。

2.1 异常类型

那接下里我们就要来学习一下,如何自定义异常?自定义异常非常的简单,你只需要去实现一个接口叫BlockExceptionHandler就行了。

代码语言:javascript复制
public interface BlockExceptionHandler {
    /**
     * 处理请求被限流、降级、授权拦截时抛出的异常:BlockException
     */
    void handle(HttpServletRequest request, HttpServletResponse response, BlockException e) throws Exception;
}

就是阻塞异常的一个处理器。为什么是它呢?

因为当Sentinel里面发生限流降级,授权拦截等等各种异常时,它都会抛出BlockException。

你只要实现了BlockExceptionHandler,那么你就能够去处理这个异常了,你看这里接口里只有一个方法叫handle啊。

这个方法有三个参数:

  • HttpServletRequest request:request对象
  • HttpServletResponse response:response对象
  • BlockException e:被sentinel拦截时抛出的异常

那你在这个方法里啊,就可以去判断一下这个异常到底是哪一种,而后呢?根据异常的类型不同返回不同的结果,通过response呀,写到前端。

那我该怎么样去判断这个异常是哪种类型的异常呢?

其实这里的BlockException包含多个不同的子类:

异常

说明

FlowException

限流异常

ParamFlowException

热点参数限流的异常

DegradeException

降级异常

AuthorityException

授权规则异常

SystemBlockException

系统规则异常

所以我们就可以对异常类型做个判断,看它是这5种中的哪一种,从而去返回不同的结果,做不同处理。

2.2 自定义异常处理

下面,我们就在order-service定义一个自定义异常处理类:

代码语言:javascript复制
package com.jie.order.sentinel;

import com.alibaba.csp.sentinel.adapter.spring.webmvc.callback.BlockExceptionHandler;
import com.alibaba.csp.sentinel.slots.block.BlockException;
import com.alibaba.csp.sentinel.slots.block.authority.AuthorityException;
import com.alibaba.csp.sentinel.slots.block.degrade.DegradeException;
import com.alibaba.csp.sentinel.slots.block.flow.FlowException;
import com.alibaba.csp.sentinel.slots.block.flow.param.ParamFlowException;
import org.springframework.stereotype.Component;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

/**
 * Sentinel的异常处理器,用于处理Sentinel的流量控制、熔断降级和授权管理等异常
 */
@Component
public class SentinelExceptionHandler implements BlockExceptionHandler {

    /**
     * 处理Sentinel的异常
     *
     * @param request  HTTP请求
     * @param response HTTP响应
     * @param e        Sentinel的异常
     * @throws Exception 抛出异常
     */
    @Override
    public void handle(HttpServletRequest request, HttpServletResponse response, BlockException e) throws Exception {
        String msg = "未知异常";
        int status = 429;

        // 根据异常类型,设置不同的响应信息和状态码
        if (e instanceof FlowException) {
            msg = "请求被限流了";
        } else if (e instanceof ParamFlowException) {
            msg = "请求被热点参数限流";
        } else if (e instanceof DegradeException) {
            msg = "请求被降级了";
        } else if (e instanceof AuthorityException) {
            msg = "没有权限访问";
            status = 401;
        }

        // 设置HTTP响应的内容类型和状态码,并输出响应内容
        response.setContentType("application/json;charset=utf-8");
        response.setStatus(status);
        response.getWriter().println("{"msg": "   msg   ", "status": "   status   "}");
    }
}

重启测试,在不同场景下,会返回不同的异常消息.(这里就不演示添加流控规则了)

3、规则持久化

经过前边的学习啊,我们已经掌握了sentinel的常用玩法。

在使用的过程中,我们发现有一个问题啊,就是每当我们的服务重启,我们所配的各种各样的规则,它就丢失了。

这是因为sentinel默认会把这些规则保存在内存里,重启自然就丢失了。那我们在生产环境下肯定无法容忍这样的问题啊。

所以们就来学习一下如何将sentinel的规则持久化。

3.1 规则管理模式

规则管理呢,它有三种模式:

  • 原始模式:Sentinel的默认模式,将规则保存在内存,重启服务会丢失。
  • pull模式
  • push模式

原始模式是sentinel的默认模式,这种模式呢sentinel。会把规则保存在内存里,那这样一重启自然就丢失了。

而pull和push这两种模式啊,都可以实现规则的持久化,只不过实现的方式上有差异。

3.1.1 pull模式

我们首先首先来说一下pull模式啊。

Sentinel的Sentinel Dashboard 控制台,后面是一个微服务。它是Sentinel的客户端。

你要知道我们在实际生产当中,微服务一定是集群同一个微服务是不是也会部署多份啊?

那当你向一个Dashboard 里编写规则时,那会把这个规则推送给这个微服务的某一个Sentinel 的客户端。而它就会将这个规则持久化到一个本地的文件或者是数据库里去,那这样我们就实现了规则的持久化。

但是呢,如果说我还有一个服务,也需要这个规则呢?我怎么知道这个规则有没有变化呢?所以呢,我们的微服务呢,就会去定时轮询啊,这个文件或者是数据库。

当监听到数据库或者文件的内容发生变化时,我就知道规则更新了,那我是不是就可以去更新我自己的这个规则缓存了?

这样呢,就可以实现多个Sentinel 客户端的规则同步了,但是呢,这种定时轮询的方式。它存在一些缺点啊,第一呢,是时效性比较差,你想你这边刚写进去。那边那个服务它还不一定去读取呢,对不对?

它是定时的呀,那如果它现在还没轮到去读取,那现在你的服务与服务之间。是不是数据就不一致了呀?规则就不一致了。

所以这种模式存在一个时效性的问题,从而就导致了一个数据的不一致问题啊。那因此,这种方案也不是非常的推荐。

3.1.2 push模式

那我们再来看一下最后一种模式 push模式。

push模式 Sentinel Dashboard 并不会把这个规则推送给任意一个客户端。而是啊,把这个规则保存到远程的一个配置中心里,比如说我们之前所学习的 nacos。

这是一个统一配置中心,那 Sentinel Dashboard把这个东西推到nacos。而我们的微服务都可以去监听nacos,一旦发现nacos有变化,是不是立即监听并且更新这些数据。

那他们本地的规则是不是跟着都变化了,自然就生效了,这种方式利用了nacos数据更新的这样一种特性来实现配置的一个更新和持久化。

所以也是我们所推荐的方式啊。

3.2.实现push模式

这个push模式实现起来还是挺复杂的。

这个图是我们已经讲过的啊,这个部署模式的流程图,那我们知道啊,在这种模式当中Sentinel Dashboard 需要把规则推送到nacos,而不再是推送到Sentinel 的客户端。

但是呢,在Sentinel 的默认实现当中啊,它都是推到客户端去的。

而推到nacos 的这些功能并没有在Sentinel Dashboard的源码中实现。所以如果我们要实现push模式,我们不得不自己去改动Sentinel Dashboard的源代码。

这足以说明啊,这个阿里巴巴还是挺鸡贼的,是不是你实现了一个开源的框架,结果你却不去实现它最佳模式?

然后给的都是demo,还得让我们自己改编码。不仅如此啊,那我们的渗透客户端是不是也要去监听nacos呀?

因此你还将来还要去改什么哎?微服务端微服务端要去监听nacos。

所以要改动的地方还是挺多的啊,当然如果你不想改也行,那阿里巴巴呢,还提供了一个云服务啊。

这个云服务肯定是收钱的了,你如果你用它的云服务,那你就不需要自己去搭建Sentinel 了。

那我们这里肯定是不会去给他掏钱的,我们来自己搭建一下。

3.2.1 修改order-service服务

首先修改OrderService,让其监听Nacos中的sentinel规则配置。

具体步骤如下:

1.引入依赖

在order-service中引入sentinel监听nacos的依赖:

代码语言:javascript复制
<dependency>
    <groupId>com.alibaba.csp</groupId>
    <artifactId>sentinel-datasource-nacos</artifactId>
</dependency>
2.配置nacos地址

在order-service中的application.yml文件配置nacos地址及监听的配置信息:

代码语言:javascript复制
spring:
  cloud:
    sentinel:
      datasource:
        flow:
          nacos:
            server-addr: localhost:8848 # nacos地址
            dataId: orderservice-flow-rules
            groupId: SENTINEL_GROUP
            rule-type: flow # 还可以是:degrade、authority、param-flow

好,这里配完,那我们这个服务其实就准备好了啊,那我们就可以去重启这个服务了。

3.2.2 修改sentinel-dashboard源码

SentinelDashboard默认不支持nacos的持久化,需要修改源码。

sentinel-dashboard源码 在我的公众号 《KnowledgeSeeker》里给大家提供了。

只需要回复 Sentinel规则持久化 就可以获取了。

1. 解压

解压 sentinel源码包,然后并用IDEA打开这个项目,结构如下:

2. 修改nacos依赖

在sentinel-dashboard源码的pom文件中,nacos的依赖默认的scope是test,只能在测试时使用,这里要去除:

3. 添加nacos支持

在sentinel-dashboard的test包下,已经编写了对nacos的支持,我们需要将其拷贝到main下。

4. 修改nacos地址

然后,还需要修改测试代码中的NacosConfig类:

代码放在下面了。

代码语言:javascript复制
package com.alibaba.csp.sentinel.dashboard.rule.nacos;

import com.alibaba.csp.sentinel.dashboard.datasource.entity.rule.FlowRuleEntity;
import com.alibaba.csp.sentinel.datasource.Converter;
import com.alibaba.fastjson.JSON;
import com.alibaba.nacos.api.config.ConfigFactory;
import com.alibaba.nacos.api.config.ConfigService;
import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

import java.util.List;

/**
 * @author Eric Zhao
 * @since 1.4.0
 */
@Configuration
@ConfigurationProperties(prefix = "nacos")
public class NacosConfig {
    
    /**
     * nacos 地址
     */
    private String addr;

    public String getAddr() {
        return addr;
    }

    public void setAddr(String addr) {
        this.addr = addr;
    }


    @Bean
    public Converter<List<FlowRuleEntity>, String> flowRuleEntityEncoder() {
        return JSON::toJSONString;
    }

    @Bean
    public Converter<String, List<FlowRuleEntity>> flowRuleEntityDecoder() {
        return s -> JSON.parseArray(s, FlowRuleEntity.class);
    }

    @Bean
    public ConfigService nacosConfigService() throws Exception {
        return ConfigFactory.createConfigService(addr);
    }
}

在sentinel-dashboard的application.properties中添加nacos地址配置:

代码语言:javascript复制
nacos.addr=localhost:8848
5. 配置nacos数据源

另外,还需要修com.alibaba.csp.sentinel.dashboard.controller.v2包下的FlowControllerV2类:

让我们添加的Nacos数据源生效:

6. 修改前端页面

接下来,还要修改前端页面,添加一个支持nacos的菜单。

修改src/main/webapp/resources/app/scripts/directives/sidebar/目录下的sidebar.html文件:

将其中的这部分注释打开:

修改其中的文本:

7. 重新编译、打包项目

运行IDEA中的maven插件,编译和打包修改好的Sentinel-Dashboard:

8.启动

启动方式跟官方一样:

代码语言:javascript复制
java -jar sentinel-dashboard.jar

如果要修改nacos地址,需要添加参数:

代码语言:javascript复制
java -jar -Dnacos.addr=localhost:8848 sentinel-dashboard.jar

3.3 测试

这里现在什么都没有啊。我们去访问一下http://localhost:8088/order/103

然后在回去刷新一下。

可以看到啊,现在是不是多出了一个流控规则了,就是Nacos的流控规则那如果你点这个表单啊,在这添加的流控规则。最终就会进入Nacos了。

但是呢,如果你现在是在这边去添加啊。

它就还是原始模式,所以呢,这里其实我只改了一个页面啊,理论上讲你要想实现,你这里面每个都得改,所以改动特别的大,那现在呢,我们就来测一下这个流控规则。

那我们再来点击新增流控规则。

我们给那个/order/{orderId}加一个流控规则。

我们一定要在我们这个流控规则-NACOS 这里加,到其他的地方还是走的原始模式。

我们到NACOS里去刷新看看。

发现已经多出了一个配置了。

我再去浏览器疯狂刷新看看,有没有限流规则。

我们后面现在去重启服务,看看我们的配置会不会丢失。

0 人点赞