Không định cấu hình được miền tùy chỉnh do lỗi máy chủ ảo không hợp lệ trong cổng thông tin nhà phát triển tích hợp

Bạn đang xem tài liệu về Apigee Edge.
Truy cập vào tài liệu Apigee X.
thông tin

Dấu hiệu

Người dùng gặp lỗi Giá trị máy chủ ảo không hợp lệ khi định cấu hình thông tin về kho khoá, bí danh và miền cho một cổng nhà phát triển tích hợp: Xuất bản > Cổng > Cổng nhà phát triển > Cài đặt > Miền.

Thông báo lỗi

Thông báo lỗi sau đây sẽ xuất hiện:

Invalid virtual host value (id: <value>)

Thông báo lỗi xuất hiện trong giao diện người dùng Edge như minh hoạ dưới đây:

Cổng > Cổng dành cho nhà phát triển > Cài đặt > Miền" title="Miền">

Các nguyên nhân có thể

Nguyên nhân Mô tả Hướng dẫn khắc phục sự cố áp dụng cho
Chuỗi chứng chỉ TLS được cung cấp không ở định dạng PEM Chuỗi chứng chỉ TLS được dùng trong máy chủ lưu trữ ảo phải ở định dạng PEM. Nếu bạn sử dụng chuỗi chứng chỉ TLS ở định dạng không phải PEM, thì cấu hình miền tuỳ chỉnh sẽ không thành công. Người dùng Edge Public Cloud
Khoá và chứng chỉ TLS được cung cấp trong một tệp Bạn cần cung cấp chuỗi chứng chỉ TLS và khoá riêng tư trong các tệp riêng lẻ khi tải lên kho khoá. Nếu không, bạn sẽ không thể định cấu hình miền tuỳ chỉnh. Người dùng Edge Public Cloud

Nguyên nhân: Chuỗi chứng chỉ TLS được cung cấp không ở định dạng PEM

Chẩn đoán

  1. Xác minh rằng chuỗi chứng chỉ TLS ở định dạng PEM.
  2. Nếu chuỗi chứng chỉ TLS cụ thể không ở định dạng PEM, thì quá trình tạo máy chủ lưu trữ ảo sẽ không thành công trong cổng thông tin cho nhà phát triển tích hợp. Do đó, thông báo lỗi nêu trên sẽ xuất hiện cho người dùng trên trang cấu hình miền tuỳ chỉnh của Giao diện người dùng Edge.

Độ phân giải

Nếu bạn xác định rằng chuỗi chứng chỉ TLS không ở định dạng PEM, hãy thực hiện các bước sau để giải quyết vấn đề này:

  1. Chuyển đổi chuỗi chứng chỉ TLS sang định dạng PEM.
  2. Xác thực rằng chuỗi chứng chỉ TLS là hợp lệ.
  3. Xoá chuỗi chứng chỉ TLS hiện có và khoá riêng tư khỏi kho khoá cụ thể.
  4. Tải tệp chứa chuỗi chứng chỉ TLS ở định dạng PEM và tệp chứa khoá riêng tư lên kho khoá bằng cách sử dụng bí danh khoá trong giao diện người dùng Edge hoặc Management API.
  5. Định cấu hình kho khoá, biệt hiệu và tên miền trong cổng thông tin nhà phát triển tích hợp: Xuất bản > Cổng thông tin > Cổng thông tin nhà phát triển > Cài đặt > Miền.
  6. Nhấp vào Lưu.

Nguyên nhân: Chứng chỉ và khoá TLS được cung cấp trong một tệp duy nhất

Chẩn đoán

  1. Xác minh rằng chuỗi chứng chỉ TLS đã cho chứa cả chứng chỉ và khoá riêng tư trong cùng một tệp được tải lên kho khoá.
  2. Xem tệp nguồn ban đầu trong một trình chỉnh sửa văn bản trên hệ thống mà bạn đã dùng để tải chuỗi chứng chỉ TLS và khoá riêng tư lên kho khoá Apigee.
  3. Nếu tệp chứa cả chứng chỉ TLS và khoá riêng tư, thì mỗi chứng chỉ TLS trong chuỗi chứng chỉ sẽ bắt đầu bằng dòng sau:

    -----BEGIN CERTIFICATE-----

    và kết thúc bằng dòng sau:

    -----END CERTIFICATE-----

    Chứng chỉ TLS theo sau là khoá riêng tư bắt đầu bằng dòng sau:

    -----BEGIN RSA PRIVATE KEY-----

    và kết thúc bằng dòng sau:

    -----END RSA PRIVATE KEY-----

    như ví dụ sau đây cho thấy:

    -----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. Nếu bạn xác định rằng chuỗi chứng chỉ TLS và khoá riêng tư đều được kết hợp trong một tệp duy nhất và tải lên kho khoá, thì đó là nguyên nhân khiến quá trình tạo máy chủ ảo không thành công trong cổng thông tin cho nhà phát triển tích hợp. Do đó, thông báo lỗi nêu trên sẽ xuất hiện cho người dùng trên trang cấu hình miền tuỳ chỉnh trên giao diện người dùng Edge.

Độ phân giải

Nếu tệp PEM chứng chỉ TLS chứa cả chứng chỉ TLS và khoá riêng tư, hãy thực hiện các bước sau để giải quyết vấn đề:

  1. Di chuyển khoá riêng tư từ tệp PEM chứng chỉ TLS sang một tệp khoá riêng biệt.
  2. Xoá chứng chỉ TLS hiện có khỏi kho khoá cụ thể.
  3. Xác minh rằng chuỗi chứng chỉ TLS ở định dạng PEM.
  4. Nếu không, hãy chuyển đổi chuỗi chứng chỉ TLS sang định dạng PEM.
  5. Xác thực rằng chuỗi chứng chỉ TLS là hợp lệ.
  6. Tải tệp chứa chuỗi chứng chỉ TLS đã chuyển đổi sang định dạng PEM và tệp chứa khoá riêng tư lên kho khoá bằng cách sử dụng bí danh khoá trong giao diện người dùng Edge hoặc Management API.
  7. Định cấu hình kho khoá, biệt hiệu và tên miền trong cổng thông tin nhà phát triển tích hợp: Xuất bản > Cổng thông tin > Cổng thông tin nhà phát triển > Cài đặt > Miền.
  8. Nhấp vào Lưu.

Nếu vấn đề vẫn tiếp diễn, hãy chuyển đến phần Phải thu thập thông tin chẩn đoán.

Phải thu thập thông tin chẩn đoán

Nếu vấn đề vẫn tiếp diễn sau khi bạn làm theo hướng dẫn ở trên, hãy thu thập thông tin chẩn đoán sau đây và chia sẻ với Nhóm hỗ trợ Apigee Edge:

  • Tên tổ chức Apigee Edge Cloud
  • Tên cổng thông tin cho nhà phát triển được tích hợp với Apigee Edge Cloud
  • Tên của kho khoá được tạo trong môi trường cổng thông tin
  • Tên email đại diện
  • Tên miền tuỳ chỉnh
  • Ảnh chụp màn hình trang định cấu hình miền tuỳ chỉnh, ghi lại thông báo lỗi
  •