ההגדרה של הדומיין המותאם אישית נכשלה עם שגיאה של מארח וירטואלי לא חוקי בפורטל המפתחים המשולב

אתם צופים במסמכי התיעוד של Apigee Edge.
כדאי לעיין במסמכי התיעוד של Apigee X. מידע

תיאור הבעיה

המשתמשים מקבלים שגיאה 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. מגדירים את מאגר המפתחות, הכינוי ושם הדומיין בפורטל המפתחים המשולב: פרסום > פורטלים > פורטל מפתחים > הגדרות > דומיינים.
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. מגדירים את מאגר המפתחות, הכינוי ושם הדומיין בפורטל המפתחים המשולב: פרסום > פורטלים > פורטל מפתחים > הגדרות > דומיינים.
8. לוחצים על שמירה.

אם הבעיה נמשכת, צריך לעבור אל איסוף מידע לצורך אבחון.

צריך לאסוף פרטי אבחון

אם הבעיה נמשכת אחרי שמבצעים את ההוראות שלמעלה, צריך לאסוף את נתוני האבחון הבאים ולשתף אותם עם התמיכה של Apigee Edge:

• שם הארגון ב-Apigee Edge Cloud
• שם פורטל המפתחים המשולב של Apigee Edge Cloud
• השם של מאגר המפתחות שנוצר בסביבת הפורטל
• שם הכינוי
• שם דומיין מותאם אישית
• צילום מסך של דף ההגדרה של הדומיין המותאם אישית שבו מופיעה הודעת השגיאה