Nie udało się skonfigurować domeny niestandardowej z powodu błędu nieprawidłowego hosta wirtualnego w zintegrowanym portalu dla programistów

Przeglądasz dokumentację Apigee Edge.
Przejdź do Dokumentacja Apigee X. informacje.

Krótki opis problemu

Użytkownicy otrzymują błąd Nieprawidłowa wartość hosta wirtualnego podczas konfigurowania magazyn kluczy, aliasy i informacje o domenie zintegrowanego portalu dla programistów: Opublikuj > Portale > Portal dla programistów > Ustawienia > Domeny.

Komunikat o błędzie

Wyświetlany jest następujący komunikat o błędzie: 

Invalid virtual host value (id: <value>)

Komunikat o błędzie wyświetla się w interfejsie Edge w następujący sposób:

Portale > Portal dla programistów > Ustawienia > Domeny title="Domeny">

Możliwe przyczyny

Przyczyna Opis Instrukcje rozwiązywania problemów dotyczące
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 certyfikat TLS został użyty łańcuch w formacie innym niż PEM, konfiguracja domeny niestandardowej się nie uda. Użytkownicy Edge Public Cloud
Certyfikat TLS i klucz zostały dostarczone w jednym pliku Łańcuch certyfikatów TLS i klucz prywatny należy podać w osobnych plikach podczas przesyłania do do magazynu kluczy. W przeciwnym razie niestandardowa konfiguracja domeny się nie uda. Użytkownicy Edge Public Cloud

Przyczyna: podany łańcuch certyfikatów TLS nie jest w formacie PEM

Diagnostyka

  1. Sprawdź, czy łańcuch certyfikatów TLS jest w formacie PEM.
  2. Jeśli określony łańcuch certyfikatów TLS nie jest w formacie PEM, wywoła niepowodzenie procesu tworzenia hosta w zintegrowanym portalu dla programistów. Z tego powodu powyższy błąd jest wyświetlany użytkownikowi na stronie konfiguracji domeny niestandardowej w interfejsie Edge.

Rozdzielczość

Jeśli masz pewność, że łańcuch certyfikatów TLS nie jest w formacie PEM, wykonaj wykonaj następujące czynności, aby rozwiązać ten problem:

  1. Przekonwertuj łańcuch certyfikatów TLS na format PEM.
  2. Sprawdź, czy łańcuch certyfikatów TLS jest prawidłowy.
  3. Usuń istniejący łańcuch certyfikatów TLS i klucz prywatny z określonego magazynu kluczy.
  4. Prześlij plik zawierający łańcuch certyfikatów TLS w formacie PEM i plik zawierający prywatny klucz do magazynu kluczy za pomocą aliasu klucza w interfejsie Edge lub interfejsie Management API.
  5. Skonfiguruj magazyn kluczy, alias i nazwę domeny w zintegrowanym portalu dla programistów: Opublikuj > Portale > Portal dla programistów > Ustawienia > Domeny.
  6. Kliknij Zapisz.

Przyczyna: certyfikat i klucz TLS zostały przekazane w jednym pliku

Diagnostyka

  1. Sprawdź, czy dany łańcuch certyfikatów TLS zawiera zarówno certyfikaty, jak i klucz prywatny ten sam plik przesłany do magazynu kluczy.
  2. Wyświetl oryginalny plik źródłowy w edytorze tekstu w systemie, który został użyty do przesłania protokołu TLS łańcucha certyfikatów i klucza prywatnego do magazynu kluczy Apigee.

  3. 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ę następującym wierszem:

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

    Po certyfikatach TLS znajduje się klucz prywatny, który zaczyna się od tego wiersza:

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

    i kończy się następującym wierszem:

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

    co widać w następnym 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-----
  4. Jeśli masz pewność, że łańcuch certyfikatów TLS i klucz prywatny są połączone w jednym i przesłanego do magazynu kluczy, wówczas utworzenie hosta wirtualnego nie działa w zintegrowanym portalu dla programistów. W związku z tym powyższy komunikat o błędzie jest wyświetlany na stronie konfiguracji domeny niestandardowej w interfejsie Edge.

Rozdzielczość

Jeśli plik PEM certyfikatu TLS zawierał zarówno certyfikaty TLS, jak i klucz prywatny, zrób to wykonaj te czynności, by rozwiązać problem:

  1. Przenieś klucz prywatny z pliku PEM certyfikatu TLS do osobnego pliku klucza.
  2. Usuń istniejący certyfikat TLS z określonego magazynu kluczy.
  3. Sprawdź, czy łańcuch certyfikatów TLS jest w formacie PEM.
  4. Jeśli nie, przekonwertować łańcuch certyfikatów TLS na format PEM.
  5. Sprawdź, czy łańcuch certyfikatów TLS jest prawidłowy.
  6. Prześlij plik zawierający łańcuch certyfikatów TLS przekonwertowany na format PEM oraz plik zawierający klucz prywatny do magazynu kluczy przy użyciu aliasu klucza w interfejsie Edge lub Interfejs API zarządzania Google Analytics.
  7. Skonfiguruj magazyn kluczy, alias i nazwę domeny w zintegrowanym portalu dla programistów: Opublikuj > Portale > Portal dla programistów > Ustawienia > Domeny.
  8. Kliknij Zapisz.

Jeśli problem będzie nadal występował, wejdź na Wymagane jest zbieranie informacji diagnostycznych.

Musi zbierać informacje diagnostyczne

Jeśli po wykonaniu powyższych czynności problem nie ustąpi, przeprowadź następujące czynności diagnostyczne i udostępniać je zespołowi pomocy Apigee Edge:

  • Nazwa organizacji Apigee Edge Cloud
  • Nazwa portalu dla deweloperów zintegrowanego z Apigee Edge Cloud
  • Nazwa magazynu kluczy utworzonego w środowisku portalu
  • Nazwa aliasu
  • Nazwa domeny niestandardowej
  • Zrzut ekranu strony konfiguracji domeny niestandardowej, na której jest widoczny komunikat o błędzie
    •