درحال مشاهده اسناد Apigee Edge هستید.
به
اسناد Apigee X بروید. اطلاعات
نشانه
کاربران هنگام پیکربندی اطلاعات انبار کلید، نام مستعار، و دامنه برای درگاه توسعه‌دهنده یکپارچه، خطای مقدار میزبان مجازی نامعتبر دریافت می‌کنند: انتشار > درگاه‌ها > درگاه توسعه‌دهنده > تنظیمات > دامنه‌ها.
پیام خطا
پیام خطای زیر نمایش داده می‌شود:
Invalid virtual host value (id: <value>)
پیام خطا در «واسط کاربر Edge» به‌صورت زیر نمایش داده می‌شود:
درگاه‌ها > درگاه توسعه‌دهندگان > تنظیمات > دامنه‌ها" عنوان="دامنه‌ها">
علل احتمالی
| علت | شرح | دستورالعمل‌های عیب‌یابی برای موارد زیر قابل‌اجرا است |
|---|---|---|
| زنجیره گواهینامه «امنیت لایه انتقال» ارائه‌شده در قالب PEM نیست | زنجیره‌های گواهینامه TLS که در میزبان‌های مجازی استفاده می‌شوند باید در قالب PEM باشند. اگر از زنجیره گواهینامه TLS با قالب غیر PEM استفاده شود، پیکربندی دامنه سفارشی ناموفق خواهد بود. | کاربران Edge Public Cloud |
| گواهی و کلید «امنیت لایه انتقال» در یک فایل ارائه شده است | هنگام بارگذاری در انبار کلید، زنجیره گواهی «امنیت لایه انتقال» و کلید خصوصی باید در فایل‌های جداگانه ارائه شوند. درغیراین‌صورت، پیکربندی دامنه سفارشی ناموفق خواهد بود. | کاربران Edge Public Cloud |
دلیل: زنجیره گواهینامه TLS ارائه‌شده در قالب PEM نیست
تشخیص
- تأیید کنید که زنجیره گواهی TLS در قالب PEM است.
- اگر زنجیره گواهینامه TLS خاص در قالب PEM نباشد، باعث می‌شود فرایند ایجاد میزبان مجازی در درگاه توسعه‌دهنده یکپارچه با شکست مواجه شود. درنتیجه، پیام خطای بالا در صفحه پیکربندی دامنه سفارشی واسط کاربر Edge به کاربر نمایش داده می‌شود.
وضوح
اگر مطمئن شده‌اید که زنجیره گواهینامه TLS در قالب PEM نیست، مراحل زیر را برای رفع این مشکل انجام دهید:
- زنجیره گواهینامه «امنیت لایه انتقال» را به قالب PEM تبدیل کنید.
- اعتبارسنجی کنید که زنجیره گواهینامه «امنیت لایه انتقال» معتبر باشد.
- زنجیره گواهینامه TLS موجود و کلید خصوصی را از انبار کلید خاص بردارید.
- فایل حاوی زنجیره گواهی TLS در قالب PEM و فایل حاوی کلید خصوصی را بااستفاده از نام مستعار کلید در «واسط کاربر Edge» یا «میانای برنامه‌سازی کاربردی مدیریت» در محل ذخیره کلید بارگذاری کنید.
- فروشگاه کلید، نام مستعار، و نام دامنه را در درگاه توسعه‌دهنده یکپارچه پیکربندی کنید: انتشار > درگاه‌ها > درگاه توسعه‌دهنده > تنظیمات > دامنه‌ها.
- روی ذخیره کلیک کنید.
دلیل: گواهی و کلید «امنیت لایه انتقال» در یک فایل ارائه شده است
تشخیص
- تأیید کنید که زنجیره گواهی TLS ارائه‌شده حاوی گواهی‌ها و کلید خصوصی در فایل بارگذاری‌شده در انبار کلید است.
- فایل منبع اصلی را در ویرایشگر نوشتاری در سیستم خود که برای بارگذاری زنجیره گواهینامه TLS و کلید خصوصی در محل ذخیره کلید Apigee استفاده کرده‌اید مشاهده کنید.
-
اگر فایل هم گواهی‌های TLS و هم کلید خصوصی را داشته باشد، هر گواهی TLS در زنجیره گواهی با خط زیر شروع می‌شود:
-----BEGIN CERTIFICATE-----و با خط زیر پایان می‌یابد:
-----END CERTIFICATE-----گواهی‌های «امنیت لایه انتقال» با کلید خصوصی که با خط زیر شروع می‌شود دنبال می‌شود:
-----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 تبدیل‌شده به قالب PEM و فایل حاوی کلید خصوصی را بااستفاده از نام مستعار کلید در «واسط کاربر Edge» یا «میانای برنامه‌سازی کاربردی مدیریت» در محل ذخیره کلید بارگذاری کنید.
- فروشگاه کلید، نام مستعار، و نام دامنه را در درگاه توسعه‌دهنده یکپارچه پیکربندی کنید: انتشار > درگاه‌ها > درگاه توسعه‌دهنده > تنظیمات > دامنه‌ها.
- روی ذخیره کلیک کنید.
اگر مشکل همچنان ادامه داشت، به باید اطلاعات تشخیصی را جمع‌آوری کنید بروید.
باید اطلاعات تشخیص خرابی را جمع‌آوری کند
اگر مشکل پس‌از دنبال کردن دستورالعمل‌های بالا همچنان ادامه داشت، اطلاعات تشخیصی زیر را جمع‌آوری کنید و آن‌ها را با پشتیبانی Apigee Edge هم‌رسانی کنید:
- نام سازمان Apigee Edge Cloud
- نام پورتال توسعه‌دهنده یکپارچه‌سازی‌شده Apigee Edge Cloud
- نام انبار کلید ایجادشده در محیط درگاه
- نام مستعار
- نام دامنه سفارشی
- نماگرفتی از صفحه پیکربندی دامنه سفارشی که پیام خطا را ضبط می‌کند