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

כרגע מוצג התיעוד של 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

אבחון

  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
  • שם הפורטל למפתחים המשולב ב-Apigee Edge Cloud
  • שם מאגר המפתחות שנוצר בסביבת הפורטל
  • כינוי
  • שם דומיין מותאם אישית
  • צילום מסך של דף הגדרת הדומיין המותאם אישית, שבו מופיעה הודעת השגיאה
    •