การกําหนดค่าโดเมนที่กําหนดเองล้มเหลวโดยมีข้อผิดพลาดโฮสต์เสมือนที่ไม่ถูกต้องในพอร์ทัลนักพัฒนาซอฟต์แวร์ที่ผสานรวม

คุณกำลังดูเอกสารประกอบของ Apigee Edge
ไปที่ เอกสารประกอบของ Apigee X
info

ลักษณะปัญหา

ผู้ใช้ได้รับข้อผิดพลาด ค่าโฮสต์เสมือนไม่ถูกต้อง ขณะกำหนดค่า คีย์สโตร์ ชื่อแทน และข้อมูลโดเมนสำหรับพอร์ทัลนักพัฒนาแอปแบบผสานรวม โดยไปที่ เผยแพร่ > พอร์ทัล > พอร์ทัลนักพัฒนาแอป > การตั้งค่า > โดเมน

ข้อความแสดงข้อผิดพลาด

ข้อความแสดงข้อผิดพลาดต่อไปนี้จะปรากฏขึ้น

Invalid virtual host value (id: <value>)

ข้อความแสดงข้อผิดพลาดจะปรากฏใน UI ของ Edge ดังที่แสดงด้านล่าง

Portals > Developer Portal > Settings > Domains" title="Domains">

สาเหตุที่เป็นไปได้

สาเหตุ คำอธิบาย วิธีการแก้ปัญหาที่ใช้ได้กับ
เชนใบรับรอง TLS ที่ระบุไม่ได้อยู่ในรูปแบบ PEM เชนใบรับรอง TLS ที่ใช้ในโฮสต์เสมือนต้องอยู่ในรูปแบบ PEM หากใช้เชนใบรับรอง TLS ในรูปแบบที่ไม่ใช่ PEM การกำหนดค่าโดเมนที่กำหนดเองจะล้มเหลว ผู้ใช้ Edge Public Cloud
ระบุใบรับรองและคีย์ TLS ในไฟล์เดียว ต้องระบุเชนใบรับรอง TLS และคีย์ส่วนตัวในไฟล์แต่ละไฟล์เมื่ออัปโหลดไปยัง คีย์สโตร์ ไม่เช่นนั้น การกำหนดค่าโดเมนที่กำหนดเองจะล้มเหลว ผู้ใช้ Edge Public Cloud

สาเหตุ: เชนใบรับรอง TLS ที่ระบุไม่ได้อยู่ในรูปแบบ PEM

การวินิจฉัย

  1. ตรวจสอบว่าเชนใบรับรอง TLS อยู่ในรูปแบบ PEM
  2. หากเชนใบรับรอง TLS ที่เฉพาะเจาะจงไม่ได้อยู่ในรูปแบบ PEM ก็จะทำให้กระบวนการสร้างโฮสต์เสมือนล้มเหลวในพอร์ทัลนักพัฒนาซอฟต์แวร์แบบผสานรวม ด้วยเหตุนี้ ผู้ใช้จึงเห็นข้อความแสดงข้อผิดพลาดข้างต้น ในหน้าการกำหนดค่าโดเมนที่กำหนดเองของ UI ของ Edge

ความละเอียด

หากคุณตรวจสอบแล้วว่าเชนใบรับรอง TLS ไม่ได้อยู่ในรูปแบบ PEM ให้ทำตามขั้นตอนต่อไปนี้เพื่อแก้ไขปัญหานี้

  1. แปลงเชนใบรับรอง TLS เป็นรูปแบบ PEM.
  2. ตรวจสอบว่า เชนใบรับรอง TLS ใช้ได้
  3. นำเชนใบรับรอง TLS และคีย์ส่วนตัวที่มีอยู่ออกจากคีย์สโตร์ที่เฉพาะเจาะจง
  4. อัปโหลดไฟล์ที่มีเชนใบรับรอง TLS ในรูปแบบ PEM และไฟล์ที่มี คีย์ส่วนตัวไปยังคีย์สโตร์โดยใช้ชื่อแทนคีย์ใน UI ของ 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 และคีย์ส่วนตัวรวมกันอยู่ในไฟล์เดียวและอัปโหลดไปยังคีย์สโตร์ นั่นคือสาเหตุที่ทำให้การสร้างโฮสต์เสมือนล้มเหลวในพอร์ทัลนักพัฒนาซอฟต์แวร์แบบผสานรวม ด้วยเหตุนี้ ผู้ใช้จึงเห็นข้อความแสดงข้อผิดพลาดข้างต้นในหน้าการกำหนดค่าโดเมนที่กำหนดเองใน UI ของ Edge

ความละเอียด

หากไฟล์ PEM ของใบรับรอง TLS มีทั้งใบรับรอง TLS และคีย์ส่วนตัว ให้ทำ ตามขั้นตอนต่อไปนี้เพื่อแก้ไขปัญหา

  1. ย้ายคีย์ส่วนตัวจากไฟล์ PEM ของใบรับรอง TLS ไปยังไฟล์คีย์แยกต่างหาก
  2. นำใบรับรอง TLS ที่มีอยู่ออกจากคีย์สโตร์ที่เฉพาะเจาะจง
  3. ตรวจสอบว่าเชนใบรับรอง TLS อยู่ในรูปแบบ PEM
  4. หากไม่ใช่ ให้แปลงเชนใบรับรอง TLS เป็นรูปแบบ PEM
  5. ตรวจสอบว่า เชนใบรับรอง TLS ใช้ได้
  6. อัปโหลดไฟล์ที่มีเชนใบรับรอง TLS ที่แปลงเป็นรูปแบบ PEM และไฟล์ ที่มีคีย์ส่วนตัวไปยังคีย์สโตร์โดยใช้ชื่อแทนคีย์ใน UI ของ Edge หรือ Management API
  7. กำหนดค่าคีย์สโตร์ ชื่อแทน และชื่อโดเมนในพอร์ทัลนักพัฒนาแอปแบบผสานรวม: เผยแพร่ > พอร์ทัล > พอร์ทัลนักพัฒนาแอป > การตั้งค่า > โดเมน
  8. คลิกบันทึก

หากยังพบปัญหาอยู่ ให้ไปที่ ข้อมูลการวินิจฉัยที่ต้องรวบรวม

ข้อมูลการวินิจฉัยที่ต้องรวบรวม

หากยังพบปัญหาอยู่หลังจากทำตามวิธีการข้างต้นแล้ว ให้รวบรวมข้อมูลการวินิจฉัยต่อไปนี้ และแชร์กับ ทีมสนับสนุนของ Apigee Edge

  • ชื่อองค์กร Apigee Edge Cloud
  • ชื่อพอร์ทัลนักพัฒนาซอฟต์แวร์แบบผสานรวมของ Apigee Edge Cloud
  • ชื่อคีย์สโตร์ที่สร้างในสภาพแวดล้อมพอร์ทัล
  • ชื่อแทน
  • ชื่อโดเมนที่กำหนดเอง
  • ภาพหน้าจอของหน้าการกำหนดค่าโดเมนที่กำหนดเองซึ่งแสดงข้อความแสดงข้อผิดพลาด
  •