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

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

Edge Microgateway v. 2.3.x

खास जानकारी

यह ट्यूटोरियल आपको एज माइक्रोगेटवे का इंस्टेंस पाने और चालू करने के ज़रूरी तरीके बताता है.

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

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

ज़रूरी शर्त: Edge माइक्रोगेटवे इंस्टॉल करें

Edge Microgateway इंस्टॉल करने के निर्देशों का पालन करें. इंस्टॉलेशन पूरा करने के बाद, इस ट्यूटोरियल में दिया गया तरीका अपनाया जा सकता है.

इंस्टॉल करने के बाद, अगले सेक्शन "पार्ट 1: एज माइक्रोगेटवे कॉन्फ़िगर करें" पर जाएं.

पहला भाग: एज माइक्रोगेटवे कॉन्फ़िगर करना

इस हिस्से में, Apigee Edge से संपर्क करने के लिए, एज माइक्रोगेटवे को कॉन्फ़िगर करने के लिए, कमांड-लाइन इंटरफ़ेस (सीएलआई) कमांड का इस्तेमाल किया जा सकता है. अगर Apigee Edge Cloud का इस्तेमाल किया जा रहा है, तो Apigee Edge क्लाउड को कॉन्फ़िगर करने का तरीका अपनाएं. अगर आप Apigee Private Cloud का इस्तेमाल कर रहे हैं, तो Apigee Edge Private Cloud के लिए दिया गया तरीका अपनाएं.

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

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

  1. अगर आपने पहले ऐसा नहीं किया है, तो Edge माइक्रोगेटवे को शुरू करें (आपको यह चरण सिर्फ़ एक बार करना होगा):
    edgemicro init
  2. (ज़रूरी नहीं) edgemicroconfig कमांड के लिए सहायता प्रिंट करें:
    edgemicro configure -h
  3. Edge माइक्रोगेटवे को कॉन्फ़िगर करने के लिए नीचे दिए गए निर्देश का इस्तेमाल करें:
    edgemicro configure -o [org] -e [env] -u [username]

    जगह:

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

उदाहरण

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.1.0
current edgemicro version is 2.2.3-beta
password:
file doesn't exist, setting up
Give me a minute or two... this can take a while...
App edgemicro-auth deployed.
creating vault
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/wwitman-test-config.yaml

vault info:
 -----BEGIN CERTIFICATE-----
MIICpDCCAYwCCQCaDpaTttaDANBgkqhkiG9w0BAQsFADAUMRIwEAYDVQQDEwls
b2NhbGhvc3QwHhcNMTYxAxMjA0NzIyWhcNMTYxMTAyMjA0NzIyWjAUMRIwEAYD
VQQDEwlsb2NhbGhvcwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQDA
YbtbsFe50GgBrI8QTih5yzxxxvCfdubGrLWmovwwCCFthno3u8lS54ekOL9jQu
JTJsocJfNhZxvnXifDsCk5Muwx87Z/D0BYLw9ZhM8TMyA2MCkXgC6RfKT69IdJ
jT3X+3D0s+apr3lACsDhgOfaeQfeHAm1SSwH/VemaJqdImGkQMtM8uscMDwG6k
vBbCSNS+hh6ZH1m3tAkcKXqvj/E1hbrHNTWr+uiYFRByUzeo1I607daQD4Lxid
il4Ng3hr3LC1gEzvobWgVyhQ2ovYB57T886H7dGghTnOUxLm2y/TwmQya+44SL
JSsDwauArMF38cRKZZ7VAgMBAAEwDQYJKoZIhvcNAQELBQADEBAHwwu+gOn8Tq
jKOYBTXtOX11HPMTxmyvZ/I57R4roE7Z/lXg/DXwbiFpFG2uamXNKq7yTDJH2i
iiqdERZOGfv7TJMjRlxEnfVHoCV7UKguKq4zeeAEU2x55yFwpWNrarx0kMXRwI
v3WgGfo2bimFQrCjDCNIkDKmYYt4SXIF5zUJmBWPCaK9aJoQb7ARXQO9s2zoOI
XZ5bCUDbehQZ+6LyqC0hgDXiIZYy7R0j93yCbQgoHaHUMEprJEEjE24SHdsWBO
nxGZxB20JLq5AHTm8lbZp7XtvbU0jVpxyrBo2/olFnmpvBVOq9eIp042IVD7nT
J4rPejdK6C4=
-----END CERTIFICATE-----

The following credentials are required to start edge micro
  key: e88ec9d5da17cd88ca338d532b7c7a8c4f43ddd3da139d95955ab345af30352d
  secret: d7f64854eb6889d06b809dd7c161dba5eeba4a2657277fd819921bf992221a8f

edgemicro configuration complete!

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

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

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

    जगह:

    • आपके Edge संगठन का नाम org है. इसके लिए, ज़रूरी है कि आप संगठन के एडमिन हों.
    • 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 vault creating vault adding private_key adding public_key
configuring host http://192.168.52.106:9001 for region dc-1

saving configuration information to: /Users/ApigeeCorporation/.edgemicro/jdoe-test-config.yaml 
vault info: 
-----BEGIN CERTIFICATE----- 
MIICpDCCAYwCCQDpIvWlpaZJGDANBgkqhkiG9w0BAQFADAUMRIwEAYDVQQDEwls 
b2NhbGhvc3QwHhcNMTYwNDA3MTcxNTM5WhcNMTYwND4MTcxNTM5WjAUMRIwEAYD 
VQQDEwlsb2NhbGhvc3QwggEiMA0GCSqGSIb3DQEBAUAA4IBDwAwggEKAoIBAQD3 
OAQ+kf5FH0S0yuj05ITqUODuUJspBPberRMbqOZYHcFswhB0Yvg6JKWxKWBDP9o 
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: a3f8f3dfe39158fc3c50b274f0af2234246e0d5f6ea4dd09389b645147151ba3 
   secret: 3e9904802fb3c0e8ca408128a11119cf13546d54dac30ace944c097a726a1263

edgemicro configuration complete!

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

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

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

जगह:

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

उदाहरण

edgemicro verify -o docs -e test -k 93b01fd21d86331459ae52f664ae9aeb13eb94767ce40a4f621d172cdfb7e8e6 -s c8c755be97cf56c21f8b0556d7132afbd03625bbd85dc34ebfefae4f23fbcb3c

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

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

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

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

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

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

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

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

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

ज़्यादा जानें: एज माइक्रोगेटवे की खास जानकारी में "एज माइक्रोगेटवे-अवेयर प्रॉक्सी के बारे में क्या जानने की ज़रूरत है" लेख पढ़ें.

1. Edge पर Edge माइक्रोगेटवे-अवेयर एपीआई प्रॉक्सी बनाएं

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

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

दो प्रॉक्सी वाला प्रॉडक्ट बनाएं:

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

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

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

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

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

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

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

तीसरा चरण: एज माइक्रोगेटवे का इस्तेमाल करना

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

1. Edge माइक्रोगेटवे चालू करें

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

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

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

    जगह:

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

    उदाहरण

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

    आउटपुट

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

    ...

PROCESS PID : 9757
installed plugin from analytics
installed plugin from oauth
eb725020-a2b0-11e6-8a52-6de156e3a6e2 edge micro listening on port 8000
installed plugin from analytics
installed plugin from oauth
installed plugin from analytics
installed plugin from oauth
installed plugin from analytics
installed plugin from oauth
eb77ce60-a2b0-11e6-8a88-b96278c0c198 edge micro listening on port 8000
eb78b8c0-a2b0-11e6-bf36-717b986c91fe edge micro listening on port 8000
eb77f570-a2b0-11e6-883e-472b9104351e edge micro listening on port 8000

इसकी क्या वजह है?

उस टर्मिनल को देखें जहां आपने edgemicro config कमांड चलाया है. स्टैंडर्ड आउटपुट में ऊपर की ओर स्क्रोल करने पर, यह देखा जा सकता है कि कमांड, Apigee Edge से Edge माइक्रोगेटवे के कॉन्फ़िगरेशन की जानकारी का पेलोड इकट्ठा करता है. इस जानकारी में ये चीज़ें शामिल होती हैं:

  • वह सार्वजनिक कुंजी जिसे हमने पहले Apigee Vault में बनाया और सेव किया था.
  • संगठन/एनवायरमेंट में मौजूद सभी एज माइक्रोगेटवे-अवेयर प्रॉक्सी का JSON फ़ॉर्मैट. इन सभी प्रॉक्सी को edgemicro_ प्रीफ़िक्स से नाम दिया गया है.
  • संगठन/परिवेश में मौजूद सभी एपीआई प्रॉडक्ट का JSON फ़ॉर्मैट.

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

2. एज माइक्रोगेटवे की जांच करें

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

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

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

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

4. एज माइक्रोगेटवे को बंद करें

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

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

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

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

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

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

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

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

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

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

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

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

    जगह:

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

    उदाहरण

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

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

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

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

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

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

जगह:

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

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

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

MIICpDCCAYwCCQDpIvWlpaZJGDANBgkqhkiG9w0BAQFADAUMRIwEAYDVQQDEwls 
b2NhbGhvc3QwHhcNMTYwNDA3MTcxNTM5WhcNMTYwND4MTcxNTM5WjAUMRIwEAYD 
VQQDEwlsb2NhbGhvc3QwggEiMA0GCSqGSIb3DQEBAUAA4IBDwAwggEKAoIBAQD3 
OAQ+kf5FH0S0yuj05ITqUODuUJspBPberRMbqOZYHcFswhB0Yvg6JKWxKWBDP9o 
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=

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

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

    जगह:

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

    उदाहरण

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

4. एपीआई का इस्तेमाल सुरक्षित तरीके से करें

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

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

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

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

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

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

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

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

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

    जगह:

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

    उदाहरण

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

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

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

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

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

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

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

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

स्पैम अरेस्ट प्लगिन जोड़ा जा रहा है

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

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

  1. फ़ाइल खोलें ~/.edgemicro/org-env-config.yaml. इंस्टॉलिंग एज माइक्रोगेटवे में "एज माइक्रोगेटवे कहां इंस्टॉल है" भी देखें.
  2. नीचे दिया गया एलिमेंट जोड़ें. इसे फ़ाइल में कहीं भी जोड़ा जा सकता है. 
       spikearrest:
      timeUnit: minute   
      allow: 10   
      buffersize: 0
  3. spikearrest को edgemicro: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:
    - spikearrest
    - oauth
  4. कॉन्फ़िगरेशन फ़ाइल सेव करें.
  5. reload कमांड की मदद से, Edge माइक्रोगेटवे को फिर से लोड करें. आपको यह निर्देश उसी डायरेक्ट्री से चलाना होगा जहां से आपने Edge माइक्रोगेटवे की शुरुआत की थी. 
    edgemicro reload -o [org] -e [env] -k [key] -s [secret]

    जगह:

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

    उदाहरण

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

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

ज़्यादा जानकारी के लिए, प्लगिन का इस्तेमाल करें में "स्पाइक अरेस्ट कैसे काम करता है?" देखें.

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

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

कोटा कैसे काम करता है, यह जानने के लिए प्लगिन का इस्तेमाल करें में "कोटा प्लगिन का इस्तेमाल करना" देखें.

छठा भाग: Apigee Edge पर आंकड़े देखना

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

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

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