คุณกำลังดูเอกสารประกอบ Apigee Edge
ไปที่
เอกสารประกอบเกี่ยวกับ Apigee 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