• 规则配置
  • 示例

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

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

    规则配置

    黑白名单规则(AuthorityRule)非常简单,主要有以下配置项:

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

    示例

    比如我们希望控制对资源 test 的访问设置白名单,只有来源为 appAappB 的请求才可通过,则可以配置如下白名单规则:

    1. AuthorityRule rule = new AuthorityRule();
    2. rule.setResource("test");
    3. rule.setStrategy(RuleConstant.AUTHORITY_WHITE);
    4. rule.setLimitApp("appA,appB");
    5. AuthorityRuleManager.loadRules(Collections.singletonList(rule));

    详细示例请参考 AuthorityDemo.