अपने डोमेन को पसंद के मुताबिक बनाना

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

डेवलपर पोर्टल बनाते समय, डिफ़ॉल्ट रूप से आपको Apigee का सैंपल डोमेन नेम दिया जाता है. इसकी मदद से, लाइव पोर्टल को इस फ़ॉर्मैट में ऐक्सेस किया जा सकता है:

https://orgname-portalname.apigee.io

यहां orgname संगठन का नाम है और portalname को पोर्टल के नाम को पूरी तरह से लोअर केस में बदलकर और उसमें से स्पेस और डैश हटाकर तय किया जाता है.

डेवलपर पोर्टल लॉन्च करने से पहले, हमारा सुझाव है कि आप अपना कस्टम डोमेन नेम दें. उदाहरण के लिए, एक लोकप्रिय विकल्प यह है:

https://developers.example.com

SAML आइडेंटिटी प्रोवाइडर के साथ कस्टम डोमेन का इस्तेमाल करने से जुड़ी ज़रूरी बातों के लिए, SAML प्रोवाइडर के साथ कस्टम डोमेन का इस्तेमाल करना लेख पढ़ें.

अपने डोमेन को पसंद के मुताबिक बनाने का तरीका, इन सेक्शन में बताया गया है.

अपने डोमेन नेम को पसंद के मुताबिक बनाना (Apigee Edge)

Apigee Edge के इंटिग्रेटेड पोर्टल में, अपने डोमेन नेम को पसंद के मुताबिक बनाने के लिए, यह तरीका अपनाएं:

1. अपना डोमेन नेम रजिस्टर करें.
2. TLS कॉन्फ़िगर करें.
3. अपने पोर्टल में कस्टम डोमेन नेम जोड़ें.
4. अपना डीएनएस कॉन्फ़िगर करें.

कस्टम डोमेन जोड़ने के बाद, उसमें बदलाव किया जा सकता है या उसे बंद किया जा सकता है. समस्याओं को हल करने में मदद पाने के लिए, अपना कस्टम डोमेन की समस्याएं हल करना लेख पढ़ें.

पहला चरण: अपना डोमेन नेम रजिस्टर करना

अगर आपको कोई नया डोमेन रजिस्टर करना है, तो डोमेन रजिस्टर करने वाली कई लोकप्रिय साइटें उपलब्ध हैं. जैसे, Google Domains. डोमेन रजिस्टर करने के लिए, कौनसी साइट चुननी है, यह आपके ऊपर निर्भर करता है.

अपना डोमेन नेम तय करते समय, इस बात का ध्यान रखें कि उपयोगकर्ता के लिए आसान और आसानी से पढ़े जा सकने वाले यूआरएल, सर्च इंजन ऑप्टिमाइज़ेशन को बेहतर बनाने में अहम भूमिका निभाते हैं. इसके बारे में, सर्च इंजन ऑप्टिमाइज़ेशन (एसईओ) लागू करना लेख में बताया गया है.

दूसरा चरण: TLS कॉन्फ़िगर करना

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

TLS कॉन्फ़िगर करने के लिए:

1. सर्टिफ़िकेट देने वाली किसी भरोसेमंद संस्था से TLS सर्टिफ़िकेट खरीदें. जैसे, Google Trust Services. सर्टिफ़िकेट देने के लिए, कौनसी संस्था चुननी है, यह आपके ऊपर निर्भर करता है.
2. https://apigee.com/edge पर साइन इन करें.
3. अपनी उपयोगकर्ता प्रोफ़ाइल मेन्यू से, अपना संगठन चुनें.
4. TLS कीस्टोर पेज दिखाने के लिए, एडमिन > एनवायरमेंट > TLS कीस्टोर चुनें.

5. एनवायरमेंट के ड्रॉप-डाउन से, पोर्टल चुनें.

   

6. कीस्टोर और एलियास बनाएं. इसके बारे में, Edge यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करके कीस्टोर और ट्रस्टस्टोर बनाना लेख में बताया गया है.

अपने पोर्टल में कस्टम डोमेन नेम जोड़ना

अपने पोर्टल में कस्टम डोमेन नेम जोड़ने पर, सिस्टम आपके लिए ये संसाधन बनाता है. इसके लिए, उसी फ़ंक्शन का इस्तेमाल किया जाता है जिसका इस्तेमाल, किसी एंडपॉइंट पर कस्टम डोमेन नेम लागू करने के लिए किया जाता है. जैसे, api.example.com:

• एक वर्चुअल होस्ट, जो आपके बताए गए कस्टम डोमेन नेम का इस्तेमाल करके, पोर्ट 443 पर सुनता है.

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

अपने पोर्टल में कस्टम डोमेन नेम जोड़ने के लिए:

1. पब्लिश करें > पोर्टल चुनें. इसके बाद, अपना पोर्टल चुनें..
2. सबसे ऊपर मौजूद नेविगेशन बार या लैंडिंग पेज पर, ड्रॉप-डाउन मेन्यू में सेटिंग चुनें.
3. डोमेन टैब पर क्लिक करें.
4. कस्टम डोमेन में जाकर, ये फ़ील्ड भरें.
   

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

   सभी फ़ील्ड भरने के बाद, कस्टम डोमेन की स्थिति का आइकॉन अपडेट हो जाएगा. यह इस तरह दिखेगा:

   स्थिति	ब्यौरा
   	कीस्टोर, एलियास, और कस्टम डोमेन मान्य हैं.
   	सर्टिफ़िकेट 30 दिनों के अंदर एक्सपायर हो जाएगा.
   	कीस्टोर, एलियास, और कस्टम डोमेन अमान्य हैं.

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

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

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

चौथा चरण: अपना डीएनएस कॉन्फ़िगर करना

इसके बाद, आपको अपने डोमेन के डीएनएस में कैननिकल नेम (सीएनएएमई) रिकॉर्ड जोड़ना होगा, ताकि वह {org_name}-portal.apigee.net पर पॉइंट करे.

सीएनएएमई वैल्यू की पुष्टि करने के लिए:

1. पब्लिश करें > पोर्टल चुनें. इसके बाद, अपना पोर्टल चुनें.
2. सबसे ऊपर मौजूद नेविगेशन बार या लैंडिंग पेज पर, ड्रॉप-डाउन मेन्यू में सेटिंग चुनें.
3. डोमेन टैब पर क्लिक करें.
4. डीएनएस कॉन्फ़िगर करें सेक्शन में, अपने संगठन के लिए सीएनएएमई वैल्यू देखें. यह वैल्यू, यहां दी गई इमेज में दिखाई गई है:

यहां, सीएनएएमई रिकॉर्ड का एक उदाहरण दिया गया है. इसे ऊपर दिखाए गए कस्टम डोमेन के लिए कॉन्फ़िगर किया जाएगा. यानी, myorg संगठन में मौजूद developers.example.com कस्टम डोमेन के लिए:

developers.example.com. CNAME myorg-portal.apigee.net.

अपने कस्टम डोमेन की समस्याएं हल करना

अपने कस्टम डोमेन की समस्याएं हल करने के सुझाव, इन सेक्शन में दिए गए हैं.

समस्या हल करना: dig का इस्तेमाल करके अपने डोमेन के डीएनएस सेटअप की पुष्टि करना

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

उदाहरण के लिए, यहां दिया गया dig निर्देश, आपके डोमेन के डीएनएस सर्वर से क्वेरी करता है. निर्देश के आउटपुट में, ANSWER SECTION में सीएनएएमई रिकॉर्ड की एंट्री शामिल होती है.

$ dig @your.domain.dns developer.mycompany.com
; <<>> DiG 9.8.3-P1 <<>> @your.domain.dns developer.mycompany.com
; (1 server found)
;; global options:  cmd
;; Got answer:
;; ->>HEADER<<- opcode: QUERY, status: NOERROR, id: 41356
;; flags: qr rd ra; QUERY: 1, ANSWER: 3, AUTHORITY: 0, ADDITIONAL: 0
;; WARNING: recursion requested but not available

;; QUESTION SECTION:
;developer.mycompany.com.       IN  A

;; ANSWER SECTION:
developer.mycompany.com.    29  IN  CNAME   myorg-portal.apigee.net.

;; Query time: 141 msec
;; SERVER: 192.168.1.254#53(192.168.1.254)
;; WHEN: Mon Mar 20 16:41:59 2017
;; MSG SIZE  rcvd: 136

समस्या हल करना: होस्ट के लिए प्रॉक्सी की पहचान नहीं की जा सकी

अपने पोर्टल में कस्टम डोमेन नेम जोड़ने पर, डिफ़ॉल्ट रूप से एक एपीआई प्रॉक्सी जनरेट होती है. यह कस्टम डोमेन यूआरएल का इस्तेमाल करती है. इसका टारगेट एंडपॉइंट, डिफ़ॉल्ट पोर्टल डोमेन पर सेट होता है. अगर आपने कस्टम डोमेन से जुड़ी एपीआई प्रॉक्सी में बदलाव किया या उसे मिटाया, तो कस्टम डोमेन का कॉन्फ़िगरेशन अमान्य हो जाएगा. साथ ही, कस्टम डोमेन यूआरएल को ऐक्सेस करने की कोशिश करने पर, आपको Unable to identify proxy for host गड़बड़ी का मैसेज मिलेगा. उदाहरण के लिए:

{"fault":{"faultstring":"Unable to identify proxy for host: developers.mycompany.com:443 and url: \/","detail":{"errorcode":"messaging.adaptors.http.flow.ApplicationNotFound"}}}

अगर एपीआई प्रॉक्सी में बदलाव किया गया है या उसे मिटाया गया है, तो कस्टम डोमेन के कॉन्फ़िगरेशन को वापस लाने के लिए:

1. पब्लिश करें > पोर्टल चुनें. इसके बाद, अपना पोर्टल चुनें.
2. सबसे ऊपर मौजूद नेविगेशन बार या लैंडिंग पेज पर, ड्रॉप-डाउन मेन्यू में सेटिंग चुनें.
3. डोमेन टैब पर क्लिक करें.
4. एपीआई प्रॉक्सी को वापस लाने के लिए, सेव करें पर क्लिक करें.

अपना सर्टिफ़िकेट अपडेट करना

TLS सर्टिफ़िकेट अपडेट करने के बारे में सामान्य जानकारी के लिए, TLS सर्टिफ़िकेट अपडेट करना लेख पढ़ें.

1. दूसरा चरण: TLS कॉन्फ़िगर करना में दिया गया तरीका अपनाएं.
2. तीसरा चरण: अपने पोर्टल में कस्टम डोमेन नेम जोड़ना में दिया गया तरीका अपनाएं