此页面由 Cloud Translation API 翻译。

Edge Microgate 操作和配置参考

<ph type="x-smartling-placeholder"></ph> 您正在查看 Apigee Edge 文档。
转到 Apigee X 文档。信息

Edge Microgateway v. 3.3.x

本主题介绍如何管理和配置 Edge Microgateway。

如果您有互联网连接，则升级 Edge Microgateway

本部分介绍如何升级现有安装的 Edge Microgateway。如果您在没有互联网连接的情况下操作，请参阅我可以在没有互联网连接的情况下安装 Edge Microgateway 吗？。

Apigee 建议您使用在升级生产环境之前使用新版本。

执行以下 npm 命令以升级到最新版本的 Edge Microgateway：
```
npm upgrade edgemicro -g
```
要安装特定版本的 Edge Microgateway，您需要指定版本 number 号。例如，要安装到版本 3.2.3，请使用以下命令：
```
npm install edgemicro@3.2.3 -g
```

检查版本号。例如，如果您安装了 3.2.3 版：

edgemicro --version
current nodejs version is v12.5.0
current edgemicro version is 3.2.3

最后，升级到最新版本的 edgemicro-auth 代理：
```
edgemicro upgradeauth -o $ORG -e $ENV -u $USERNAME
```

更改配置

您需要了解的配置文件包括：

默认系统配置文件
新初始化的 Edge Microgateway 实例的默认配置文件
用于正在运行的实例的动态配置文件

本节讨论这些文件以及关于更改它们需要了解的信息。

默认系统配置文件

安装 Edge Microgateway 时，默认系统配置文件位于此处：

prefix/lib/node_modules/edgemicro/config/default.yaml

其中 prefix 是 npm 前缀目录。请参阅如果找不到 Edge Microgateway 的安装位置，

如果您更改系统配置文件，则必须重新初始化、重新配置并重启 Edge Microgateway：

edgemicro init
edgemicro configure [params]
edgemicro start [params]

新初始化的 Edge Microgateway 实例的默认配置文件

运行 edgemicro init 时，系统配置文件（描述 default.yaml）会放在 ~/.edgemicro 目录中。

如果您更改 ~/.edgemicro 中的配置文件，则必须重新配置并重启 Edge Microgateway：

edgemicro stop
edgemicro configure [params]
edgemicro start [params]

动态用于运行实例的

当您运行 edgemicro configure [params] 时，在 ~/.edgemicro 中创建配置文件。该文件的命名依据如下格式：org-env-config.yaml，其中 org 和 env是您的 Apigee Edge 组织和环境名称。您可以使用此文件然后重新加载它们，无需停机例如，如果您添加并配置一个插件，您可以重新加载配置，而不会导致任何停机，具体如下所述。

如果 Edge Microgateway 正在运行（零停机选项）：

重新加载 Edge Microgateway 配置：
```
edgemicro reload -o $ORG -e $ENV -k $KEY -s $SECRET
```
其中：
- $ORG 是您的 Edge 组织名称（您必须是组织）管理员）。
- $ENV 是贵组织中的一种环境（例如“test”或 “prod”）。
- $KEY 是 configure 命令之前返回的键。
- $SECRET 是 configure 命令之前返回的键。
例如：
```
edgemicro reload -o docs -e test -k 701e70ee718ce6dc188...78b6181d000723 \
  -s 05c14356e42ed1...4e34ab0cc824
```

如果 Edge Microgateway 已停止：

重启 Edge Microgateway：
```
edgemicro start -o $ORG -e $ENV -k $KEY -s $SECRET
```
其中：
- $ORG 是您的 Edge 组织名称（您必须是组织）管理员）。
- $ENV 是贵组织中的环境（例如“test”或 “prod”）。
- $KEY 是 configure 命令之前返回的键。
- $SECRET 是 configure 命令之前返回的键。
例如：
```
edgemicro start -o docs -e test -k 701e70ee718ce...b6181d000723 \
  -s 05c1435...e34ab0cc824
```

下面是一个配置文件示例。如需详细了解配置文件设置，请参阅 Edge Microgateway 配置参考文档。

edge_config:
  bootstrap: >-
    https://edgemicroservices-us-east-1.apigee.net/edgemicro/bootstrap/organization/docs/environment/test
  jwt_public_key: 'https://docs-test.apigee.net/edgemicro-auth/publicKey'
  managementUri: 'https://api.enterprise.apigee.com'
  vaultName: microgateway
  authUri: 'https://%s-%s.apigee.net/edgemicro-auth'
  baseUri: >-
    https://edgemicroservices.apigee.net/edgemicro/%s/organization/%s/environment/%s
  bootstrapMessage: Please copy the following property to the edge micro agent config
  keySecretMessage: The following credentials are required to start edge micro
  products: 'https://docs-test.apigee.net/edgemicro-auth/products'
edgemicro:
  port: 8000
  max_connections: 1000
  max_connections_hard: 5000
  config_change_poll_interval: 600
  logging:
    level: error
    dir: /var/tmp
    stats_log_interval: 60
    rotate_interval: 24
  plugins:
    sequence:
      - oauth
headers:
  x-forwarded-for: true
  x-forwarded-host: true
  x-request-id: true
  x-response-time: true
  via: true
oauth:
  allowNoAuthorization: false
  allowInvalidAuthorization: false
  verify_api_key_url: 'https://docs-test.apigee.net/edgemicro-auth/verifyApiKey'
analytics:
  uri: >-
    https://edgemicroservices-us-east-1.apigee.net/edgemicro/axpublisher/organization/docs/environment/test

设置环境变量

需要 Edge 组织和启动 Edge Microgateway 所需的密钥和密钥可以存储在环境变量：

EDGEMICRO_ORG
EDGEMICRO_ENV
EDGEMICRO_KEY
EDGEMICRO_SECRET

设置这些变量是可选的。如果设置了这些参数，则无需指定它们的值当您使用命令行界面 (CLI) 配置和启动 Edge Microgateway 时。

在 Edge Microgateway 上配置 SSL 服务器

观看以下视频，了解如何在 Apigee Edge Microgateway 中配置 TLS：

视频	说明
配置单向北向 TLS	了解如何在 Apigee Edge Microgateway 中配置 TLS。此视频简要介绍了 TLS 及其重要性，并介绍了 TLS 以及如何配置北向单向 TLS。
配置双向北向 TLS	这是有关在 Apigee Edge Microgateway 中配置 TLS 的第二个视频。本次视频介绍了如何配置北向双向 TLS。
配置单向和双向 TLS 传输层安全协议	第三个视频介绍了如何在 Apigee Edge Microgateway 中配置 TLS 介绍了如何配置南向单向 TLS 和双向 TLS。

您可以将 Microgateway 服务器配置为使用 SSL。例如，配置 SSL 后可以使用“https”通过 Edge Microgateway 调用 API协议，如下所示：

https://localhost:8000/myapi

如需在 Microgateway 服务器上配置 SSL，请按以下步骤操作：

使用 openssl 实用程序或您喜欢的任何方法生成或获取 SSL 证书和密钥。

将 edgemicro:ssl 属性添加到 Edge Microgateway 配置文件。有关选项列表，请参阅下表。例如：

edgemicro:
  ssl:
   key: <absolute path to the SSL key file>
   cert: <absolute path to the SSL cert file>
   passphrase: admin123 #option added in v2.2.2
   rejectUnauthorized: true #option added in v2.2.2
   requestCert: true

重启 Edge Microgateway。请按照更改配置是默认文件或运行时配置文件。

下面是一个使用 SSL 的配置文件的 edgemicro 部分的示例已配置：

edgemicro:
  port: 8000
  max_connections: 1000
  max_connections_hard: 5000
  logging:
    level: error
    dir: /var/tmp
    stats_log_interval: 60
    rotate_interval: 24
  plugins:
    sequence:
      - oauth
  ssl:
    key: /MyHome/SSL/em-ssl-keys/server.key
    cert: /MyHome/SSL/em-ssl-keys/server.crt
    passphrase: admin123 #option added in v2.2.2
    rejectUnauthorized: true #option added in v2.2.2

以下是所有支持的服务器选项的列表：

选项	说明
`key`	`ca.key` 文件的路径（PEM 格式）。
`cert`	`ca.cert` 文件的路径（PEM 格式）。
`pfx`	包含私钥、证书和 CA 证书的 `pfx` 文件的路径采用 PFX 格式
`passphrase`	包含私钥或 PFX 密码的字符串。
`ca`	指向包含 PEM 格式的可信证书列表的文件的路径。
`ciphers`	用于描述要使用的密码的字符串，以“:”分隔。
`rejectUnauthorized`	如果为 true，则根据提供的 CA 列表验证服务器证书。如果则会返回错误。
`secureProtocol`	要使用的 SSL 方法。例如，使用 SSLv3_method 将 SSL 强制使用版本 3。
`servername`	SNI（服务器名称指示）TLS 扩展的服务器名称。
`requestCert`	如果是双向 SSL，则为 true；false（对于单向 SSL）

使用客户端 SSL/TLS 选项

您可以将 Edge Microgateway 在连接到目标时配置为 TLS 或 SSL 客户端端点。在 Microgateway 配置文件中，使用 targets 元素设置 SSL/TLS 选项。请注意，您可以指定多个特定目标。其中包含多目标示例。

以下示例提供了将应用于所有主机的设置：

edgemicro:
...
targets:
  ssl:
    client:
      key: /Users/jdoe/nodecellar/twowayssl/ssl/client.key
      cert: /Users/jdoe/nodecellar/twowayssl/ssl/ca.crt
      passphrase: admin123
      rejectUnauthorized: true

在此示例中，这些设置仅应用于指定的主机：

edgemicro:
...
targets:
  - host: 'myserver.example.com'
    ssl:
      client:
        key: /Users/myname/twowayssl/ssl/client.key
        cert: /Users/myname/twowayssl/ssl/ca.crt
        passphrase: admin123
        rejectUnauthorized: true

以下是 TLS 的示例：

edgemicro:
...
targets:
  - host: 'myserver.example.com'
    tls:
      client:
        pfx: /Users/myname/twowayssl/ssl/client.pfx
        passphrase: admin123
        rejectUnauthorized: true

如果您要对多个特定目标应用 TLS/SSL 设置，则必须指定将配置中的第一个主机设为“空”，这会启用通用请求，然后指定按任意顺序排列的主机在此示例中，设置应用于多个特定主机：

targets:
 - host:   ## Note that this value must be "empty"
   ssl:
     client:
       key: /Users/myname/twowayssl/ssl/client.key
       cert: /Users/myname/twowayssl/ssl/ca.crt
       passphrase: admin123
       rejectUnauthorized: true
 - host: 'myserver1.example.com'
   ssl:
     client:
       key: /Users/myname/twowayssl/ssl/client.key
       cert: /Users/myname/twowayssl/ssl/ca.crt
       rejectUnauthorized: true
 - host: 'myserver2.example.com'
   ssl:
     client:
       key: /Users/myname/twowayssl/ssl/client.key
       cert: /Users/myname/twowayssl/ssl/ca.crt
       rejectUnauthorized: true

下面列出了所有支持的客户端选项：

选项	说明
`pfx`	包含私钥、证书和 CA 证书的 `pfx` 文件的路径采用 PFX 格式
`key`	`ca.key` 文件的路径（PEM 格式）。
`passphrase`	包含私钥或 PFX 密码的字符串。
`cert`	`ca.cert` 文件的路径（PEM 格式）。
`ca`	指向包含 PEM 格式的可信证书列表的文件的路径。
`ciphers`	用于描述要使用的密码的字符串，以“:”分隔。
`rejectUnauthorized`	如果为 true，则根据提供的 CA 列表验证服务器证书。如果则会返回错误。
`secureProtocol`	要使用的 SSL 方法。例如，使用 SSLv3_method 将 SSL 强制使用版本 3。
`servername`	SNI（服务器名称指示）TLS 扩展的服务器名称。

自定义 Edgemicro-auth 代理

默认情况下，Edge Microgateway 使用 Apigee Edge 上部署的代理进行 OAuth2 身份验证。此代理会在您首次运行 edgemicro configure 时部署。您可以更改此代理的默认配置，用于向 JSON 网络令牌添加自定义声明 (JWT)、配置令牌到期时间并生成刷新令牌。如需了解详情，请参阅 GitHub 中的 edgemicro-auth 页面。

使用自定义身份验证服务

默认情况下，Edge Microgateway 使用 Apigee Edge 上部署的代理进行 OAuth2 身份验证。此代理会在您首次运行 edgemicro configure 时部署。默认情况下，代理的网址在 Edge Microgateway 配置文件中指定，如下所示：

authUri: https://myorg-myenv.apigee.net/edgemicro-auth

如果您希望使用自己的自定义服务来处理身份验证，请将 authUri 值，以指向您的服务。例如，您可能有一项使用 LDAP 验证身份的服务。

重要提示：如果您替换默认 auth 代理，新代理或服务必须返回与默认 edgemicro-auth 代理。

管理日志文件

Edge Microgateway 会记录每个请求和响应的相关信息。日志文件会提供调试和问题排查信息。

日志文件的存储位置

默认情况下，日志文件存储在 /var/tmp 中。

如何更改默认日志文件目录

存储日志文件的目录在 Edge Microgateway 配置中指定文件。另请参阅进行配置更改。

edgemicro:
  home: ../gateway
  port: 8000
  max_connections: -1
  max_connections_hard: -1
  logging:
    level: info
    dir: /var/tmp
    stats_log_interval: 60
    rotate_interval: 24

更改 dir 值以指定其他日志文件目录。

将日志发送到控制台

您可以配置日志记录，以便将日志信息发送到标准输出，而不是日志文件。将 to_console 标志设置为 true，如下所示：

edgemicro:
  logging:
    to_console: true

如果使用此设置，日志将发送至“标准输出”。目前，您不能同时向两者发送日志标准输出和日志文件。

如何设置日志记录级别

您可以在 edgemicro 配置中指定要使用的日志级别。对于日志级别及其说明的完整列表，请参阅 edgemicro 属性。

例如，以下配置将日志记录级别设置为 debug：

edgemicro:
  home: ../gateway
  port: 8000
  max_connections: -1
  max_connections_hard: -1
  logging:
    level: debug
    dir: /var/tmp
    stats_log_interval: 60
    rotate_interval: 24

如何更改日志时间间隔

您可以在 Edge Microgateway 配置文件中配置这些时间间隔。另请参阅更改配置。

可配置的属性包括：

stats_log_interval：（默认值：60）显示统计数据时的时间间隔（以秒为单位）将写入 API 日志文件。
rotate_interval：（默认值：24）日志文件的间隔时间（以小时为单位）旋转。例如：

edgemicro:
  home: ../gateway
  port: 8000
  max_connections: -1
  max_connections_hard: -1
  logging:
    level: info
    dir: /var/tmp
    stats_log_interval: 60
    rotate_interval: 24

如何放宽严格的日志文件权限

默认情况下，Edge Microgateway 会生成具有文件权限的应用日志文件 (api-log.log) 设为 0600。此权限级别不允许外部应用或用户读取日志文件如需放宽此严格权限级别，请设置 logging:disableStrictLogFile 至 true。如果此属性为 true，则使用将文件权限设置为 0755。如果为 false 或未提供该属性，则权限默认为 0600。

在 v3.2.3 中引入。

例如：

edgemicro:
 logging:
   disableStrictLogFile: true

日志文件维护的良好做法

随着日志文件数据随时间的积累，Apigee 建议您采用以下做法做法：

由于日志文件会变得非常大，因此请确保日志文件目录空间充足。请参阅下面的日志文件的存储位置和如何更改默认日志文件目录。
每周至少删除一次日志文件，或将日志文件移至单独的存档目录。
如果您的政策是删除日志，可以使用 CLI 命令 edgemicro log -c 移除（清理）较旧的日志。

日志文件命名惯例

每个 Edge Microgateway 实例都会生成一个扩展名为 .log 的日志文件。通过日志文件的命名惯例如下：

edgemicro-HOST_NAME-INSTANCE_ID-api.log

例如：

edgemicro-mymachine-local-MTQzNTgNDMxODAyMQ-api.log

关于日志文件内容

添加此模块的版本：v2.3.3

默认情况下，日志记录服务会忽略下载的代理、产品的 JSON 和 JSON 网络令牌 (JWT)。如果您希望将这些对象输出到控制台，请设置命令行标志， DEBUG=*（在您启动 Edge Microgateway 时）。例如：

DEBUG=* edgemicro start -o docs -e test -k abc123 -s xyz456

在 Windows 上，使用 SET DEBUG=*

“API”的内容日志文件

“API”日志文件包含有关请求和响应流的详细信息通过 Edge Microgateway 访问 Wi-Fi。“API”日志文件的名称如下所示：

edgemicro-mymachine-local-MTQzNjIxOTk0NzY0Nw-api.log

对于发送到 Edge Microgateway 的每个请求，“api”中会捕获四个事件日志文件：

来自客户端的传入请求
向目标发出的传出请求
来自目标的响应
对客户端的传出响应

这些单独的条目均以简写表示法表示让文件更加紧凑以下是四个示例条目，分别代表这四个事件。在日志中它们将如下所示（行号仅供在文档中参考，不会出现记录）。

(1) 1436403888651 info req m=GET, u=/, h=localhost:8000, r=::1:59715, i=0
(2) 1436403888665 info treq m=GET, u=/, h=127.0.0.18080, i=0
(3) 1436403888672 info tres s=200, d=7, i=0
(4) 1436403888676 info res s=200, d=11, i=0

下面我们将逐一介绍：

1. 来自客户端的传入请求示例：

1436403888651 info req m=GET, u=/, h=localhost:8000, r=::1:59715, i=0

1436403888651 - Unix 日期戳
info - 日志记录级别。此值取决于事务的上下文以及设置的日志记录级别（位于 edgemicro 配置中）。请参阅如何设置日志记录级别。对于统计数据记录，级别设置为 stats。统计数据记录的报告地址：使用 stats_log_interval 配置设置的固定时间间隔。另请参阅如何更改日志时间间隔。
req - 标识事件。在这种情况下，请从客户端。
m - 请求中使用的 HTTP 动词。
u - 网址中基本路径之后的部分。
h - Edge Microgateway 所在的主机和端口号。
r - 客户端请求所在的远程主机和端口来源。
i - 请求 ID。所有四个事件条目都将共用此 ID。每个系统会为请求分配一个唯一的请求 ID按请求 ID 关联日志记录可以可让您了解目标延迟时间的宝贵数据洞见
d - 自从 SDK 收到请求后的持续时间（以毫秒为单位） Edge Microgateway。在上面的示例中，收到了目标对请求 0 的响应 7 毫秒之后（第 3 行），并且在额外 4 次请求后，毫秒（第 4 行）。换句话说，总请求延迟时间为 11 毫秒，目标占用了 7 毫秒，Edge Microgateway 占用了 4 毫秒本身。

2. 向目标发出的传出请求的示例：

1436403888665 info treq m=GET, u=/, h=127.0.0.1:8080, i=0

1436403888651 - Unix 日期戳
info - 日志记录级别。此值取决于事务的上下文以及设置的日志记录级别（位于 edgemicro 配置中）。请参阅如何设置日志记录级别。对于统计数据记录，级别设置为 stats。统计数据记录的报告地址：使用 stats_log_interval 配置设置的固定时间间隔。另请参阅如何更改日志时间间隔。
treq - 标识事件。在本示例中，目标请求。
m - 目标请求中使用的 HTTP 动词。
u - 网址中基本路径之后的部分。
h - 后端目标的主机和端口号。
i - 日志条目的 ID。这四个活动条目将会共享 ID。

3. 来自目标的传入响应示例

1436403888672 info tres s=200, d=7, i=0

1436403888651 - Unix 日期戳

info - 日志记录级别。此值取决于事务的上下文以及设置的日志记录级别（位于 edgemicro 配置中）。请参阅如何设置日志记录级别。对于统计数据记录，级别设置为 stats。统计数据记录的报告地址：使用 stats_log_interval 配置设置的固定时间间隔。另请参阅如何更改日志时间间隔。
tres - 标识事件。在本示例中，目标回复。
s - HTTP 响应状态。
d - 时长（以毫秒为单位）。调用 API 所用的时间目标。
i - 日志条目的 ID。这四个活动条目将会共享 ID。

4. 发送至客户端的传出响应示例

1436403888676 info res s=200, d=11, i=0

1436403888651 - Unix 日期戳

info - 日志记录级别。此值取决于事务的上下文以及设置的日志记录级别（位于 edgemicro 配置中）。请参阅如何设置日志记录级别。对于统计数据记录，级别设置为 stats。统计数据记录的报告地址：使用 stats_log_interval 配置设置的固定时间间隔。另请参阅如何更改日志时间间隔。
res - 标识事件。在这种情况下，对客户端。
s - HTTP 响应状态。
d - 时长（以毫秒为单位）。这是总时间由 API 调用触发，包括目标 API 花费的时间和 Edge 花费的时间 Microgateway 本身。
i - 日志条目的 ID。这四个活动条目将会共享 ID。

日志文件时间安排

日志文件按 rotate_interval 指定的间隔定期轮替配置属性。参评申请将继续添加到同一个日志文件，直到轮替间隔过期。不过，每次重新启动后，设备会接收新的 UID，并使用此 UID 创建一组新的日志文件。另请参阅良好的日志文件维护做法。

错误消息

部分日志条目包含错误消息。为帮助确定错误的发生位置和原因请参阅 Edge Microgateway 错误参考。

Edge Microgateway 配置参考文档

的配置文件

本部分介绍的配置属性位于 Edge Microgateway 配置文件另请参阅进行配置更改。

Edge_config 属性

这些设置用于配置 Edge Microgateway 实例和 Apigee Edge。

bootstrap：（默认值：无）指向 Edge 的网址在 Apigee Edge 上运行的 Microgateway 专用服务。Edge Microgateway 使用此服务与 Apigee Edge 进行通信当您执行相应命令以生成公钥/私钥对：edgemicro genkeys。请参阅有关设置和配置 Edge Microgateway。
jwt_public_key：（默认值：无）指向 Edge Microgateway 的网址部署在 Apigee Edge 上的代理此代理可用作以下账号的身份验证端点：向客户端颁发已签名的访问令牌。当您执行命令以部署代理：edgemicro configure。请参阅有关设置和配置 Edge Microgateway。
quotaUri：设置此配置属性（如果您想通过 edgemicro-auth 代理）部署到您的组织如果未设置此属性配额端点默认为内部 Edge Microgateway 端点。
```
edge_config:
  quotaUri: https://your_org-your_env.apigee.net/edgemicro-auth
```

Edgemicro 属性

这些设置会配置 Edge Microgateway 进程。

port：（默认值：8000）Edge Microgateway 所在的端口号进程监听
max_connections：（默认值：-1）指定 Edge Microgateway 可以接收的并发传入连接数。如果此数字为系统将返回以下状态：

res.statusCode = 429; // Too many requests
max_connections_hard：（默认值：-1）并发的最大数量在关闭连接之前 Edge Microgateway 可以接收的请求。此设置旨在阻止拒绝服务攻击。通常，将其设置为大于 max_connections.
logging： <ph type="x-smartling-placeholder">
- level：（默认值：error） <ph type="x-smartling-placeholder">
  - info -（推荐）记录流经 Edge Microgateway 实例。
  - warn - 仅记录警告消息。
  - error - 仅记录错误消息。
  - debug - 记录调试消息以及信息、警告和错误消息。
  - trace - 记录错误的跟踪信息，以及相关信息、警告和错误消息。
  - none - 不创建日志文件。
- dir：（默认值：/var/tmp）日志文件所在的目录存储的数据。
- stats_log_interval：（默认值：60）显示统计数据时的时间间隔（以秒为单位）将写入 API 日志文件
- rotate_interval：（默认值：24）日志文件的间隔时间（以小时为单位）旋转。

插件：插件用于向 Edge Microgateway 添加功能。了解详情如需了解如何开发插件，请参阅开发自定义插件。

dir：从 ./gateway 目录到 ./plugins 目录或绝对路径。
sequence：要添加到 Edge Microgateway 的插件模块列表实例。模块将按此处指定的顺序执行。

debug ：在 Edge Microgateway 进程中添加远程调试。
- port：要监听的端口号。例如，设置 IDE 调试程序在此端口上进行监听。
- args：调试进程的参数。例如：args --nolazy
config_change_poll_interval:（默认值：600 秒）Edge Microgateway 定期加载新配置，并在发生更改时执行重新加载。轮询提取在 Edge 上所做的任何更改（产品更改、可感知微网关的代理等），以及对本地配置文件所做的更改
disable_config_poll_interval:（默认值：false）设置为设置为 true 可关闭自动更改轮询。
request_timeout：为目标请求设置超时。超时时间是在。如果发生超时，Edge Microgateway 会返回 504 状态代码。（已添加 v2.4.x)
keep_alive_timeout：此属性可让您设置 Edge Microgateway 超时（以毫秒为单位）。（默认值：5 秒）（添加于 v3.0.6）
headers_timeout：此属性用于限制时长（以毫秒为单位） HTTP 解析器将等待接收完整 HTTP 标头。
例如：
```
edgemicro:
  keep_alive_timeout: 6000
  headers_timeout: 12000
```
在内部，该参数用于设置 Node.js Server.headersTimeout 属性。（默认值：超过 5 秒）使用 edgemicro.keep_alive_timeout 设置的时间。此默认值设置可防止负载平衡器或代理错误地断开连接）。（添加 v3.1.1）
noRuleMatchAction:：（字符串）在以下情况下将执行的操作（允许或拒绝访问）：无法解析 accesscontrol 插件中指定的匹配规则（不匹配）。有效值：ALLOW 或 DENY 默认值：ALLOW（已添加：v3.1.7）
enableAnalytics:：（默认值：true）将属性设为 enableAnalytics: 即可阻止分析插件加载这些代码在这种情况下，不会调用 Apigee Edge 分析。如果设为 true，或者此属性未提供，则 Google Analytics 插件将正常工作。请参阅 edgemicro 属性。（添加 v3.1.8）。
示例：
```
edgemicro
  enableAnalytics=false|true
```
如果 enableAnalytics 设置为 false，但 Edge Microgateway 使用指标插件启动后，分析插件将照常运行，因为指标插件需要分析插件才能正常运行。有关请参阅 Edge Microgateway v1.3.6 版本说明。

on_target_response_abort：通过此属性，您可以控制如果客户端 (Edge Microgateway) 与目标服务器过早关闭。

值	说明
默认	如果未指定 `on_target_response_abort`，则默认行为截断响应而不显示错误。在日志文件中，如果消息会显示 `targetResponse aborted` 和 502 响应代码。
`appendErrorToClientResponseBody`	系统会将自定义错误 `TargetResponseAborted` 返回给客户端。在日志文件中，如果消息会显示 `targetResponse aborted` 和 502 响应代码。在此外，错误 `TargetResponseAborted` 会记录到以下消息中： `Target response ended prematurely.`
`abortClientRequest`	Edge Microgateway 会中止请求，并将警告写入日志文件：将 `TargetResponseAborted` 替换为 502 请求状态代码。

示例：

edgemicro:
 on_target_response_abort: appendErrorToClientResponseBody | abortClientRequest

标头属性

这些设置用于配置某些 HTTP 标头的处理方式。

x-forwarded-for：（默认值：true）设置为 false 可防止 x-forwarded-for 要传递给目标的标头。请注意，如果 x-forwarded-for 标头，那么其值将设置为 Edge Analytics 中的 client-ip 值。
x-forwarded-host：（默认值：true）设置为 false 可防止要传递给目标的 x-forwarded-host 标头。
x-request-id：（默认值：true）设置为 false 可防止要传递给目标的 x-request-id 标头。
x-response-time：（默认值：true）设置为 false 以防止要传递给目标的 x-response-time 标头。
via：（默认值：true）设置为 false 可阻止通过标头传递给目标。

OAuth 属性

这些设置用于配置 Edge Microgateway 如何强制执行客户端身份验证。

allowNoAuthorization：（默认值：false）如果设置为 true，则会执行 API 调用允许在没有任何授权标头的情况下通过 Edge Microgateway。将此项设为 false 表示需要使用授权标头（默认）。
allowInvalidAuthorization：（默认值：false）如果设置为 true，则会执行 API 调用在 Authorization 标头中传递的令牌无效或过期时允许传递。设置此项设置为 false 则要求有效令牌（默认）。
authorization-header：（默认值： Authorization: Bearer）用于将访问令牌发送到 Edge Microgateway。如果遇到这种情况，您可能需要更改目标需要使用 Authorization 标头来实现其他目的。
api-key-header：（默认值：x-api-key）标头或查询的名称参数，用于将 API 密钥传递给 Edge Microgateway。另请参阅使用 API 密钥。
keep-authorization-header：（默认值：false）如果设为 true，则授权标头会传递到目标（会得到保留）。
allowOAuthOnly - 如果设置为 true，则每个 API 都必须带有授权带有不记名访问令牌的标头。允许您仅允许 OAuth 安全模型（而保持向后兼容性）。（添加了 2.4.x）
allowAPIKeyOnly - 如果设置为 true，则每个 API 都必须带有带有 API 密钥的 x-api-key 标头（或自定义位置）。允许您允许仅 API 密钥安全模型（同时保持向后兼容性）。（添加了 2.4.x）
请勿同时设置 allowOAuthOnly 和 allowAPIKeyOnly 设置为 true。默认设置为两个标志都设为 false （以实现向后兼容性）。
gracePeriod - 此参数有助于防止由于轻度系统时钟与“不早于”(nbf) 或颁发时间 (iat) 时间之间存在差异指定 JWT 授权令牌。将此参数设置为允许的秒数处理这些差异。（添加了 2.5.7）

插件专用属性

要详细了解每个插件的可配置属性，请参阅“使用插件”。

过滤代理

您可以过滤 Edge Microgateway 实例将处理哪些 microgateway 感知代理。 Edge Microgateway 启动时，会下载组织。使用以下配置来限制 microgateway 将对其进行处理。例如，此配置限制了 microgateway 将处理为三个：edgemicro_proxy-1、edgemicro_proxy-2、和 edgemicro_proxy-3：

edgemicro:
  proxies:
  - edgemicro_proxy-1
  - edgemicro_proxy-2
  - edgemicro_proxy-3

按名称过滤商品

使用以下配置来限制 Edge Microgateway 使用的 API 产品的数量下载和处理。如需过滤下载的商品，请添加productnamefilter 查询参数添加到 Edge Microgateway *.config.yaml 中列出的 /products API 文件。例如：

edge_config:
  bootstrap: >-
    https://edgemicroservices.apigee.net/edgemicro/bootstrap/organization/willwitman/environment/test
  jwt_public_key: 'https://myorg-test.apigee.net/edgemicro-auth/publicKey'
  managementUri: 'https://api.enterprise.apigee.com'
  vaultName: microgateway
  authUri: 'https://%s-%s.apigee.net/edgemicro-auth'
  baseUri: >-
    https://edgemicroservices.apigee.net/edgemicro/%s/organization/%s/environment/%s
  bootstrapMessage: Please copy the following property to the edge micro agent config
  keySecretMessage: The following credentials are required to start edge micro
  products: 'https://myorg-test.apigee.net/edgemicro-auth/products?productnamefilter=%5E%5BEe%5Ddgemicro.%2A%24'

请注意，查询参数的值必须以正则表达式格式指定，并且进行网址编码。例如，正则表达式 ^[Ee]dgemicro.*$ 可捕获如下名称： “edgemicro-test-1”、“edgemicro_demo”和“Edgemicro_New_Demo”。网址编码值，适用于是 %5E%5BEe%5Ddgemicro.%2A%24。

以下调试输出显示仅下载了过滤后的商品：

...
2020-05-27T03:13:50.087Z [76060] [microgateway-config network] products download from https://gsc-demo-prod.apigee.net/edgemicro-auth/products?productnamefilter=%5E%5BEe%5Ddgemicro.%2A%24 returned 200 OK
...
....
....
{
   "apiProduct":[
      {
         "apiResources":[

         ],
         "approvalType":"auto",
         "attributes":[
            {
               "name":"access",
               "value":"public"
            }
         ],
         "createdAt":1590549037549,
         "createdBy":"k***@g********m",
         "displayName":"test upper case in name",
         "environments":[
            "prod",
            "test"
         ],
         "lastModifiedAt":1590549037549,
         "lastModifiedBy":"k***@g********m",
         "name":"Edgemicro_New_Demo",
         "proxies":[
            "catchall"
         ],
         "quota":"null",
         "quotaInterval":"null",
         "quotaTimeUnit":"null",
         "scopes":[

         ]
      },
      {
         "apiResources":[

         ],
         "approvalType":"auto",
         "attributes":[
            {
               "name":"access",
               "value":"public"
            }
         ],
         "createdAt":1590548328998,
         "createdBy":"k***@g********m",
         "displayName":"edgemicro test 1",
         "environments":[
            "prod",
            "test"
         ],
         "lastModifiedAt":1590548328998,
         "lastModifiedBy":"k***@g********m",
         "name":"edgemicro-test-1",
         "proxies":[
            "Lets-Encrypt-Validation-DoNotDelete"
         ],
         "quota":"null",
         "quotaInterval":"null",
         "quotaTimeUnit":"null",
         "scopes":[

         ]
      },
      {
         "apiResources":[
            "/",
            "/**"
         ],
         "approvalType":"auto",
         "attributes":[
            {
               "name":"access",
               "value":"public"
            }
         ],
         "createdAt":1558182193472,
         "createdBy":"m*********@g********m",
         "displayName":"Edge microgateway demo product",
         "environments":[
            "prod",
            "test"
         ],
         "lastModifiedAt":1569077897465,
         "lastModifiedBy":"m*********@g********m",
         "name":"edgemicro_demo",
         "proxies":[
            "edgemicro-auth",
            "edgemicro_hello"
         ],
         "quota":"600",
         "quotaInterval":"1",
         "quotaTimeUnit":"minute",
         "scopes":[

         ]
      }
   ]
}

按自定义属性过滤商品

要根据自定义属性过滤商品，请执行以下操作：

在 Edge 界面中，选择组织/环境中的 edgemicro_auth 代理其中配置 Edge Microgateway。
在“开发”点按界面中，在编辑器中打开“JavaCallout”政策。
添加键为 products.filter.attributes 的自定义属性（以英文逗号分隔）属性名称列表。仅限包含任何自定义属性名称的商品将返回至 Edge Microgateway。
您可以选择性地停用通过设置将自定义属性 products.filter.env.enable 设置为 false。（默认值为 true）。
（仅限私有云）如果您使用的是适用于私有云的 Edge，请设置属性从 org.noncps 到 true，可拉取适用于非 CPS 环境的产品。

例如：

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<JavaCallout async="false" continueOnError="false" enabled="true" name="JavaCallout">
    <DisplayName>JavaCallout</DisplayName>
    <FaultRules/>
    <Properties>
        <Property name="products.filter.attributes">attrib.one, attrib.two</Property>
        <Property name="products.filter.env.enable">false</Property>
        <Property name="org.noncps">true</Property>
    </Properties>
    <ClassName>io.apigee.microgateway.javacallout.Callout</ClassName>
    <ResourceURL>java://micro-gateway-products-javacallout-2.0.0.jar</ResourceURL>
</JavaCallout>

配置 Google Analytics 推送频率

使用以下配置参数来控制 Edge Microgateway 发送的频率导出到 Apigee：

bufferSize（可选）：读取广告缓冲区可以在开始删除最早的记录之前持有。默认值：10000
batchSize（可选）：一批分析记录的大小上限发送到 Apigee 的平台默认值：500
flushInterval（可选）：每次刷新间隔的毫秒数将一批分析记录发送到 Apigee。默认值：5000

例如：

analytics:
  bufferSize: 15000
  batchSize: 1000
  flushInterval: 6000

遮盖分析数据

以下配置可防止请求路径信息显示在 Edge 中分析。将以下内容添加到 microgateway 配置，以遮盖请求 URI 和/或请求路径。请注意，URI 包含请求的主机名和路径部分。

analytics:
  mask_request_uri: 'string_to_mask'
  mask_request_path: 'string_to_mask'

在 Edge Analytics 中隔离 API 调用

您可以将分析插件配置为隔离特定的 API 路径，使其显示为在 Edge Analytics 信息中心内使用单独的代理。例如，您可以在信息中心内隔离健康检查 API，以免与实际的 API 代理调用混淆。在 Analytics 信息中心内，独立代理遵循以下命名模式：

edgemicro_proxyname-health

下图显示了 Google Analytics 信息中心内的两个独立代理：edgemicro_hello-health 和 edgemicro_mock-health：

使用这些参数，将 Google Analytics 信息中心内的相对路径和绝对路径隔离为单独的代理：

relativePath（可选）：指定要在 Analytics 信息中心。例如，如果您指定 /healthcheck，则包含该路径的所有 API 调用 /healthcheck在信息中心内将显示为 edgemicro_proxyname-health。请注意，此标志会忽略代理基本路径。如需根据完整路径（包括基本路径）进行隔离，请使用 proxyPath 标志。
proxyPath（可选）：指定完整的 API 代理路径，包括代理基本路径，在分析信息中心内隔离出来。例如，如果您指定 /mocktarget/healthcheck，其中/mocktarget 是代理基本路径，路径为 /mocktarget/healthcheck 的所有 API 调用都将在信息中心内显示为 edgemicro_proxyname-health。

例如，在以下配置中，包含 /healthcheck 的任何 API 路径都将与分析插件隔离开来这意味着，/foo/healthcheck 和 /foo/bar/healthcheck 将在 Google Analytics 信息中心内被隔离为名为 edgemicro_proxyname-health 的单独代理。

analytics:
  uri: >-
    https://xx/edgemicro/ax/org/docs/environment/test
  bufferSize: 100
  batchSize: 50
  flushInterval: 500
  relativePath: /healthcheck

在以下配置中，任何具有代理路径 /mocktarget/healthcheck 的 API 将被隔离为名为edgemicro_proxyname-health的单独代理查看分析信息中心

analytics:
  uri: >-
    https://xx/edgemicro/ax/org/docs/environment/test
  bufferSize: 100
  batchSize: 50
  flushInterval: 500
  proxyPath: /mocktarget/healthcheck

在公司防火墙

使用 HTTP 代理与 Apigee Edge 通信

在版本 3.1.2 中引入。

如需使用 HTTP 代理进行 Edge Microgateway 与 Apigee Edge 之间的通信，请执行以下操作：以下：

设置环境变量 HTTP_PROXY、HTTPS_PROXY和NO_PROXY。这些变量控制您希望用来与其进行通信的每个 HTTP 代理的主机 Apigee Edge，或哪些主机不应处理与 Apigee Edge 的通信。例如：
```
export HTTP_PROXY='http://localhost:3786'
export HTTPS_PROXY='https://localhost:3786'
export NO_PROXY='localhost,localhost:8080'
```
请注意，NO_PROXY 可以是 Edge Microgateway 配置的网域列表（以英文逗号分隔）不应代理。

如需详细了解这些变量，请参阅 https://www.npmjs.com/package/request#controlling-proxy-behaviour-using-environment-variables
重启 Edge Microgateway。

使用 HTTP 代理进行目标通信

在版本 3.1.2 中引入。

如需使用 HTTP 代理进行 Edge Microgateway 与后端目标之间的通信，请执行以下操作：执行以下操作：

将以下配置添加到 microgateway 配置文件中：
```
edgemicro:
  proxy:
    tunnel: true | false
    url: proxy_url
    bypass: target_host # target hosts to bypass the proxy.
    enabled: true | false
```
其中：
- tunnel：（可选）如果为 true，Edge Microgateway 将使用 HTTP CONNECT 方法建立 HTTP 隧道通过单个 TCP 连接发送请求。（如果环境变量也是如此），启用 TLS）。默认值：false
- url：HTTP 代理网址。
- bypass：（可选）指定一个或多个以英文逗号分隔的目标主机网址，应绕过 HTTP 代理。如果未设置此属性，则使用 NO_PROXY 环境变量指定要绕过的目标网址。
- enabled：如果设置为 true 且已设置 proxy.url，则对 HTTP 代理使用 proxy.url 值。如果为 true 且未设置 proxy.url，请使用 HTTP 代理中指定的代理环境变量 HTTP_PROXY 和 HTTPS_PROXY，如使用 HTTP 代理与 Apigee Edge 通信。
例如：
```
edgemicro:
  proxy:
    tunnel: true
    url: 'http://localhost:3786'
    bypass: 'localhost','localhost:8080' # target hosts to bypass the proxy.
    enabled: true
```
注意：如果 edgemicro.proxy 从配置文件，或者如果 edgemicro.proxy.enabled 为 false，则 Edge Microgateway 不会使用用于目标通信的 HTTP 代理。
重启 Edge Microgateway。

在 Microgateway 感知中使用通配符个指标

您可以使用一个或多个“*”或包含通配符 edgemicro_*（可感知 Microgateway）代理。例如， /team/*/members 允许客户调用 https://[host]/team/blue/members 和 https://[host]/team/green/members，而无需创建新的 API 代理为新团队提供支持请注意，不支持 /**/。

重要提示：Apigee 不支持使用通配符“*”用作基本路径的第一个元素。例如，不支持：/*/ 搜索。

轮替 JWT 密钥

在最初生成 JWT 之后的某个时间，您可能需要更改存储在 Edge 加密 KVM 中的公钥/私钥对。生成新密钥的过程称为密钥轮替。

Edge Microgateway 如何使用 JWT

JSON 网络令牌 (JWT) 是 RFC7519 中所述的令牌标准。JWT 提供了对一组声明进行签名的方式且可由 JWT 接收方进行可靠的验证。

您可以使用 CLI 生成 JWT，并在 API 调用的授权标头，而不是 API 密钥。例如：

curl -i http://localhost:8000/hello -H "Authorization: Bearer eyJhbGciOiJ..dXDefZEA"

如需了解如何使用 CLI 生成 JWT，请参阅生成令牌。

什么是密钥轮替？

在最初生成 JWT 之后的某个时间，您可能需要更改存储在 Edge 加密 KVM 中的公钥/私钥对。生成新密钥的过程称为密钥轮替。当您轮替密钥时，系统会生成新的私钥/公钥对，存储在“microgateway”您的 Apigee Edge 组织/环境中的 KVM。此外，旧公钥及其原始密钥 ID 值会保留下来。

为了生成 JWT，Edge 会使用存储在加密 KVM 中的信息。答在您最初设置（配置）时创建并填充了名为 microgateway 的 KVM， Edge Microgateway。KVM 中的密钥用于对 JWT 进行签名和加密。

KVM 密钥包括：

private_key - 用于签名的最新（最近创建）RSA 私钥 JWT。
public_key - 用于验证 JWT 的最新（最近创建）证书使用 private_key 进行签名。
private_key_kid - 最新（最近创建的）私钥 ID。此密钥 ID 与 private_key 值相关联，用于支持密钥轮替。
public_key1_kid - 最新（最近创建的）公钥 ID。此键为与 public_key1 值相关联，用于支持密钥轮替。此值与私钥小区相同。
public_key1 - 最新（最近创建的）公钥。

执行密钥轮替时，系统会替换映射中的现有密钥值，密钥以保留旧的公钥。例如：

public_key2_kid - 旧的公钥 ID。此键与 public_key2 值，用于支持密钥轮替。
public_key2 - 旧的公钥。

将使用新的公钥对呈现以供验证的 JWT 进行验证。如果验证失败，系统将使用旧的公钥，直到 JWT 过期（token_expiry* 间隔之后，默认为 30 分钟）。在通过这种方式，您可以密钥，而不会立即中断 API 流量。

如何进行密钥轮替

本部分介绍了如何执行密钥轮替。

如需升级 KVM，请使用 edgemicro upgradekvm 命令。了解详情请参阅升级 KVM。此步骤只需执行一次。
如需升级 edgemicro-oauth 代理，请使用 edgemicro upgradeauth 命令。有关运行此命令的详细信息，请参阅升级 Edgemicro-auth 代理。此步骤只需执行一次。
将以下代码行添加到 ~/.edgemicro/org-env-config.yaml 文件中，指定您配置微网关所使用的同一组织和环境：
```
jwk_public_keys: 'https://$ORG-$ENV.apigee.net/edgemicro-auth/jwkPublicKeys'
```

运行密钥轮替命令以轮替密钥。如需详细了解此命令，请参阅轮替密钥。

edgemicro rotatekey -o $ORG -e $ENV -k $KEY -s $SECRET

例如：

edgemicro rotatekey -o docs -e test \
-k 27ee39567c75e4567a66236cbd4e86d1cc93df6481454301bd5fac4d3497fcbb \
-s 4618b0008a6185d7327ebf53bee3c50282ccf45a3cceb1ed9828bfbcf1148b47

密钥轮替后，Edge 会将多个密钥返回到 Edge Microgateway。备注例如，每个键都有一个唯一的“kid”（键 ID）值。然后，微网关会使用密钥来验证授权令牌。如果令牌验证失败，则微网关会向查看键集中是否有较旧的键，并尝试该键。该返回的密钥是 JSON 网络密钥 (JWK)。您可以在 RFC 7517 中了解此格式。

{
  "keys": [
    {
      "kty": "RSA",
      "n": "nSl7R_0wKLiWi6cO3n8aOJwYGBtinq723Jgg8i7KKWTSTYoszOjgGsJf_MX4JEW1YCScwpE5o4o8ccQN09iHVTlIhk8CNiMZNPipClmRVjaL_8IWvMQp1iN66qy4ldWXzXnHfivUZZogCkBNqCz7VSC5rw2Jf57pdViULVvVDGwTgf46sYveW_6h8CAGaD0KLd3vZffxIkoJubh0yMy0mQP3aDOeIGf_akeZeZ6GzF7ltbKGd954iNTiKmdm8IKhz6Y3gLpC9iwQ-kex_j0CnO_daHl1coYxUSCIdv4ziWIeM3dmjQ5_2dEvUDIGG6_Az9hTpNgPE5J1tvrOHAmunQ",
      "e": "AQAB",
      "kid": "2"
    },
    {
      "kty": "RSA",
      "n": "8BKwzx34BMUcHwTuQtmp8LFRCMxbkKg_zsWD6eOMIUTAsORexTGJsTy7z-4aH0wJ3fT-3luAAUPLBQwGcuHo0P1JnbtPrpuYjaJKSZOeIMOnlryJCspmv-1xG4qAqQ9XaZ9C97oecuj7MMoNwuaZno5MvsY-oi5B_gqED3vIHUjaWCErd4reONyFSWn047dvpE6mwRhZbcOTkAHT8ZyKkHISzopkFg8CD-Mij12unxA3ldcTV7yaviXgxd3eFSD1_Z4L7ZRsDUukCJkJ-8qY2-GWjewzoxl-mAW9D1tLK6qAdc89yFem3JHRW6L1le3YK37-bs6b2a_AqJKsKm5bWw",
      "e": "AQAB",
      "kid": "1"
    }
  ]
}

配置“不早于”延迟

对于 3.1.5 及更低版本，由 rotatekey 命令生成的新私钥并且生成的新令牌会使用新私钥进行签名。不过，新公钥每 10 分钟仅可供 Edge Microgateway 实例使用（默认情况下）当 microgateway 配置刷新时触发。由于令牌签名之间的延迟和 Microgateway 实例刷新时，使用最新密钥签名的令牌将被拒绝，直到所有实例都收到了最新的公钥。

如果存在多个微网关实例，则有时会导致公钥延迟出现状态为 403 的间歇性运行时错误，因为令牌验证会跳过但在另一个实例上会失败，直到所有实例都刷新完毕。

从版本 3.1.6 开始，rotatekey 命令中新增了一个标志，可用于为新私钥失效，从而让系统有时间刷新所有微网关实例并接收新的公钥。新标志为 --nbf，表示“not before”。此标志采用整数值，表示延迟的分钟数。

在以下示例中，延迟时间设置为 15 分钟：

edgemicro rotatekey -o docs -e test \
-k 27ee39567c75e4567a66236cbd4e86d1cc93df6481454301bd5fac4d3497fcbb \
-s 4618b0008a6185d7327ebf53bee3c50282ccf45a3cceb1ed9828bfbcf1148b47 \
--nbf 15

请注意，最好将延迟时间设置为大于 config_change_poll_internal 配置设置。默认为 10 分钟另请参阅 edgemicro 属性。

过滤下载的代理

默认情况下，Edge Microgateway 会下载 Edge 组织中的所有代理名称前缀“edgemicro_”开头的应用了您可以更改此默认设置以下载代理其名称与某个模式匹配。

打开 Edge Micro 配置文件：~/.edgemicro/org-env-config.yaml
在 Edge_config 下添加 proxyPattern 元素。例如，以下格式下载 Edgemicro_foo、edgemicro_fast 和 edgemicro_first 等代理。
```
edge_config:
…
proxyPattern: edgemicro_f*
```

指定没有 API 代理的产品

在 Apigee Edge 中，您可以创建不包含任何 API 代理的 API 产品。此产品配置允许与该产品关联的 API 密钥用于任何部署了代理从 2.5.4 版开始，Edge Microgateway 支持此产品配置。

调试和问题排查

连接到调试程序

您可以使用调试程序（例如 node-inspector）运行 Edge Microgateway。这对于自定义插件的问题排查和调试。

在调试模式下重启 Edge Microgateway。为此，请将 DEBUG=* 添加到 start 命令的开头：
```
DEBUG=* edgemicro start -o $ORG -e $ENV -k $KEY -s $SECRET
```
注意：在 Windows 上，请使用 SET DEBUG=*

如需将调试输出定向到文件，您可以使用以下命令：
```
export DEBUG=* nohup edgemicro start \
-o $ORG -e $ENV -k $KEY -s $SECRET 2>&1 | tee /tmp/file.log
```
启动调试程序，并将其设置为监听调试过程的端口号。
现在，您可以逐步执行 Edge Microgateway 代码、设置断点、监视表达式，依此类推。

您可以指定与调试模式相关的标准 Node.js 标志。例如： --nolazy 有助于调试异步代码。

检查日志文件

如果您遇到问题，请务必检查日志文件以获取执行详情和错误信息。有关详情，请参阅管理日志文件。

使用 API 密钥安全性

API 密钥提供了一种简单的机制，用于对向 Edge 发出请求的客户端进行身份验证 Microgateway。您可以通过复制使用方密钥（也称为“客户端 ID”）值来获取 API 密钥。

缓存键

API 密钥交换为已缓存的不记名令牌。您可以通过将发送到 Edge 的传入请求中的 Cache-Control: no-cache 标头 Microgateway。

使用 API 密钥

您可以在 API 请求中将 API 密钥作为查询参数或标头传递。默认情况下标头和查询参数名称均为 x-api-key。

查询参数示例：

curl http://localhost:8000/foobar?x-api-key=JG616Gjz7xs4t0dvpvVsGdI49G34xGsz

标头示例：

curl http://localhost:8000/foobar -H "x-api-key:JG616Gjz7xs4t0dvpvVsGdI49G34xGsz"

配置 API 密钥名称

默认情况下，x-api-key 是 API 密钥标头和查询参数使用的名称。如更改配置中所述，您可以在配置文件中更改此默认设置。例如，要更改 apiKey：

oauth:
  allowNoAuthorization: false
  allowInvalidAuthorization: false
  api-key-header: apiKey

在此示例中，查询参数和标头名称均更改为 apiKey。通过无论是哪种情况，名称“x-api-key”都将不再有效。另请参阅更改配置。

例如：

curl http://localhost:8000/foobar -H "apiKey:JG616Gjz7xs4t0dvpvVsGdI49G34xGsz"

有关将 API 密钥用于代理请求的详细信息，请参阅 Secure Edge Microgateway。

启用上行响应代码

默认情况下，如果存在以下情况，oauth 插件仅返回 4xx 错误状态代码该响应不是 200 状态。您可以更改此行为，根据错误返回确切的 4xx 或 5xx 代码。

如需启用此功能，请添加 oauth.useUpstreamResponse: true 属性添加到 Edge Microgateway 配置。例如：

oauth:
  allowNoAuthorization: false
  allowInvalidAuthorization: false
  gracePeriod: 10
  useUpstreamResponse: true

使用 OAuth2 令牌安全性

本部分介绍了如何获取 OAuth2 访问令牌和刷新令牌。访问令牌用于确保 API 调用的安全性。刷新令牌用于获取新的访问令牌。

如何获取访问令牌

本部分介绍了如何使用 edgemicro-auth 代理获取访问令牌。

您还可以使用 edgemicro token CLI 命令获取访问令牌。如需详细了解 CLI，请参阅管理令牌。

API 1：将凭据作为正文参数发送

替换网址中的组织和环境名称，并请替换从 Apigee 上的开发者应用获取的使用方 ID 和使用方密钥值 client_id 和 client_secret 正文参数的 Edge：

curl -i -X POST "http://<org>-<test>.apigee.net/edgemicro-auth/token" \
-d '{"grant_type": "client_credentials", "client_id": "your_client_id", \
"client_secret": "your_client_secret"}' -H "Content-Type: application/json"

API 2：在基本身份验证标头中发送凭据

将客户端凭据作为基本身份验证标头发送， grant_type 作为表单参数。关于此命令格式 RFC 6749：OAuth 2.0 授权框架。

http://<org>-<test>.apigee.net/edgemicro-auth/token -v -u your_client_id:your_client_secret \
-d 'grant_type=client_credentials' -H "Content-Type: application/x-www-form-urlencoded"

输出示例

API 会返回 JSON 响应。请注意，token 和 access_token 属性。您可以使用其中任何一个。请注意，expires_in 是以秒为单位的整数值。

{
"token": "eyJraWQiOiIxIiwidHlwIjoi",
"access_token": "eyJraWQiOiIxIiwid",
"token_type": "bearer",
"expires_in": 1799
}

如何获取刷新令牌

要获取刷新令牌，请对/token edgemicro-auth 代理。您必须使用 password 进行此 API 调用授权类型。您可以按照以下步骤操作。

通过 /token API 获取访问令牌和刷新令牌。请注意，授权类型为 password：

curl -X POST \
  https://your_organization-your_environment.apigee.net/edgemicro-auth/token \
  -H 'Content-Type: application/json' \
  -d '{
   "client_id":"mpK6l1Bx9oE5zLdifoDbF931TDnDtLq",
   "client_secret":"bUdDcFgv3nXffnU",
   "grant_type":"password",
   "username":"mpK6lBx9RoE5LiffoDbpF931TDnDtLq",
   "password":"bUdD2FvnMsXffnU"
}'

该 API 会返回一个访问令牌和一个刷新令牌。响应类似于这个。请注意，expires_in 值为整数，以秒为单位。

{
    "token": "your-access-token",
    "access_token": "your-access-token",
    "token_type": "bearer",
    "expires_in": 108,
    "refresh_token": "your-refresh-token",
    "refresh_token_expires_in": 431,
    "refresh_token_issued_at": "1562087304302",
    "refresh_token_status": "approved"
}

现在，您可以调用同一 API 的 /refresh 端点。例如：

curl -X POST \
  https://willwitman-test.apigee.net/edgemicro-auth/refresh \
  -H 'Content-Type: application/json' \
  -d '{
   "client_id":"mpK6l1Bx9RoE5zLifoDbpF931TDnDtLq",
   "client_secret":"bUdDc2Fv3nMXffnU",
   "grant_type":"refresh_token",
   "refresh_token":"your-refresh-token"
}'

API 会返回一个新的访问令牌。响应类似于以下内容：

{
    "token": "your-new-access-token"
    }

永久监控

已移除：此 CLI 功能已在 Edge Microgateway 版本中移除 3.3.3.您可以用 PM2 代替forever-monitor。如需了解详情，请参阅此 Apigee 社区帖子：Edgemicro + PM2：以服务形式启动 Edgemicro。另请参阅 Edge Microgateway 3.3.3 版本说明。

指定配置文件端点

如果您运行多个 Edge Microgateway 实例，您可能希望管理其配置。为此，您可以指定一个 HTTP 端点下载其配置文件使用以下命令启动 Edge Micro 时，您可以指定此端点： -u 标志。

例如：

edgemicro start -o jdoe -e test -u http://mylocalserver/mgconfig -k public_key -s secret_key

其中，mgconfig 端点会返回配置文件的内容。这就是文件该属性默认位于 ~/.edgemicro 中，并采用以下命名惯例： org-env-config.yaml。

停用 TCP 连接数据缓冲

您可以使用 nodelay 配置属性为以下内容停用数据缓冲： Edge Microgateway 使用的 TCP 连接。

默认情况下，TCP 连接使用 Nagle 算法在发送数据之前缓冲数据。正在将 nodelay 设置为 true，停用此行为（每次调用 socket.write()）。另请参阅 Node.js 文档了解详情。

如需启用 nodelay，请按如下方式修改 Edge Micro 配置文件：

edgemicro:
  nodelay: true
  port: 8000
  max_connections: 1000
  config_change_poll_interval: 600
  logging:
    level: error
    dir: /var/tmp
    stats_log_interval: 60
    rotate_interval: 24

在独立模式下运行 Edge Microgateway

您可以运行与任何设备完全断开连接的 Edge Microgateway Apigee Edge 依赖项。这种场景称为独立模式，可让您运行和测试 Edge Microgateway 无法连接互联网。

在独立模式下，以下功能无法运行，因为它们需要连接到网络迁移到 Apigee Edge：

OAuth 和 API 密钥
配额
分析

另一方面，自定义插件和高峰控制可以正常工作，因为它们需要连接到 Apigee Edge。此外，借助一个名为 extauth 的新插件，在独立模式下使用 JWT 授权对微网关的 API 调用。

配置和启动网关

如需在独立模式下运行 Edge Microgateway，请执行以下操作：

创建一个名为 $HOME/.edgemicro/$ORG-$ENV-config.yaml 的配置文件，如下所示：
您可以根据需要对文件名中的 $ORG 和 $ENV 使用任何值。组织/环境组合只是一种惯例，可以让 Edge Microgateway 在遇到以下情况时查找文件：启动。

例如：
```
vi $HOME/.edgemicro/foo-bar-config.yaml
```
将以下代码粘贴到此文件中：
```
edgemicro:
  port: 8000
  max_connections: 1000
  config_change_poll_interval: 600
  logging:
    level: error
    dir: /var/tmp
    stats_log_interval: 60
    rotate_interval: 24
  plugins:
    sequence:
      - extauth
      - spikearrest
headers:
  x-forwarded-for: true
  x-forwarded-host: true
  x-request-id: true
  x-response-time: true
  via: true
extauth:
  publickey_url: https://www.googleapis.com/oauth2/v1/certs
spikearrest:
  timeUnit: second
  allow: 10
  buffersize: 0
```
该配置文件包含一个名为 extauth 的特殊可选插件。此插件用于验证传递到 microgateway 的有效 JWT 令牌。在后面的步骤中，您将学习如何获取并使用该令牌。另请注意，spikearrest 插件包含它，因为它不依赖于与 Edge 的连接。quota、 oauth 和 analytics 插件被排除，因为它们依赖于与 Edge 和在断开连接模式下无法运行。允许使用自定义插件，并将正常运行符合预期。
导出以下值为“1”的环境变量：
```
export EDGEMICRO_LOCAL=1
```
执行以下 start 命令，您可以在其中提供值以实例化本地代理：
```
edgemicro start -o $ORG -e $ENV -a $LOCAL_PROXY_NAME \
  -v $LOCAL_PROXY_VERSION -t $TARGET_URL -b $BASE_PATH
```
其中：
- $ORG 是“组织”您在配置文件名称中使用的名称
- $ENV 是“env”您在配置文件中使用的名称。
- $LOCAL_PROXY_NAME 是将创建的本地代理的名称。您可以使用随意命名。
- $LOCAL_PROXY_VERSION 是代理的版本号。
- $TARGET_URL 是代理目标的网址。（目标是（由代理调用的服务）。
- $BASE_PATH 是该代理的基本路径。此值必须以正向开头斜杠。对于根基本路径，只需指定正斜杠；例如“/”。
例如：
```
edgemicro start -o local -e test -a proxy1 -v 1 -t http://mocktarget.apigee.net -b /
```
测试配置。
```
curl http://localhost:8000/echo  { "error" : "missing_authorization" }
```
由于 extauth 插件位于 foo-bar-config.yaml 文件中，因此您需要获取“missing_authorization”错误。此插件用于验证授权中必须包含的 JWT API 调用的标头。在下一部分中，您将获取允许 API 调用的 JWT 以确保整个过程不会出现错误

示例：获取授权令牌

以下示例展示了如何从 Apigee Edge 上的 Edge Microgateway JWT 端点 (edgemicro-auth/jwkPublicKeys) 获取 JWT。当您对 Edge Microgateway 执行标准设置和配置时，系统会部署此端点。要从 Apigee 端点获取 JWT，您必须先执行标准的 Edge Microgateway 设置，并且必须连接到互联网。此处以 Apigee 端点为例进行说明，不是必需的。如果您愿意，可以使用其他 JWT 令牌端点。如果包含，则需要使用为该端点提供的 API。

您可以自由选择是否在 microgateway 配置中添加 extauth 插件，但如果包含它，因此您需要在 Authorization 标头中提供有效的 JWT 令牌以进行 API 调用。

以下步骤说明了如何使用 edgemicro-auth/jwkPublicKeys 端点获取令牌：

您必须执行标准设置和配置 Edge Microgateway，以部署 edgemicro-auth 代理 Apigee Edge 上的组织/环境。如果您以前执行过此步骤，则无需重复。
如果您已将 Edge Microgateway 部署到 Apigee Cloud，则必须连接到互联网，以便从此端点获取 JWT。
停止 Edge Microgateway：
```
edgemicro stop
```
在您之前创建的配置文件 ($HOME/.edgemicro/org-env-config.yaml) 中，指向extauth:publickey_url 属性添加到 Apigee Edge 组织/环境中的 edgemicro-auth/jwkPublicKeys 端点。例如：
```
extauth:
  publickey_url: 'https://your_org-your_env.apigee.net/edgemicro-auth/jwkPublicKeys'
```
使用您在配置文件名称中使用的组织/环境名称，像之前一样重启 Edge Microgateway。例如：
```
edgemicro start -o foo -e bar -a proxy1 -v 1 -t http://mocktarget.apigee.net -b /
```
从授权端点获取 JWT 令牌。因为您使用的是edgemicro-auth/jwkPublicKeys 可以使用此 CLI 命令：
要执行此步骤，您需要连接互联网。以下命令用于来自 Apigee Edge 的令牌要执行此步骤，您必须拥有一个 Apigee 组织，并且该组织您执行了标准的 Edge Microgateway 设置和配置。完成此步骤后，您无需连接到互联网。令牌在独立模式下可继续工作，直至过期。

您可以使用 edgemicro token 命令或 API。例如：

edgemicro token get -o your_org -e your_env \
  -i G0IAeU864EtBo99NvUbn6Z4CBwVcS2 -s uzHTbwNWvoSmOy

其中：

your_org 是您之前为其创建的 Apigee 组织的名称已配置 Edge Microgateway。
your_env 是组织中的环境。
i 选项用于指定具有商品的开发者应用中的使用方密钥（包含 edgemicro-auth 代理）。
s 选项用于指定来自满足以下条件的开发者应用的使用方密钥：产品的 edgemicro-auth 代理。

此命令要求 Apigee Edge 生成 JWT，然后可用于验证 API 调用。

另请参阅生成令牌。

测试独立配置

如需测试配置，请使用 Authorization 标头中添加的令牌调用 API，如下所示：

curl http://localhost:8000/echo -H "Authorization: Bearer your_token

示例：

curl http://localhost:8000/echo -H "Authorization: Bearer eyJraWQiOiIxIiwidHlwIjo...iryF3kwcDWNv7OQ"

输出示例：

{
   "headers":{
      "user-agent":"curl/7.54.0",
      "accept":"*/*",
      "x-api-key":"DvUdLlFwG9AvGGpEgfnNGwtvaXIlUUvP",
      "client_received_start_timestamp":"1535134472699",
      "x-authorization-claims":"eyJhdDbiO...M1OTE5MTA1NDkifQ==",
      "target_sent_start_timestamp":"1535134472702",
      "x-request-id":"678e3080-a7ae-11e8-a70f-87ae30db3896.8cc81cb0-a7c9-11e8-a70f-87ae30db3896",
      "x-forwarded-proto":"http",
      "x-forwarded-host":"localhost:8000",
      "host":"mocktarget.apigee.net",
      "x-cloud-trace-context":"e2ac4fa0112c2d76237e5473714f1c85/1746478453618419513",
      "via":"1.1 localhost, 1.1 google",
      "x-forwarded-for":"::1, 216.98.205.223, 35.227.194.212",
      "connection":"Keep-Alive"
   },
   "method":"GET",
   "url":"/",
   "body":""
}

使用本地代理模式

在本地代理模式下，Edge Microgateway 不需要 microgateway-aware 代理要部署在 Apigee Edge 上您可以配置“本地代理”通过提供本地代理名称、基本路径和目标网址启动 microgateway。然后，对 microgateway 的 API 调用会发送到目标本地代理的网址。在所有其他方面，本地代理模式与处于普通模式的 Edge Microgateway。身份验证的工作原理与峰值一样限制和配额强制执行、自定义插件等。

本地模式与常规 Edge Microgateway 之间的两个重要区别 (1) 在本地模式下，您无需创建可感知微网关在 Apigee Edge 上创建代理；(2) 在 Edge 上创建 API 产品时，您只能向其添加一个代理； edgemicro-auth 代理。您无需向该产品添加任何其他代理。

用例和示例

当您只需将单个代理与 Edge Microgateway 相关联时，本地代理模式非常有用实例。例如，您可以将 Edge Microgateway 作为 Sidecar 代理添加到 Kubernetes 中， microgateway 和 2 个 Service 均在单个 Pod 中运行，而 microgateway 则通过 microgateway 管理以及相应的配套服务下图说明了这种架构 Microgateway 在 Kubernetes 集群中用作 Sidecar 代理。每个微网关实例仅发送到其配套服务上的单个端点：

Edgemicro 作为 Sidecar

这种架构的一大优势是管理部署到容器环境中的各项服务，例如 Kubernetes 集群

配置本地代理模式

如需将 Edge Microgateway 配置为在本地代理模式下运行，请按以下步骤操作：

运行 edgemicro init 以准确设置本地配置环境就像在典型的 Edge Microgateway 设置中一样。另请参阅配置 Edge Microgateway。
像在典型的 Edge Microgateway 设置中一样运行 edgemicro configure 过程。例如：
```
edgemicro configure -o your_org -e your_env -u your_apigee_username
```
此命令会将 edgemicro-auth 政策部署到 Edge 并返回密钥和 Secret（启动微网关所需的密钥）。如果您需要帮助，请参阅配置 Edge Microgateway。
在 Apigee Edge 上，创建 API 产品并使用以下强制性配置要求（您可以根据需要管理所有其他配置）： <ph type="x-smartling-placeholder">
- 您必须为产品添加 edgemicro-auth 代理。此代理是在您运行 edgemicro configure 时自动部署的。
- 您必须提供资源路径。Apigee 建议将此路径添加到商品：/**。如需了解详情，请参阅配置资源路径的行为。另请参阅创建 API 请参阅 Edge 文档。
在 Apigee Edge 上创建开发者。如果您有其他需求，也可以使用现有开发者愿望。如需帮助，请参阅使用 Edge 管理界面添加开发者。
在 Apigee Edge 上，创建一个开发者应用。您必须将 API 产品添加到新创建的应用如需帮助，请参阅在 Edge 中注册应用管理界面。
在安装了 Edge Microgateway 的机器上，导出以下内容环境变量，其中值为“1”。
```
export EDGEMICRO_LOCAL_PROXY=1
```
执行以下 start 命令：
```
edgemicro start -o your_org -e your_environment -k your_key -s your_secret \
    -a local_proxy_name -v local_proxy_version -t target_url -b base_path
```
其中：
- your_org 是您的 Apigee 组织。
- your_environment 是贵组织中的环境。
- your_key 是应用运行时返回的键 edgemicro configure。
- your_secret 是运行密钥时返回的 Secret edgemicro configure。
- local_proxy_name 是将创建的本地代理的名称。
- local_proxy_version 是代理的版本号。
- target_url 是代理目标（代理将调用）。
- base_path 是该代理的基本路径。此值必须以正向开头斜杠。对于根基本路径，只需指定正斜杠；例如“/”。
例如：
```
edgemicro start -o your_org -e test -k 7eb6aae644cbc09035a...d2eae46a6c095f \
  -s e16e7b1f5d5e24df...ec29d409a2df853163a -a proxy1 -v 1 \
  -t http://mocktarget.apigee.net -b /echo
```

测试配置

您可以通过调用代理端点来测试本地代理配置。例如：如果您将基本路径指定为 /echo，则可以按如下方式调用该代理：

curl  http://localhost:8000/echo
{
  "error" : "missing_authorization",
  "error_description" : "Missing Authorization header"
}

此初始 API 调用产生了错误，因为您没有提供有效的 API 密钥。您可以找到找到之前创建的开发者应用在 Edge 界面中打开应用，复制使用方密钥，并按如下方式使用该密钥：

curl  http://localhost:8000/echo -H 'x-api-key:your_api_key'

例如：

curl  http://localhost:8000/echo -H "x-api-key:DvUdLlFwG9AvGGpEgfnNGwtvaXIlUUvP"

输出示例：

{
  "headers":{
    "user-agent":"curl/7.54.0",
    "accept":"*/*",
    "x-api-key":"DvUdLlFwG9AvGGpEgfnNGwtvaXIlUUvP",
    "client_received_start_timestamp":"1535134472699",
    "x-authorization-claims":"eyJhdWQiOi...TQ0YmUtOWNlOS05YzM1OTE5MTA1NDkifQ==",
    "target_sent_start_timestamp":"1535134472702",
    "x-request-id":"678e3080-a7ae-11e8-a70f-87ae30db3896.8cc81cb0-a7c9-11e8-a70f-87ae30db3896",
    "x-forwarded-proto":"http",
    "x-forwarded-host":"localhost:8000",
    "host":"mocktarget.apigee.net",
    "x-cloud-trace-context":"e2ac4fa0112c2d76237e5473714f1c85/1746478453618419513",
    "via":"1.1 localhost, 1.1 google",
    "x-forwarded-for":"::1, 216.98.205.223, 35.227.194.212",
    "connection":"Keep-Alive"
  },
  "method":"GET",
  "url":"/",
  "body":""
}

使用同步程序

本节将说明如何使用同步程序，同步程序是一项可选功能，增强了 Edge Microgteway 的弹性从 Apigee Edge 检索配置数据并将其写入本地 Redis 数据库。包含一个同步器实例正在运行，其他 Edge Microgateway 实例在不同节点上运行可以直接从该数据库中检索其配置。

Syncrhonizer 功能目前支持与 Redis 5.0.x 配合使用。

什么是同步器？

同步程序为 Edge Microgateway 提供了一定程度的弹性。这有助于确保 Edge Microgateway 的每个实例都使用相同的配置，并且如果遇到互联网中断，Edge Microgateway 实例可以启动并运行正确。

默认情况下，Edge Microgateway 实例必须能够与 Apigee Edge 通信，检索和刷新其配置数据，例如 API 代理和 API 产品配置。如果与 Edge 的互联网连接中断，微网关实例可以继续函数，因为已缓存最新的配置数据。不过，新的 microgateway 实例如果没有清晰连接，则无法启动。此外，也可以让互联网中断会导致一个或多个微网关实例按照配置运行不与其他实例同步的信息。

Edge Microgateway 同步程序为 Edge Microgateway 提供了替代机制实例检索启动和处理 API 代理流量所需的配置数据。从对 Apigee Edge 的调用中检索到的配置数据包括：jwk_public_keys 调用、 jwt_public_key 调用、引导加载程序调用和 API 产品调用。通过同步程序，不同节点上运行的多个实例， Edge Microgateway 和 Apigee Edge 之间的互联网连接中断。

同步程序是经过特殊配置的 Edge Microgateway 实例。它的用途轮询 Apigee Edge（时间可配置），检索配置数据，然后写入本地 Redis 数据库。同步程序实例本身无法处理 API 代理流量。在不同节点上运行的 Edge Microgateway 实例配置为从 Redis 数据库（而不是从 Apigee）检索配置数据 Edge。由于所有微网关实例都从本地数据库，即使在互联网上，它们也可以启动并处理 API 请求造成干扰。

配置同步程序实例

将以下配置添加到 org-env/config.yaml 文件中要用作同步程序的 Edge Microgateway 安装：

edgemicro:
  redisHost: host_IP
  redisPort: host_port
  redisDb: database_index
  redisPassword: password
edge_config:
  synchronizerMode: 1
  redisBasedConfigCache: true

例如：

edgemicro:
  redisHost: 192.168.4.77
  redisPort: 6379
  redisDb: 0
  redisPassword: codemaster
edge_config:
  synchronizerMode: 1
  redisBasedConfigCache: true

选项	说明
`redisHost`	运行 Redis 实例的主机。默认值：127.0.0.1
`redisPort`	Redis 实例的端口。默认值：6379
`redisDb`	要使用的 Redis 数据库。默认值：0
`redisPassword`	您的数据库密码。

您可以使用环境变量 EDGEMICRO_REDIS_PASSWORD 覆盖 edgemicro.redisPassword 参数另请参阅使用环境变量值设置配置属性。

最后，保存配置文件并启动 Edge Microgateway 实例。它将开始轮询 Apigee Edge 并将下载的配置数据存储在 Redis 数据库中。

配置常规 Edge Microgateway 实例

在同步程序运行时，您可以配置额外的 Edge Microgateway 节点来运行处理 API 代理流量的常规 microgateway 实例。不过，您可以配置从 Redis 数据库获取其配置数据，而不是从 Apigee Edge。

将以下配置添加到每个额外 Edge Microgateway 节点的 org-env/config.yaml 文件。请注意，synchronizerMode 属性设置为 0。该属性将实例设置为正常运行处理 API 代理流量的 Edge Microgateway 实例，该实例将获得从 Redis 数据库检索其配置数据。

edgemicro:
  redisHost: host_IP
  redisPort: host_port
  redisDb: database_index
  redisPassword: password
edge_config:
  synchronizerMode: 0
  redisBasedConfigCache: true

例如：

edgemicro:
  redisHost: 192.168.4.77
  redisPort: 6379
  redisDb: 0
  redisPassword: codemaster
edge_config:
  synchronizerMode: 0
  redisBasedConfigCache: true

配置属性

添加了以下配置属性，以支持同步程序的使用：

属性值说明

属性	值	说明
`edge_config.synchronizerMode`	0 或 1	如果为 0（默认值），则 Edge Microgateway 将在其标准模式下运行。如果为 1，请启动 Edge Microgateway 实例以作为同步程序运行。在本课中，实例将从 Apigee Edge 提取配置数据并将其存储在本地 Redis 数据库。此实例无法处理 API 代理请求；其唯一的目的是轮询 Apigee Edge 以获取配置数据，并将其写入本地数据库。然后，您必须将其他微网关实例配置为从数据库读取数据。
`edge_config.redisBasedConfigCache`	true 或 false	如果为 true，则 Edge Microgateway 实例会从 Redis 数据库，而不是 Apigee Edge。Redis 数据库必须是同一个数据库同步程序被配置为写入数据的名称。如果 Redis 数据库不可用或如果数据库为空，则微网关将查找现有的 `cache-config.yaml` 配置文件。如果为 false（默认值），则 Edge Microgateway 实例会从 Apigee Edge。
`edgemicro.config_change_poll_interval`	时间间隔（以秒为单位）	指定同步程序从 Apigee Edge 拉取数据的轮询间隔。

edge_config.synchronizerMode

0 或 1

如果为 0（默认值），则 Edge Microgateway 将在其标准模式下运行。

如果为 1，请启动 Edge Microgateway 实例以作为同步程序运行。在本课中，实例将从 Apigee Edge 提取配置数据并将其存储在本地 Redis 数据库。此实例无法处理 API 代理请求；其唯一的目的是轮询 Apigee Edge 以获取配置数据，并将其写入本地数据库。然后，您必须将其他微网关实例配置为从数据库读取数据。

edge_config.redisBasedConfigCache

true 或 false

如果为 true，则 Edge Microgateway 实例会从 Redis 数据库，而不是 Apigee Edge。Redis 数据库必须是同一个数据库同步程序被配置为写入数据的名称。如果 Redis 数据库不可用或如果数据库为空，则微网关将查找现有的 cache-config.yaml 配置文件。

如果为 false（默认值），则 Edge Microgateway 实例会从 Apigee Edge。

edgemicro.config_change_poll_interval 时间间隔（以秒为单位）指定同步程序从 Apigee Edge 拉取数据的轮询间隔。

为插件配置排除网址

您可以将 microgateway 配置为跳过指定网址您可以配置这些“排除”全局网址（适用于所有插件）或针对特定插件使用。

例如：

...
edgemicro:
  ...
  plugins:
    excludeUrls: '/hello,/proxy_one' # global exclude urls
    sequence:
      - oauth
      - json2xml
      - quota
json2xml:
  excludeUrls: '/hello/xml'  # plugin level exclude urls
...

在此示例中，插件不会使用路径 /hello 或 /proxy_one。此外，json2xml 对于路径中含有 /hello/xml 的 API，系统会跳过该插件。

您不能排除 analytics 插件。

使用环境变量值设置配置属性

您可以使用配置中的标记指定环境变量文件。指定的环境变量标记会替换为实际环境变量值。替换项只会存储在内存中，不会存储在原装配置或缓存文件

注意：默认情况下，<E> 代码会解析变量值字符串形式。要指定正整数和布尔值，请使用 <n> 和 <b> 标记，如下面的示例所示。

在此示例中，属性 key 替换为 TARGETS_SSL_CLIENT_KEY 环境变量等。

targets:
  - ssl:
      client:
        key: <E>TARGETS_SSL_CLIENT_KEY</E>
        cert: <E>TARGETS_SSL_CLIENT_CERT</E>
        passphrase: <E>TARGETS_SSL_CLIENT_PASSPHRASE</E>

在此示例中，<n> 标记用于表示整数值。仅限正面评价支持整数。

edgemicro:
  port: <E><n>EMG_PORT</n></E>

在此示例中，<b> 标记用于表示布尔值 ( 即 true 或 false）值。

quotas:
  useRedis: <E><b>EMG_USE_REDIS</b></E>

Edge Microgate 操作和配置参考

如果您有互联网连接，则升级 Edge Microgateway

更改配置

默认系统配置 文件

新初始化的 Edge Microgateway 实例的默认配置文件

动态 用于运行实例的

设置环境变量

在 Edge Microgateway 上配置 SSL 服务器

使用客户端 SSL/TLS 选项

自定义 Edgemicro-auth 代理

使用自定义身份验证服务

管理日志文件

日志文件的存储位置

如何更改默认日志 文件目录

将日志发送到控制台

如何设置日志记录级别

如何更改日志时间间隔

如何放宽严格的日志文件权限

日志文件维护的良好做法

日志文件命名惯例

关于日志文件内容

“API”的内容日志文件

1. 来自客户端的传入请求示例：

2. 向目标发出的传出请求的示例：

日志文件时间安排

错误消息

Edge Microgateway 配置参考文档

的 配置文件

Edge_config 属性

Edgemicro 属性

标头属性

OAuth 属性

插件专用 属性

过滤代理

按名称过滤商品

按自定义属性过滤商品

配置 Google Analytics 推送频率

遮盖分析数据

在 Edge Analytics 中隔离 API 调用

在 公司防火墙

使用 HTTP 代理与 Apigee Edge 通信

使用 HTTP 代理进行目标通信

在 Microgateway 感知中使用通配符 个指标

轮替 JWT 密钥

Edge Microgateway 如何使用 JWT

什么是密钥轮替？

如何进行密钥轮替

配置“不早于”延迟

过滤下载的代理

指定没有 API 代理的产品

调试和问题排查

连接到调试程序

检查日志文件

使用 API 密钥安全性

缓存键

使用 API 密钥

配置 API 密钥名称

启用上行响应代码

使用 OAuth2 令牌安全性

如何获取访问令牌

如何获取刷新令牌

永久监控

指定配置文件端点

停用 TCP 连接数据缓冲

在独立模式下运行 Edge Microgateway

配置和启动网关

示例：获取授权令牌

测试独立配置

使用本地代理模式

用例和示例

配置本地代理模式

测试配置

使用同步程序

什么是同步器？

配置同步程序实例

配置常规 Edge Microgateway 实例

配置属性

为插件配置排除网址

使用环境变量值设置配置属性

默认系统配置文件

动态用于运行实例的

如何更改默认日志文件目录

的配置文件

插件专用属性

在公司防火墙

在 Microgateway 感知中使用通配符个指标