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

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

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

https://orgname-portalname.apigee.io

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

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

https://developers.example.com

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

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

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

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

  1. अपना डोमेन नेम रजिस्टर करें.
  2. TLS कॉन्फ़िगर करें.
  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 दिन में खत्म हो जाती है.
      • सर्टिफ़िकेट की समयसीमा खत्म हो गई है सर्टिफ़िकेट की समयसीमा खत्म हो गई है.
    • सर्टिफ़िकेट के मान्य रहने के बाकी दिनों की संख्या देखने के लिए, अपने कर्सर को किसी उपनाम पर रखें.

    उपनाम चुनने के बाद, डोमेन फ़ील्ड दिखता है.

    डोमेन ड्रॉप-डाउन सूची से कोई डोमेन चुनें. अगर आपने वाइल्डकार्ड उपनाम चुना है, तो सबडोमेन डालें.

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

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

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

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

  1. पब्लिश करें > पोर्टल चुनें और अपना पोर्टल चुनें.
  2. सबसे ऊपर मौजूद नेविगेशन बार में, ड्रॉप-डाउन मेन्यू में या लैंडिंग पेज पर, सेटिंग चुनें.
  3. डोमेन टैब पर क्लिक करें.
  4. डीएनएस कॉन्फ़िगर करें सेक्शन में जाकर, अपने संगठन के लिए 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. चरण 2: TLS कॉन्फ़िगर करें में दिया गया तरीका अपनाएं.
  2. तीसरा चरण: अपने पोर्टल में कस्टम डोमेन नेम जोड़ना में दिया गया तरीका अपनाएं