एज माइक्रोगेटवे के लिए सीएलआई रेफ़रंस

Apigee Edge दस्तावेज़ देखा जा रहा है.
Apigee X दस्तावेज़ पर जाएं.
जानकारी

Edge Microgateway v. 2.3.x

खास जानकारी

Edge माइक्रोगेटवे सीएलआई से आपको एज माइक्रोगेटवे इंस्टेंस के सभी पहलुओं को कंट्रोल और मैनेज करने की सुविधा मिलती है.

सर्टिफ़िकेट मैनेज करना

cert निर्देशों की मदद से, सार्वजनिक/निजी कुंजी के जोड़े को इंस्टॉल और मैनेज किया जा सकता है. इसका इस्तेमाल, एज माइक्रोगेटवे के ज़रिए सुरक्षित कॉल करने के लिए क्लाइंट के इस्तेमाल किए जाने वाले बेयर टोकन पर साइन करने के लिए किया जाता है. कुंजियां, Apigee Edge में सुरक्षित वॉल्ट में सेव हैं. एज माइक्रोगेटवे, साइन किए गए बेयरर टोकन की पुष्टि करने के लिए, सार्वजनिक पासकोड का इस्तेमाल करता है. Edge माइक्रोगेटवे को सेट अप और कॉन्फ़िगर करें कमांड के बारे में जानने के बाद, ये कुंजियां जनरेट होती हैं. ज़रूरत पड़ने पर, इन कुंजियों को फिर से जनरेट और मैनेज करने के लिए, यहां बताए गए cert कमांड का इस्तेमाल किया जा सकता है. 

कोई सर्टिफ़िकेट इंस्टॉल करें

Apigee Edge की सुरक्षित स्टोर सेवा का इस्तेमाल करके, वॉल्ट में कुंजियां इंस्टॉल करता है और आउटपुट के तौर पर सार्वजनिक कुंजी दिखाता है. कुंजी के जोड़े किसी खास संगठन तक सीमित होते हैं.

इस्तेमाल किए जाने से जुड़ी जानकारी

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

पैरामीटर

पैरामीटर ब्यौरा
-o, --org वह Apigee संगठन जिसके लिए आपने Edge माइक्रोगेटवे को कॉन्फ़िगर किया है.
-e, --env वह एनवायरमेंट जिसके लिए आपने Edge माइक्रोगेटवे को कॉन्फ़िगर किया है.
-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 माइक्रोगेटवे को कॉन्फ़िगर किया है.
-e, --env वह एनवायरमेंट जिसके लिए आपने Edge माइक्रोगेटवे को कॉन्फ़िगर किया है.
-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 माइक्रोगेटवे को कॉन्फ़िगर किया है.
-e, --env वह एनवायरमेंट जिसके लिए आपने Edge माइक्रोगेटवे को कॉन्फ़िगर किया है.
-u, --username आपका Apigee उपयोगकर्ता नाम. आपको खास संगठन के लिए संगठन का एडमिन होना चाहिए.
-p, --password (ज़रूरी नहीं) आपका पासवर्ड. अगर कमांड लाइन पर यह पैरामीटर नहीं दिया जाता है, तो आपको कहा जाएगा.
-h, --help आउटपुट के इस्तेमाल की जानकारी.

उदाहरण

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

आउटपुट (सफल)

checked cert successfully

आउटपुट (Failure)

अगर यह सर्टिफ़िकेट मौजूद नहीं है, तो गड़बड़ी का मैसेज दिखता है.

सार्वजनिक कुंजी डाउनलोड करें

किसी खास संगठन के लिए सार्वजनिक कुंजी दिखाता है. पुष्टि करने की ज़रूरत नहीं होती.

इस्तेमाल किए जाने से जुड़ी जानकारी

edgemicro cert public-key -o [organization] -e [environment]

पैरामीटर

पैरामीटर ब्यौरा
-o, --org वह Apigee संगठन जिसके लिए आपने Edge माइक्रोगेटवे को कॉन्फ़िगर किया है.
-e, --env वह एनवायरमेंट जिसके लिए आपने Edge माइक्रोगेटवे को कॉन्फ़िगर किया है.
-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 माइक्रोगेटवे को कॉन्फ़िगर करना

यह सुविधा, Apigee Edge Cloud इंस्टेंस के साथ काम करने के लिए, Edge माइक्रोगेटवे को चालू करती है. यह Edge पर पुष्टि करने वाले एक ज़रूरी प्रॉक्सी को डिप्लॉय करने, पुष्टि करने वाले टोकन जनरेट करने, और कॉन्फ़िगरेशन फ़ाइलों को अपडेट करने के लिए, निर्देशों के क्रम को रैप करता है और एक क्रम परफ़ॉर्म करता है. पूरी तरह से काम करने वाले उदाहरण के लिए, एज माइक्रोगेटवे को सेट अप और कॉन्फ़िगर करना देखें.

इस्तेमाल किए जाने से जुड़ी जानकारी

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

पैरामीटर

पैरामीटर ब्यौरा
-o, --org वह Apigee संगठन जिसके लिए आपने Edge माइक्रोगेटवे को कॉन्फ़िगर किया है.
-e, --env वह एनवायरमेंट जिसके लिए आपने Edge माइक्रोगेटवे को कॉन्फ़िगर किया है.
-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 माइक्रोगेटवे को शुरू करने पर होती है.

...

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

edgemicro configuration complete!

 

कुंजियां जनरेट की जा रही हैं

genkeys कमांड, कुंजी और सीक्रेट जोड़े को जनरेट करता है, जिनका इस्तेमाल Edge माइक्रोगेटवे करता है. इसका इस्तेमाल, Apigee Edge पर एसिंक्रोनस तरीके से Analytics डेटा पोस्ट करते समय खुद की पुष्टि करने के लिए किया जाता है.

इस्तेमाल किए जाने से जुड़ी जानकारी

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

पैरामीटर

पैरामीटर ब्यौरा
-o, --org वह Apigee संगठन जिसके लिए आपने Edge माइक्रोगेटवे को कॉन्फ़िगर किया है.
-e, --env वह एनवायरमेंट जिसके लिए आपने Edge माइक्रोगेटवे को कॉन्फ़िगर किया है.
-u, --username आपका Apigee उपयोगकर्ता नाम. आपको खास संगठन के लिए संगठन का एडमिन होना चाहिए.
-p, --password (ज़रूरी नहीं) आपका पासवर्ड. अगर कमांड लाइन पर यह पैरामीटर नहीं दिया जाता है, तो आपको कहा जाएगा.
-h, --help आउटपुट के इस्तेमाल की जानकारी.

ट्रैक के इस्तेमाल से जुड़ी जानकारी

सफल होने पर, निर्देश तीन आइटम लौटाता है. पहला वाला यूआरएल है, जिसे आपको कॉन्फ़िगरेशन फ़ाइल में रखना होगा. अन्य दोनों कुंजी के जोड़े हैं, जिनकी ज़रूरत एज माइक्रोगेटवे इंस्टेंस को शुरू करने के दौरान होती है.

  • बूटस्ट्रैप यूआरएल: यह यूआरएल, Apigee Edge की सेवा पर ले जाता है. इसकी मदद से, Apigee Edge को Analytics का डेटा भेजने के लिए, Edge माइक्रोगेटवे इंस्टेंस चालू होता है. आपको उस यूआरएल को Edge माइक्रोगेटवे कॉन्फ़िगरेशन फ़ाइल में कॉपी करना होगा: ~/.edgemicro/org-env-config.yaml.
  • key: कुंजी. यह कुंजी और सीक्रेट की ज़रूरत, एज माइक्रोगेटवे के इंस्टेंस को शुरू करने वाले सीएलआई कमांड में इनपुट के तौर पर होती है.
  • गुप्त: राज़.

उदाहरण

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

 

Apigee Edge के प्राइवेट क्लाउड के लिए, Edge माइक्रोगेटवे को कॉन्फ़िगर करना

यह नीति Apigee Edge के प्राइवेट क्लाउड इंस्टॉलेशन के साथ काम करने के लिए, Edge माइक्रोगेट को कॉन्फ़िगर करती है.

इस्तेमाल किए जाने से जुड़ी जानकारी

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

पैरामीटर

पैरामीटर ब्यौरा
-o, --org वह Apigee संगठन जिसके लिए आपने Edge माइक्रोगेटवे को कॉन्फ़िगर किया है.
-e, --env वह एनवायरमेंट जिसके लिए आपने Edge माइक्रोगेटवे को कॉन्फ़िगर किया है.
-u, --username आपका Apigee उपयोगकर्ता नाम. आपको खास संगठन के लिए संगठन का एडमिन होना चाहिए.
-p, --password (ज़रूरी नहीं) आपका पासवर्ड. अगर कमांड लाइन पर यह पैरामीटर नहीं दिया जाता है, तो आपको कहा जाएगा.
-r, --runtime-url यह आपके निजी क्लाउड इंस्टेंस के लिए रनटाइम यूआरएल की जानकारी देता है.
-m, --mgmt-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 माइक्रोगेटवे को शुरू करने पर होती है.

...

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

edgemicro configuration complete!

 

एज माइक्रोगेटवे शुरू किया जा रहा है

Edge माइक्रोगेटवे को शुरू करने से पहले, आपको edgemicro कॉन्फ़िगर (पब्लिक क्लाउड) या edgemicro निजी कॉन्फ़िगर (प्राइवेट क्लाउड) सबसे पहले चलाना होगा. कॉन्फ़िगर करने वाला निर्देश, Edge माइक्रोगेटवे को शुरू करने के लिए ज़रूरी कुंजी और सीक्रेट वैल्यू दिखाता है.

इस्तेमाल किए जाने से जुड़ी जानकारी

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

पैरामीटर

पैरामीटर ब्यौरा
-o, --org वह Apigee संगठन जिसके लिए आपने Edge माइक्रोगेटवे को कॉन्फ़िगर किया है.
-e, --env वह एनवायरमेंट जिसके लिए आपने Edge माइक्रोगेटवे को कॉन्फ़िगर किया है.
-k, --key कुंजी के लिए वह वैल्यू दिखती है जो "edgemicro configure" निर्देश को चलाने पर दिखती है.
-s, --secret सीक्रेट वैल्यू दिखती है, जो "edgemicro configure" कमांड को चलाने पर मिलती है.
-p, --processes (ज़रूरी नहीं) शुरू की जाने वाली प्रोसेस की संख्या. डिफ़ॉल्ट: आपके सिस्टम में मौजूद कोर की संख्या.
-d, --pluginDir (ज़रूरी नहीं) प्लगिन डायरेक्ट्री का ऐब्सलूट पाथ.
-r, --port (ज़रूरी नहीं) ~/.edgemicro/org-env-config.yaml फ़ाइल में दिए गए पोर्ट नंबर को बदल देता है. डिफ़ॉल्ट: 8000
-c, --cluster

(ज़रूरी नहीं) क्लस्टर मोड में Edge माइक्रोगेटवे को चालू करता है.

ध्यान दें: वर्शन 2.3.1 के बाद से, यह विकल्प हटा दिया गया है. v2.3.1 और इसके बाद के वर्शन में, Edge माइक्रो हमेशा क्लस्टर मोड में शुरू होता है.

-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 माइक्रोगेटवे एक गड़बड़ी दिखाता है.

क्लस्टरिंग के बारे में जानकारी

एज माइक्रोगेटवे, क्लस्टरिंग को चालू करने के लिए Node.js क्लस्टर मॉड्यूल का इस्तेमाल करता है. क्लस्टरिंग की मदद से Edge माइक्रोगेटवे को मल्टी-कोर सिस्टम का फ़ायदा मिलता है. ज़्यादा जानकारी के लिए, यह 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 ऐक्सेस टोकन पाए जा सकते हैं, उन्हें डिकोड किया जा सकता है, और उनकी पुष्टि की जा सकती है. 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: '' }

टोकन जनरेट करना

साइन किया हुआ बेयरर टोकन जनरेट करता है. इस टोकन की मदद से क्लाइंट ऐप्लिकेशन, Edge Microgateway पर पुष्टि किए गए एपीआई कॉल कर सकते हैं. यह टोकन, OAuth 2.0 का पालन करने वाला JSON Web Token (JWT) है. इसे Apigee Edge पर रजिस्टर किए गए डेवलपर ऐप्लिकेशन से उपभोक्ता कुंजी (क्लाइंट आईडी) और उपभोक्ता सीक्रेट (क्लाइंट सीक्रेट) की वैल्यू इनपुट करने की ज़रूरत होती है. OAuth2 ऐक्सेस टोकन की मदद से सुरक्षित एपीआई कॉल भी देखें.

इस्तेमाल किए जाने से जुड़ी जानकारी

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

पैरामीटर

पैरामीटर ब्यौरा
-o, --org वह Apigee संगठन जिसके लिए आपने Edge माइक्रोगेटवे को कॉन्फ़िगर किया है.
-e, --env वह एनवायरमेंट जिसके लिए आपने Edge माइक्रोगेटवे को कॉन्फ़िगर किया है.
-1, --key डेवलपर ऐप्लिकेशन का क्लाइंट आईडी, जो आपके माइक्रोगेटवे-अवेयर प्रॉक्सी से जुड़ा होता है.
-s, --secret आपके माइक्रोगेटवे-अवेयर प्रॉक्सी से जुड़े डेवलपर ऐप्लिकेशन का क्लाइंट सीक्रेट.
-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' }

टोकन पाने के लिए एचटीटीपी अनुरोध करना

टोकन पाने के लिए, एक रॉ एचटीटीपी अनुरोध भी किया जा सकता है. यहां कर्ल का एक उदाहरण दिया गया है. यूआरएल में अपने संगठन और एनवायरमेंट के नामों की जगह डालें. इसके बाद, 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 माइक्रोगेटवे को कॉन्फ़िगर किया है.
-e, --env वह एनवायरमेंट जिसके लिए आपने Edge माइक्रोगेटवे को कॉन्फ़िगर किया है.
-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) }

सीधे बेयरर टोकन पाना

Apigee Edge पर, टोकन एंडपॉइंट पर एचटीटीपी अनुरोध करके, सीधे बेयरर टोकन पाए जा सकते हैं. असल टोकन एंडपॉइंट, प्रॉक्सी में लागू किया जाता है जिसे डिप्लॉय-एज-सर्विस सीएलआई कमांड के साथ डिप्लॉय किया जाता है.

यहां कर्ल का एक उदाहरण दिया गया है. यूआरएल में अपने संगठन और पर्यावरण के नाम बदलें. इसके बाद, 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 माइक्रोगेटवे को इंस्टॉल करने के बाद, इस निर्देश को एक बार चलाएं. नई डिफ़ॉल्ट कॉन्फ़िगरेशन फ़ाइल बनाता है: ~/.edgemicro/default.yaml.

इस्तेमाल किए जाने से जुड़ी जानकारी

edgemicro init 

पैरामीटर

पैरामीटर ब्यौरा
-h, --help आउटपुट के इस्तेमाल की जानकारी.

उदाहरण

edgemicro init

आउटपुट (सफल)

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

Edge माइक्रोगेटवे कॉन्फ़िगरेशन की पुष्टि की जा रही है

यह पुष्टि करता है कि EDGE माइक्रोगेटवे को सही तरीके से कॉन्फ़िगर किया गया है.

इस्तेमाल किए जाने से जुड़ी जानकारी

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

पैरामीटर

पैरामीटर ब्यौरा
-o, --org वह Apigee संगठन जिसके लिए आपने Edge माइक्रोगेटवे को कॉन्फ़िगर किया है.
-e, --env वह एनवायरमेंट जिसके लिए आपने Edge माइक्रोगेटवे को कॉन्फ़िगर किया है.
-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-बीटा

डिफ़ॉल्ट रूप से, Edge माइक्रोगेटवे क्लस्टर मोड में शुरू होता है. क्लस्टर की स्थिति देखने के लिए, इस निर्देश का इस्तेमाल किया जा सकता है.

इस्तेमाल किए जाने से जुड़ी जानकारी

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-बीटा

एज माइक्रोगेटवे क्लस्टर को रोकता है.

इस्तेमाल किए जाने से जुड़ी जानकारी

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-बीटा

कॉन्फ़िगरेशन में बदलाव के बाद, ज़ीरो-डाउनटाइम रीस्टार्ट करने की सुविधा देता है. नए कॉन्फ़िगरेशन को दबाकर, Edge माइक्रोगेटवे को फिर से लोड करता है.

इस्तेमाल किए जाने से जुड़ी जानकारी

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

पैरामीटर

>
पैरामीटर ब्यौरा
-o, --org वह Apigee संगठन जिसके लिए आपने Edge माइक्रोगेटवे को कॉन्फ़िगर किया है.
-e, --env वह एनवायरमेंट जिसके लिए आपने Edge माइक्रोगेटवे को कॉन्फ़िगर किया है.
-k, --key कुंजी के लिए वह वैल्यू दिखती है जो "edgemicro configure" निर्देश को चलाने पर दिखती है.
-s, --secret सीक्रेट वैल्यू दिखती है, जो "edgemicro configure" कमांड को चलाने पर मिलती है.
-h, --help आउटपुट के इस्तेमाल की जानकारी.

उदाहरण

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

आउटपुट (सफल)

...

Reload Completed Successfully