Wyświetlasz dokumentację Apigee Edge.
Otwórz dokumentację
Apigee X. info
Krótki opis problemu
Podczas konfigurowania magazynu kluczy, aliasu i informacji o domenie w zintegrowanym portalu dla programistów użytkownicy otrzymują błąd Nieprawidłowa wartość hosta wirtualnego : Opublikuj > Portale > Portal dla programistów > Ustawienia > Domeny.
Komunikat o błędzie
Wyświetla się ten komunikat o błędzie:
Invalid virtual host value (id: <value>)
Komunikat o błędzie jest wyświetlany w interfejsie Edge w sposób pokazany poniżej:
Portals > Developer Portal > Settings > Domains" title="Domains">
Możliwe przyczyny
| Przyczyna | Opis | Instrukcje rozwiązywania problemów, których dotyczy |
|---|---|---|
| Podany łańcuch certyfikatów TLS nie jest w formacie PEM | Łańcuchy certyfikatów TLS używane w hostach wirtualnych muszą być w formacie PEM. Jeśli używany jest łańcuch certyfikatów TLS w formacie innym niż PEM, konfiguracja domeny niestandardowej się nie powiedzie. | Użytkownicy chmury publicznej Edge |
| Certyfikat i klucz TLS zostały podane w jednym pliku | Podczas przesyłania do magazynu kluczy łańcuch certyfikatów TLS i klucz prywatny muszą być podane w osobnych plikach. W przeciwnym razie konfiguracja domeny niestandardowej się nie powiedzie. | Użytkownicy chmury publicznej Edge |
Przyczyna: podany łańcuch certyfikatów TLS nie jest w formacie PEM
Diagnostyka
- Sprawdź, czy łańcuch certyfikatów TLS jest w formacie PEM.
- Jeśli dany łańcuch certyfikatów TLS nie jest w formacie PEM, spowoduje to niepowodzenie procesu tworzenia hosta wirtualnego w zintegrowanym portalu dla programistów. W rezultacie użytkownik zobaczy powyższy komunikat o błędzie na stronie konfiguracji domeny niestandardowej w interfejsie Edge.
Rozdzielczość
Jeśli stwierdzisz, że łańcuch certyfikatów TLS nie jest w formacie PEM, wykonaj te czynności, aby rozwiązać ten problem:
- Przekonwertuj łańcuch certyfikatów TLS na format PEM.
- Sprawdź, czy łańcuch certyfikatów TLS jest prawidłowy.
- Usuń dotychczasowy łańcuch certyfikatów TLS i klucz prywatny z danego magazynu kluczy.
- Prześlij plik zawierający łańcuch certyfikatów protokołu TLS w formacie PEM oraz plik zawierający klucz prywatny do magazynu kluczy za pomocą aliasu klucza w interfejsie Edge lub interfejsie API zarządzania Google Analytics.
- Skonfiguruj magazyn kluczy, alias i nazwę domeny w zintegrowanym portalu dla programistów: Opublikuj > Portale > Portal dla programistów > Ustawienia > Domeny.
- Kliknij Zapisz.
Przyczyna: certyfikat i klucz TLS zostały podane w jednym pliku
Diagnostyka
- Sprawdź, czy dany łańcuch certyfikatów TLS zawiera zarówno certyfikaty, jak i klucz prywatny w tym samym pliku przesłanym do magazynu kluczy.
- Otwórz oryginalny plik źródłowy w edytorze tekstu na komputerze, którego używasz do przesyłania łańcucha certyfikatów TLS i klucza prywatnego do magazynu kluczy Apigee.
-
Jeśli plik zawiera zarówno certyfikaty TLS, jak i klucz prywatny, każdy certyfikat TLS w łańcuchu certyfikatów zaczyna się od tego wiersza:
-----BEGIN CERTIFICATE-----i kończy się tym wierszem:
-----END CERTIFICATE-----Po certyfikatach TLS następuje klucz prywatny, który zaczyna się od tego wiersza:
-----BEGIN RSA PRIVATE KEY-----i kończy się tym wierszem:
-----END RSA PRIVATE KEY-----jak pokazano w tym przykładzie:
-----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-----
- Jeśli stwierdzisz, że łańcuch certyfikatów TLS i klucz prywatny zostały połączone w jednym pliku i przesłane do magazynu kluczy, jest to przyczyną niepowodzenia tworzenia hosta wirtualnego w zintegrowanym portalu dla programistów. W rezultacie użytkownik zobaczy powyższy komunikat o błędzie na stronie konfiguracji domeny niestandardowej w interfejsie Edge.
Rozdzielczość
Jeśli plik PEM certyfikatu TLS zawierał zarówno certyfikaty TLS, jak i klucz prywatny, wykonaj poniższe czynności, aby rozwiązać ten problem:
- Przenieś klucz prywatny z pliku PEM certyfikatu TLS do osobnego pliku klucza.
- Usuń dotychczasowy certyfikat TLS z danego magazynu kluczy.
- Sprawdź, czy łańcuch certyfikatów TLS jest w formacie PEM.
- Jeśli nie, przekonwertuj łańcuch certyfikatów TLS na format PEM.
- Sprawdź, czy łańcuch certyfikatów TLS jest prawidłowy.
- Prześlij plik zawierający łańcuch certyfikatów protokołu TLS przekonwertowany na format PEM oraz plik zawierający klucz prywatny do magazynu kluczy za pomocą aliasu klucza w interfejsie Edge lub interfejsie API zarządzania Google Analytics.
- Skonfiguruj magazyn kluczy, alias i nazwę domeny w zintegrowanym portalu dla programistów: Opublikuj > Portale > Portal dla programistów > Ustawienia > Domeny.
- Kliknij Zapisz.
Jeśli problem nadal występuje, przejdź do sekcji Informacje diagnostyczne, które należy zebrać.
Informacje diagnostyczne, które należy zebrać
Jeśli problem nadal występuje po wykonaniu powyższych instrukcji, zbierz te informacje diagnostyczne i udostępnij je zespołowi pomocy Apigee Edge:
- Nazwa organizacji w chmurze Apigee Edge
- Nazwa zintegrowanego portalu dla programistów w chmurze Apigee Edge
- Nazwa magazynu kluczy utworzonego w środowisku portalu
- Nazwa aliasu
- Nazwa domeny niestandardowej
- Zrzut ekranu ze strony konfiguracji domeny niestandardowej, na którym widoczny jest komunikat o błędzie