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.
Chuyển đến tài liệu về Apigee X.
thông tin

Triệu chứng

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 kho khoá, bí danh và thông tin miền cho cổng thông tin tích hợp cho nhà phát triển: Xuất bản > Cổng thông tin > 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 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ư dưới đây:

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

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

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

Độ phân giải

Nếu bạn đã chắc chắn rằng chuỗi chứng chỉ TLS không ở định dạng PEM, hãy làm theo 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ư cho kho khoá bằng cách sử dụng bí danh khoá trong giao diện người dùng Edge hoặc API Quản lý.
  5. Định cấu hình kho khoá, bí danh và tên miền trong cổng thông tin tích hợp cho nhà phát triển: Phát hành > Cổng thông tin > Cổng 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 (Bảo mật tầng truyền tải) đượ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 đã cấp có 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 bằng trình chỉnh sửa văn bản trên hệ thống của bạn. Tệp này đã được 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-----

    Theo sau chứng chỉ TLS 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 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 chắc chắn rằng chuỗi chứng chỉ TLS (Bảo mật tầng truyền tải) và khoá riêng tư đều được kết hợp trong một tệp duy nhất và được tải lên kho khoá, thì đó là nguyên nhân khiến việc 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 ở trên sẽ hiển thị 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 của 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 của chứng chỉ TLS và chuyển sang một tệp khoá riêng.
  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 được chuyển đổi sang định dạng PEM và tệp chứa khoá riêng tư cho kho khoá bằng cách sử dụng bí danh khoá trong giao diện người dùng Edge hoặc API Quản lý.
  7. Định cấu hình kho khoá, bí danh và tên miền trong cổng thông tin tích hợp cho nhà phát triển: Phát hành > Cổng thông tin > Cổng 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 sự cố vẫn tiếp diễn sau khi 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:

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