[servicecomb-docs] branch master updated: [SCB-1832] Edge will lose public request headers: add docs

[li...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

liubao pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/servicecomb-docs.git


The following commit(s) were added to refs/heads/master by this push:
     new da963cf  [SCB-1832] Edge will lose public request headers: add docs
da963cf is described below

commit da963cf3805cecba07175e3a3275bd0a55906763
Author: heyile <25...@qq.com>
AuthorDate: Fri Mar 27 20:13:02 2020 +0800

    [SCB-1832] Edge will lose public request headers: add docs
---
 .../zh_CN/docs/edge/by-servicecomb-sdk.md               | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/java-chassis-reference/zh_CN/docs/edge/by-servicecomb-sdk.md b/java-chassis-reference/zh_CN/docs/edge/by-servicecomb-sdk.md
index 0869b77..fed9ebc 100644
--- a/java-chassis-reference/zh_CN/docs/edge/by-servicecomb-sdk.md
+++ b/java-chassis-reference/zh_CN/docs/edge/by-servicecomb-sdk.md
@@ -61,6 +61,23 @@ Edge Service的工作流程如下，蓝色背景部分在Eventloop线程中执
   * 如果工作于线程池模式，则在线程池的线程中执行
 ![](../assets/workFlow.png)
 
+## 定制公共转发 Header 
+
+Edge Service 在转发请求的时候, 会默认过滤掉 `公共请求头` 。 也就是除了 **Provider** 端显示 声明需要的 `HEADER` 外， 其他的 header 在转发的时候都会丢失。用户可以通过配置相关参数保留 公共请求头。
+
+```yaml
+servicecomb:
+  edge:
+    filter:
+      addHeader:
+        # 开启 公共请求头保留功能。默认 false
+        enabled: true
+        # 要保留的公共请求头，以逗号隔开
+        allowedHeaders: external_1,external_2
+```
+
+如果对接了配置中心， 可以在配置中心动态修改 配置 `servicecomb.edge.filter.addHeader.enabled` 和 `servicecomb.edge.filter.addHeader.allowedHeaders` ， 配置动态生效。
+
 ## 定制路由规则
 使用Edge Service的核心工作是配置路由规则。场景不同，规则也不同。
 路由规则由一系列AbstractEdgeDispatcher组成。Edge Service提供了几个常见的Dispatcher，通过配置即可启用，如果这些Dispatcher不满足业务场景需要，还可以自定义。