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