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

Apigee Edge का दस्तावेज़ देखा जा रहा है.
Go to the Apigee X documentation. info

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

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

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

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

Invalid virtual host value (id: <value>)

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

Portals > Developer Portal > Settings > Domains" title="Domains">

संभावित कारण

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

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

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

रिज़ॉल्यूशन

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

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

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

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

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

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. Edge के यूज़र इंटरफ़ेस (यूआई) या Management API में, कुंजी के एलियास का इस्तेमाल करके, कीस्टोर में PEM फ़ॉर्मैट में बदली गई TLS सर्टिफ़िकेट चेन वाली फ़ाइल और निजी कुंजी वाली फ़ाइल अपलोड करें.
7. इंटीग्रेट किए गए डेवलपर पोर्टल में, कीस्टोर, एलियास, और डोमेन का नाम कॉन्फ़िगर करें: पब्लिश करें > पोर्टल > डेवलपर पोर्टल > सेटिंग > डोमेन.
8. सेव करें पर क्लिक करें.

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

गड़बड़ी की जानकारी इकट्ठा करने का तरीका

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

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