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

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

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

https://orgname-portalname.apigee.io

यहां orgname, संगठन का नाम है और portalname को पोर्टल के नाम का इस्तेमाल करके तय किया गया है. पोर्टल के नाम को सभी छोटे अक्षरों में बदला गया है और उसमें से स्पेस और डैश हटा दिए गए हैं.

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

https://developers.example.com

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

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

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

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

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

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

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

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

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

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

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

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

1. Google Trust Services जैसी किसी भरोसेमंद सर्टिफ़िकेट अथॉरिटी से TLS सर्टिफ़िकेट खरीदें. सर्टिफ़िकेट देने वाली संस्था चुनना आपके ऊपर है.
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 पर ले जाने के लिए आपको अपने डोमेन के डीएनएस में कैननिकल नाम (CNAME) रिकॉर्ड जोड़ना होगा.

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

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

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

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

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

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

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

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

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

$ 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. तीसरा चरण: अपने पोर्टल में कस्टम डोमेन नेम जोड़ना में दिया गया तरीका अपनाएं