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
- Xác minh rằng chuỗi chứng chỉ TLS ở định dạng PEM.
- 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:
- Chuyển đổi chuỗi chứng chỉ TLS sang định dạng PEM.
- Xác thực rằng chuỗi chứng chỉ TLS là hợp lệ.
- Xoá chuỗi chứng chỉ TLS hiện có và khoá riêng tư khỏi kho khoá cụ thể.
- 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.
- Đị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.
- 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
- 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á.
- 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.
-
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-----
- 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 đề:
- 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.
- Xoá chứng chỉ TLS hiện có khỏi kho khoá cụ thể.
- Xác minh rằng chuỗi chứng chỉ TLS ở định dạng PEM.
- Nếu không, hãy chuyển đổi chuỗi chứng chỉ TLS sang định dạng PEM.
- Xác thực rằng chuỗi chứng chỉ TLS là hợp lệ.
- 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.
- Đị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.
- 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