پیکربندی دامنه سفارشی با خطای میزبان مجازی نامعتبر در پورتال توسعه‌دهنده یکپارچه انجام نمی‌شود

شما در حال مشاهده اسناد Apigee Edge هستید.
به مستندات Apigee X بروید . اطلاعات

علامت

کاربران هنگام پیکربندی فروشگاه کلید، نام مستعار و اطلاعات دامنه برای یک پورتال توسعه‌دهنده یکپارچه، خطای مقدار میزبان مجازی نامعتبر دریافت می‌کنند: 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 UI به کاربر نمایش داده می شود.

قطعنامه

اگر مطمئن شده اید که زنجیره گواهی TLS در قالب PEM نیست، برای حل این مشکل مراحل زیر را انجام دهید:

1. زنجیره گواهی TLS را به فرمت PEM تبدیل کنید .
2. تأیید کنید که زنجیره گواهی TLS معتبر است.
3. زنجیره گواهی TLS موجود و کلید خصوصی را از فروشگاه کلید خاص حذف کنید.
4. فایل حاوی زنجیره گواهی TLS را در قالب PEM و فایل حاوی کلید خصوصی را با استفاده از نام مستعار کلید در Edge UI یا Management API در keystore آپلود کنید.
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 UI یا Management API در keystore آپلود کنید.
7. ذخیره‌سازی کلید، نام مستعار و نام دامنه را در پورتال توسعه‌دهنده یکپارچه پیکربندی کنید: Publish > Portals > Developer Portal > Settings > Domains .
8. روی ذخیره کلیک کنید.

اگر مشکل همچنان ادامه داشت، به اطلاعات تشخیصی باید جمع‌آوری شود بروید.

باید اطلاعات تشخیصی را جمع آوری کرد

اگر پس از دنبال کردن دستورالعمل‌های بالا، مشکل همچنان ادامه داشت، اطلاعات تشخیصی زیر را جمع‌آوری کنید و با پشتیبانی Apigee Edge به اشتراک بگذارید:

• نام سازمان Apigee Edge Cloud
• نام پورتال توسعه‌دهنده یکپارچه Apigee Edge Cloud
• نام فروشگاه کلید ایجاد شده در محیط پورتال
• نام مستعار
• نام دامنه سفارشی
• تصویری از صفحه پیکربندی دامنه سفارشی که پیام خطا را دریافت می کند