Edge माइक्रोगेटवे को सेट अप और कॉन्फ़िगर करना

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

Edge Microgateway v. 2.5.x

खास जानकारी

इस सेटअप गाइड में दिए गए चरणों को पूरा करने के बाद, आपके पास पूरी तरह से कॉन्फ़िगर किया गया, काम करने वाला Edge Microgateway इंस्टॉलेशन होगा. यह एपीआई अनुरोधों को प्रोसेस कर सकेगा. सेटअप की जांच करने के लिए, Edge Microgateway के ज़रिए बैकएंड टारगेट को सुरक्षित एपीआई कॉल किए जाएंगे. आपको यह भी पता चलेगा कि Microgateway में स्पाइक अरेस्ट प्लगिन कैसे जोड़ा जाता है.

इस गाइड को इन हिस्सों में बांटा गया है:

ज़रूरी शर्त: Edge Microgateway इंस्टॉल करना

Edge Microgateway इंस्टॉल करना में दिए गए निर्देशों का पालन करें. इंस्टॉल करने के बाद, इस ट्यूटोरियल में दिए गए चरणों को पूरा किया जा सकेगा.

पहला हिस्सा: Edge Microgateway को कॉन्फ़िगर करना

इस हिस्से में, कमांड-लाइन इंटरफ़ेस (सीएलआई) कमांड का इस्तेमाल करके, Edge Microgateway को Apigee Edge के साथ कम्यूनिकेट करने के लिए कॉन्फ़िगर किया जाएगा.

Apigee Edge Cloud को कॉन्फ़िगर करने का तरीका

Apigee Edge Cloud के साथ Edge Microgateway का इस्तेमाल करने के लिए, यह तरीका अपनाएं:

  1. Edge Microgateway को शुरू करें (आपको यह चरण सिर्फ़ एक बार करना होगा):
    edgemicro init
  2. default.yaml नाम की कॉन्फ़िगरेशन फ़ाइल को आपकी होम डायरेक्ट्री में, .edgemicro नाम की सबडायरेक्ट्री में रखा गया था. अभी जांच करें कि यह फ़ाइल मौजूद है या नहीं: 
    ls ~/.edgemicro
default.yaml

    ध्यान दें: Edge Microgateway के दस्तावेज़ों में, हम होम डायरेक्ट्री के लिए टिल्ड (~) का इस्तेमाल करते हैं. यह UNIX का शॉर्टकट है. अगर Windows का इस्तेमाल किया जा रहा है और ऐसी शेल का इस्तेमाल किया जा रहा है जो टिल्ड का इस्तेमाल नहीं करती है, तो आपको उन कमांड में टिल्ड के लिए सही एनवायरमेंट वैरिएबल का इस्तेमाल करना होगा जो होम डायरेक्ट्री को रेफ़रंस करती हैं. उदाहरण के लिए: %USERPROFILE%/.edgemicro.

  3. सीएलआई के सभी निर्देशों में सहायता फ़ंक्शन होता है. edgemicro configure कमांड के लिए, प्रिंट करने से जुड़ी मदद:
    edgemicro configure -h
  4. Edge Microgateway को कॉन्फ़िगर करने के लिए, यह कमांड चलाएं:
    edgemicro configure -o [org] -e [env] -u [username]

    कहां:

    • org: आपके Edge संगठन का नाम (आपके पास संगठन के एडमिन की भूमिका होनी चाहिए).
    • env: आपके संगठन का कोई एनवायरमेंट (जैसे, टेस्ट या प्रॉड).
    • username: आपके Apigee खाते से जुड़ा ईमेल पता.

      ध्यान दें: कॉन्फ़िगर कमांड में अतिरिक्त पैरामीटर इस्तेमाल किए जा सकते हैं. पूरी सूची देखने के लिए, Apigee Edge Cloud के लिए Edge Microgateway को कॉन्फ़िगर करना लेख पढ़ें.

उदाहरण

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

आउटपुट

./edgemicro configure -o docs -e test -u jdoe@apigee.com
password:
current nodejs version is v6.9.1
current edgemicro version is 2.5.4
password:
file doesn't exist, setting up
Give me a minute or two... this can take a while...
App edgemicro-auth deployed.
checking org for existing KVM
error checking for cert. Installing new cert.
creating KVM
adding private_key
adding public_key
configuring host edgemicroservices-us-east-1.apigee.net for region us-east-1

saving configuration information to: $HOME/.edgemicro/docs-test-config.yaml

vault info:
 -----BEGIN CERTIFICATE-----
MIICpDCCAYwCCQCQ2mJZJGbPPTANBgkqhkiG9w0BAQsFADAUMRIwEAYDVQQDEwls
b2NhbGhvc3QwHhcNMTcwOTA3MjA0ODA4WhcNMTcwOTA4MjA0ODA4WjAUMRIwEAYD
VQQDEwlsb2NhbGhvc3QwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQDw
yzmqi5CelqqtTr6IaFe1ssrMXEDnNtkBh95U6F5zHLsNQhJcyNUAO9um6FLMSqSd
fTztXfWUZzDgmbb6sfbx/9cqpvQ8TIjxyIz8xGM9H4legRQmsCQoYGkLjpPE5ZOa
wZrI5IaVm8LY6vbopPFwxgKOQ9bphx6k9Na055DmNyZAOTMD+4I0m/RdsrnZnYih
3DaFj1tXHKZI1jfAt/QOif5Nmk4+JckYwF+9HBysWUbbvj/gnBjVYF2Isb7q7oFD
lPGhwFoIebMqHMWD8lG7+9RJDO9dDV6f1g1/9waIrq1D+MoVXos9VMstNrPp0cKF
Ue+lAkct8tylH+2MosF7AgMBAAEwDQYJKoZIhvcNAQELBQADggEBAJMRdcQh3ayy
csVVT4TYwxV7MKWRfhDRz6X+MM9frB+Z7sI4+ZoZbXKOoZI2hSjmbdLpkNR/m9eJ
+1Uk0JKmpSY7Q+1rRrvcHsWNysGf4z+zDJXYECTrtSnXKBXtb9SJ8JAfoZOQD0lA
zmKuJjQMLTdiYMHOBR6ZWnaKaRvrQwGHcQrheJm4a90XgZF6jcRR8CPrBzkmsbCp
IU/Ux3E17wDGYPxjJs5otyQG8rN/88RGyaSeXK8rjKr9D4KFGJeasXBKmTG2afAr
yfBvS4h6s42FCOR/eLpmMllVoO9up71Fa3EtV+aK+FNNY9uMbgUHeLQE7z9nn06q
PTmvExZLkLQ=
-----END CERTIFICATE-----

The following credentials are required to start edge micro
  key: 27ee39567c75e4567a66236cbd4e86d1cc93df6481454301bd5fac4d3497fcbb
  secret: 4618b0008a6185d7327ebf53bee3c50282ccf45a3cceb1ed9828bfbcf1148b47

Apigee Private Cloud को कॉन्फ़िगर करने का तरीका

Apigee Private Cloud के साथ Edge Microgateway का इस्तेमाल करने के लिए, यह तरीका अपनाएं:

  1. Edge Microgateway को शुरू करें (आपको यह चरण सिर्फ़ एक बार करना होगा):
    edgemicro init
  2. edgemicro private configure कमांड के लिए, मदद से जुड़ी जानकारी प्रिंट करें. इस तरीके से, Edge Microgateway CLI की किसी भी कमांड या कमांड के विकल्प के लिए मदद प्रिंट की जा सकती है. 
    edgemicro private configure -h
  3. यह कमांड चलाएं. इसके लिए, आपके Apigee Edge Private Cloud खाते के बारे में सामान्य जानकारी की ज़रूरत होती है: संगठन का नाम, एनवायरमेंट का नाम, उपयोगकर्ता नाम (ईमेल पता), पासवर्ड, मैनेजमेंट सर्वर का आईपी पता, और राउटर का आईपी पता. इस कमांड का इस्तेमाल करने के लिए, आपके पास Edge संगठन के एडमिन का ऐक्सेस होना चाहिए: 
    edgemicro private configure -o [org] -e [env] -u [username] -r [runtime_url] -m [mgmt_url] -v [virtual_host]

    कहां:

    • org आपके Edge संगठन का नाम है. आपके पास संगठन के एडमिन की भूमिका होनी चाहिए.
    • env आपके संगठन का एनवायरमेंट है. जैसे, टेस्ट या प्रॉड.
    • runtime_url आपके प्राइवेट क्लाउड इंस्टेंस का रनटाइम यूआरएल है.
    • mgmt_url आपके प्राइवेट क्लाउड इंस्टेंस के मैनेजमेंट सर्वर का यूआरएल है.
    • username आपके Apigee खाते से जुड़ा ईमेल पता है.
    • virtual_host, वर्चुअल होस्ट के नामों की कॉमा लगाकर अलग की गई सूची है. डिफ़ॉल्ट वैल्यू ये हैं default,secure

उदाहरण

edgemicro private configure -o docs -e test -u jdoe@example.com -r http://192.162.52.106:9001 -m http://192.162.52.106:8080 -v default

इसके अलावा, अगर आपके पास myorg-test.mycompany.com का वर्चुअल होस्ट एलियास है, तो आपको इस तरह के कमांड का इस्तेमाल करना होगा:

edgemicro private configure -o docs -e test -u jdoe@example.com -r myorg-test.mycompany.com -m http://192.162.52.106:8080 -v default

आउटपुट

delete cache config
checking for previously deployed proxies
configuring edgemicro internal proxy
deploying edgemicro internal proxy
deploying  edgemicro-auth  app
copy auth app into tmp dir
copy config into tmp deer
Give me a minute or two... this can take a while...
App edgemicro-auth added to your org. Now adding resources.

checking org for existing KVM
error checking for cert. Installing new cert.
creating KVM
adding private_key
adding public_key
configuring host http://192.168.52.106:9001 for region dc-1

saving configuration information to: $HOME/.edgemicro/jdoe-test-config.yaml
vault info: 
-----BEGIN CERTIFICATE----- 
MIICpDCCAYwCCQDpIvWlpaZJGDANBgkqhkiG9w0BAQFADAUMRIwEAYDVQQDEwls 
b2NhbGhvc3QwHhcNMTYwNDA3MTcxNTM5WhcNMTYwND4MTcxNTM5WjAUMRIwEAYD 
VQQDEwlsb2NhbGhvc3QwggEiMA0GCSqGSIb3DQEBAUAA4IBDwAwggEKAoIBAQD3 
OAQ+kf5FH0S0yuj05ITqUODuUJspBPberRMbqOZYHcFswhB0Yvg6JKWsKWBDP9o
Xl96dtgH7xPFRqIU0zI452jkMQ1fPz2mSaGwik245yfBku7olooXKRKTRKOUoXa 
q3Hld/RPxGSsWtiyyYtKex7tuFdq0Knm1EhowdTRGIgjNvudeYMka/XPRXuykhd 
xIDxWj4rdX+4GPx9qT2eTQC5nOAC7XHVL7ys4KqsAiv28vw10u400KstFFS8Qho 
7FaE0bOKLolKKadKyA60ha1XIw/uSTD6ZQFWQ+XM3OaRbXePWXnSZioSxXcZT7L 
hMUKbsRXw/TCvRB51LgNAgMBAAEwDQYJKoZIhvcNAQELBQADgEBAOuR1OmE/W6j 
gRAarJB5EQuTEpI/9Zpg5c5RAGjzLhkazsycn7pal+IymUjCV7D0oIxTVuTM8ZZ 
57kR5hF/C1ZypDN9i+KGP2ovX8WOCCXYtIQECgZPB/L/7/k7BDuKN4vFBvWUe3X 
s2oyjnVWy+ASqsW8gHfj8ekhe22bP240Oqkbyg9SZP9ol1tvJX6+M0thYwcTwAd 
ft929Icey/MOTQC0jB2qm0gnIx/7KInFXfS5KoFRJoGrWDeckr3RdBo2LhnPaeZ 
1gPYIqphZ3HfisF5KlBXoR8oT/Ilym/nq5COlv+3L4tMIk18F7BQZB60SRazifz 
pFkIxepyr/0= 
-----END CERTIFICATE----- 

The following credentials are required to start edge micro 
   key: a3f8f3dfe39158fc3c50b274f0af2234246e0d5f6ea4ad09389b645147151ba3
   secret: 3e9904802fb3c0e8ca408128a11119cf13546d54dac10ace944c097a726a1263

edgemicro configuration complete!

इंस्टॉलेशन की पुष्टि करना

इंस्टॉल करने की पुष्टि करने के लिए, यह निर्देश चलाएं. अगर कोई गड़बड़ी नहीं दिखती है, तो इसका मतलब है कि सब कुछ सही तरीके से सेट अप किया गया है. इसके बाद, Edge Microgateway को आसानी से शुरू किया जा सकेगा. 

edgemicro verify -o [org] -e [env] -k [key] -s [secret]

कहां:

  • org आपके Edge संगठन का नाम है. आपके पास संगठन के एडमिन की भूमिका होनी चाहिए.
  • env आपके संगठन का एनवायरमेंट है. जैसे, टेस्ट या प्रॉड.
  • key वह कुंजी है जो कॉन्फ़िगर करें कमांड से पहले वापस की गई थी.
  • secret वह कुंजी है जो कॉन्फ़िगर करें कमांड से पहले वापस की गई थी.

उदाहरण

edgemicro verify -o docs -e test -k 93b01fd21d86331459ae52f624ae9aeb13eb94767ce40a4f621d172cdfb7e8e6 -s c8c755be97cf56c21f8b0156d7132afbd03625bbd85dc34ebfefae4f23fbcb3c

कॉन्फ़िगरेशन के बारे में जानकारी

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

इस कॉन्फ़िगरेशन की जानकारी का इस्तेमाल किस लिए किया जाता है? इस ट्यूटोरियल के अगले हिस्से में हम जानेंगे कि Edge Microgateway शुरू होने पर, इसे Apigee Edge से Edge Microgateway के साथ काम करने वाली API प्रॉक्सी की सूची मिलती है. इस ट्यूटोरियल के अगले हिस्से में, आपको Microgateway-aware प्रॉक्सी बनानी होगी. Edge Microgateway, क्लाइंट को सिर्फ़ उन एपीआई को कॉल करने की अनुमति देता है जो Microgateway-aware API प्रॉक्सी के ज़रिए फ़्रंट किए जाते हैं. साथ ही, क्लाइंट को हर कॉल के लिए मान्य सुरक्षा टोकन देना होगा. यह डिफ़ॉल्ट रूप से ज़रूरी है. इन प्रॉक्सी के बारे में ज़्यादा जानने के लिए, Edge Microgateway की खास जानकारी में "Edge Microgateway के साथ काम करने वाली प्रॉक्सी के बारे में ज़रूरी जानकारी" लेख पढ़ें.

Edge संगठन के एडमिन के तौर पर, आपको यह जानकर खुशी होगी कि Edge Microgateway-aware प्रॉक्सी को Edge प्रॉडक्ट में जोड़ा जा सकता है. ठीक उसी तरह जैसे किसी अन्य प्रॉक्सी को जोड़ा जाता है. प्रॉडक्ट और डेवलपर ऐप्लिकेशन का इस्तेमाल करके, क्लाइंट के लिए सुरक्षा टोकन जनरेट किए जा सकते हैं. इससे Edge Microgateway के ज़रिए कॉल किए गए एपीआई के ऐक्सेस को कंट्रोल किया जा सकता है. Apigee Edge पर किसी भी एपीआई प्रॉक्सी, प्रॉडक्ट, और डेवलपर ऐप्लिकेशन के साथ काम करने के लिए, एक जैसे पैटर्न का इस्तेमाल किया जाता है. अगर आपको प्रॉडक्ट के बारे में पढ़ना है, तो Edge के दस्तावेज़ में मौजूद एपीआई प्रॉडक्ट क्या होता है? लेख से शुरुआत करें.

इसके बाद, हम Edge Microgateway के बारे में जानने वाली प्रॉक्सी बनाने का तरीका जानेंगे. इसके बाद, हम Edge Microgateway शुरू करेंगे और सेटअप की जांच करेंगे.

दूसरा भाग: Apigee Edge पर इकाइयां बनाना

इस हिस्से में, Edge पर ये इकाइयां बनाई जाएंगी:

  • माइक्रोगेटवे के बारे में जानकारी रखने वाली प्रॉक्सी - यह एक खास प्रॉक्सी होती है. Edge Microgateway इसे स्टार्टअप के दौरान ढूंढ सकता है. माइक्रोगेटवे के साथ काम करने वाली प्रॉक्सी के नाम रखने का एक तरीका है. आपको इसका पालन करना होगा: नाम की शुरुआत edgemicro_ से होनी चाहिए. उदाहरण के लिए, edgemicro_hello या edgemicro_userinfo. Edge Microgateway शुरू होने पर, यह Edge से उन प्रॉक्सी की सूची को वापस पाता है जो Edge Microgateway के साथ काम करती हैं. ये प्रॉक्सी, उसी Edge संगठन और एनवायरमेंट की होती हैं जिन्हें आपने Edge Microgateway शुरू करते समय चुना था.

    माइक्रोगेटवे के बारे में जानकारी रखने वाली हर प्रॉक्सी के लिए, Edge Microgatway प्रॉक्सी का टारगेट यूआरएल और उसका बेस पाथ वापस पाता है. माइक्रोगेटवे के बारे में जानकारी रखने वाली प्रॉक्सी, Edge Microgateway से जनरेट किए गए आंकड़ों के डेटा को Edge प्लैटफ़ॉर्म पर मौजूद प्रॉक्सी से आसानी से जोड़ने का तरीका भी उपलब्ध कराती हैं. माइक्रोगेटवे, एपीआई कॉल को मैनेज करता है. इसलिए, यह Analytics के डेटा को Edge पर एसिंक्रोनस तरीके से भेजता है. Analytics का डेटा, Edge Analytics के यूज़र इंटरफ़ेस(यूआई) में, माइक्रोगेटवे के बारे में जानकारी रखने वाली प्रॉक्सी के नाम के नीचे दिखेगा. यह किसी अन्य प्रॉक्सी के लिए भी ऐसा ही होता है.
  • प्रॉडक्ट, डेवलपर, और डेवलपर ऐप्लिकेशन - Edge Microgateway, OAuth2 ऐक्सेस टोकन या एपीआई कुंजी की सुरक्षा को चालू करने के लिए, प्रॉडक्ट, डेवलपर, और डेवलपर ऐप्लिकेशन का इस्तेमाल करता है. Edge Microgateway शुरू होने पर, यह आपके Apigee Edge संगठन से सभी प्रॉडक्ट कॉन्फ़िगरेशन डाउनलोड करता है. यह इस जानकारी का इस्तेमाल, एपीआई पासकोड या OAuth2 ऐक्सेस टोकन की मदद से Edge Microgateway के ज़रिए किए गए एपीआई कॉल की पुष्टि करने के लिए करता है.

1. Edge पर Edge Microgateway के साथ काम करने वाली एपीआई प्रॉक्सी बनाना

  1. Apigee Edge पर अपने संगठन में लॉग इन करें.
  2. साइड नेविगेशन मेन्यू में, डेवलप > एपीआई प्रॉक्सी को चुनें.
  3. + प्रॉक्सी पर क्लिक करें. 'प्रॉक्सी बनाएं' विज़र्ड खुलता है.
  4. विज़र्ड के पहले पेज पर, रिवर्स प्रॉक्सी (सबसे आम) चुनें.
  5. आगे बढ़ें पर क्लिक करें.
  6. विज़र्ड के 'ज़्यादा जानकारी' पेज पर, इस तरह कॉन्फ़िगर करें. विज़र्ड में दी गई जानकारी को ठीक वैसे ही भरें जैसा दिखाया गया है:
    • प्रॉक्सी का नाम: edgemicro_hello
    • प्रॉक्सी का बेस पाथ: /hello
    • मौजूदा एपीआई: http://mocktarget.apigee.net/
  7. आगे बढ़ें पर क्लिक करें.
  8. विज़र्ड के सुरक्षा पेज पर, पास थ्रू (कोई नहीं) को चुनें.
  9. आगे बढ़ें पर क्लिक करें.
  10. विज़र्ड के वर्चुअल होस्ट पेज में, डिफ़ॉल्ट सेटिंग स्वीकार करें.
  11. आगे बढ़ें पर क्लिक करें.
  12. विज़र्ड के 'बनाएं' पेज पर, अपनी प्रॉक्सी सेटिंग की समीक्षा करें. पक्का करें कि टेस्ट एनवायरमेंट चुना गया हो.
  13. बनाएं और डिप्लॉय करें पर क्लिक करें.

2. प्रॉडक्ट बनाना

  1. साइड नेविगेशन मेन्यू में, पब्लिश करें > एपीआई प्रॉडक्ट चुनें.
  2. + एपीआई प्रॉडक्ट पर क्लिक करें. इसके बाद, आपको 'प्रॉडक्ट की जानकारी' पेज दिखेगा.
  3. प्रॉडक्ट की जानकारी वाले पेज पर यह जानकारी भरें:
    • नाम: EdgeMicroTestProduct
    • डिसप्ले नेम: EdgeMicroTestProduct
    • एनवायरमेंट: टेस्ट और प्रॉड
    • ऐक्सेस: सार्वजनिक
    • कुंजी के लिए अनुमति का टाइप: अपने-आप
  4. संसाधन में जाकर, +एपीआई प्रॉक्सी पर क्लिक करें
  5. edgemicro-auth चुनें
  6. फिर से +एपीआई प्रॉक्सी पर क्लिक करें.
  7. edgemicro_hello को चुनें
  8. + कस्टम संसाधन चुनें
  9. /** डालें
  10. + कस्टम रिसॉर्स को फिर से चुनें.
  11. / डालें
  12. सेव करें पर क्लिक करें.

3. (ज़रूरी नहीं) टेस्ट डेवलपर खाता बनाना

इस ट्यूटोरियल के लिए, अगले चरण में किसी मौजूदा डेवलपर का इस्तेमाल किया जा सकता है. इसके बाद, डेवलपर ऐप्लिकेशन बनाया जा सकता है. हालांकि, अगर आपको अभी टेस्ट डेवलपर बनाना है, तो यह तरीका अपनाएं:

  1. साइड नेविगेशन मेन्यू में, पब्लिश करें > डेवलपर को चुनें.
  2. + डेवलपर पर क्लिक करें.
  3. टेस्ट डेवलपर बनाने के लिए, डायलॉग बॉक्स में जानकारी भरें.

4. डेवलपर ऐप्लिकेशन बनाना

आपको इस ऐप्लिकेशन के क्लाइंट क्रेडेंशियल का इस्तेमाल करके, Edge Microgateway के ज़रिए सुरक्षित एपीआई कॉल करने हैं:

  1. साइड नेविगेशन मेन्यू में, पब्लिश करें > ऐप्लिकेशन को चुनें.
  2. + ऐप्लिकेशन पर क्लिक करें. इसके बाद, डेवलपर ऐप्लिकेशन की ज़्यादा जानकारी वाला पेज दिखेगा.
  3. डेवलपर ऐप्लिकेशन पेज पर यह जानकारी भरें:
    1. नाम: EdgeMicroTestApp
    2. डिसप्ले नेम: EdgeMicroTestApp
    3. डेवलपर: अगर आपने टेस्ट डेवलपर बनाया है, तो उसे चुनें. इसके अलावा, इस ट्यूटोरियल के लिए किसी मौजूदा डेवलपर का इस्तेमाल भी किया जा सकता है.
    4. क्रेडेंशियल:
      1. ऐक्सेस खत्म होने की तारीख: कभी नहीं चुनें.
      2. + प्रॉडक्ट पर क्लिक करें और EdgeMicroTestProduct चुनें (यह वही प्रॉडक्ट है जिसे आपने अभी बनाया है)
  4. सेव करें पर क्लिक करें.
  5. अब आपको ऐप्लिकेशन की सूची वाला पेज दिखेगा.
  6. आपने जो ऐप्लिकेशन बनाया है उसे चुनें. जैसे, EdgeMicroTestApp.
  7. उपयोगकर्ता कुंजी और उपयोगकर्ता सीक्रेट के बगल में मौजूद, दिखाएं पर क्लिक करें.

तीसरा हिस्सा: Edge Microgateway को ऑपरेट करना

अब आपके पास कॉन्फ़िगर किया गया Edge Microgateway और Edge पर कम से कम एक Edge Microgateway-aware प्रॉक्सी है. इसलिए, अब Edge Microgateway को चालू करने का समय आ गया है. Edge Microgateway का एचटीटीपी सर्वर, आपकी लोकल मशीन पर चलेगा. साथ ही, आपको सीधे तौर पर उस सर्वर पर एपीआई कॉल करने होंगे.

1. Edge Microgateway शुरू करना

Edge Microgateway शुरू करने के लिए, edgemicro start कमांड का इस्तेमाल करें.

  1. पक्का करें कि आपके पास वे कुंजियां हों जो edgemicro configure कमांड चलाने पर पहले वापस कर दी गई थीं. वह आउटपुट कुछ ऐसा दिखता था: 
    You need key and secret while starting edgemicro instance

key: da4778e7c240a5d4585fc559eaba5083328828bc9f3a7f583e8b73e
secret: 3aad7439708b4aeb38ee08e82189921ad00e6fc1ba8a8ae9f929ee2
  2. (ज़रूरी नहीं) edgemicro start कमांड के लिए सहायता जानकारी प्रिंट करें.
    edgemicro start -h
  3. Edge Microgateway शुरू करने के लिए, यह कमांड चलाएं: 
    edgemicro start -o [org] -e [env] -k [key] -s [secret]

    कहां:

    • org आपके Edge संगठन का नाम है. आपके पास संगठन के एडमिन की भूमिका होनी चाहिए.
    • env आपके संगठन का एनवायरमेंट है. जैसे, टेस्ट या प्रॉड.
    • key वह कुंजी है जो configure कमांड से पहले वापस मिली थी.
    • secret वह कुंजी है जो configure कमांड से पहले वापस मिली थी.

    उदाहरण

    edgemicro start -o docs -e test -k 701e70e718ce6dc1880616b3c39177d64a88754d615c7a4e1f78b6181d000723 -s 05c14356e42d136b83dd135cf8a18531ff52d7299134677e30ef4e34ab0cc824

    आउटपुट

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

    ...

current nodejs version is v6.9.1
current edgemicro version is 2.5.4
info: jwk_public_keys download from null returned 200 undefined
info: jwt_public_key download from https://docs-test.apigee.net/edgemicro-auth/publicKey returned 200 OK
info: products download from https://docs-test.apigee.net/edgemicro-auth/products returned 200 OK
info: config download from https://edgemicroservices-us-east-1.apigee.net/edgemicro/bootstrap/organization/docs/environment/test returned 200 OK
PROCESS PID : 17991
  4. माइक्रोगेटवे का स्टेटस देखें. किसी दूसरी टर्मिनल विंडो में, उस डायरेक्ट्री में जाएं जहां आपने Edge Micro शुरू किया था और यह कमांड डालें: 
    edgemicro status
current nodejs version is v6.9.1
current edgemicro version is 2.5.4
edgemicro is running with 8 workers

क्या हुआ?

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

  • यह वह सार्वजनिक कुंजी है जिसे हमने पहले बनाया था और एन्क्रिप्ट (सुरक्षित) किए गए Key Value Map (KVM) में सेव किया था.
  • संगठन/एनवायरमेंट में मौजूद, Edge Microgateway के साथ काम करने वाली सभी प्रॉक्सी का प्रतिनिधित्व करने वाला ऑब्जेक्ट. ये सभी ऐसी प्रॉक्सी हैं जिनके नाम में edgemicro_ प्रीफ़िक्स है.
  • संगठन/एनवायरमेंट में मौजूद सभी एपीआई प्रॉडक्ट का प्रतिनिधित्व करने वाला ऑब्जेक्ट.

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

2. Edge Microgateway की जांच करना

Edge Microgateway चालू होने पर, प्रॉक्सी को कॉल किया जा सकता है. Edge Microgateway शुरू करने पर, edgemicro_hello प्रॉक्सी के लिए कॉन्फ़िगरेशन, Edge से डाउनलोड किया गया था. याद रखें कि प्रॉक्सी बेसपाथ /hello है.

Edge Microgateway की जांच करने के लिए, हम बेस पाथ से शुरू करते हैं और उसमें संसाधन पाथ /echo जोड़ते हैं. ध्यान दें कि बेस पाथ के बाद की सभी चीज़ें (इसमें क्वेरी पैरामीटर भी शामिल हैं) सीधे तौर पर बैकएंड टारगेट को पास कर दी जाती हैं:

curl -i http://localhost:8000/hello/echo
{"error":"missing_authorization","error_description":"Missing Authorization header"}

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

4. Edge Microgateway को बंद करना

  1. एक अलग टर्मिनल विंडो में, cd करके उसी डायरेक्ट्री पर जाएं जहां आपने Edge Microgateway शुरू किया था.
  2. रोकने का निर्देश डालें:
    edgemicro stop

चौथा हिस्सा: सिक्योर एज माइक्रोगेटवे

एपीआई पासकोड या ऐक्सेस टोकन का इस्तेमाल करके, Edge Microgateway के ज़रिए किए गए एपीआई कॉल को सुरक्षित किया जा सकता है.

OAuth2 ऐक्सेस टोकन की मदद से सुरक्षित एपीआई कॉल करना

अगर आपको OAuth2 ऐक्सेस टोकन की मदद से, एपीआई कॉल की पुष्टि करनी है, तो यह तरीका अपनाएं:

1. ज़रूरी कुंजियां पाना

  1. Edge के यूज़र इंटरफ़ेस (यूआई) में, उस डेवलपर ऐप्लिकेशन पर जाएं जिसे आपने पहले बनाया था. ऐप्लिकेशन का नाम EdgeMicroTestApp था.
  2. Developer App पेज पर, Consumer Key और Consumer Secret दिखाएं और उन्हें कॉपी करें. अगले चरण में ऐक्सेस टोकन पाने के लिए, इन वैल्यू की ज़रूरत होती है.

2. ऐक्सेस टोकन पाना

ऐक्सेस टोकन पाने के दो तरीके हैं. हम आपको दोनों तरीके दिखाएंगे.

ऐक्सेस टोकन पाने के लिए, सीएलआई का इस्तेमाल करना

पहला तरीका आसान है. साथ ही, यह उस पैटर्न का पालन करता है जिसका इस्तेमाल हमने पूरे ट्यूटोरियल में किया है. दूसरा तरीका आम तौर पर उन क्लाइंट ऐप्लिकेशन डेवलपर के लिए ज़्यादा फ़ायदेमंद होता है जिन्हें टोकन का अनुरोध करना होता है. असल टोकन एंडपॉइंट, edgemicro-auth प्रॉक्सी में लागू किया जाता है. इसे Edge Microgateway को कॉन्फ़िगर करते समय डिप्लॉय किया गया था.

  1. (ज़रूरी नहीं) token get कमांड के लिए सहायता देखें: 
    edgemicro token get -h
  2. टोकन जनरेट करें. इसके लिए, Apigee Edge पर बनाए गए डेवलपर ऐप्लिकेशन से, -i और -s पैरामीटर में अपनी उपभोक्ता कुंजी और उपभोक्ता सीक्रेट वैल्यू डालें: 
    edgemicro token get -o [org] -e [env] -i [consumer_key] -s [consumer_secret]

    कहां:

    • org आपके Edge संगठन का नाम है. आपके पास संगठन के एडमिन की भूमिका होनी चाहिए.
    • env आपके संगठन का एनवायरमेंट है. जैसे, टेस्ट या प्रॉड.
    • consumer_id, डेवलपर ऐप्लिकेशन में मौजूद ग्राहक आईडी है. इसे आपने पहले बनाया था.
    • consumer_secret, डेवलपर ऐप्लिकेशन में मौजूद उपभोक्ता का सीक्रेट है. यह ऐप्लिकेशन आपने पहले बनाया था.

    उदाहरण

    edgemicro token get -o docs -e test -i G0IAeU864EtBo99NvUbn6Z4CBwVcS2 -s uzHTbwNWvoSmOy

    आउटपुट (नमूना)

    current nodejs version is v6.9.1
{ token: 'eyJ0eXAiOiJKV1QiLCJhbGciSUzI1NiJ9.eyJhcHBsaWNhdGl
vbl9uYW1lIjoiNWNiMGY0tOWMzOC00YmJjLWIzNzEtZGMxZTQzOGYxZGMxI
iwiY2xpZW50X2lkIjoiNVVdBWEdvSU9lbzYwYWV3OTRQN0c1TUFaRTNhSnA
iLCJzY29wZXMiOltdLCJhcGlfcHJvjdF9saXN0IjpbIsVkZ2VNaWNyb1Rlc
3RQcm9kdWN0IlmlhdCI6MTQ3ODIwODMzMiwiZXhwIjoxNDc4MjEwMTMxfQ.
v3Q8Rs0W9FO_XpERwIAMMXhjGamRmmmWgrAy1wJv0-99oajx5ASI5qjNubM
nCF14xxwlVXHcz1VfedA8Nx7Ih145zhWWuPKL9muzhXXnVBRFeBMeeLqJk4
QQ7Bhst7xH_68nJSTE20Egu95DHOCUemfrepDFH0VggY4BmzvwLkBNfz_te
E_YqwKZbpGOLMdKK1vMk0fk0x19SieIMS_aJYeOAklrzUhnFxWJFrsAWsax
NLx_BbQcZzYfK1JSDUrhRNVBuPHMnGjNA_oHw2J4qa6Hsp62PfchG-DIW_t
-0BFnYf3rYXmqyNORqFrOMdl4VxqQ' }

(ज़रूरी नहीं) टोकन पाने के लिए एपीआई का इस्तेमाल करना

अगर आपको curl या किसी अन्य एचटीटीपी क्लाइंट का इस्तेमाल करके Edge प्रॉक्सी को कॉल करने की आदत है, तो आपको यह जानकर खुशी होगी कि edgemicro token कमांड का इस्तेमाल करने के बजाय, सीधे टोकन एंडपॉइंट को कॉल किया जा सकता है. यहां curl का एक उदाहरण दिया गया है. यूआरएल में अपने संगठन और एनवायरमेंट के नाम बदलें. इसके बाद, बेसिक ऑथेंटिकेशन हेडर में कोलन से अलग की गई Consumer Key:Consumer Secret वैल्यू पास करें:

curl -i -X POST "http://[org]-[env].apigee.net/edgemicro-auth/token" -d '{ "client_id": "your consumer key", "client_secret": "your consumer secret", "grant_type": "client_credentials" }' -H "Content-Type: application/json"

कहां:

  • org आपके Edge संगठन का नाम है. आपके पास संगठन के एडमिन की भूमिका होनी चाहिए.
  • env आपके संगठन का एनवायरमेंट है. जैसे, टेस्ट या प्रॉड.
  • client_id, आपके बनाए गए डेवलपर ऐप्लिकेशन में ग्राहक आईडी है.
  • client_secret, डेवलपर ऐप्लिकेशन में मौजूद उपभोक्ता सीक्रेट है. इसे आपने पहले बनाया था.

आउटपुट (सैंपल)

edgemicro token सीएलआई कमांड का इस्तेमाल करने या कर्ल का इस्तेमाल करके एंडपॉइंट को कॉल करने पर, एक हस्ताक्षर किया गया ऐक्सेस टोकन मिलता है. इसका इस्तेमाल क्लाइंट कॉल करने के लिए किया जा सकता है. कुछ इस तरह:

MIICpDCCAYwCCQDpIvWlpaZJGDANBgkqhkiG9w0BAQFADAUMRIwEAYDVQQDEwls 
b2NhbGhvc3QwHhcNMTYwNDA3MTcxNTM5WhcNMTYwND4MTcxNTM5WjAUMRIwEAYD 
VQQDEwlsb2NhbGhvc3QwggEiMA0GCSqGSIb3DQEBAUAA4IBDwAwggEKAoIBAQD3 
OAQ+kf5FH0S0yuj05ITqUODuUJspBPberRMbqOZYHcFsnhB0Yvg6JKWxKWBDP9o
Xl96dtgH7xPFRqIU0zI452jkMQ1fPz2mSaGwik241yfBku7olooXKRKTRKOUoXa
q3Hld/RPxGSsWtiyyYtKex7tuFdq0Knm1EhowdTRGIgjNvudeYMka/XPRXuykhd 
xIDxWj4rdX+4GPx9qT2eTQC5nOAC7XHVL7ys4KqsAiv28vw10u400KstFFS8Qho 
7FaE0bOKLolKKadKyA60ha1XIw/uSTD6ZQFWQ+XM3OaRbXePWXnSZioSxXcZT7L 
hMUKbsRXw/TCvRB51LgNAgMBAAEwDQYJKoZIhvcNAQELBQADgEBAOuR1OmE/W6j 
gRAarJB5EQuTEpI/9Zpg5c5RAGjzLhkazsycn7pal+IymUjCV7D0oIxTVuTM8ZZ 
57kR5hF/C1ZypDN9i+KGP2ovX8WOCCXYtIQECgZPB/L/7/k7BDuKN4vFBvWUe3X 
s2oyjnVWy+ASqsW8gHfj8ekhe22bP240Oqkbyg9SZP9ol1tvJX6+M0thYwcTwAd 
ft929Icey/MOTQC0jB2qm0gnIx/7KInFXfS5KoFRJoGrWDeckr3RdBo2LhnPaeZ 
1gPYIqphZ3HfisF5KlBXoR8oT/Ilym/nq5COlv+3L4tMIk18F7BQZB60SRazifz 
pFkIxepyr/0=

3. Edge Microgateway में कॉन्फ़िगरेशन की जांच करना

  1. अगर आपको यह फ़ाइल नहीं मिल रही है, तो $HOME/.edgemicro/org-env-config.yaml. Edge Microgateway कहां इंस्टॉल किया गया है फ़ाइल खोलें.
  2. पक्का करें कि OAuth प्लगिन की ये प्रॉपर्टी false पर सेट हों. ये डिफ़ॉल्ट रूप से गलत होते हैं, लेकिन इनकी दोबारा जांच करना बेहतर होता है: 
    oauth:
   allowNoAuthorization: false
   allowInvalidAuthorization: false
  3. साथ ही, org-env-config.yaml फ़ाइल में यह भी पक्का करें कि oauth प्लगिन को plugins:sequence एलिमेंट में जोड़ा गया हो. जैसे:: 
    plugins:
   dir: ../plugins
   sequence:
   - oauth
  4. अगर आपने फ़ाइल में कोई बदलाव किया है, तो चालू Edge Microgateway इंस्टेंस में बदलावों को फिर से लोड करें. इस कमांड से, Edge Microgateway को बिना किसी रुकावट के फिर से कॉन्फ़िगर किया जाता है: 
    edgemicro reload -o [org] -e [env] -k [key] -s [secret]

    कहां:

    • org आपके Edge संगठन का नाम है. आपके पास संगठन के एडमिन की भूमिका होनी चाहिए.
    • env आपके संगठन का एनवायरमेंट है. जैसे, टेस्ट या प्रॉड.
    • key वह कुंजी है जो configure कमांड से पहले वापस मिली थी.
    • secret वह कुंजी है जो configure कमांड से पहले वापस मिली थी.

    उदाहरण

    edgemicro reload -o docs -e test -k 701e70ee718ce6dc188016b3c39177d64a88754d615c74e1f78b6181d

4. एपीआई को सुरक्षित तरीके से कॉल करना

ऐक्सेस टोकन मिलने के बाद, अब एपीआई कॉल को सुरक्षित तरीके से किया जा सकता है. उदाहरण के लिए:

  curl -i -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhcHBsaWNhdGlvbl
9uYW1lIjoiYmU2YmZjYjAtMWQ0Ni00Y2IxLWFiNGQtZTMxNzRlNTAyMDZkIiwiY2xpZW50X2lkIjoiOGxTTTVIRHdyM
VhIT1ZwbmhURExhYW9FVG5STVpwWk0iLCJzY29wZXMiOltdLCJhcGlfcHJvZHVjdF9saXN0IjpbIk1pY3JvZ2F0ZXdh
eVRlQcm9kdWN0Il0sImCI6MTQzNTM0NzY5MiwiZXhwIjoxNDM1MzQ5NDkxfQ.PL30Y6uK1W1f2ONPEsBDB_BT31c6
IsjWGfwpz-p6Vak8r767tAT4mQAjuBpQYv7_IU4DxSrnxXQ_q536QYCP4p4YKfBvyqbnW0Rb2CsPFziy_n8HIczsWO
s0p4czcK63SjONaUpxV9DbfGVJ_-WrSdqrqJB5syorD2YYJPSfrCcgKm-LpJc6HCylElFDW8dHuwApaWcGRSV3l5Wx
4A8Rr-WhTIxDTX7TxkrfI4THgXAo37p3au3_7DPB_Gla5dWTzV4j93xLbXPUbwTHzpaUCFzmPnVuYM44FW5KgvBrV0
64RgPmIFUxSqBWGQU7Z1w2qFmWuaDljrMDoLEreI2g" http://localhost:8000/hello/echo

एपीआई, मॉक सर्वर से हेडर और अन्य जानकारी दिखाता है.

एपीआई पासकोड की मदद से एपीआई को सुरक्षित करना

अगर आपको पुष्टि करने के लिए एपीआई पासकोड का इस्तेमाल करना है, तो यह तरीका अपनाएं:

1. एपीआई पासकोड पाना

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

2. Edge Microgateway में कॉन्फ़िगरेशन की जांच करना

  1. फ़ाइल खोलें $HOME/.edgemicro/org-env-config.yaml. अगर आपको यह फ़ाइल नहीं मिल रही है, तो Edge Microgateway कहां इंस्टॉल किया गया है देखें.
  2. पक्का करें कि OAuth प्लगिन की ये प्रॉपर्टी false पर सेट हों. ये डिफ़ॉल्ट रूप से गलत होते हैं. हालांकि, अगर आपको इनकी दोबारा जांच करनी है, तो ऐसा किया जा सकता है: 
    oauth:
   allowNoAuthorization: false
   allowInvalidAuthorization: false
  3. साथ ही, org-env-config.yaml फ़ाइल में यह भी पक्का करें कि oauth प्लगिन को plugins:sequence एलिमेंट में जोड़ा गया हो. जैसे:: 
    plugins:
   dir: ../plugins
   sequence:
   - oauth
  4. अगर आपने फ़ाइल में कोई बदलाव किया है, तो चालू Edge Microgateway इंस्टेंस में बदलावों को फिर से लोड करें. इस कमांड से, Edge Microgateway को बिना किसी रुकावट के फिर से कॉन्फ़िगर किया जाता है: 
    edgemicro reload -o [org] -e [env] -k [key] -s [secret]

    कहां:

    • org आपके Edge संगठन का नाम है. आपके पास संगठन के एडमिन की भूमिका होनी चाहिए.
    • env आपके संगठन का एनवायरमेंट है. जैसे, टेस्ट या प्रॉड.
    • key वह कुंजी है जो configure कमांड से पहले वापस मिली थी.
    • secret वह कुंजी है जो configure कमांड से पहले वापस मिली थी.

    उदाहरण

    edgemicro reload -o docs -e test -k 701e70ee718ce6dc188016b3c30177d64a88754d615c74e1f78b6181d

3. एपीआई पासकोड की मदद से, एपीआई को सुरक्षित तरीके से कॉल करना

एपीआई को x-api-key हेडर के साथ इस तरह कॉल करें. डेवलपर ऐप्लिकेशन से कॉपी की गई उपभोक्ता कुंजी की वैल्यू, एपीआई पासकोड होती है. डिफ़ॉल्ट रूप से, Edge Microgateway को आपसे x-api-key नाम के हेडर में पासकोड की ज़रूरत होती है. जैसे:

curl -i http://localhost:8000/hello/echo -H "x-api-key: [apikey]"

कहां:

  • apikey, EdgeMicroTestApp से ली गई उपभोक्ता कुंजी की वैल्यू है.

उदाहरण के लिए:


curl -i http://localhost:8000/hello/echo -H 'x-api-key: XsU1R4zGXz2ERxd0ilYQ5szwuljr5bB'

अब आपके पास पूरी तरह से काम करने वाला और सुरक्षित Edge Microgateway है. ट्यूटोरियल के अगले हिस्से में, हम उन प्लगिन के बारे में जानेंगे जो Edge Microgateway में सुविधाएं जोड़ते हैं.

पांचवां चरण: स्पाइक अरेस्ट प्लगिन जोड़ना

इस हिस्से में, हम Edge Microgateway के आपके इंस्टेंस में, दर को सीमित करने वाली सुविधा जोड़ेंगे. इसे स्पाइक अरेस्ट कहा जाता है.

प्लगिन क्या होते हैं?

प्लगिन, Node.js मॉड्यूल होता है. यह Edge Microgateway में सुविधाएं जोड़ता है. प्लगिन मॉड्यूल एक जैसे पैटर्न का पालन करते हैं और Edge Microgateway को पता होती है कि इन्हें कहां सेव किया गया है. इससे microgateway, इन्हें अपने-आप ढूंढकर लोड कर पाता है. प्लगिन के बारे में ज़्यादा जानने के लिए, प्लगिन इस्तेमाल करना लेख पढ़ें.

स्पाइक अरेस्ट प्लगिन जोड़ना

स्पाइक अरेस्ट प्लगिन, ट्रैफ़िक में अचानक होने वाली बढ़ोतरी से बचाता है. यह Edge Microgateway इंस्टेंस से प्रोसेस किए गए अनुरोधों की संख्या को थ्रॉटल करता है.

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

  1. अगर आपको यह फ़ाइल नहीं मिल रही है, तो $HOME/.edgemicro/org-env-config.yaml.Edge Microgateway कहां इंस्टॉल किया गया है फ़ाइल खोलें.
  2. यह एलिमेंट जोड़ें. इसे फ़ाइल में कहीं भी जोड़ा जा सकता है. 
       spikearrest:
      timeUnit: minute   
      allow: 10   
      buffersize: 0
  3. edgemicro:sequence एलिमेंट में spikearrest जोड़ें. ऐसा नीचे दिए गए तरीके से करें. sequence कॉन्फ़िगरेशन प्रॉपर्टी से Edge Microgateway को यह पता चलता है कि प्लगिन मॉड्यूल किस क्रम में एक्ज़ीक्यूट किए जाते हैं. 
    edgemicro:
  home: ../gateway
  port: 8000
  max_connections: -1
  max_connections_hard: -1
  logging:
    level: info
    dir: /var/tmp
    stats_log_interval: 60
  plugins:
    dir: ../plugins
  sequence:
    - oauth
    - spikearrest
  4. कॉन्फ़िगरेशन फ़ाइल सेव करें.
  5. reload कमांड का इस्तेमाल करके, Edge Microgateway को फिर से लोड करें. आपको इस निर्देश को उस डायरेक्ट्री से चलाना होगा जहां से आपने Edge Microgateway शुरू किया था. 
    edgemicro reload -o [org] -e [env] -k [key] -s [secret]

    कहां:

    • org आपके Edge संगठन का नाम है. इसके लिए, आपके पास संगठन के एडमिन की भूमिका होनी चाहिए.
    • env आपके संगठन का एनवायरमेंट है. जैसे, टेस्ट या प्रॉड.
    • key वह कुंजी है जो configure कमांड से पहले वापस मिली थी.
    • secret वह कुंजी है जो configure कमांड से पहले वापस लाई गई थी.

    उदाहरण

    edgemicro reload -o docs -e test -k 701e70ee718ce6dc188016b3c39177d64a88754d615c74e1f78b6181d
  6. एपीआई को कुछ ही समय में कई बार कॉल करने की कोशिश करें. दूसरे कॉल के बाद, Edge Microgateway यह गड़बड़ी दिखाता है: 
    {"message":"SpikeArrest engaged","status":503}

इसकी वजह यह है कि स्पाइक अरेस्ट, तय समय में किए जा सकने वाले कॉल की संख्या को कम कर देता है. इसलिए, इस मामले में एक मिनट में 10 कॉल किए जा सकते हैं. इसके अलावा, हर 6 सेकंड में एक कॉल किया जा सकता है.

अतिरिक्त क्रेडिट: कोटा प्लगिन जोड़ना

स्पाइक अरेस्ट को कॉन्फ़िगर करने के लिए इस्तेमाल किए गए पैटर्न का पालन करके, अन्य प्लगिन जोड़े जा सकते हैं. जैसे, कोटा प्लगिन. स्पाइक अरेस्ट की तरह, कोटा प्लगिन भी Edge Microgateway के हर इंस्टॉलेशन के साथ शामिल होता है. कोटा से पता चलता है कि कोई ऐप्लिकेशन, तय समयावधि (मिनट या घंटे) में किसी एपीआई को कितने अनुरोध मैसेज भेज सकता है.

छठा हिस्सा: Apigee Edge पर आंकड़े देखना

अब हमारे पास पूरी तरह से काम करने वाला Edge Microgateway इंस्टेंस है. आइए, देखते हैं कि यह क्या कर रहा है! डिफ़ॉल्ट रूप से, Analytics प्लगिन मॉड्यूल को Edge Micro में जोड़ा जाता है. यह मॉड्यूल, Edge Micro से Apigee Edge में चुपचाप तरीके से आंकड़ों का डेटा भेजता है. यहां Edge Analytics सिस्टम इसका इस्तेमाल करता है. आइए देखते हैं:

  1. Apigee Edge पर अपने संगठन में लॉग इन करें.
  2. Analytics > प्रॉक्सी की परफ़ॉर्मेंस को चुनें.
  3. प्रॉक्सी परफ़ॉर्मेंस डैशबोर्ड में, edgemicro_hello proxy चुनें.
  4. इस ग्राफ़ में, आपको प्रॉक्सी के ट्रैफ़िक पैटर्न के बारे में जानकारी मिलती है. जैसे, कुल ट्रैफ़िक, जवाब मिलने में लगने वाला औसत समय, टारगेट के हिसाब से जवाब मिलने में लगने वाला औसत समय वगैरह.

Edge Analytics डैशबोर्ड के बारे में ज़्यादा जानने के लिए, Edge के दस्तावेज़ में Analytics डैशबोर्ड का होम पेज देखें. प्लगिन के बारे में ज़्यादा जानने के लिए, प्लगिन का इस्तेमाल करना लेख पढ़ें