Sentinel规则之黑白名单规则

Sentinel规则之黑白名单规则

---

☞ ​​博客导航​​，​​带你有序的阅读和学习！​​

---

概述

很多时候，我们需要根据调用方来限制资源是否通过，这时候可以使用 Sentinel 的黑白名单控制的功能。黑白名单根据资源的请求来源（​​origin​​）限制资源是否通过，若配置白名单则只有请求来源位于白名单内时才可通过；若配置黑名单则请求来源位于黑名单时不通过，其余的请求通过。

调用方信息通过 ​​ContextUtil.enter(resourceName, origin)​​​ 方法中的 ​​origin​​ 参数传入

规则配置

黑白名单规则（​​AuthorityRule​​）非常简单，主要有以下配置项：

• ​​resource​​：资源名，即限流规则的作用对象
• ​​limitApp​​​：对应的黑名单/白名单，不同 origin 用 ​​,​​​ 分隔，如 ​​appA,appB​​
• ​​strategy​​​：限制模式，​​AUTHORITY_WHITE​​​ 为白名单模式，​​AUTHORITY_BLACK​​ 为黑名单模式，默认为白名单模式

源码

public class AuthorityRule extends AbstractRule {
    //Mode: 0 for whitelist; 1 for blacklist.
    private int strategy = RuleConstant.AUTHORITY_WHITE;
}

实验

这个规则比前面的规则都更加简单，而且更加容易理解：

public static void testAuthorityRuleWithWhite() {
    ContextUtil.enter("entrance1","App3");
    Entry entry = null;
    try {
      entry = SphU.entry("login");
      System.out.println("访问通过！");
    } catch (BlockException e) {
      System.out.println("访问受限！");
    } finally {
      if (entry != null) {
        entry.exit();
      }
    }
}

public static void initAuthorityRule() {
    List<AuthorityRule> rules = new ArrayList<>();
    AuthorityRule rule = new AuthorityRule();
    rule.setResource("login");
    //配置白名单
    rule.setStrategy(RuleConstant.AUTHORITY_WHITE);
    rule.setLimitApp("App1,App2");
    rules.add(rule);
    AuthorityRuleManager.loadRules(rules);
}

上面代码测试结果为：访问受限！

• 通过​​Strategy​​ 来设置规则策略，白名单和黑名单。
• 通过​​LimitApp​​ 来配置白名单列表或黑名单列表。多个之间使用逗号隔开。

上面的初始化规则在页面显示如下：