29、Sentinel:来源白名单规则与认证边界

实际验证 origin 白名单,说明来源字符串的可信边界以及与用户权限控制的区别。

简明结论

来源白名单只比较 origin;它不能证明身份,也不能代替用户或服务认证。

Sentinel 授权规则能代替用户认证吗?

不能。AuthorityRule 根据调用来源 origin 与名单作比较,来源由接入代码传入。如果直接相信客户端任意填写的请求头,攻击者也能伪造名单中的字符串。应先在可信网关或服务认证链建立身份,再决定是否以及如何映射 origin。

本例只验证 Sentinel 1.8.6 核心 API:资源 phase3-resource 白名单允许 appA,拒绝 appB 与 unknown。不同 origin 共享同一个资源名,避免把规则绑定到错误资源。

复现实验

先采用依赖版本与完整 Maven 配置中的 POM。将下面完整测试类保存为 src/test/java/site/SentinelExampleTest.java,在项目目录执行 mvn -Dtest=SentinelExampleTest test。首次运行需要下载依赖。

package site;

import java.util.List;
import com.alibaba.csp.sentinel.*;
import com.alibaba.csp.sentinel.context.ContextUtil;
import com.alibaba.csp.sentinel.slots.block.authority.*;
import com.alibaba.csp.sentinel.slots.block.RuleConstant;
import org.junit.jupiter.api.Test;
import static org.junit.jupiter.api.Assertions.*;

class SentinelExampleTest {
  @Test void authority() throws Exception {
    var rule=new AuthorityRule(); rule.setResource("phase3-resource");
    rule.setLimitApp("appA"); rule.setStrategy(RuleConstant.AUTHORITY_WHITE);
    AuthorityRuleManager.loadRules(List.of(rule));
    try {
      assertTrue(allowed("appA")); assertFalse(allowed("appB")); assertFalse(allowed("unknown"));
      System.out.println("appA=allowed; appB=blocked; unknown=blocked");
    } finally { AuthorityRuleManager.loadRules(List.of()); }
  }
  boolean allowed(String origin) throws Exception {
    ContextUtil.enter("phase3-entry",origin);
    Entry entry=null;
    try { entry=SphU.entry("phase3-resource"); return true; }
    catch(AuthorityException denied) { return false; }
    finally { if(entry!=null) entry.exit(); ContextUtil.exit(); }
  }
}

预期输出 appA=allowed; appB=blocked; unknown=blocked。每次 entry 在 finally 中退出,ContextUtil 也成对进入和退出,避免线程复用时污染后续调用。

从实验到 Web 接入还缺什么

核心测试没有验证 HTTP 适配器、请求来源解析器、规则推送或控制台持久化。接入时应测试空来源、伪造来源、绕过网关以及规则未加载的行为。不要把 flow QPS 规则、熔断降级和来源访问规则混为一套配置。

下一步:配置加载实验。

整理范围与出处

本次依据下方版本资料整理说明与示例;历史导入资料的来源状态单独列示,不将技术参考认作原作者信息。原始发布日期与地址保留。