تعذَّر ضبط النطاق المخصّص مع ظهور خطأ مضيف غير صالح في بوابة المطوّر المدمجة.

أنت الآن بصدد الاطّلاع على مستندات Apigee Edge.
انتقِل إلىمستندات Apigee X. info

المشكلة

يتلقّى المستخدمون الخطأ Invalid virtual host value أثناء ضبط معلومات ملف تخزين المفاتيح والاسم المستعار والنطاق لبوابة مطوّري برامج متكاملة: Publish > Portals > Developer Portal > Settings > Domains.

رسالة الخطأ

تظهر رسالة الخطأ التالية:

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. حمِّل الملف الذي يحتوي على سلسلة شهادات طبقة النقل الآمنة (TLS) بتنسيق PEM والملف الذي يحتوي على المفتاح الخاص إلى ملف تخزين المفاتيح باستخدام اسم مستعار للمفتاح في واجهة مستخدِم Edge أو Management API.
5. اضبط ملف تخزين المفاتيح والاسم المستعار واسم النطاق في بوابة مطوّري البرامج المتكاملة: Publish > Portals > Developer Portal > Settings > Domains.
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.

الدقة

إذا كان ملف PEM لشهادة طبقة النقل الآمنة (TLS) يحتوي على كل من شهادات طبقة النقل الآمنة (TLS) والمفتاح الخاص، اتّبِع الخطوات التالية لحلّ المشكلة:

1. انقِل المفتاح الخاص من ملف PEM لشهادة طبقة النقل الآمنة (TLS) إلى ملف مفتاح منفصل.
2. أزِل شهادة طبقة النقل الآمنة (TLS) الحالية من ملف تخزين المفاتيح المحدّد.
3. تأكَّد من أنّ سلسلة شهادات طبقة النقل الآمنة (TLS) بتنسيق PEM.
4. إذا لم تكن كذلك، حوِّل سلسلة شهادات طبقة النقل الآمنة (TLS) إلى تنسيق PEM.
5. تأكَّد من أنّ سلسلة شهادات طبقة النقل الآمنة (TLS) صالحة.
6. حمِّل الملف الذي يحتوي على سلسلة شهادات طبقة النقل الآمنة (TLS) التي تم تحويلها إلى تنسيق PEM والملف الذي يحتوي على المفتاح الخاص إلى ملف تخزين المفاتيح باستخدام اسم مستعار للمفتاح في واجهة مستخدِم Edge أو Management API.
7. اضبط ملف تخزين المفاتيح والاسم المستعار واسم النطاق في بوابة مطوّري البرامج المتكاملة: Publish > Portals > Developer Portal > Settings > Domains.
8. انقر على حفظ.

إذا استمرت المشكلة، انتقِل إلى جمع معلومات التشخيص المطلوبة.

جمع معلومات التشخيص المطلوبة

إذا استمرت المشكلة بعد اتّباع التعليمات أعلاه، اجمع معلومات التشخيص التالية وشاركها مع فريق دعم Apigee Edge:

• اسم مؤسسة Apigee Edge Cloud
• اسم بوابة مطوّري البرامج المتكاملة في Apigee Edge Cloud
• اسم ملف تخزين المفاتيح الذي تم إنشاؤه في بيئة البوابة
• اسم العنوان البديل للبريد الإلكتروني
• اسم النطاق الخاص
• لقطة شاشة لصفحة ضبط النطاق الخاص تعرض رسالة الخطأ