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

أنت تعرض مستندات Apigee Edge.
انتقل إلى مستندات Apigee X. معلومات

المشكلة

تظهر للمستخدمين رسالة الخطأ قيمة المضيف الظاهري غير صالحة أثناء ضبط معلومات ملف تخزين المفاتيح والاسم المستعار والنطاق لبوابة المطوّرين المتكاملة: النشر > بوابات > بوابة المطوّرين > الإعدادات > Domains (نطاقات):

رسالة الخطأ

يتم عرض رسالة الخطأ التالية:

Invalid virtual host value (id: <value>)

يتم عرض رسالة الخطأ في واجهة مستخدم Edge كما هو موضح أدناه:

بوابات > بوابة المطوّرين > الإعدادات > Google Domains" title="النطاقات">

الأسباب المحتملة

السبب	الوصف	إرشادات استكشاف الأخطاء وإصلاحها التي تنطبق على
سلسلة شهادات بروتوكول أمان طبقة النقل (TLS) المُقدَّمة ليست بتنسيق PEM	يجب أن تكون سلاسل شهادات بروتوكول أمان طبقة النقل (TLS) المستخدَمة في المضيفات الافتراضية بتنسيق PEM. إذا كانت شهادة بروتوكول أمان طبقة النقل (TLS) بتنسيق غير PEM، وسيتعذّر إعداد النطاق الخاص.	مستخدمو 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 أو Management API.
5. اضبط ملف تخزين المفاتيح والاسم المستعار واسم النطاق في بوابة المطوّرين المدمجة: النشر > بوابات > بوابة المطوّرين > الإعدادات > 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. اضبط ملف تخزين المفاتيح والاسم المستعار واسم النطاق في بوابة المطوّرين المدمجة: النشر > بوابات > بوابة المطوّرين > الإعدادات > Domains (نطاقات):
8. انقر على حفظ.

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

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

في حال استمرار المشكلة بعد اتّباع التعليمات أعلاه، يُرجى جمع بيانات التشخيص التالية. المعلومات ومشاركتها مع Apigee Edge Support:

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