您正在查看 Apigee Edge 文档。
请查看 Apigee X 文档。
Edge Microgate 版本 2.5.x
概览
借助 Edge Microgate CLI,您可以控制和管理 Edge Microgate 实例的方方面面。
管理证书
借助 cert
命令,您可以安装和管理公钥/私钥对,用于为通过 Edge Microgate 进行安全调用的不记名令牌签名。密钥以加密的键值对映射 (KVM) 存储在 Apigee Edge 中。Edge Microgate 使用公钥来验证已签名的不记名令牌。这些密钥会在您运行 Edgemicro 配置命令时生成,如设置和配置 Edge Microgate 中所述。如果需要,您可以使用此处所述的 cert 命令重新生成和管理这些密钥。
安装证书
在加密的键值对映射 (KVM) 中安装密钥,并将公钥作为输出返回。密钥对的作用域限定为指定的组织。
用法
edgemicro cert install -o [organization] -e [environment] -u [username] -p [password] --force
参数
参数 | 说明 |
---|---|
-o, --org |
您配置了 Edge Microgate 的 Apigee 组织。 |
-e, --env |
您为其配置了 Edge Microgate 的环境。 |
-u, --username |
您的 Apigee 用户名。您必须是指定组织的组织管理员。 |
-p, --password |
(可选)您的密码。如果您不在命令行中提供此参数,系统会提示您。 |
-f, --force |
(可选)如果密钥已存储在加密的 KVM 中,请强制替换该密钥。 |
-h, --help |
输出使用情况信息。 |
示例
edgemicro cert install -o docs -e test -u jdoe@example.com -f
输出
current nodejs version is v6.9.1 current edgemicro version is 2.5.4 password: deleting vault creating vault adding private_key adding public_key installed cert
删除证书
删除组织的密钥对。
用法
edgemicro cert delete -o [organization] -e [environment] -u [username] -p [password]
参数
参数 | 说明 |
---|---|
-o, --org |
您配置了 Edge Microgate 的 Apigee 组织。 |
-e, --env |
您为其配置了 Edge Microgate 的环境。 |
-u, --username |
您的 Apigee 用户名。您必须是指定组织的组织管理员。 |
-p, --password |
(可选)您的密码。如果您不在命令行中提供此参数,系统会提示您。 |
-h, --help |
输出使用情况信息。 |
示例
edgemicro cert delete -o docs -e test -u jdoe@example.com
输出
deleting vault Vault deleted!
检查证书
检查贵组织是否安装了证书。
用法
edgemicro cert check -o [organization] -e [environment] -u [username] -p [password]
参数
参数 | 说明 |
---|---|
-o, --org |
您配置了 Edge Microgate 的 Apigee 组织。 |
-e, --env |
您为其配置了 Edge Microgate 的环境。 |
-u, --username |
您的 Apigee 用户名。您必须是指定组织的组织管理员。 |
-p, --password |
(可选)您的密码。如果您不在命令行中提供此参数,系统会提示您。 |
-h, --help |
输出使用情况信息。 |
示例
edgemicro cert check -o docs -e test -u jdoe@example.com
输出 (成功)
checked cert successfully
输出 (失败)
如果证书不存在,则系统会返回错误。
获取公钥
返回指定组织的公钥。不需要进行身份验证。
用法
edgemicro cert public-key -o [organization] -e [environment]
参数
参数 | 说明 |
---|---|
-o, --org |
您配置了 Edge Microgate 的 Apigee 组织。 |
-e, --env |
您为其配置了 Edge Microgate 的环境。 |
-h, --help |
输出使用情况信息。 |
示例
edgemicro cert public-key -o docs -e test
输出 (示例)
-----BEGIN CERTIFICATE----- MIICpDCCAYwCCQCKpXWGum9uTjANBgkq9w0BAQsFADAUMRIwEAYDVQQDEwls b2NhbGhvc3cNMTYxMTAyMjAxNTA2WhcNMTYxMTAzMjAxNTA2WjAUMRIwEAYD VQQDEwlsb2Nvc3QwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQDD ETr/ne/gP47+9LgjLvBJjpbFVdaeUabZZ3wbA7sSIVnnNXWt3yPklrWSfIh+ L2+dq4k+YunsQE2+dwPdXA2x8DPGvqGcCdWPxnpZ7ix5Akbs8i/J+Ue0pXT4 jkpWbaDDftGL2tcxwP45yI+slpDYvmWRps07TFXkAPjGEHYPvCT9/v/35GkL 0h4v0S+XfpcjS5c47o7CIWlkgEM5GBosQUb17kuVR48392vGFPsnCP34iNe7 zguhiCXYg2zkOcj/N3AE4xKIhCz0QcewULy08GltWMmyjJ/30zs8P41JqoA4 RwfeEZ8RenN3rJQim1ppAAEwDQYJKoZIhvcNAQELBQADggEBAHcORIfc+ySe 2FMmqicNe6Wt5V/5zOaBMLsGQdqGOHB5cQc79sMBrk680KVhrwHXZ2nBIkVe UEL+2qLY1VLfswBNAvcNwV9U4TwHq4eIANiD751oJK1tHmM/ujThQkwNf96o 6I7Ws+wfpGO3ppJCttRbtnATIxrwsCHN4i5lbW/tJSL7t/Zf6T1B+YSJU9AF xuvLq22cCqyYJQdmKq2vVS55WRZdllm+mRtJrv7MLM9gfDPRxVlwrBz/eQHy Fv+dwzxcvQjkz03RNhZUodzuD34DPJoYeK++rItsddwQ26KTahH80yYTAFzY x9gfPf1/+qo=? -----END CERTIFICATE-----
为 Apigee Edge Cloud 配置 Edge Microgate
使 Edge Microgate 能够与 Apigee Edge Cloud 实例搭配使用。它会封装和执行一系列命令,以将所需的身份验证代理部署到 Edge、生成身份验证令牌和更新配置文件。如需完整的工作示例,请参阅设置和配置 Edge Microgate。
用法
edgemicro configure -o [organization] -e [environment] -u [username] -p [password]
参数
参数 | 说明 |
---|---|
-o, --org |
您配置了 Edge Microgate 的 Apigee 组织。 |
-e, --env |
您为其配置了 Edge Microgate 的环境。 |
-u, --username |
您的 Apigee 用户名。您必须是指定组织的组织管理员。 |
-p, --password |
(可选)您的密码。如果您不在命令行中提供此参数,系统会提示您。 |
-r, --url |
(可选)为您的组织:environment 指定虚拟主机别名。请参阅 Edge 文档,了解虚拟主机。默认值:org-env.apigee.net |
-c, --configDir |
(可选)指定 Edge Microgate 配置文件的路径。默认情况下,配置文件位于 ./config/config.yaml 中。(添加了 v2.4.x) |
-x, --proxyName |
(可选)为 edgemicro-auth 代理设置基本路径。如果 edgemicro-auth 代理部署在默认路径 /edgemicro-auth 之外,则此功能允许您在 Edge Microgate 中设置新路径。默认情况下,基本路径为 /edgemicro-auth。(添加了 v2.4.x) |
-t, --token |
(可选)允许您使用 OAuth 令牌(而不是用户名/密码)进行身份验证。另请参阅使用 OAuth2 访问令牌进行安全的 API 调用。
例如:edgemicro configure -o docs -e test -t <your token> |
-v, --virtualHosts |
(可选)替换默认虚拟主机,即“default,secure ”。如果您为 Edge 组织:环境指定了虚拟主机(默认环境除外),请使用此选项。请参阅 Edge 文档,了解虚拟主机。 |
-d, --debug |
(可选)提供调试信息。 |
-h, --help |
输出使用情况信息。 |
使用说明
此命令会将配置信息存储在 ~/.edgemicro/org-env-config.yaml
中。
示例
edgemicro configure -o docs -e test -u jdoe@example.com
输出
运行成功后,该命令会返回您在启动 Edge Microgate 时需要使用的一组密钥。
... The following credentials are required to start edge micro key: d2f0a246ad52b5d2a8b04ba65b43c76348aba586691cf6185cd7bb9fb78fe9f secret: 59813bc1db4a7ada182705ae40893c28a6fae680c3deb42aefbf1a4db42e372 edgemicro configuration complete!
生成键
在将分析数据异步发布到 Apigee Edge 时,genkeys
命令会生成密钥和 Secret 对,用于对自身进行身份验证。
用法
edgemicro genkeys -o [organization] -e [environment] -u [username] -p [password]
参数
参数 | 说明 |
---|---|
-o, --org |
您配置了 Edge Microgate 的 Apigee 组织。 |
-e, --env |
您为其配置了 Edge Microgate 的环境。 |
-u, --username |
您的 Apigee 用户名。您必须是指定组织的组织管理员。 |
-p, --password |
(可选)您的密码。如果您不在命令行中提供此参数,系统会提示您。 |
-h, --help |
输出使用情况信息。 |
使用说明
运行成功后,该命令会返回三项。第一个图标是您需要在配置文件中添加的网址。其他两个密钥是启动 Edge Microgate 实例时所需的密钥对。
- 引导网址:此网址指向 Apigee Edge 服务,该服务允许 Edge Microgate 实例将分析数据发送到 Apigee Edge。您需要将该网址复制到 Edge Microgate 配置文件:~
/.edgemicro/org-env-config.yaml
。 - key:键。必须提供此密钥和该密钥作为用于启动 Edge Microgate 实例的 CLI 命令的输入。
- secret:密钥。
示例
edgemicro genkeys -o docs -e test -u jdoe@example.com
输出 (示例)
运行成功后,该命令会返回您在启动 Edge Microgate 时需要使用的一组密钥。
configuring host edgemicroservices-us-east-1.apigee.net for region us-east-1 Please copy the following property to the edge micro agent config bootstrap: https://edgemicroservices-us-east-1.apigee.net/edgemicro/bootstrap/organization/jdoe/environment/test The following credentials are required to start edge micro key: db39324077989c75eac34c13d285772ea8e3b982b957b3f52916f3048511443f secret: 5bf8da39de0056f88fdd5f25a8602d22f312c1c8c870580a5fef55ac6637b7ae finished
为 Apigee Edge Private Cloud 配置 Edge Microgate
配置 Edge Microgate 以与 Apigee Edge 私有云安装搭配使用。
用法
edgemicro private configure -o [organization] -e [environment] -u [username] -p [password]
参数
参数 | 说明 |
---|---|
-o, --org |
您配置了 Edge Microgate 的 Apigee 组织。 |
-e, --env |
您为其配置了 Edge Microgate 的环境。 |
-u, --username |
您的 Apigee 用户名。您必须是指定组织的组织管理员。 |
-p, --password |
(可选)您的密码。如果您不在命令行中提供此参数,系统会提示您。 |
-r, --runtime-url |
指定私有云实例的运行时网址。 |
-m, --mgmt-url |
您的私有云实例的管理服务器网址。 |
-v, --virtualHosts |
贵组织环境的虚拟主机列表(以英文逗号分隔)。默认“default,secure ”。 |
-c, --configDir |
(可选)指定 Edge Microgate 配置文件的路径。默认情况下,配置文件位于 ./config/config.yaml 中。(添加了 v2.4.x) |
-t, --token |
(可选)允许您使用 OAuth 令牌(而不是用户名/密码)进行身份验证。另请参阅使用 OAuth2 访问令牌进行安全的 API 调用。
例如:edgemicro configure -o docs -e test -t <your token> |
-d, --debug |
(可选)提供调试信息。 |
-h, --help |
输出使用情况信息。 |
使用说明
此命令会将配置信息存储在 ~/.edgemicro/org-env-config.yaml
中。
示例
edgemicro private configure -o docs -e test -u jdoe@example.com -r http://192.162.55.100:9002 -m http://192.162.55.100:8080
输出
运行成功后,该命令会返回您在启动 Edge Microgate 时需要使用的一组密钥。
... The following credentials are required to start edge micro key: d2f0a246ad52b5d2a8b04ba65b43c76348aba586691cf6185cd7bb9fb78fe9f secret: 59813bc1db4a7ada182705ae40893c28a6fae680c3deb42aefbf1a4db42e372 edgemicro configuration complete!
正在启动 Edge Microgate
在启动 Edge Microgate 之前,您必须先运行 edgemicro configuration(公有云)或 edgemicro private configuration(私有云)。配置命令会返回启动 Edge Microgate 所需的密钥和密钥值。
用法
edgemicro start -o [organization] -e [environment] -k [public-key] -s [secret-key]
参数
参数 | 说明 |
---|---|
-o, --org |
您配置了 Edge Microgate 的 Apigee 组织。 |
-e, --env |
您为其配置了 Edge Microgate 的环境。 |
-k, --key |
运行“edgemicro
configure ”命令时返回的键值对。 |
-s, --secret |
运行“edgemicro
configure ”命令时返回的 Secret 值。 |
-p, --processes |
(可选)要启动的进程数。默认:系统上的核心数。 |
-d, --pluginDir |
(可选)插件目录的绝对路径。 |
-r, --port |
(可选)替换 ~/.edgemicro/org-env-config.yaml 文件中指定的端口号。默认:8000 |
-c, --cluster |
(可选)在集群模式下启动 Edge Microgate。 注意:从 v2.3.1 开始,此选项已被移除。在 v2.3.1 及更高版本中,Edge Micro 始终在集群模式下启动。 |
-c, --configDir |
(可选)指定 Edge Microgate 配置文件的路径。默认情况下,配置文件位于 ./config/config.yaml 中。(添加了 v2.4.x) |
-u, --configUrl |
(可选)指定 Edge Microgate 将从中下载其配置文件的端点。(2.5.x 版添加) |
-d, --debug |
(可选)提供调试信息。 |
-h, --help |
输出使用情况信息。 |
设置端口
使用 start
命令,您可以指定端口号以替换配置文件中指定的端口。您还可以使用 PORT
环境变量指定端口号。例如:
edgemicro start -o docs -e test -k abc123 -s xyz456 -p 2 --port 8002
或
export PORT=8002 edgemicro start -o org -e test -k key -s secret -p 2
如果正在使用端口,则 Edge Microgate 会返回错误。
聚类简介
Edge Microgate 采用 Node.js 集群模块来启用聚类。通过聚类,Edge Microgate 可以充分利用多核系统。如需了解详情,请参阅此 Node.js 文档。
示例
edgemicro start -o docs -e test -k abc123 -s xyz456
示例输出:
... current nodejs version is v6.9.1 current edgemicro version is 2.5.4 info: jwk_public_keys download from null returned 200 undefined info: jwt_public_key download from https://docs-test.apigee.net/edgemicro-auth/publicKey returned 200 OK info: products download from https://docs-test.apigee.net/edgemicro-auth/products returned 200 OK info: config download from https://edgemicroservices-us-east-1.apigee.net/edgemicro/bootstrap/organization/docs/environment/test returned 200 OK PROCESS PID : 17991
管理令牌
借助 token
命令,您可以获取、解码和验证已签名的 OAuth2 访问令牌。另请参阅
使用 OAuth2 访问令牌进行安全 API 调用。
解码令牌
将经过签名的编码不记名令牌解码为其纯文本 JSON JWT(Java 网络令牌)表示形式。令牌用于传达 Apigee Edge 开发者应用的相关信息,该应用提供用于创建令牌的密钥,包括应用名称、client_id、产品列表等。
用法
edgemicro token decode -f [filename]
参数
参数 | 说明 |
---|---|
-f, --file |
包含要解码的 JWT 令牌的文件的名称。 |
-h, --help |
输出使用情况信息。 |
示例
edgemicro token decode -f token.jwt
输出(示例)
{ header: { typ: 'JWT', alg: 'RS256' }, payload: { application_name: 'b43342ef-86f6-4666-a121-b9ac2025d217', client_id: 'O9ZQRZKnn1rdgcKQgsABSMdOsKS', scopes: [], api_product_list: [ 'MicroTest' ], iat: 1436280566, exp: 1436282365 }, signature: '' }
生成令牌
生成已签名的不记名令牌。此令牌允许客户端应用向 Edge Microgate 进行经过身份验证的 API 调用。该令牌是符合 OAuth 2.0 标准的 JSON Web 令牌 (JWT)。它需要输入 Apigee Edge 中已注册的开发者的消费者密钥(客户端 ID)和消费者密钥(客户端密钥)值。另请参阅 使用 OAuth2 访问令牌进行安全 API 调用。
用法
edgemicro token get -o [org] -e [env] -i [client_id] -s [client_secret]
参数
参数 | 说明 |
---|---|
-o, --org |
您配置了 Edge Microgate 的 Apigee 组织。 |
-e, --env |
您为其配置了 Edge Microgate 的环境。 |
-1, --key |
与 Microgate-aware 代理相关联的开发者应用中的客户端 ID。 |
-s, --secret |
与 Microgate-aware 代理关联的开发者应用中的客户端密钥。 |
-h, --help |
输出使用情况信息。 |
示例
edgemicro token get -o docs -e test -i 5UzOwAXGoOeo60aew94PPG5MAZE3aJp -s 6vahKFGS9a3qMLwz
输出(示例)
{ token: 'eyJ0eXAiOiJKV1JhbGciOiJSUzI1NiJ9Glvbl9uYW1lIjoiNWNiMGY0NTV6TV3 EtOWMzOC00YmJjLWIzNzEtZGMxZTQzOGMxIiwiY2xpZW50X2lkIjoiNVV6T3dBWEdvSU9lbz YwYWV3OTRQN0c1TUFaRTNhSnAiLCJzY2MiOltdLCJhcGlfcHJvZHVjdF9saXN0IjpbIkVkZ2 VNaWNyb1Rlc3RQcm9kdWN0Il0sImlhdCI3ODEyMzQ2MSwiZXhwIjoxNDc4MTI1MjYwfQ.Dx5 f5U7PXm8koNGmFX4N6VrxKMJnpndKgoJ5zWSJvBZ6Ccvhlpd85ipIIA5S2A5nx4obYWp_rpY RJpIGYwyxP6Oq2j0rxnVjdCC4qyYMgthZjhKgEBVBe3s1ndP72GP2vV6PsSA9RQ2-yzsy9r0 TzhAZ3NJTxT1tS0XKqKngE-OhR3fJHVLAzdMDT0AmS9H0Z2NAJtQOuK6RTpCjG9B6Bc48AEM sj7QSM-1LWiQ8LdY8k_BoC06qsTI7bCQGWwTuqL-ismbcx2bxovUxSemZIaoROfuF-dCZHG3 2aTP75WxBvvNgBBvPvQtPzbeSOtEaww' }
发出 HTTP 请求以获取令牌
您还可以发出原始 HTTP 请求来获取令牌。请参阅直接获取不记名令牌。
验证令牌
根据存储在 Apigee Edge 中的公钥,针对指定的组织和环境验证已签名的不记名令牌。
用法
edgemicro token verify -o [org] -e [env] -f [filename]
参数
参数 | 说明 |
---|---|
-o, --org |
您配置了 Edge Microgate 的 Apigee 组织。 |
-e, --env |
您为其配置了 Edge Microgate 的环境。 |
-f, --file |
包含要验证的 JWT 的文件的名称。 |
-h, --help |
输出使用情况信息。 |
示例
edgemicro token get -o docs -e test -f token.jwt
有效令牌的示例输出
{ application_name: 'b43342ef-86f6-4666-a121-b9ac2025d217', client_id: 'O9ZQRZKnn1rdgcKQsAZUBkQSMdOsKS', scopes: [], api_product_list: [ 'MicroTest' ], iat: 1436396155, exp: 1436397954 }
无效令牌的示例输出
{ [JsonWebTokenError: invalid token] name: 'JsonWebTokenError', message: 'invalid token' }
过期令牌的示例输出
{ [TokenExpiredError: jwt expired] name: 'TokenExpiredError', message: 'jwt expired', expiredAt: Tue Jul 07 2015 09:19:25 GMT-0600 (MDT) }
初始化新的 Edge Microgate 配置
在您首次安装 Edge Microgate 后运行此命令。创建一个新的默认配置文件:~/.edgemicro/default.yaml
。
用法
edgemicro init
参数
参数 | 说明 |
---|---|
-c, --configDir |
(可选)指定 Edge Microgate 配置文件的路径。默认情况下,配置文件位于 ./config/config.yaml 中。(添加了 v2.4.x) |
-h, --help |
输出使用情况信息。 |
示例
edgemicro init
输出 (成功)
config initialized to /MyHome/.edgemicro/default.yaml
验证 Edge Microgate 配置
验证是否已正确配置 Edge Microgate。
用法
edgemicro verify -o [organization] -e [environment] -k [public-key] -s [secret-key]
参数
示例
edgemicro verify -o docs -e test -k abc123 -s xyz456
输出 (成功)
logging to /var/tmp/edgemicro-My-Machine.local-a0c48610-a148-11e6-8466-93f081b05988 installed plugin from analytics installed plugin from oauth a0c48610-a148-11e6-8466-93f081b05988 edge micro listening on port 8000 verifying analytics negative case: OK verifying bootstrap url availability:OK verifying jwt_public_key availability: OK verifying products availability: OK verifying quota with configured products: OK verifying analytics with payload: OK verification complete
检查微网关集群状态
默认情况下,Edge Microgate 在集群模式下启动。您可以使用此命令检查集群的状态。
用法
edgemicro status
参数
参数 | 说明 |
---|---|
-h, --help |
输出使用情况信息。 |
示例
edgemicro status
输出 (成功)
current nodejs version is v6.9.1 current edgemicro version is 2.5.4 edgemicro is running with 8 workers
停止微网关集群
停止 Edge Microgate 集群。
用法
edgemicro stop
参数
参数 | 说明 |
---|---|
-h, --help |
输出使用情况信息。 |
示例
edgemicro stop
输出 (成功)
current nodejs version is v6.9.1 current edgemicro version is 2.5.4 Stop Completed Successfully
重新加载微网关集群
在配置更改后提供零停机时间重启。通过引入新配置来重新加载 Edge Microgate。
用法
edgemicro reload -o [organization] -e [environment] -k [public-key] -s [secret-key]
参数
参数 | 说明 |
---|---|
-o, --org |
您配置了 Edge Microgate 的 Apigee 组织。 |
-e, --env |
您为其配置了 Edge Microgate 的环境。 |
-k, --key |
运行“edgemicro
configure ”命令时返回的键值对。 |
-s, --secret |
运行“edgemicro
configure ”命令时返回的 Secret 值。 |
-h, --help |
输出使用情况信息。 |
示例
edgemicro reload -o docs -e test -k abc123 -s xyz456
输出 (成功)
... Reload Completed Successfully
升级 KVM
如需使用密钥轮替,您必须在 Apigee Edge 组织中安装升级后的键值对映射。(2.5.x 版添加)
注意:如果您在 2.5.2 版之前配置了当前的 Edge Micro 实例,则必须升级您的 KVM 才能使用密钥轮替。升级过程只需进行一次。用法
edgemicro upgradekvm -o [organization] -e [environment] -u [username]
参数
参数 | 说明 |
---|---|
-o, --org |
您配置了 Edge Microgate 的 Apigee 组织。 |
-e, --env |
您为其配置了 Edge Microgate 的环境。 |
-u, --username |
您的 Apigee 用户名。您必须是指定组织的组织管理员。 |
-p, --password |
(可选)您的密码。如果您不在命令行中提供此参数,系统会提示您。 |
-v, --virtualhost |
(可选)代理的虚拟主机。 |
-t, --token |
(可选。)让您使用 OAuth 令牌(而不是用户名/密码)进行身份验证。另请参阅使用 OAuth2 访问令牌进行安全的 API 调用。
例如:edgemicro upgradekvm -o docs -e test -t <your token> |
-b, --baseuri |
(可选)贵组织在 Apigee Edge 中的基本 URI。Apigee 云端部署的默认 URI 是 api.enterprise.apigee.com。对于本地部署,基准网址可能有所不同。 |
示例
edgemicro upgradekvm -o docs -e test -u jdoe@example.com
输出 (成功)
运行成功后,该命令会返回类似如下所示的输出:
current nodejs version is v6.9.1 current edgemicro version is 2.5.4 password: Checking for certificate... Certificate found! -----BEGIN PUBLIC KEY----- MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAsT6yVoT/h6pvkPlkUUtv Hgs7MbDPcWxto7dZqJBwQ4oOQ0IJ2P4XGigc3kYUyPp5lFHg1ssP9+0onRpqn6Lq z7N5iaTSv5YXb26bU2kSOl4hbwcljIzauAnBzQ13VaQ5SoflRxMGSZmTqZeu5jkQ 3JZ7F6k2bCar5sk1k84vd4WXcCVyngFlrMtlux5z0vOU56QYZFvvKYl/wOHNPLLB Js54531CV1ZfhV3nDDq9Lh5D1C/oQVlm1Lc7BJoEUmKeFATmSsi50c14ScsmdtJ1 HqC/brSXCd185P6ifu2RH7IHKzNfcD4NlfAVmDScng4w5RxBan2avbmAJrokQ4b5 WQIDAQAB -----END PUBLIC KEY----- KVM update complete
升级 Edgemicro-auth 代理
如需使用密钥轮替,您必须在 Apigee Edge 组织中部署升级后的 Edgemicro-auth 代理。(2.5.x 版添加)
注意:如果您在 2.5.2 版之前配置了当前的 Edge Micro 实例,如果您要使用密钥轮替,则必须升级此代理。升级过程只需进行一次。
用法
edgemicro upgradeauth -o [organization] -e [environment] -u [username]
参数
参数 | 说明 |
---|---|
-o, --org |
您配置了 Edge Microgate 的 Apigee 组织。 |
-e, --env |
您为其配置了 Edge Microgate 的环境。 |
-u, --username |
您的 Apigee 用户名。您必须是指定组织的组织管理员。 |
-p, --password |
(可选)您的密码。如果您不在命令行中提供此参数,系统会提示您。 |
-v, --virtualhost |
(可选)代理的虚拟主机。 |
-b, --baseuri |
(可选)贵组织在 Apigee Edge 中的基本 URI。Apigee 云端部署的默认 URI 是 api.enterprise.apigee.com。对于本地部署,基准网址可能有所不同。 |
示例
edgemicro upgradeauth -o docs -e test -u jdoe@example.com
输出 (成功)
运行成功后,该命令会返回类似如下所示的输出:
Going to create revision 2 of API edgemicro-auth Using /Users/jdoe/npm/lib/node_modules/edgemicro/node_modules/microgateway-edgeauth/apiproxy/edgemicro-auth.xml as the root file Creating revision 2 of API edgemicro-auth Uploading java resource micro-gateway-products-javacallout-2.0.0.jar Uploading jsc resource generate-verify-jwt.js Uploading jsc resource send-public-key.js Uploading jsc resource set-jwt-variables.js Uploading jsc resource set-response.js Uploading node resource index.js Uploading node resource node_modules_apigee-access.zip Uploading node resource node_modules_base64url.zip Uploading node resource node_modules_buffer-equal-constant-time.zip Uploading node resource node_modules_ecdsa-sig-formatter.zip Uploading node resource node_modules_jsrsasign.zip Uploading node resource node_modules_jwa.zip Uploading node resource node_modules_jws.zip Uploading node resource node_modules_safe-buffer.zip Uploading node resource package.json Uploading policy Access-App-Info-2.xml Uploading policy Access-App-Info.xml Uploading policy AccessTokenRequest.xml Uploading policy Add-Custom-Claims.xml Uploading policy Create-OAuth-Request.xml Uploading policy Create-Refresh-Request.xml Uploading policy Extract-API-Key.xml Uploading policy Extract-OAuth-Params.xml Uploading policy Extract-Refresh-Params.xml Uploading policy Get-Private-Key.xml Uploading policy Get-Public-Key.xml Uploading policy Get-Public-Keys.xml Uploading policy JavaCallout.xml Uploading policy Products-to-JSON-2.xml Uploading policy Products-to-JSON.xml Uploading policy Raise-Fault-Unknown-Request.xml Uploading policy RefreshAccessToken.xml Uploading policy Send-Public-Key.xml Uploading policy Set-JWT-Variables.xml Uploading policy Set-Response.xml Uploading policy Verify-API-Key.xml Uploading target TargetEndpoint-1 Uploading proxy default Deploying revision 2 of edgemicro-auth to test Deployment on test successful edgemicro-auth proxy upgraded
轮替密钥
使用 edgemicro rotatekey
命令轮替用于为 Edge Microgate 生成 OAuth 安全性的 JWT 令牌的公钥/私钥对。
如需了解详情,请参阅 轮替 JWT 密钥。
用法
edgemicro rotatekey -o [organization] -e [environment] -u [username] -k [kid]
参数
参数 | 说明 |
---|---|
-o, --org |
(必需)您为其配置了 Edge Microgate 的 Apigee 组织。 |
-e, --env |
(必需)您已配置 Edge Microgate 的环境。 |
-u、--username | (必需)您的 Apigee 用户名。您必须是指定组织的组织管理员。 |
-p, --password |
(可选)您的密码。如果您不在命令行中提供此参数,系统会提示您。 |
-k, --kid |
(必需)用于匹配特定键的 ID。在密钥轮替期间,Edge Microgate 使用该值从一组密钥中进行选择。如需了解详情,请参阅 JSON Web Key 规范的第 4.5 节。 |
-b, --baseuri |
(可选)贵组织在 Apigee Edge 中的基本 URI。Apigee 云端部署的默认 URI 是 api.enterprise.apigee.com。对于本地部署,基准网址可能有所不同。 |
示例
edgemicro rotatekey -o jdoe -e test -u jdoe@google.com -k 2
输出 (成功)
运行成功后,该命令会返回类似如下所示的输出:
current nodejs version is v6.9.1 current edgemicro version is 2.5.7 password: Checking if private key exists in the KVM... Checking for certificate... Found Certificate Generating New key/cert pair... Extract new public key Key Rotation successfully completed!
轮替后,您会在 Edge 界面中看到新的密钥已添加到微网关 KVM。
永久监控
您可以使用 edgemicro forever
命令来管理 Forever 进程,这个 Node.js 工具会在应用停止运行或出现错误时自动重启 Node.js 应用。另请参阅
永久监控。
用法
在执行 edgemicro forever
命令之前,您必须设置以下环境变量:
EDGEMICRO_ORG
- 为其配置 Edge Microgate 的 Apigee 组织。EDGEMICRO_ENV
- 您为其配置了 Edge Microgate 的环境。EDGEMICRO_KEY
- 运行“edgemicro configure”命令时返回的键值对。EDGEMICRO_SECRET
- 您运行“edgemicro configure”命令时返回的 Secret 值。
edgemicro forever -f [forever_file] -a [start|stop]
参数
参数 | 说明 |
---|---|
-f, --file | 指定 forever.json 文件的位置。 |
-a, --action | start 或 stop 。默认为开始。 |
示例:
要永久启动,请按以下步骤操作:
edgemicro forever -f ~/mydir/forever.json -a start
要永久停止,请按以下步骤操作:
edgemicro forever -a stop
撤消密钥
使用 edgemicro revokekeys
命令可撤消 Edge Microgate 配置的密钥凭据和 Secret 凭据。
用法
edgemicro revokekeys -o [organization] -e [environment] -u [username] -k [key] -s [secret]
参数
参数 | 说明 |
---|---|
-o, --org |
(必需)您为其配置了 Edge Microgate 的 Apigee 组织。 |
-e, --env |
(必需)您已配置 Edge Microgate 的环境。 |
-u, --username |
(必需)您的 Apigee 用户名。您必须是指定组织的组织管理员。 |
-p, --password |
(可选)您的密码。如果您不在命令行中提供此参数,系统会提示您。 |
-k, --key |
(必需)要撤消的键。 |
-s, --secret |
(必需)要撤消的密钥。 |
示例
edgemicro revokekeys -o myorg -e test -u jdoe@apigee.com -k 2c0064f5bd85f5573dcaffe21566fa7a2d49885cdbf8899370c8a4479285f -s 4b5d6355b874f7c46838893823e8d929dcb2e42fb9aebcb535089c9b98513
成功部署后,您会看到以下消息:
key 2c0064f5bd85f5573dcaffe21566fa7a2d49885cdbf8899370c8a4479285f revoked successfully