From e74a589b88d63d34446ea75d5fd3529a65e64dfa Mon Sep 17 00:00:00 2001 From: Uncarbon <4840454+uncarbon97@user.noreply.gitee.com> Date: Sat, 2 Sep 2023 07:39:53 +0000 Subject: [PATCH] =?UTF-8?q?!277=20docs:=20=E3=80=8C=E5=BE=AE=E6=9C=8D?= =?UTF-8?q?=E5=8A=A1=E3=80=8D=E8=8A=82=E6=96=87=E6=A1=A3=E5=AE=8C=E5=96=84?= =?UTF-8?q?=20*=20docs:=20=E3=80=8C=E5=BE=AE=E6=9C=8D=E5=8A=A1=E3=80=8D?= =?UTF-8?q?=E8=8A=82=E6=96=87=E6=A1=A3=E6=A0=BC=E5=BC=8F=E5=AE=8C=E5=96=84?= =?UTF-8?q?=20*=20docs:=20boot3=E7=89=88=E7=9A=84=E4=BE=9D=E8=B5=96?= =?UTF-8?q?=E5=90=8D=E6=9C=AA=E5=90=8C=E6=AD=A5=E8=87=B3=E3=80=8C=E5=BE=AE?= =?UTF-8?q?=E6=9C=8D=E5=8A=A1=E3=80=8D=E8=8A=82=E4=B8=AD=EF=BC=9B=E3=80=8C?= =?UTF-8?q?=E6=9C=8D=E5=8A=A1=E3=80=8D=F0=9F=91=89=E3=80=8C=E6=9C=8D?= =?UTF-8?q?=E5=8A=A1=E9=97=B4=E3=80=8D?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- sa-token-doc/micro/gateway-auth.md | 2 ++ sa-token-doc/micro/import-intro.md | 6 +++++- sa-token-doc/micro/same-token.md | 10 +++++++--- 3 files changed, 14 insertions(+), 4 deletions(-) diff --git a/sa-token-doc/micro/gateway-auth.md b/sa-token-doc/micro/gateway-auth.md index 8860f5de..1ee62c14 100644 --- a/sa-token-doc/micro/gateway-auth.md +++ b/sa-token-doc/micro/gateway-auth.md @@ -16,6 +16,7 @@ +注:如果你使用的是 `SpringBoot 3.x`,只需要将 `sa-token-reactor-spring-boot-starter` 修改为 `sa-token-reactor-spring-boot3-starter` 即可。 ``` xml @@ -36,6 +37,7 @@ ``` +注:如果你使用的是 `SpringBoot 3.x`,只需要将 `sa-token-reactor-spring-boot-starter` 修改为 `sa-token-reactor-spring-boot3-starter` 即可。 ``` gradle // Sa-Token 权限认证(Reactor响应式集成),在线文档:https://sa-token.cc implementation 'cn.dev33:sa-token-reactor-spring-boot-starter:${sa.top.version}' diff --git a/sa-token-doc/micro/import-intro.md b/sa-token-doc/micro/import-intro.md index 73c7d167..96a13d89 100644 --- a/sa-token-doc/micro/import-intro.md +++ b/sa-token-doc/micro/import-intro.md @@ -11,6 +11,7 @@ +注:如果你使用的是 `SpringBoot 3.x`,只需要将 `sa-token-spring-boot-starter` 修改为 `sa-token-spring-boot3-starter` 即可。 ``` xml @@ -20,6 +21,7 @@ ``` +注:如果你使用的是 `SpringBoot 3.x`,只需要将 `sa-token-spring-boot-starter` 修改为 `sa-token-spring-boot3-starter` 即可。 ``` gradle // Sa-Token 权限认证,在线文档:https://sa-token.cc implementation 'cn.dev33:sa-token-spring-boot-starter:${sa.top.version}' @@ -28,6 +30,7 @@ implementation 'cn.dev33:sa-token-spring-boot-starter:${sa.top.version}' +注:如果你使用的是 `SpringBoot 3.x`,只需要将 `sa-token-reactor-spring-boot-starter` 修改为 `sa-token-reactor-spring-boot3-starter` 即可。 ``` xml @@ -37,6 +40,7 @@ implementation 'cn.dev33:sa-token-spring-boot-starter:${sa.top.version}' ``` +注:如果你使用的是 `SpringBoot 3.x`,只需要将 `sa-token-reactor-spring-boot-starter` 修改为 `sa-token-reactor-spring-boot3-starter` 即可。 ``` gradle // Sa-Token 权限认证(Reactor响应式集成),在线文档:https://sa-token.cc implementation 'cn.dev33:sa-token-reactor-spring-boot-starter:${sa.top.version}' @@ -50,7 +54,7 @@ implementation 'cn.dev33:sa-token-reactor-spring-boot-starter:${sa.top.version}' 因为这个SpringMVC是基于Servlet模型的,在这里我们需要引入的是`sa-token-spring-boot-starter` 对于网关服务,大体来讲分为两种: -- 一种是基于Servlet模型的,如:Zuul,我们需要引入的是:`sa-token-spring-boot-starter`,详细戳:[在SpringBoot环境集成](/start/example) +- 一种是基于Servlet模型的,如:Zuul,我们需要引入的是:`sa-token-spring-boot-starter`,详细戳:[在SpringBoot环境集成](/start/example);理论上`Zuul`并不支持`Spring Boot3` - 一种是基于Reactor模型的,如:SpringCloud Gateway、ShenYu 等等,我们需要引入的是:`sa-token-reactor-spring-boot-starter`,**并且注册全局过滤器!**,详细戳:[在WebFlux环境集成](/start/webflux-example) 注:切不可直接在一个项目里同时引入这两个依赖,否则会造成项目无法启动 diff --git a/sa-token-doc/micro/same-token.md b/sa-token-doc/micro/same-token.md index a387f345..63f70dba 100644 --- a/sa-token-doc/micro/same-token.md +++ b/sa-token-doc/micro/same-token.md @@ -10,7 +10,7 @@ 1. 物理隔离:子服务部署在指定的内网环境中,只有网关对外网开放 2. 逻辑隔离:子服务与网关同时暴露在外网,但是子服务会有一个权限拦截层保证只接受网关发送来的请求,绕过网关直接访问子服务会被提示:无效请求 -这种鉴权需求牵扯到两个环节:**`网关转发鉴权`**、**`服务内部调用鉴权`** +这种鉴权需求牵扯到两个环节: **`网关转发鉴权`** 、 **`服务间内部调用鉴权`** Sa-Token提供两种解决方案: 1. 使用 OAuth2.0 模式的凭证式,将 Client-Token 用作各个服务的身份凭证进行权限校验 @@ -25,6 +25,7 @@ Sa-Token提供两种解决方案: 在网关处引入的依赖为(此处以 SpringCloud Gateway 为例): +注:如果你使用的是 `SpringBoot 3.x`,只需要将 `sa-token-reactor-spring-boot-starter` 修改为 `sa-token-reactor-spring-boot3-starter` 即可。 ``` xml @@ -45,6 +46,7 @@ Sa-Token提供两种解决方案: ``` +注:如果你使用的是 `SpringBoot 3.x`,只需要将 `sa-token-reactor-spring-boot-starter` 修改为 `sa-token-reactor-spring-boot3-starter` 即可。 ``` gradle // Sa-Token 权限认证(Reactor响应式集成),在线文档:https://sa-token.cc implementation 'cn.dev33:sa-token-reactor-spring-boot-starter:${sa.top.version}' @@ -55,9 +57,10 @@ implementation 'org.apache.commons:commons-pool2' ``` -在子服务引入的依赖为: +在下游子服务引入的依赖为: +注:如果你使用的是 `SpringBoot 3.x`,只需要将 `sa-token-spring-boot-starter` 修改为 `sa-token-spring-boot3-starter` 即可。 ``` xml @@ -78,6 +81,7 @@ implementation 'org.apache.commons:commons-pool2' ``` +注:如果你使用的是 `SpringBoot 3.x`,只需要将 `sa-token-spring-boot-starter` 修改为 `sa-token-spring-boot3-starter` 即可。 ``` gradle // Sa-Token 权限认证,在线文档:https://sa-token.cc implementation 'cn.dev33:sa-token-spring-boot-starter:${sa.top.version}' @@ -146,7 +150,7 @@ public class SaTokenConfigure implements WebMvcConfigurer { > 如果通过网关转发,可以正常访问,直接访问子服务会提示:`无效Same-Token:xxx` -### 三、服务内部调用鉴权 +### 三、服务间内部调用鉴权 有时候我们需要在一个服务调用另一个服务的接口,这也是需要添加`Same-Token`作为身份凭证的