提交 e74a589b 编写于 作者: U Uncarbon 提交者: shengzhang_

!277 docs: 「微服务」节文档完善

* docs: 「微服务」节文档格式完善
* docs: boot3版的依赖名未同步至「微服务」节中;「服务」👉「服务间」
上级 31b410ea
...@@ -16,6 +16,7 @@ ...@@ -16,6 +16,7 @@
<!---------------------------- tabs:start ------------------------------> <!---------------------------- tabs:start ------------------------------>
<!-------- tab:Maven 方式 --------> <!-------- tab:Maven 方式 -------->
注:如果你使用的是 `SpringBoot 3.x`,只需要将 `sa-token-reactor-spring-boot-starter` 修改为 `sa-token-reactor-spring-boot3-starter` 即可。
``` xml ``` xml
<!-- Sa-Token 权限认证(Reactor响应式集成), 在线文档:https://sa-token.cc --> <!-- Sa-Token 权限认证(Reactor响应式集成), 在线文档:https://sa-token.cc -->
<dependency> <dependency>
...@@ -36,6 +37,7 @@ ...@@ -36,6 +37,7 @@
</dependency> </dependency>
``` ```
<!-------- tab:Gradle 方式 --------> <!-------- tab:Gradle 方式 -------->
注:如果你使用的是 `SpringBoot 3.x`,只需要将 `sa-token-reactor-spring-boot-starter` 修改为 `sa-token-reactor-spring-boot3-starter` 即可。
``` gradle ``` gradle
// Sa-Token 权限认证(Reactor响应式集成),在线文档:https://sa-token.cc // Sa-Token 权限认证(Reactor响应式集成),在线文档:https://sa-token.cc
implementation 'cn.dev33:sa-token-reactor-spring-boot-starter:${sa.top.version}' implementation 'cn.dev33:sa-token-reactor-spring-boot-starter:${sa.top.version}'
......
...@@ -11,6 +11,7 @@ ...@@ -11,6 +11,7 @@
<!---------------------------- tabs:start ----------------------------> <!---------------------------- tabs:start ---------------------------->
<!-------- tab:Maven 方式 --------> <!-------- tab:Maven 方式 -------->
注:如果你使用的是 `SpringBoot 3.x`,只需要将 `sa-token-spring-boot-starter` 修改为 `sa-token-spring-boot3-starter` 即可。
``` xml ``` xml
<!-- Sa-Token 权限认证,在线文档:https://sa-token.cc --> <!-- Sa-Token 权限认证,在线文档:https://sa-token.cc -->
<dependency> <dependency>
...@@ -20,6 +21,7 @@ ...@@ -20,6 +21,7 @@
</dependency> </dependency>
``` ```
<!-------- tab:Gradle 方式 --------> <!-------- tab:Gradle 方式 -------->
注:如果你使用的是 `SpringBoot 3.x`,只需要将 `sa-token-spring-boot-starter` 修改为 `sa-token-spring-boot3-starter` 即可。
``` gradle ``` gradle
// Sa-Token 权限认证,在线文档:https://sa-token.cc // Sa-Token 权限认证,在线文档:https://sa-token.cc
implementation 'cn.dev33:sa-token-spring-boot-starter:${sa.top.version}' 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}' ...@@ -28,6 +30,7 @@ implementation 'cn.dev33:sa-token-spring-boot-starter:${sa.top.version}'
<!---------------------------- tabs:start ------------------------------> <!---------------------------- tabs:start ------------------------------>
<!-------- tab:Maven 方式 --------> <!-------- tab:Maven 方式 -------->
注:如果你使用的是 `SpringBoot 3.x`,只需要将 `sa-token-reactor-spring-boot-starter` 修改为 `sa-token-reactor-spring-boot3-starter` 即可。
``` xml ``` xml
<!-- Sa-Token 权限认证(Reactor响应式集成),在线文档:https://sa-token.cc --> <!-- Sa-Token 权限认证(Reactor响应式集成),在线文档:https://sa-token.cc -->
<dependency> <dependency>
...@@ -37,6 +40,7 @@ implementation 'cn.dev33:sa-token-spring-boot-starter:${sa.top.version}' ...@@ -37,6 +40,7 @@ implementation 'cn.dev33:sa-token-spring-boot-starter:${sa.top.version}'
</dependency> </dependency>
``` ```
<!-------- tab:Gradle 方式 --------> <!-------- tab:Gradle 方式 -------->
注:如果你使用的是 `SpringBoot 3.x`,只需要将 `sa-token-reactor-spring-boot-starter` 修改为 `sa-token-reactor-spring-boot3-starter` 即可。
``` gradle ``` gradle
// Sa-Token 权限认证(Reactor响应式集成),在线文档:https://sa-token.cc // Sa-Token 权限认证(Reactor响应式集成),在线文档:https://sa-token.cc
implementation 'cn.dev33:sa-token-reactor-spring-boot-starter:${sa.top.version}' 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}' ...@@ -50,7 +54,7 @@ implementation 'cn.dev33:sa-token-reactor-spring-boot-starter:${sa.top.version}'
因为这个SpringMVC是基于Servlet模型的,在这里我们需要引入的是`sa-token-spring-boot-starter` 因为这个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) - 一种是基于Reactor模型的,如:SpringCloud Gateway、ShenYu 等等,我们需要引入的是:`sa-token-reactor-spring-boot-starter`**并且注册全局过滤器!**,详细戳:[在WebFlux环境集成](/start/webflux-example)
注:切不可直接在一个项目里同时引入这两个依赖,否则会造成项目无法启动 注:切不可直接在一个项目里同时引入这两个依赖,否则会造成项目无法启动
......
...@@ -10,7 +10,7 @@ ...@@ -10,7 +10,7 @@
1. 物理隔离:子服务部署在指定的内网环境中,只有网关对外网开放 1. 物理隔离:子服务部署在指定的内网环境中,只有网关对外网开放
2. 逻辑隔离:子服务与网关同时暴露在外网,但是子服务会有一个权限拦截层保证只接受网关发送来的请求,绕过网关直接访问子服务会被提示:无效请求 2. 逻辑隔离:子服务与网关同时暴露在外网,但是子服务会有一个权限拦截层保证只接受网关发送来的请求,绕过网关直接访问子服务会被提示:无效请求
这种鉴权需求牵扯到两个环节:**`网关转发鉴权`****`服务内部调用鉴权`** 这种鉴权需求牵扯到两个环节: **`网关转发鉴权`****`服务间内部调用鉴权`**
Sa-Token提供两种解决方案: Sa-Token提供两种解决方案:
1. 使用 OAuth2.0 模式的凭证式,将 Client-Token 用作各个服务的身份凭证进行权限校验 1. 使用 OAuth2.0 模式的凭证式,将 Client-Token 用作各个服务的身份凭证进行权限校验
...@@ -25,6 +25,7 @@ Sa-Token提供两种解决方案: ...@@ -25,6 +25,7 @@ Sa-Token提供两种解决方案:
在网关处引入的依赖为(此处以 SpringCloud Gateway 为例): 在网关处引入的依赖为(此处以 SpringCloud Gateway 为例):
<!---------------------------- tabs:start ------------------------------> <!---------------------------- tabs:start ------------------------------>
<!-------- tab:Maven 方式 --------> <!-------- tab:Maven 方式 -------->
注:如果你使用的是 `SpringBoot 3.x`,只需要将 `sa-token-reactor-spring-boot-starter` 修改为 `sa-token-reactor-spring-boot3-starter` 即可。
``` xml ``` xml
<!-- Sa-Token 权限认证(Reactor响应式集成), 在线文档:https://sa-token.cc --> <!-- Sa-Token 权限认证(Reactor响应式集成), 在线文档:https://sa-token.cc -->
<dependency> <dependency>
...@@ -45,6 +46,7 @@ Sa-Token提供两种解决方案: ...@@ -45,6 +46,7 @@ Sa-Token提供两种解决方案:
</dependency> </dependency>
``` ```
<!-------- tab:Gradle 方式 --------> <!-------- tab:Gradle 方式 -------->
注:如果你使用的是 `SpringBoot 3.x`,只需要将 `sa-token-reactor-spring-boot-starter` 修改为 `sa-token-reactor-spring-boot3-starter` 即可。
``` gradle ``` gradle
// Sa-Token 权限认证(Reactor响应式集成),在线文档:https://sa-token.cc // Sa-Token 权限认证(Reactor响应式集成),在线文档:https://sa-token.cc
implementation 'cn.dev33:sa-token-reactor-spring-boot-starter:${sa.top.version}' implementation 'cn.dev33:sa-token-reactor-spring-boot-starter:${sa.top.version}'
...@@ -55,9 +57,10 @@ implementation 'org.apache.commons:commons-pool2' ...@@ -55,9 +57,10 @@ implementation 'org.apache.commons:commons-pool2'
``` ```
<!---------------------------- tabs:end ------------------------------> <!---------------------------- tabs:end ------------------------------>
在子服务引入的依赖为: 下游子服务引入的依赖为:
<!---------------------------- tabs:start ------------------------------> <!---------------------------- tabs:start ------------------------------>
<!-------- tab:Maven 方式 --------> <!-------- tab:Maven 方式 -------->
注:如果你使用的是 `SpringBoot 3.x`,只需要将 `sa-token-spring-boot-starter` 修改为 `sa-token-spring-boot3-starter` 即可。
``` xml ``` xml
<!-- Sa-Token 权限认证, 在线文档:https://sa-token.cc --> <!-- Sa-Token 权限认证, 在线文档:https://sa-token.cc -->
<dependency> <dependency>
...@@ -78,6 +81,7 @@ implementation 'org.apache.commons:commons-pool2' ...@@ -78,6 +81,7 @@ implementation 'org.apache.commons:commons-pool2'
</dependency> </dependency>
``` ```
<!-------- tab:Gradle 方式 --------> <!-------- tab:Gradle 方式 -------->
注:如果你使用的是 `SpringBoot 3.x`,只需要将 `sa-token-spring-boot-starter` 修改为 `sa-token-spring-boot3-starter` 即可。
``` gradle ``` gradle
// Sa-Token 权限认证,在线文档:https://sa-token.cc // Sa-Token 权限认证,在线文档:https://sa-token.cc
implementation 'cn.dev33:sa-token-spring-boot-starter:${sa.top.version}' implementation 'cn.dev33:sa-token-spring-boot-starter:${sa.top.version}'
...@@ -146,7 +150,7 @@ public class SaTokenConfigure implements WebMvcConfigurer { ...@@ -146,7 +150,7 @@ public class SaTokenConfigure implements WebMvcConfigurer {
> 如果通过网关转发,可以正常访问,直接访问子服务会提示:`无效Same-Token:xxx` > 如果通过网关转发,可以正常访问,直接访问子服务会提示:`无效Same-Token:xxx`
### 三、服务内部调用鉴权 ### 三、服务内部调用鉴权
有时候我们需要在一个服务调用另一个服务的接口,这也是需要添加`Same-Token`作为身份凭证的 有时候我们需要在一个服务调用另一个服务的接口,这也是需要添加`Same-Token`作为身份凭证的
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册