يتم الآن عرض مستندات Apigee Edge.
انتقِل إلى مستندات
Apigee X. المعلومات
المشكلة
يظهر الخطأ قيمة المضيف الظاهري غير صالحة للمستخدمين أثناء تهيئة ملف تخزين المفاتيح والاسم المستعار ومعلومات النطاق لبوابة مطور متكاملة: النشر > البوابات > بوابة المطور > الإعدادات > النطاقات.
رسالة الخطأ
يتم عرض رسالة الخطأ التالية:
Invalid virtual host value (id: <value>)
يتم عرض رسالة الخطأ في واجهة مستخدم Edge كما هو موضح أدناه:
البوابات > بوابة مطوّري البرامج > الإعدادات > النطاقات" title="Domains">
الأسباب المحتملة
| السبب | الوصف | تعليمات تحديد المشاكل وحلّها السارية على |
|---|---|---|
| سلسلة شهادات TLS المقدَّمة ليست بتنسيق PEM | يجب أن تكون سلاسل شهادات TLS المستخدمة في المضيفين الافتراضيين بتنسيق PEM. وفي حال استخدام سلسلة شهادات TLS بتنسيق غير PEM، سيتعذّر إتمام عملية إعداد النطاق الخاص. | مستخدمو Edge Public Cloud |
| تم تقديم شهادة ومفتاح بروتوكول أمان طبقة النقل (TLS) في ملف واحد | يجب توفير سلسلة شهادات TLS والمفتاح الخاص في الملفات الفردية عند التحميل إلى ملف تخزين المفاتيح. وإلا، ستفشل عملية إعداد النطاق الخاص. | مستخدمو Edge Public Cloud |
السبب: سلسلة شهادات TLS المقدَّمة ليست بتنسيق PEM
التشخيص
- تأكَّد من أنّ سلسلة شهادات بروتوكول أمان طبقة النقل (TLS) بتنسيق PEM.
- إذا لم تكن سلسلة شهادات TLS المحدّدة بتنسيق PEM، سيؤدي ذلك إلى تعذُّر عملية إنشاء المضيف الافتراضي في بوابة المطوّرين المتكاملة. ونتيجةً لذلك، يتم عرض رسالة الخطأ أعلاه للمستخدم في صفحة إعداد النطاق الخاص في واجهة مستخدم Edge.
درجة الدقّة
إذا تأكّدت من أنّ سلسلة شهادات TLS ليست بتنسيق PEM، عليك اتّباع الخطوات التالية لحل هذه المشكلة:
- تحويل سلسلة شهادات بروتوكول أمان طبقة النقل (TLS) إلى تنسيق PEM.
- تحقَّق من صلاحية سلسلة شهادات بروتوكول أمان طبقة النقل (TLS).
- أزِل سلسلة شهادات TLS الحالية والمفتاح الخاص من ملف تخزين المفاتيح المحدَّد.
- حمِّل الملف الذي يحتوي على سلسلة شهادات TLS بتنسيق PEM والملف الذي يحتوي على المفتاح الخاص في ملف تخزين المفاتيح باستخدام اسم مستعار للمفتاح في واجهة مستخدم Edge أو Management API.
- اضبط ملف تخزين المفاتيح والاسم المستعار واسم النطاق في بوابة مطوّري البرامج المدمجة: النشر > المداخل > بوابة المطوّر > الإعدادات > النطاقات.
- انقر على حفظ.
السبب: تم تقديم شهادة ومفتاح TLS في ملف واحد
التشخيص
- تأكَّد من أنّ سلسلة شهادات TLS المحدّدة تحتوي على الشهادات والمفتاح الخاص في الملف نفسه الذي تم تحميله إلى ملف تخزين المفاتيح.
- اطّلِع على ملف المصدر الأصلي في محرِّر نصوص على نظامك كنت تستخدمه لتحميل سلسلة شهادات TLS والمفتاح الخاص إلى ملف تخزين مفاتيح Apigee.
-
إذا كان الملف يحتوي على كلّ من شهادات بروتوكول أمان طبقة النقل (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-----
- إذا تأكّدت من أنّ سلسلة شهادات TLS والمفتاح الخاص قد تم دمجهما في ملف واحد وتم تحميلهما إلى ملف تخزين المفاتيح، يصبح ذلك سبب تعذُّر إنشاء المضيف الظاهري في بوابة المطوّرين المتكاملة. ونتيجةً لذلك، يتم عرض رسالة الخطأ أعلاه للمستخدم على صفحة إعداد النطاق الخاص على واجهة مستخدم Edge.
درجة الدقّة
إذا كان ملف PEM لشهادة بروتوكول أمان طبقة النقل (TLS) يحتوي على كل من شهادات بروتوكول أمان طبقة النقل (TLS) والمفتاح الخاص، يجب تنفيذ الخطوات التالية لحل المشكلة:
- انقل المفتاح الخاص من ملف PEM لشهادة TLS إلى ملف مفتاح منفصل.
- أزِل شهادة بروتوكول أمان طبقة النقل (TLS) الحالية من ملف تخزين المفاتيح المحدَّد.
- تأكَّد من أنّ سلسلة شهادات بروتوكول أمان طبقة النقل (TLS) بتنسيق PEM.
- وإذا لم تكن كذلك، عليك تحويل سلسلة شهادات TLS إلى تنسيق PEM.
- تحقَّق من صلاحية سلسلة شهادات بروتوكول أمان طبقة النقل (TLS).
- حمِّل الملف الذي يحتوي على سلسلة شهادات TLS التي تم تحويلها إلى تنسيق PEM والملف الذي يحتوي على المفتاح الخاص في ملف تخزين المفاتيح باستخدام اسم مستعار للمفتاح في واجهة مستخدم Edge أو Management API.
- اضبط ملف تخزين المفاتيح والاسم المستعار واسم النطاق في بوابة مطوّري البرامج المدمجة: النشر > المداخل > بوابة المطوّر > الإعدادات > النطاقات.
- انقر على حفظ.
في حال استمرار المشكلة، انتقِل إلى ضرورة جمع معلومات التشخيص.
ضرورة جمع معلومات التشخيص
في حال استمرار المشكلة بعد اتّباع التعليمات الواردة أعلاه، يمكنك جمع معلومات التشخيص التالية ومشاركتها مع فريق دعم Apigee Edge:
- اسم المؤسسة في Apigee Edge Cloud
- اسم بوابة مطوّري البرامج المتكاملة في Apigee Edge Cloud
- اسم ملف تخزين المفاتيح الذي تم إنشاؤه في بيئة البوابة
- الاسم المستعار
- اسم النطاق الخاص
- لقطة شاشة لصفحة إعداد النطاق الخاص التي تسجِّل رسالة الخطأ