การอ้างอิง CLI สำหรับ Edge Microgateway

คุณกำลังดูเอกสารประกอบ Apigee Edge
ไปที่ เอกสารประกอบเกี่ยวกับ Apigee X.
ข้อมูล

Edge Microgateway เวอร์ชัน 2.3.x

ภาพรวม

Edge Microgateway CLI ช่วยให้คุณสามารถควบคุมและจัดการอินสแตนซ์ Edge Microgateway ในทุกด้าน

การจัดการใบรับรอง

คำสั่ง cert ช่วยให้คุณติดตั้งและจัดการคู่คีย์สาธารณะ/ส่วนตัวที่ใช้ในการลงนามโทเค็นสำหรับผู้ถือที่ใช้โดยไคลเอ็นต์เพื่อเรียกอย่างปลอดภัยผ่าน Edge Microgateway โดยระบบจะเก็บคีย์ไว้ใน Apigee Edge ในห้องนิรภัยที่ปลอดภัย Edge Microgateway ใช้คีย์สาธารณะเพื่อตรวจสอบโทเค็นสำหรับผู้ถือที่มีการลงนาม คีย์เหล่านี้จะสร้างขึ้นเมื่อคุณเรียกใช้คำสั่ง EDGEmicro กำหนดค่า ตามที่อธิบายไว้ใน การตั้งค่าและการกำหนดค่า Edge Microgateway คุณใช้คำสั่ง cert ตามที่อธิบายไว้ที่นี่เพื่อสร้างและจัดการคีย์เหล่านี้ได้ใหม่ หากจำเป็น

ติดตั้งใบรับรอง

ติดตั้งคีย์ในห้องนิรภัยโดยใช้บริการร้านค้าที่ปลอดภัยของ Apigee Edge และแสดงผลคีย์สาธารณะเป็นเอาต์พุต คู่คีย์มีการกำหนดขอบเขตเฉพาะองค์กรที่ระบุ

การใช้งาน

edgemicro cert install -o [organization] -e [environment] -u [username] -p [password] --force

พารามิเตอร์

พารามิเตอร์ คำอธิบาย
-o, --org องค์กร Apigee ที่คุณกำหนดค่า Edge Microgateway ไว้
-e, --env สภาพแวดล้อมที่คุณกำหนดค่า Edge Microgateway ไว้
-u, --username ชื่อผู้ใช้ Apigee ของคุณ คุณต้องเป็นผู้ดูแลระบบขององค์กรขององค์กรที่ระบุ
-p, --password (ไม่บังคับ) รหัสผ่านของคุณ คุณจะได้รับข้อความแจ้งหากไม่ระบุพารามิเตอร์นี้ในบรรทัดคำสั่ง
-f, --force (ไม่บังคับ) หากมีการเก็บคีย์ไว้ในห้องนิรภัยแล้ว ให้บังคับใช้คีย์ใหม่
-h, --help ข้อมูลการใช้งานเอาต์พุต

ตัวอย่าง

edgemicro cert install -o docs -e test -u jdoe@example.com -f

เอาต์พุต

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

ลบใบรับรอง

ลบคู่คีย์ขององค์กร

การใช้งาน

edgemicro cert delete -o [organization] -e [environment] -u [username] -p [password]

พารามิเตอร์

พารามิเตอร์ คำอธิบาย
-o, --org องค์กร Apigee ที่คุณกำหนดค่า Edge Microgateway ไว้
-e, --env สภาพแวดล้อมที่คุณกำหนดค่า Edge Microgateway ไว้
-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 องค์กร Apigee ที่คุณกำหนดค่า Edge Microgateway ไว้
-e, --env สภาพแวดล้อมที่คุณกำหนดค่า Edge Microgateway ไว้
-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 องค์กร Apigee ที่คุณกำหนดค่า Edge Microgateway ไว้
-e, --env สภาพแวดล้อมที่คุณกำหนดค่า Edge Microgateway ไว้
-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-----

 

การกำหนดค่า Edge Microgateway สำหรับ Apigee Edge Cloud

เปิดใช้ Edge Microgateway เพื่อดำเนินการกับอินสแตนซ์ Apigee Edge Cloud ซึ่งจะรวมและดำเนินการตามลำดับของคำสั่งเพื่อทำให้พร็อกซีการตรวจสอบสิทธิ์ที่จำเป็นใช้งานได้กับ Edge สร้างโทเค็นการตรวจสอบสิทธิ์ และอัปเดตไฟล์การกำหนดค่า สำหรับตัวอย่างการทำงานที่สมบูรณ์ โปรดดูการตั้งค่าและการกำหนดค่า Edge Microgateway

การใช้งาน

edgemicro configure -o [organization] -e [environment] -u [username] -p [password]

พารามิเตอร์

พารามิเตอร์ คำอธิบาย
-o, --org องค์กร Apigee ที่คุณกำหนดค่า Edge Microgateway ไว้
-e, --env สภาพแวดล้อมที่คุณกำหนดค่า Edge Microgateway ไว้
-u, --username ชื่อผู้ใช้ Apigee ของคุณ คุณต้องเป็นผู้ดูแลระบบขององค์กรขององค์กรที่ระบุ
-p, --password (ไม่บังคับ) รหัสผ่านของคุณ คุณจะได้รับข้อความแจ้งหากไม่ระบุพารามิเตอร์นี้ในบรรทัดคำสั่ง
-r, --url (ไม่บังคับ) ระบุชื่อแทนโฮสต์เสมือนสำหรับองค์กร:สภาพแวดล้อม ดูข้อมูลเกี่ยวกับโฮสต์เสมือนในเอกสารประกอบของ Edge ค่าเริ่มต้น: org-env.apigee.net
-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 Microgateway

...

The following credentials are required to start edge micro
  key: d2f0a246ad52b5d2a8b04ba65b43c76348aba586691cf6185cd7bb9fb78fe9f
  secret: 59813bc1db4a7ada182705ae40893c28a6fae680c3deb42aefbf1a4db42e372

edgemicro configuration complete!

 

กำลังสร้างคีย์

คำสั่ง genkeys จะสร้างคู่คีย์และข้อมูลลับที่ Edge Microgateway ใช้เพื่อตรวจสอบสิทธิ์ตนเองเมื่อโพสต์ข้อมูลวิเคราะห์ไปยัง Apigee Edge แบบไม่พร้อมกัน

การใช้งาน

edgemicro genkeys -o [organization] -e [environment] -u [username] -p [password]

พารามิเตอร์

พารามิเตอร์ คำอธิบาย
-o, --org องค์กร Apigee ที่คุณกำหนดค่า Edge Microgateway ไว้
-e, --env สภาพแวดล้อมที่คุณกำหนดค่า Edge Microgateway ไว้
-u, --username ชื่อผู้ใช้ Apigee ของคุณ คุณต้องเป็นผู้ดูแลระบบขององค์กรขององค์กรที่ระบุ
-p, --password (ไม่บังคับ) รหัสผ่านของคุณ คุณจะได้รับข้อความแจ้งหากไม่ระบุพารามิเตอร์นี้ในบรรทัดคำสั่ง
-h, --help ข้อมูลการใช้งานเอาต์พุต

หมายเหตุการใช้งาน

เมื่อทำสำเร็จแล้ว คำสั่งจะแสดงผลลัพธ์ 3 รายการ ส่วนแรกคือ URL ที่คุณต้องใส่ในไฟล์การกำหนดค่า อีก 2 รายการเป็นคู่คีย์ที่จำเป็นเมื่อคุณเริ่มอินสแตนซ์ Edge Microgateway

  • bootstrap URL: URL นี้ชี้ไปยังบริการ Apigee Edge ที่ช่วยให้อินสแตนซ์ Edge Microgateway ส่งข้อมูลการวิเคราะห์ไปยัง Apigee Edge ได้ คุณต้องคัดลอก URL นั้นลงในไฟล์การกำหนดค่า Edge Microgateway: ~/.edgemicro/org-env-config.yaml
  • key: คีย์ คีย์นี้และข้อมูลลับจำเป็นสำหรับอินพุตของคำสั่ง CLI ที่ใช้เพื่อเริ่มต้นอินสแตนซ์ของ Edge Microgateway
  • secret: ความลับ

ตัวอย่าง

edgemicro genkeys -o docs -e test -u jdoe@example.com

เอาต์พุต (ตัวอย่าง)

เมื่อสำเร็จแล้ว คำสั่งจะแสดงผลชุดคีย์ที่คุณจำเป็นต้องใช้เมื่อเริ่มต้นใช้งาน Edge Microgateway

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

 

การกำหนดค่า Edge Microgateway สำหรับ Apigee Edge Private Cloud

กำหนดค่า Edge Microgateway เพื่อทำงานร่วมกับการติดตั้ง Apigee Edge Private Cloud

การใช้งาน

edgemicro private configure -o [organization] -e [environment] -u [username] -p [password]

พารามิเตอร์

พารามิเตอร์ คำอธิบาย
-o, --org องค์กร Apigee ที่คุณกำหนดค่า Edge Microgateway ไว้
-e, --env สภาพแวดล้อมที่คุณกำหนดค่า Edge Microgateway ไว้
-u, --username ชื่อผู้ใช้ Apigee ของคุณ คุณต้องเป็นผู้ดูแลระบบขององค์กรขององค์กรที่ระบุ
-p, --password (ไม่บังคับ) รหัสผ่านของคุณ คุณจะได้รับข้อความแจ้งหากไม่ระบุพารามิเตอร์นี้ในบรรทัดคำสั่ง
-r, --runtime-url ระบุ URL รันไทม์สำหรับอินสแตนซ์ระบบคลาวด์ส่วนตัว
-m, --mgmt-url URL ของเซิร์ฟเวอร์การจัดการสำหรับอินสแตนซ์ระบบคลาวด์ส่วนตัว
-v, --virtualHosts รายชื่อโฮสต์เสมือนที่คั่นด้วยคอมมาสำหรับองค์กรของคุณ:สภาพแวดล้อม ค่าเริ่มต้น "default,secure"
-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 Microgateway

...

The following credentials are required to start edge micro
  key: d2f0a246ad52b5d2a8b04ba65b43c76348aba586691cf6185cd7bb9fb78fe9f
  secret: 59813bc1db4a7ada182705ae40893c28a6fae680c3deb42aefbf1a4db42e372

edgemicro configuration complete!

 

การเริ่มต้น Edge Microgateway

ก่อนเริ่ม Edge Microgateway คุณต้องเรียกใช้ edgemicroConfigure (Public Cloud) หรือ edgemicro Private Configuration (Private Cloud) ก่อน คำสั่งกำหนดค่าจะแสดงคีย์และค่าข้อมูลลับที่จำเป็นเพื่อเริ่มต้นใช้งาน Edge Microgateway

การใช้งาน

edgemicro start -o [organization] -e [environment] -k [public-key] -s [secret-key]

พารามิเตอร์

พารามิเตอร์ คำอธิบาย
-o, --org องค์กร Apigee ที่คุณกำหนดค่า Edge Microgateway ไว้
-e, --env สภาพแวดล้อมที่คุณกำหนดค่า Edge Microgateway ไว้
-k, --key คีย์-ค่าที่แสดงผลซึ่งแสดงผลเมื่อคุณเรียกใช้ "edgemicro configure" คำสั่ง
-s, --secret ค่าข้อมูลลับที่แสดงกลับมาเมื่อคุณเรียกใช้ "edgemicro configure" คำสั่ง
-p, --processes (ไม่บังคับ) จำนวนขั้นตอนที่จะเริ่มต้น ค่าเริ่มต้น: จำนวนแกนในระบบ
-d, --pluginDir (ไม่บังคับ) เส้นทางสัมบูรณ์ไปยังไดเรกทอรีปลั๊กอิน
-r, --port (ไม่บังคับ) ลบล้างหมายเลขพอร์ตที่ระบุไว้ในไฟล์ ~/.edgemicro/org-env-config.yaml ค่าเริ่มต้น: 8000
-c, --cluster

(ไม่บังคับ) เริ่มต้น Edge Microgateway ในโหมดคลัสเตอร์

หมายเหตุ: ตัวเลือกนี้ได้ถูกนำออกตั้งแต่เวอร์ชัน 2.3.1 เป็นต้นไป ในเวอร์ชัน 2.3.1 ขึ้นไป Edge Micro จะเริ่มต้นในโหมดคลัสเตอร์เสมอ

-c --config (ไม่บังคับ) ระบุตำแหน่งของไฟล์ default config.yaml ไฟล์นี้อยู่ใน ./config/config.yaml โดยค่าเริ่มต้น
-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 Microgateway จะแสดงข้อผิดพลาด

เกี่ยวกับการจัดกลุ่ม

Edge Microgateway ใช้โมดูลคลัสเตอร์ Node.js เพื่อเปิดใช้คลัสเตอร์ คลัสเตอร์ช่วยให้ Edge Microgateway ใช้ประโยชน์จากระบบแบบหลายแกนได้ โปรดดูรายละเอียดที่เอกสาร Node.js นี้

ตัวอย่าง

edgemicro start -o docs -e test -k abc123 -s xyz456

ตัวอย่างเอาต์พุต:

...

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

 

การจัดการโทเค็น

คำสั่ง token จะช่วยให้คุณรับ ถอดรหัส และยืนยันโทเค็นเพื่อการเข้าถึง OAuth2 ที่ลงนามแล้ว โปรดดูเพิ่มเติมที่หัวข้อการเรียก API ที่ปลอดภัยด้วยโทเค็นเพื่อการเข้าถึง OAuth2

ถอดรหัสโทเค็น

ถอดรหัสโทเค็นสำหรับผู้ถือที่เข้ารหัสและลงชื่อไว้ในการแทน JSON JWT (Java Web Token) แบบข้อความธรรมดา โทเค็นจะบ่งบอกถึงข้อมูลเกี่ยวกับแอปของนักพัฒนาซอฟต์แวร์ 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: '' }

สร้างโทเค็น

สร้างโทเค็นสำหรับผู้ถือที่มีลายเซ็น โทเค็นนี้จะช่วยให้แอปไคลเอ็นต์เรียกใช้ API ที่ผ่านการตรวจสอบสิทธิ์ไปยัง Edge Microgateway ได้ ซึ่งเป็นโทเค็นเว็บ JSON (JWT) ที่สอดคล้องกับ OAuth 2.0 โดยจะกำหนดให้ป้อนค่าคีย์ผู้ใช้ (รหัสไคลเอ็นต์) และรหัสลับผู้บริโภค (รหัสลับไคลเอ็นต์) จากแอปของนักพัฒนาซอฟต์แวร์ที่ลงทะเบียนใน Apigee Edge โปรดดูเพิ่มเติมที่หัวข้อการเรียก API ที่ปลอดภัยด้วยโทเค็นเพื่อการเข้าถึง OAuth2

การใช้งาน

edgemicro token get -o [org] -e [env] -i [client_id] -s [client_secret]

พารามิเตอร์

พารามิเตอร์ คำอธิบาย
-o, --org องค์กร Apigee ที่คุณกำหนดค่า Edge Microgateway ไว้
-e, --env สภาพแวดล้อมที่คุณกำหนดค่า Edge Microgateway ไว้
-1, --key รหัสไคลเอ็นต์จากแอปนักพัฒนาซอฟต์แวร์ที่เชื่อมโยงกับพร็อกซีที่รับรู้ Microgateway
-s, --secret รหัสลับไคลเอ็นต์จากแอปของนักพัฒนาซอฟต์แวร์ที่เชื่อมโยงกับพร็อกซีที่รับรู้ Microgateway ของคุณ
-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 ดิบเพื่อรับโทเค็นได้ด้วย นี่คือตัวอย่างของ Curl เพียงแทนที่ชื่อองค์กรและสภาพแวดล้อมใน URL และแทนที่ค่ารหัสผู้บริโภคและข้อมูลลับของผู้บริโภคสำหรับพารามิเตอร์ client_id และ 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"

ยืนยันโทเค็น

ยืนยันโทเค็นสำหรับผู้ถือที่ลงชื่อไว้กับคีย์สาธารณะที่จัดเก็บใน Apigee Edge สำหรับองค์กรและสภาพแวดล้อมที่ระบุ

การใช้งาน

edgemicro token verify -o [org] -e [env] -f [filename]

พารามิเตอร์

พารามิเตอร์ คำอธิบาย
-o, --org องค์กร Apigee ที่คุณกำหนดค่า Edge Microgateway ไว้
-e, --env สภาพแวดล้อมที่คุณกำหนดค่า Edge Microgateway ไว้
-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) }

การรับโทเค็นสำหรับผู้ถือโดยตรง

คุณอาจต้องการรับโทเค็นสำหรับผู้ถือโดยตรงด้วยการส่งคำขอ HTTP ไปยังปลายทางของโทเค็นใน Apigee Edge ปลายทางของโทเค็นจริงจะมีการใช้งานในพร็อกซีที่ทำให้ใช้งานได้ด้วยคำสั่ง CLI บริการ EDGE

นี่คือตัวอย่างของ Curl เพียงแทนที่ชื่อองค์กรและสภาพแวดล้อมใน URL และแทนที่ค่ารหัสผู้บริโภคและข้อมูลลับของผู้บริโภคที่ได้รับจากแอปของนักพัฒนาซอฟต์แวร์ใน Apigee Edge สำหรับพารามิเตอร์ client_id และ 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"

ตัวอย่างเอาต์พุต:

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>"

กำลังเริ่มต้นการกำหนดค่า Edge Microgateway ใหม่

เรียกใช้คำสั่งนี้เพียงครั้งเดียวหลังจากที่คุณติดตั้ง Edge Microgateway เป็นครั้งแรก สร้างไฟล์การกำหนดค่าเริ่มต้นใหม่: ~/.edgemicro/default.yaml

การใช้งาน

edgemicro init 

พารามิเตอร์

พารามิเตอร์ คำอธิบาย
-h, --help ข้อมูลการใช้งานเอาต์พุต

ตัวอย่าง

edgemicro init

เอาต์พุต (สำเร็จ)

config initialized to /MyHome/.edgemicro/default.yaml

กำลังยืนยันการกำหนดค่า Edge Microgateway

ตรวจสอบว่า Edge Microgateway มีการกำหนดค่าอย่างถูกต้อง

การใช้งาน

edgemicro verify -o [organization] -e [environment] -k [public-key] -s [secret-key]

พารามิเตอร์

พารามิเตอร์ คำอธิบาย
-o, --org องค์กร Apigee ที่คุณกำหนดค่า Edge Microgateway ไว้
-e, --env สภาพแวดล้อมที่คุณกำหนดค่า Edge Microgateway ไว้
-k, --key คีย์-ค่าที่แสดงผลซึ่งแสดงผลเมื่อคุณเรียกใช้ "edgemicro configure" คำสั่ง
-s, --secret ค่าข้อมูลลับที่แสดงกลับมาเมื่อคุณเรียกใช้ "edgemicro configure" คำสั่ง
-h, --help ข้อมูลการใช้งานเอาต์พุต

ตัวอย่าง

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

ตรวจสอบสถานะคลัสเตอร์ไมโครเกตเวย์

เพิ่มแล้ว: v2.2.4-beta

โดยค่าเริ่มต้น Edge Microgateway จะเริ่มต้นในโหมดคลัสเตอร์ คุณใช้คำสั่งนี้เพื่อตรวจสอบสถานะของคลัสเตอร์ได้

การใช้งาน

edgemicro status

พารามิเตอร์

พารามิเตอร์ คำอธิบาย
-h, --help ข้อมูลการใช้งานเอาต์พุต

ตัวอย่าง

edgemicro status

เอาต์พุต (สำเร็จ)

current nodejs version is v6.1.0
current edgemicro version is 2.2.4-beta
edgemicro is running with 4 workers

การหยุดคลัสเตอร์ไมโครเกตเวย์

เพิ่มแล้ว: v2.2.4-beta

หยุดคลัสเตอร์ Edge Microgateway

การใช้งาน

edgemicro stop

พารามิเตอร์

พารามิเตอร์ คำอธิบาย
-h, --help ข้อมูลการใช้งานเอาต์พุต

ตัวอย่าง

edgemicro stop

เอาต์พุต (สำเร็จ)

current nodejs version is v6.1.0
current edgemicro version is 2.2.4-beta
Stop Completed Successfully

กำลังโหลดคลัสเตอร์ไมโครเกตเวย์ซ้ำ

เพิ่มแล้ว: v2.2.4-beta

ระบุการรีสตาร์ทช่วงพักการใช้งานหลังจากการเปลี่ยนแปลงการกำหนดค่า โหลด Edge Microgateway ซ้ำโดยดึงข้อมูลการกำหนดค่าใหม่

การใช้งาน

edgemicro reload -o [organization] -e [environment] -k [public-key] -s [secret-key]

พารามิเตอร์

>
พารามิเตอร์ คำอธิบาย
-o, --org องค์กร Apigee ที่คุณกำหนดค่า Edge Microgateway ไว้
-e, --env สภาพแวดล้อมที่คุณกำหนดค่า Edge Microgateway ไว้
-k, --key คีย์-ค่าที่แสดงผลซึ่งแสดงผลเมื่อคุณเรียกใช้ "edgemicro configure" คำสั่ง
-s, --secret ค่าข้อมูลลับที่แสดงกลับมาเมื่อคุณเรียกใช้ "edgemicro configure" คำสั่ง
-h, --help ข้อมูลการใช้งานเอาต์พุต

ตัวอย่าง

edgemicro reload -o docs -e test -k abc123 -s xyz456

เอาต์พุต (สำเร็จ)

...

Reload Completed Successfully