Bạn đang xem tài liệu về Apigee Edge.
Chuyển đến
Tài liệu về Apigee X. thông tin
Edge Microgateway phiên bản 2.4.x
Tổng quan
Edge Microgateway CLI cho phép bạn kiểm soát và quản lý mọi khía cạnh của Edge Microgateway thực thể.
Quản lý chứng chỉ
Các lệnh cert cho phép bạn cài đặt và quản lý khoá công khai/riêng tư
cặp dùng để ký mã thông báo truyền dữ liệu mà khách hàng dùng để thực hiện cuộc gọi an toàn qua Edge
Cổng nhỏ. Các khoá được lưu trữ trên Apigee Edge trong một Bản đồ giá trị khoá (KVM) đã mã hoá. Edge Microgateway sử dụng
khoá công khai để xác thực mã thông báo người dùng đã ký. Các khoá này được tạo khi bạn chạy Edgemicro
cấu hình, như được giải thích trong Cài đặt
thiết lập và định cấu hình Edge Microgateway. Bạn có thể sử dụng
các lệnh cert được mô tả tại đây để tạo lại và quản lý các khoá này
nếu cần.
Cài đặt chứng chỉ
Cài đặt các khoá trong một Bản đồ giá trị khoá (KVM) đã mã hoá bằng dịch vụ cửa hàng bảo mật Apigee Edge và trả về đầu ra là khoá công khai. Các cặp khoá thuộc phạm vi một tổ chức được chỉ định.
Tác dụng
edgemicro cert install -o [organization] -e [environment] -u [username] -p [password] --force
Tham số
| Tham số | Mô tả |
|---|---|
-o, --org |
Tổ chức Apigee mà bạn đã định cấu hình Edge Microgateway. |
-e, --env |
Một môi trường mà bạn đã định cấu hình Edge Microgateway. |
-u, --username |
Tên người dùng của bạn trên Apigee. Bạn phải là quản trị viên tổ chức cho thuộc tính tổ chức. |
-p, --password |
(Không bắt buộc) Mật khẩu của bạn. Bạn sẽ được nhắc nếu không cung cấp thông số này vào dòng lệnh. |
-f, --force |
(Không bắt buộc) Nếu một khoá đã được lưu trữ trong KVM đã mã hoá, hãy buộc thay thế khoá. |
-h, --help |
Thông tin về mức sử dụng đầu ra. |
Ví dụ
edgemicro cert install -o docs -e test -u jdoe@example.com -f
Kết quả
current nodejs version is v6.1.0 current edgemicro version is 2.2.4-beta password: deleting vault creating vault adding private_key adding public_key installed cert
Xoá chứng chỉ
Xoá cặp khoá của một tổ chức.
Tác dụng
edgemicro cert delete -o [organization] -e [environment] -u [username] -p [password]
Tham số
| Tham số | Mô tả |
|---|---|
-o, --org |
Tổ chức Apigee mà bạn đã định cấu hình Edge Microgateway. |
-e, --env |
Một môi trường mà bạn đã định cấu hình Edge Microgateway. |
-u, --username |
Tên người dùng của bạn trên Apigee. Bạn phải là quản trị viên tổ chức cho thuộc tính tổ chức. |
-p, --password |
(Không bắt buộc) Mật khẩu của bạn. Bạn sẽ được nhắc nếu không cung cấp thông số này vào dòng lệnh. |
-h, --help |
Thông tin về mức sử dụng đầu ra. |
Ví dụ
edgemicro cert delete -o docs -e test -u jdoe@example.com
Kết quả
deleting vault Vault deleted!
Kiểm tra chứng chỉ
Kiểm tra để đảm bảo rằng tổ chức của bạn đã cài đặt một chứng chỉ.
Tác dụng
edgemicro cert check -o [organization] -e [environment] -u [username] -p [password]
Tham số
| Tham số | Mô tả |
|---|---|
-o, --org |
Tổ chức Apigee mà bạn đã định cấu hình Edge Microgateway. |
-e, --env |
Một môi trường mà bạn đã định cấu hình Edge Microgateway. |
-u, --username |
Tên người dùng của bạn trên Apigee. Bạn phải là quản trị viên tổ chức cho thuộc tính tổ chức. |
-p, --password |
(Không bắt buộc) Mật khẩu của bạn. Bạn sẽ được nhắc nếu không cung cấp thông số này vào dòng lệnh. |
-h, --help |
Thông tin về mức sử dụng đầu ra. |
Ví dụ
edgemicro cert check -o docs -e test -u jdoe@example.com
Kết quả (Thành công)
checked cert successfully
Kết quả (Không thành công)
Nếu chứng chỉ không tồn tại thì hệ thống sẽ trả về lỗi.
Lấy khoá công khai
Trả về khoá công khai cho tổ chức được chỉ định. Không yêu cầu xác thực.
Tác dụng
edgemicro cert public-key -o [organization] -e [environment]
Tham số
| Tham số | Mô tả |
|---|---|
-o, --org |
Tổ chức Apigee mà bạn đã định cấu hình Edge Microgateway. |
-e, --env |
Một môi trường mà bạn đã định cấu hình Edge Microgateway. |
-h, --help |
Thông tin về mức sử dụng đầu ra. |
Ví dụ
edgemicro cert public-key -o docs -e test
Đầu ra (Mẫu)
-----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-----
Định cấu hình Edge Microgateway cho Apigee Đám mây viền
Cho phép Edge Microgateway hoạt động với một phiên bản Apigee Edge Cloud. Chiến dịch kết thúc và hoạt động hiệu quả một trình tự các lệnh để triển khai proxy xác thực bắt buộc cho Edge, tạo phương thức xác thực mã thông báo và cập nhật tệp cấu hình. Để xem ví dụ đầy đủ về cách hoạt động, hãy xem phần Cài đặt thiết lập và định cấu hình Edge Microgateway.
Tác dụng
edgemicro configure -o [organization] -e [environment] -u [username] -p [password]
Tham số
| Tham số | Mô tả |
|---|---|
-o, --org |
Tổ chức Apigee mà bạn đã định cấu hình Edge Microgateway. |
-e, --env |
Một môi trường mà bạn đã định cấu hình Edge Microgateway. |
-u, --username |
Tên người dùng của bạn trên Apigee. Bạn phải là quản trị viên tổ chức cho thuộc tính tổ chức. |
-p, --password |
(Không bắt buộc) Mật khẩu của bạn. Bạn sẽ được nhắc nếu không cung cấp thông số này vào dòng lệnh. |
-r, --url |
(Không bắt buộc) Chỉ định bí danh máy chủ ảo cho tổ chức của bạn:environment. Xem
Tài liệu Edge để tìm hiểu về máy chủ ảo.
Mặc định: org-env.apigee.net |
-c, --configDir |
(Không bắt buộc) Chỉ định đường dẫn đến tệp cấu hình Edge Microgateway. Theo mặc định, tệp cấu hình nằm trong ./config/config.yaml. (Đã thêm v2.4.x) |
-x, --proxyName |
(Không bắt buộc) Đặt đường dẫn cơ sở cho proxy edgemicro-auth. Nếu proxy edgemicro-auth được triển khai theo một đường dẫn khác từ giá trị mặc định, /edgemicro-auth, tính năng này cho phép bạn đặt con đường mới trong Edge Microgateway. Theo mặc định, đường dẫn cơ sở là /edgemicro-auth. (Đã thêm phiên bản 2.4.x) |
-t, --token |
(Không bắt buộc) Cho phép bạn dùng mã thông báo OAuth để xác thực thay vì tên người dùng/mật khẩu.
Ví dụ:edgemicro configure -o docs -e test -t <your token> |
-v, --virtualHosts |
(Không bắt buộc) Ghi đè các máy chủ ảo mặc định
"default,secure". Sử dụng tuỳ chọn này nếu bạn đã chỉ định máy chủ ảo cho
Tổ chức biên:môi trường không phải là các giá trị mặc định này. Xem tài liệu Edge để
tìm hiểu về máy chủ ảo. |
-d, --debug |
(Không bắt buộc) Cung cấp thông tin gỡ lỗi. |
-h, --help |
Thông tin về mức sử dụng đầu ra. |
Ghi chú sử dụng
Lệnh này lưu trữ thông tin cấu hình trong
khoảng /.edgemicro/org-env-config.yaml.
Ví dụ
edgemicro configure -o docs -e test -u jdoe@example.com
Kết quả
Khi thành công, lệnh này sẽ trả về một tập hợp các phím bạn cần dùng khi khởi động Edge Cổng nhỏ.
... The following credentials are required to start edge micro key: d2f0a246ad52b5d2a8b04ba65b43c76348aba586691cf6185cd7bb9fb78fe9f secret: 59813bc1db4a7ada182705ae40893c28a6fae680c3deb42aefbf1a4db42e372 edgemicro configuration complete!
Đang tạo khoá
Lệnh genkeys tạo ra một cặp khoá và khoá bí mật mà Edge sử dụng
Microgateway để tự xác thực khi đăng không đồng bộ dữ liệu phân tích lên Apigee
Cạnh.
Tác dụng
edgemicro genkeys -o [organization] -e [environment] -u [username] -p [password]
Tham số
| Tham số | Mô tả |
|---|---|
-o, --org |
Tổ chức Apigee mà bạn đã định cấu hình Edge Microgateway. |
-e, --env |
Một môi trường mà bạn đã định cấu hình Edge Microgateway. |
-u, --username |
Tên người dùng của bạn trên Apigee. Bạn phải là quản trị viên tổ chức cho thuộc tính tổ chức. |
-p, --password |
(Không bắt buộc) Mật khẩu của bạn. Bạn sẽ được nhắc nếu không cung cấp thông số này vào dòng lệnh. |
-h, --help |
Thông tin về mức sử dụng đầu ra. |
Ghi chú sử dụng
Khi thành công, lệnh này trả về 3 mục. Đầu tiên là một URL bạn cần đặt vào tệp cấu hình. Hai khoá còn lại là cặp khoá bắt buộc khi bạn khởi động Edge Phiên bản Microgateway.
- URL khởi động: URL này trỏ đến dịch vụ Apigee Edge cho phép
Phiên bản Edge Microgateway để gửi dữ liệu phân tích cho Apigee Edge. Bạn cần sao chép URL đó
vào tệp cấu hình Edge Microgateway: ~
/.edgemicro/org-env-config.yaml. - key: Khoá. Khoá này và mã bí mật là dữ liệu đầu vào cho CLI dùng để khởi động một phiên bản của Edge Microgateway.
- secret: Bí mật.
Ví dụ
edgemicro genkeys -o docs -e test -u jdoe@example.com
Đầu ra (Mẫu)
Khi thành công, lệnh này sẽ trả về một tập hợp các phím bạn cần dùng khi khởi động Edge Cổng nhỏ.
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
Định cấu hình Edge Microgateway cho Đám mây riêng tư Apigee Edge
Thiết lập để Edge Microgateway hoạt động với quy trình cài đặt dịch vụ đám mây riêng tư của Apigee Edge.
Tác dụng
edgemicro private configure -o [organization] -e [environment] -u [username] -p [password]
Tham số
| Tham số | Mô tả |
|---|---|
-o, --org |
Tổ chức Apigee mà bạn đã định cấu hình Edge Microgateway. |
-e, --env |
Một môi trường mà bạn đã định cấu hình Edge Microgateway. |
-u, --username |
Tên người dùng của bạn trên Apigee. Bạn phải là quản trị viên tổ chức cho thuộc tính tổ chức. |
-p, --password |
(Không bắt buộc) Mật khẩu của bạn. Bạn sẽ được nhắc nếu không cung cấp thông số này vào dòng lệnh. |
-r, --runtime-url |
Chỉ định URL thời gian chạy cho phiên bản đám mây riêng tư của bạn. |
-m, --mgmt-url |
URL của máy chủ quản lý cho phiên bản đám mây riêng tư của bạn. |
-v, --virtualHosts |
Danh sách máy chủ ảo được phân tách bằng dấu phẩy cho tổ chức của bạn:environment. Mặc định
"default,secure". |
-c, --configDir |
(Không bắt buộc) Chỉ định đường dẫn đến tệp cấu hình Edge Microgateway. Theo mặc định, tệp cấu hình nằm trong ./config/config.yaml. (Đã thêm v2.4.x) |
-t, --token |
(Không bắt buộc) Cho phép bạn dùng mã thông báo OAuth để xác thực thay vì tên người dùng/mật khẩu.
Ví dụ:edgemicro configure -o docs -e test -t <your token> |
-d, --debug |
(Không bắt buộc) Cung cấp thông tin gỡ lỗi. |
-h, --help |
Thông tin về mức sử dụng đầu ra. |
Ghi chú sử dụng
Lệnh này lưu trữ thông tin cấu hình trong
khoảng /.edgemicro/org-env-config.yaml.
Ví dụ
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
Kết quả
Khi thành công, lệnh này sẽ trả về một tập hợp các phím bạn cần dùng khi khởi động Edge Cổng nhỏ.
... The following credentials are required to start edge micro key: d2f0a246ad52b5d2a8b04ba65b43c76348aba586691cf6185cd7bb9fb78fe9f secret: 59813bc1db4a7ada182705ae40893c28a6fae680c3deb42aefbf1a4db42e372 edgemicro configuration complete!
Khởi động Edge Microgateway
Trước khi khởi động Edge Microgateway, đầu tiên bạn phải chạy Edgemicro cấu hình (Public Cloud) hoặc edgemicro riêng tư định cấu hình (Đám mây riêng tư). Lệnh cấu hình trả về các giá trị khoá và khoá bí mật cần thiết để khởi động Edge Microgateway.
Tác dụng
edgemicro start -o [organization] -e [environment] -k [public-key] -s [secret-key]
Tham số
| Tham số | Mô tả |
|---|---|
-o, --org |
Tổ chức Apigee mà bạn đã định cấu hình Edge Microgateway. |
-e, --env |
Một môi trường mà bạn đã định cấu hình Edge Microgateway. |
-k, --key |
Giá trị khoá được trả về và được trả về khi bạn chạy "edgemicro
configure" . |
-s, --secret |
Giá trị bí mật được trả về khi bạn chạy "edgemicro
configure" . |
-p, --processes |
(Không bắt buộc) Số quy trình cần bắt đầu. Mặc định: Số lượng lõi trên hệ thống. |
-d, --pluginDir |
(Không bắt buộc) Đường dẫn tuyệt đối đến thư mục trình bổ trợ. |
-r, --port |
(Không bắt buộc) Ghi đè số cổng được chỉ định trong
~/.edgemicro/org-env-config.yaml tệp. Mặc định: 8000 |
-c, --cluster |
(Không bắt buộc) Khởi động Edge Microgateway ở chế độ cụm. Lưu ý: Kể từ phiên bản 2.3.1, tuỳ chọn này đã bị xoá. Trong Các phiên bản từ 2.3.1 trở lên, Edge Micro luôn khởi động ở chế độ cụm đồng hồ. |
-c, --configDir |
(Không bắt buộc) Chỉ định đường dẫn đến tệp cấu hình Edge Microgateway. Theo mặc định, tệp cấu hình nằm trong ./config/config.yaml. (Đã thêm v2.4.x) |
-d, --debug |
(Không bắt buộc) Cung cấp thông tin gỡ lỗi. |
-h, --help |
Thông tin về mức sử dụng đầu ra. |
Đặt cổng
Lệnh start cho phép bạn chỉ định số cổng để ghi đè cổng đó
được chỉ định trong tệp cấu hình. Bạn cũng có thể chỉ định số cổng bằng
biến môi trường PORT. Ví dụ:
edgemicro start -o docs -e test -k abc123 -s xyz456 -p 2 --port 8002
hoặc
export PORT=8002 edgemicro start -o org -e test -k key -s secret -p 2
Nếu cổng đang được sử dụng, Edge Microgateway sẽ trả về lỗi.
Giới thiệu về tính năng phân cụm
Edge Microgateway sử dụng Node.js mô-đun cụm để bật tính năng phân cụm. Việc phân cụm cho phép Edge Microgateway của các hệ thống đa lõi. Để biết thông tin chi tiết, hãy xem tài liệu về Node.js.
Ví dụ
edgemicro start -o docs -e test -k abc123 -s xyz456
Kết quả mẫu:
... PROCESS PID : 54709 installed plugin from analytics installed plugin from analytics installed plugin from oauth installed plugin from oauth installed plugin from analytics installed plugin from oauth 5a86b570-a142-11e6-aa1f-6730e9065d6c edge micro listening on port 8000 5a86dc80-a142-11e6-962c-43d9cc723190 edge micro listening on port 8000 5a8751b0-a142-11e6-8241-cf1c517c91eb edge micro listening on port 8000 installed plugin from analytics installed plugin from oauth 5a924e30-a142-11e6-8740-2944162ce275 edge micro listening on port 8000
Quản lý mã thông báo
Các lệnh token cho phép bạn thu thập, giải mã và xác minh OAuth2 đã ký
mã truy cập. Xem thêm phần Bảo mật
Lệnh gọi API bằng mã truy cập OAuth2.
Giải mã mã thông báo
Giải mã một mã thông báo mang tải đã ký, được mã hoá thành JSON JWT văn bản thuần tuý (Mã thông báo web Java) đại diện. Mã thông báo truyền tải thông tin về ứng dụng của nhà phát triển Apigee Edge đã cung cấp các khoá dùng để tạo mã thông báo, bao gồm tên ứng dụng, client_id, danh sách sản phẩm, v.v.
Tác dụng
edgemicro token decode -f [filename]
Tham số
| Tham số | Mô tả |
|---|---|
-f, --file |
Tên của tệp chứa mã thông báo JWT để giải mã. |
-h, --help |
Thông tin về mức sử dụng đầu ra. |
Ví dụ
edgemicro token decode -f token.jwt
Kết quả (Mẫu)
{ 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: ... }
Tạo mã thông báo
Tạo mã thông báo mang tải đã ký. Mã thông báo này cho phép ứng dụng khách thực hiện lệnh gọi API đã xác thực đến Edge Microgateway. Mã thông báo là Mã thông báo web JSON tuân thủ OAuth 2.0 (JWT). Định dạng này yêu cầu nhập các giá trị Khoá Người dùng (ID ứng dụng khách) và Bí mật ứng dụng khách (mật khẩu ứng dụng khách) từ một tên ứng dụng dành cho nhà phát triển trên Apigee Edge. Xem thêm phần Bảo mật Lệnh gọi API bằng mã truy cập OAuth2.
Tác dụng
edgemicro token get -o [org] -e [env] -i [client_id] -s [client_secret]
Tham số
| Tham số | Mô tả |
|---|---|
-o, --org |
Tổ chức Apigee mà bạn đã định cấu hình Edge Microgateway. |
-e, --env |
Một môi trường mà bạn đã định cấu hình Edge Microgateway. |
-1, --key |
Mã ứng dụng khách trong Ứng dụng dành cho nhà phát triển được liên kết với Microgateway của bạn proxy. |
-s, --secret |
Mật khẩu ứng dụng khách từ ứng dụng dành cho nhà phát triển được liên kết với khả năng nhận biết Microgateway của bạn proxy. |
-h, --help |
Thông tin về mức sử dụng đầu ra. |
Ví dụ
edgemicro token get -o docs -e test -i 5UzOwAXGoOeo60aew94PPG5MAZE3aJp -s 6vahKFGS9a3qMLwz
Kết quả (Mẫu)
{ token: 'eyJ0eXAiOiJKV1JhbGciOiJSUzI1NiJ9Glvbl9uYW1lIjoiNWNiMGY0NTV6TV3
EtOWMzOC00YmJjLWIzNzEtZGMxZTQzOGMxIiwiY2xpZW50X2lkIjoiNVV6T3dBWEdvSU9lbz
YwYWV3OTRQN0c1TUFaRTNhSnAiLCJzY2MiOltdLCJhcGlfcHJvZHVjdF9saXN0IjpbIkVkZ2
VNaWNyb1Rlc3RQcm9kdWN0Il0sImlhdCI3ODEyMzQ2MSwiZXhwIjoxNDc4MTI1MjYwfQ.Dx5
f5U7PXm8koNGmFX4N6VrxKMJnpndKgoJ5zWSJvBZ6Ccvhlpd85ipIIA5S2A5nx4obYWp_rpY
RJpIGYwyxP6Oq2j0rxnVjdCC4qyYMgthZjhKgEBVBe3s1ndP72GP2vV6PsSA9RQ2-yzsy9r0
TzhAZ3NJTxT1tS0XKqKngE-OhR3fJHVLAzdMDT0AmS9H0Z2NAJtQOuK6RTpCjG9B6Bc48AEM
sj7QSM-1LWiQ8LdY8k_BoC06qsTI7bCQGWwTuqL-ismbcx2bxovUxSemZIaoROfuF-dCZHG3
2aTP75WxBvvNgBBvPvQtPzbeSOtEaww' }Tạo yêu cầu HTTP để nhận mã thông báo
Bạn cũng có thể thực hiện một yêu cầu HTTP thô để lấy mã thông báo. Dưới đây là một ví dụ về cuộn tròn. Chỉ thay thế tên tổ chức và môi trường của bạn vào URL, đồng thời thay thế Mã nhận dạng người tiêu dùng và Thông tin bí mật của người tiêu dùng các giá trị cho các thông số client_id và client_secret:
curl -i -X POST "http://<org>-<test>.apigee.net/edgemicro-auth/token" -d '{"grant_type": "client_credentials", "client_id": "4t8X137pOUUtMR7wag3M1yZTcRxeK", "client_secret": "RAcOFVOvO0jns"}' -H "Content-Type: application/json"
Xác minh mã thông báo
Xác minh mã thông báo mang đã ký dựa trên khoá công khai được lưu trữ trên Apigee Edge cho giá trị được chỉ định tổ chức và môi trường.
Tác dụng
edgemicro token verify -o [org] -e [env] -f [filename]
Tham số
| Tham số | Mô tả |
|---|---|
-o, --org |
Tổ chức Apigee mà bạn đã định cấu hình Edge Microgateway. |
-e, --env |
Một môi trường mà bạn đã định cấu hình Edge Microgateway. |
-f, --file |
Tên của tệp chứa JWT để xác minh. |
-h, --help |
Thông tin về mức sử dụng đầu ra. |
Ví dụ
edgemicro token get -o docs -e test -f token.jwt
Kết quả mẫu cho mã thông báo hợp lệ
{ application_name: 'b43342ef-86f6-4666-a121-b9ac2025d217',
client_id: 'O9ZQRZKnn1rdgcKQsAZUBkQSMdOsKS',
scopes: [],
api_product_list: [ 'MicroTest' ],
iat: 1436396155,
exp: 1436397954 }Kết quả mẫu cho mã thông báo không hợp lệ
{ [JsonWebTokenError: invalid token] name: 'JsonWebTokenError', message: 'invalid token' }Nội dung mẫu cho mã thông báo đã hết hạn
{ [TokenExpiredError: jwt expired]
name: 'TokenExpiredError',
message: 'jwt expired',
expiredAt: Tue Jul 07 2015 09:19:25 GMT-0600 (MDT) }Nhận mã thông báo truy cập trực tiếp
Bạn có thể muốn lấy trực tiếp mã thông báo mang bằng cách gửi yêu cầu HTTP tới mã thông báo điểm cuối trên Apigee Edge. Điểm cuối của mã thông báo thực tế được triển khai trong proxy đã triển khai bằng lệnh CLI triển khai cạnh tranh.
Dưới đây là một ví dụ về cuộn tròn. Bạn chỉ cần thay thế tên tổ chức và tên môi trường của mình trong URL, và thay thế các giá trị Mã nhận dạng người tiêu dùng và Thông tin bí mật của người dùng thu được từ ứng dụng của nhà phát triển trên Apigee Cạnh cho các thông số client_id và client_secret:
curl -i -X POST "http://<org>-<test>.apigee.net/edgemicro-auth/token" -d '{"grant_type": "client_credentials", "client_id": "4t8X137pOUUtMR7wag3M1yZTcRxeK", "client_secret": "RAcOFVOvO0jns"}' -H "Content-Type: application/json"
Kết quả mẫu:
HTTP/1.1 200 OK X-Powered-By: Express Cache-Control: no-store Pragma: no-cache Content-Type: application/json; charset=utf-8 Content-Length: 640 ETag: W/"280-ze/g/k+c9taqp110vjYQ" Date: Fri, 17 07 2015 15:49:24 GMT Connection: keep-alive "<long string of numbers and letters>"
Khởi chạy một Microgateway mới cấu hình
Chạy lệnh này một lần sau khi bạn cài đặt Edge Microgateway lần đầu tiên. Tạo chế độ mặc định mới
tệp cấu hình: ~/.edgemicro/default.yaml.
Tác dụng
edgemicro init
Tham số
| Tham số | Mô tả |
|---|---|
-c, --configDir |
(Không bắt buộc) Chỉ định đường dẫn đến tệp cấu hình Edge Microgateway. Theo mặc định, tệp cấu hình nằm trong ./config/config.yaml. (Đã thêm v2.4.x) |
-h, --help |
Thông tin về mức sử dụng đầu ra. |
Ví dụ
edgemicro init
Kết quả (Thành công)
config initialized to /MyHome/.edgemicro/default.yaml
Xác minh cấu hình Edge Microgateway
Xác minh rằng Edge Microgateway được định cấu hình đúng cách.
Tác dụng
edgemicro verify -o [organization] -e [environment] -k [public-key] -s [secret-key]
Tham số
Ví dụ
edgemicro verify -o docs -e test -k abc123 -s xyz456
Kết quả (Thành công)
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
Kiểm tra trạng thái của cụm cổng vi mô
Đã thêm: phiên bản 2.2.4-beta
Theo mặc định, Edge Microgateway sẽ khởi động ở chế độ cụm đồng hồ. Bạn có thể sử dụng lệnh này để kiểm tra trạng thái của cụm.
Tác dụng
edgemicro status
Tham số
| Tham số | Mô tả |
|---|---|
-h, --help |
Thông tin về mức sử dụng đầu ra. |
Ví dụ
edgemicro status
Kết quả (Thành công)
current nodejs version is v6.1.0 current edgemicro version is 2.2.4-beta edgemicro is running with 4 workers
Dừng cụm cổng nhỏ (microgateway)
Đã thêm: phiên bản 2.2.4-beta
Dừng cụm Edge Microgateway.
Tác dụng
edgemicro stop
Tham số
| Tham số | Mô tả |
|---|---|
-h, --help |
Thông tin về mức sử dụng đầu ra. |
Ví dụ
edgemicro stop
Kết quả (Thành công)
current nodejs version is v6.1.0 current edgemicro version is 2.2.4-beta Stop Completed Successfully
Đang tải lại cụm cổng vi mô
Đã thêm: phiên bản 2.2.4-beta
Cho phép khởi động lại trong thời gian không hoạt động sau khi thay đổi cấu hình. Tải lại Edge Microgateway bằng cách thêm một cấu hình mới.
Tác dụng
edgemicro reload -o [organization] -e [environment] -k [public-key] -s [secret-key]
Tham số
| Tham số | Mô tả |
|---|---|
-o, --org |
Tổ chức Apigee mà bạn đã định cấu hình Edge Microgateway. |
-e, --env |
Một môi trường mà bạn đã định cấu hình Edge Microgateway. |
-k, --key |
Giá trị khoá được trả về và được trả về khi bạn chạy "edgemicro
configure" . |
-s, --secret |
Giá trị bí mật được trả về khi bạn chạy "edgemicro
configure" . |
-h, --help |
Thông tin về mức sử dụng đầu ra. |
Ví dụ
edgemicro reload -o docs -e test -k abc123 -s xyz456
Kết quả (Thành công)
... Reload Completed Successfully