इंटिग्रेट किए गए डेवलपर पोर्टल में, अमान्य वर्चुअल होस्ट की गड़बड़ी की वजह से कस्टम डोमेन कॉन्फ़िगरेशन काम नहीं करता

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

समस्या का ब्यौरा

इंटिग्रेट किए गए डेवलपर पोर्टल के लिए कीस्टोर, उपनाम, और डोमेन की जानकारी कॉन्फ़िगर करते समय उपयोगकर्ताओं को अमान्य वर्चुअल होस्ट वैल्यू वाली गड़बड़ी मिलती है: पब्लिश करें > पोर्टल > डेवलपर पोर्टल > सेटिंग > डोमेन.

गड़बड़ी का मैसेज

गड़बड़ी का यह मैसेज दिखता है:

Invalid virtual host value (id: <value>)

गड़बड़ी का मैसेज, Edge यूज़र इंटरफ़ेस (यूआई) में दिखता है, जैसा कि नीचे दिखाया गया है:

पोर्टल > डेवलपर पोर्टल > सेटिंग > डोमेन" title="Domains">

संभावित कारण

वजह ब्यौरा समस्या हल करने के लिए निर्देश
दिया गया TLS सर्टिफ़िकेट चेन, PEM फ़ॉर्मैट में नहीं है वर्चुअल होस्ट में इस्तेमाल की जाने वाली TLS सर्टिफ़िकेट चेन, PEM फ़ॉर्मैट में होनी चाहिए. अगर बिना PEM फ़ॉर्मैट में TLS सर्टिफ़िकेट चेन का इस्तेमाल किया जाता है, तो कस्टम डोमेन को कॉन्फ़िगर नहीं किया जा सकेगा. Edge Public Cloud के उपयोगकर्ता
TLS सर्टिफ़िकेट और कुंजी एक ही फ़ाइल में दी गई थी कीस्टोर में अपलोड करते समय, अलग-अलग फ़ाइलों में TLS सर्टिफ़िकेट चेन और निजी पासकोड देना ज़रूरी है. ऐसा न करने पर, कस्टम डोमेन का कॉन्फ़िगरेशन काम नहीं करेगा. Edge Public Cloud के उपयोगकर्ता

वजह: दी गई TLS सर्टिफ़िकेट चेन, PEM फ़ॉर्मैट में नहीं है

संक्रमण की जांच

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

रिज़ॉल्यूशन

अगर आपको पता चल गया है कि TLS सर्टिफ़िकेट वाली चेन, PEM फ़ॉर्मैट में नहीं है, तो इस समस्या को ठीक करने के लिए यह तरीका अपनाएं:

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

वजह: TLS सर्टिफ़िकेट और कुंजी एक ही फ़ाइल में दी गई थी

संक्रमण की जांच

  1. पुष्टि करें कि दी गई TLS सर्टिफ़िकेट चेन में, कीस्टोर में अपलोड की गई फ़ाइल में मौजूद सर्टिफ़िकेट और निजी कुंजी, दोनों शामिल हैं.
  2. ओरिजनल सोर्स फ़ाइल को अपने सिस्टम पर टेक्स्ट एडिटर में देखें. आपने इसका इस्तेमाल करके, TLS सर्टिफ़िकेट वाली चेन और निजी पासकोड को Apigee कीस्टोर में अपलोड किया था.
  3. अगर फ़ाइल में TLS सर्टिफ़िकेट और निजी कुंजी, दोनों हैं, तो सर्टिफ़िकेट की चेन में हर TLS सर्टिफ़िकेट इस लाइन से शुरू होता है:

    -----BEGIN CERTIFICATE-----

    और नीचे दी गई पंक्ति पर खत्म होता है:

    -----END CERTIFICATE-----

    TLS सर्टिफ़िकेट के बाद, निजी कुंजी आती है, जो नीचे दी गई लाइन से शुरू होती है:

    -----BEGIN RSA PRIVATE KEY-----

    और नीचे दी गई पंक्ति पर खत्म होता है:

    -----END RSA PRIVATE KEY-----

    जैसा कि नीचे दिए गए उदाहरण में बताया गया है:

    -----BEGIN CERTIFICATE-----
    CzAJBgNVBAYTAkJCMQswCQYDVQQIDAJCQjELMAkGA1UEBwwCQkIxDzANBgNVBAoM
    BkJCIEx0ZDELMAkGA1UECwwCQkIxEDAOBgNVBAMMB2Zvby5vcmcxGjAYBgkqhkiG
    9w0BCQEWC2FiY0Bmb28ub3JnMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKC
    AQEA8IN15+8HrfeSVf4NIj7mM4jjms89EUX4HKrey+lm1+ljv3OGw+NK7BCHvoV3
    vZ+KXMHTtFeeFd1NgQZnDdbmuD0jTvvF7YoC/h6bLPytJquQJZykm9DyszsmACI8
    ...
    -----END CERTIFICATE-----
    -----BEGIN CERTIFICATE-----
    MIIDbjCCAlYCCQCrcuwFhXCcujANBgkqhkiG9w0BAQsFADB5MQswCQYDVQQGEwJB
    QTELMAkGA1UECAwCQUExCzAJBgNVBAcMAkFBMQ8wDQYDVQQKDAZBQSBMdGQxCzA
    BgNVBAsMAkFBMRMwEQYDVQQDDApjYS5mb28ub3JnMR0wGwYJKoZIhvcNAQkBFg5h
    YmNAY2EuZm9vLm9yZzAeFw0xOTEwMDQwNTA0MzVaFw0yOTEwMDEwNTA0MzVaMHk
    CzAJBgNVBAYTAkFBMQswCQYDVQQIDAJBQTELMAkGA1UEBwwCQUExDzANBgNVBAo
    ...
    -----END CERTIFICATE-----
    -----BEGIN CERTIFICATE-----
    YcJpTL5yNyQE3NIXPGCiTrrSEBSX5X9ae8C/URlyWPbJ3jBE7GH4u6id5qEcgx6I
    /6QHDyPIhFcwfdU3nZbzZfwCYfH9SI5hQPscfGTotNxZxDwNIzuqqrIhari4e6lc
    mlEa/CDzOzvdYTX7RT1MmBY9US8JY5xhUKk0gQbhCfB7TcpvySldTbiUGQVn8h62
    /fJDhNQlzV7Maogc7te9DWW/HhYfGTFKOwIDAQABMA0GCSqGSIb3DQEBCwUAA4IB
    AQAT/5FCiKJ/Pv62bl+GYuuc0gXXeumW2205dN5cXBAVZ3kRqHjR9tMCx3u+F2Td
    ...
    -----END CERTIFICATE-----
    -----BEGIN RSA PRIVATE KEY-----
    MIIEowIBAAKCAQEA8IN15+8HrfeSVf4NIj7mM4jjms89EUX4HKrey+lm1+ljv3OG
    w+NK7BCHvoV3vZ+KXMHTtFeeFd1NgQZnDdbmuD0jTvvF7YoC/h6bLPytJquQJZyk
    m9DyszsmACI8hK4azrd7zZqTETVZN+mxOiYBfa1E1pE8v/bdIqnLTICmFbIQ2PVF
    zc0anobltRRI4/OcRb7QPQUk+dBxU7XyyAhcACROwaeT8yqksnYNANBcnMiS5qH+
    sucJFNJ9bGIuWIwhsYVxzrANe9ttVvie38Cj6Go+UiIzF3VAyRkIE7MvW9Qc5m0O
    ...
    -----END RSA PRIVATE KEY-----
  4. अगर आपको यह पता चलता है कि TLS सर्टिफ़िकेट वाली चेन और निजी पासकोड को एक ही फ़ाइल में जोड़कर, कीस्टोर पर अपलोड कर दिया गया था, तो इसी वजह से इंटिग्रेट किए गए डेवलपर पोर्टल में वर्चुअल होस्ट नहीं बन पाए. इस वजह से, उपयोगकर्ता को ऊपर दिया गया गड़बड़ी का मैसेज, Edge यूज़र इंटरफ़ेस (यूआई) पर कस्टम डोमेन कॉन्फ़िगरेशन पेज पर दिखता है.

रिज़ॉल्यूशन

अगर TLS सर्टिफ़िकेट वाली PEM फ़ाइल में TLS सर्टिफ़िकेट और निजी कुंजी, दोनों मौजूद हैं, तो इस समस्या को हल करने के लिए यह तरीका अपनाएं:

  1. निजी कुंजी को TLS प्रमाणपत्र PEM फ़ाइल से और किसी अलग कुंजी फ़ाइल में ले जाएं.
  2. खास कीस्टोर से मौजूदा TLS सर्टिफ़िकेट हटाएं.
  3. पुष्टि करें कि TLS सर्टिफ़िकेट चेन, PEM फ़ॉर्मैट में है.
  4. अगर ऐसा नहीं है, तो TLS सर्टिफ़िकेट चेन को PEM फ़ॉर्मैट में बदलें.
  5. पुष्टि करें कि TLS सर्टिफ़िकेट वाली चेन मान्य है.
  6. टीएलएस सर्टिफ़िकेट चेन की फ़ाइल को PEM फ़ॉर्मैट में अपलोड करें. साथ ही, उस फ़ाइल को कीस्टोर पर अपलोड करें जिसमें निजी कुंजी मौजूद है. इसके लिए, Edge यूज़र इंटरफ़ेस (यूआई) या Management API में कुंजी के तौर पर इस्तेमाल किया जाने वाला कुंजी का इस्तेमाल करें.
  7. इंटिग्रेट किए गए डेवलपर पोर्टल में कीस्टोर, उपनाम, और डोमेन नेम कॉन्फ़िगर करें: पब्लिश करें > पोर्टल > डेवलपर पोर्टल > सेटिंग > डोमेन में.
  8. सेव करें पर क्लिक करें.

अगर समस्या अब भी बनी रहती है, तो गड़बड़ी की जानकारी इकट्ठा करना ज़रूरी है पर जाएं.

ऐप्लिकेशन की परफ़ॉर्मेंस से जुड़ी जानकारी इकट्ठा करनी होगी

अगर ऊपर दिए गए निर्देशों का पालन करने के बाद भी समस्या बनी रहती है, तो गड़बड़ी से जुड़ी यह जानकारी इकट्ठा करें और उसे Apigee Edge के सहायता केंद्र के साथ शेयर करें:

  • Apigee Edge के क्लाउड संगठन का नाम
  • Apigee Edge Cloud के इंटिग्रेट किए गए डेवलपर पोर्टल का नाम
  • पोर्टल एनवायरमेंट में बनाए गए कीस्टोर का नाम
  • उपनाम
  • कस्टम डोमेन नाम
  • कस्टम डोमेन के कॉन्फ़िगरेशन पेज का स्क्रीनशॉट, जिसमें गड़बड़ी का मैसेज दिख रहा है
  •