คุณกำลังดูเอกสารประกอบ Apigee Edge
ไปที่
เอกสารประกอบเกี่ยวกับ Apigee X. ข้อมูล
Edge Microgateway เวอร์ชัน 2.4.x
ภาพรวม
Edge Microgateway CLI ช่วยให้คุณสามารถควบคุมและจัดการ Edge Microgateway ในทุกด้าน อินสแตนซ์
การจัดการใบรับรอง
คำสั่ง cert ช่วยให้คุณติดตั้งและจัดการคีย์สาธารณะ/ส่วนตัวได้
คู่ที่ใช้ในการเซ็นโทเค็นสำหรับผู้ถือโดยไคลเอ็นต์ที่ไคลเอ็นต์ใช้ในการโทรอย่างปลอดภัยผ่าน Edge
ทางไมโครเกตเวย์ ระบบจะจัดเก็บคีย์ไว้ใน Apigee Edge ใน Key Value Map (KVM) ที่เข้ารหัส Edge Microgateway ใช้องค์ประกอบ
คีย์สาธารณะสำหรับตรวจสอบโทเค็นสำหรับผู้ถือที่ลงนามแล้ว คีย์เหล่านี้จะสร้างขึ้นเมื่อคุณเรียกใช้ Edgemicro
คำสั่งกำหนดค่า ตามที่อธิบายไว้ในการตั้งค่า
และกำหนดค่า Edge Microgateway คุณสามารถใช้
คำสั่ง cert ที่อธิบายไว้ในนี้เพื่อสร้างและจัดการคีย์เหล่านี้ใหม่
หากจำเป็น
ติดตั้งใบรับรอง
ติดตั้งคีย์ใน Key Value Map (KVM) ที่เข้ารหัสโดยใช้บริการร้านค้าที่ปลอดภัยของ 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 |
(ไม่บังคับ) หากมีการจัดเก็บคีย์ไว้ใน KVM ที่เข้ารหัสแล้ว ให้บังคับการเปลี่ยนคีย์ |
-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 |
-c, --configDir |
(ไม่บังคับ) ระบุเส้นทางไปยังไฟล์การกำหนดค่า Edge Microgateway โดยค่าเริ่มต้น ไฟล์การกำหนดค่าอยู่ใน ./config/config.yaml (เพิ่มแล้ว v2.4.x) |
-x, --proxyName |
(ไม่บังคับ) ตั้งค่าเส้นทางฐานสำหรับพร็อกซี edgemicro-auth มีการใช้งานพร็อกซี edgemicro-auth ภายใต้เส้นทางอื่นหรือไม่ จากค่าเริ่มต้น /edgemicro-auth ฟีเจอร์นี้จะช่วยให้คุณตั้งค่าโดเมน เส้นทางใหม่ใน Edge Microgateway โดยค่าเริ่มต้น เส้นทางฐาน คือ /edgemicro-auth (เพิ่ม v2.4.x) |
-t, --token |
(ไม่บังคับ) ให้คุณใช้โทเค็น OAuth ในการตรวจสอบสิทธิ์แทนชื่อผู้ใช้/รหัสผ่าน
ตัวอย่างเช่น วันที่ 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 ทางไมโครเกตเวย์
... The following credentials are required to start edge micro key: d2f0a246ad52b5d2a8b04ba65b43c76348aba586691cf6185cd7bb9fb78fe9f secret: 59813bc1db4a7ada182705ae40893c28a6fae680c3deb42aefbf1a4db42e372 edgemicro configuration complete!
กำลังสร้างคีย์
คำสั่ง genkeys จะสร้างคู่คีย์และข้อมูลลับที่ Edge ใช้
ช่องทางขนาดเล็กในการตรวจสอบสิทธิ์ตัวเองเมื่อโพสต์ข้อมูลวิเคราะห์ไปยัง 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 อินสแตนซ์ไมโครเกตเวย์
- 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 ทางไมโครเกตเวย์
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" |
-c, --configDir |
(ไม่บังคับ) ระบุเส้นทางไปยังไฟล์การกำหนดค่า Edge Microgateway โดยค่าเริ่มต้น ไฟล์การกำหนดค่าอยู่ใน ./config/config.yaml (เพิ่มแล้ว v2.4.x) |
-t, --token |
(ไม่บังคับ) ให้คุณใช้โทเค็น OAuth ในการตรวจสอบสิทธิ์แทนชื่อผู้ใช้/รหัสผ่าน
ตัวอย่างเช่น วันที่ 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 ทางไมโครเกตเวย์
... The following credentials are required to start edge micro key: d2f0a246ad52b5d2a8b04ba65b43c76348aba586691cf6185cd7bb9fb78fe9f secret: 59813bc1db4a7ada182705ae40893c28a6fae680c3deb42aefbf1a4db42e372 edgemicro configuration complete!
การเริ่มต้น Edge Microgateway
ก่อนที่จะเริ่ม Edge Microgateway คุณต้องเรียกใช้ edgemicro ก่อน กำหนดค่า (Public Cloud) หรือ edgemicro Private กำหนดค่า (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 เป็นต้นไป ใน Edge Micro จะเริ่มต้นในโหมดคลัสเตอร์เสมอ ตั้งแต่เวอร์ชัน 2.3.1 ขึ้นไป |
-c, --configDir |
(ไม่บังคับ) ระบุเส้นทางไปยังไฟล์การกำหนดค่า Edge Microgateway โดยค่าเริ่มต้น ไฟล์การกำหนดค่าอยู่ใน ./config/config.yaml (เพิ่มแล้ว v2.4.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 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-Aware ของคุณ พร็อกซี |
-s, --secret |
รหัสลับไคลเอ็นต์จากแอปของนักพัฒนาซอฟต์แวร์ที่เชื่อมโยงกับ Microgateway-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 ดิบเพื่อรับโทเค็นได้ด้วย นี่คือตัวอย่างของ 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-service
นี่คือตัวอย่างของ Curl เพียงแทนที่ชื่อองค์กรและสภาพแวดล้อมใน URL และ แทนที่ค่ารหัสผู้บริโภคและข้อมูลลับของผู้บริโภคที่ได้รับจากแอปของนักพัฒนาซอฟต์แวร์ใน Apigee ขอบสำหรับ พารามิเตอร์ 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
พารามิเตอร์
| พารามิเตอร์ | คำอธิบาย |
|---|---|
-c, --configDir |
(ไม่บังคับ) ระบุเส้นทางไปยังไฟล์การกำหนดค่า Edge Microgateway โดยค่าเริ่มต้น ไฟล์การกำหนดค่าอยู่ใน ./config/config.yaml (เพิ่มแล้ว v2.4.x) |
-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]
พารามิเตอร์
ตัวอย่าง
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