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.
Otwórz dokumentację Apigee X. Informacje

Krótki opis problemu

Podczas konfigurowania magazynu kluczy, aliasu i domeny dla zintegrowanego portalu dla programistów użytkownicy widzą błąd Nieprawidłowa wartość hosta wirtualnego: Opublikuj > Portale > Portal dla programistów > Ustawienia > Domeny.

Komunikat o błędzie

Wyświetlany jest ten komunikat o błędzie: 

Invalid virtual host value (id: <value>)

Komunikat o błędzie jest wyświetlany w interfejsie Edge w ten 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 zostanie użyty łańcuch certyfikatów TLS w formacie innym niż PEM, konfiguracja domeny niestandardowej nie powiedzie się. Użytkownicy Edge Public Cloud
Certyfikat i klucz TLS zostały udostępnione w jednym pliku Podczas przesyłania do magazynu kluczy łańcuch certyfikatów TLS i klucz prywatny muszą być podane w poszczególnych plikach. W przeciwnym razie konfiguracja domeny niestandardowej nie powiedzie się. Użytkownicy Edge Public Cloud

Przyczyna: podany łańcuch certyfikatów TLS nie ma formatu 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, spowoduje to błąd procesu tworzenia hosta wirtualnego 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 użytkownika Edge.

Rozdzielczość

Jeśli masz pewność, że łańcuch certyfikatów TLS nie jest w formacie PEM, wykonaj te 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 oraz plik zawierający klucz prywatny do magazynu kluczy, korzystając z aliasu klucza w interfejsie użytkownika Edge lub interfejsie Management API.
  5. Skonfiguruj magazyn kluczy, alias i nazwę domeny w zintegrowanym portalu dla programistów: Publikowanie > Portale > Portal dla programistów > Ustawienia > Domeny.
  6. Kliknij Zapisz.

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

Diagnostyka

  1. 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.
  2. Wyświetl oryginalny plik źródłowy w edytorze tekstu w systemie, który został użyty do przesłania łańcucha certyfikatów TLS 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 rozpoczynający się następującym wierszem:

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

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

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

    jak 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-----
  4. Jeśli masz pewność, że łańcuch certyfikatów TLS i klucz prywatny zostały połączone w 1 pliku i przesłane do magazynu kluczy, jest to przyczyną niepowodzenia tworzenia hosta wirtualnego 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 użytkownika Edge.

Rozdzielczość

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

  1. Przenieś klucz prywatny z pliku PEM certyfikatu TLS i do osobnego pliku kluczy.
  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, przekonwertuj ł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, korzystając z aliasu klucza w interfejsie użytkownika Edge lub interfejsie Management API.
  7. Skonfiguruj magazyn kluczy, alias i nazwę domeny w zintegrowanym portalu dla programistów: Publikowanie > Portale > Portal dla programistów > Ustawienia > Domeny.
  8. Kliknij Zapisz.

Jeśli problem nadal występuje, przejdź do artykułu Wymagane jest zebranie informacji diagnostycznych.

Musisz zebrać informacje diagnostyczne

Jeśli po wykonaniu powyższych instrukcji problem będzie nadal występował, zbierz poniższe informacje diagnostyczne i udostępnij je zespołowi pomocy Apigee Edge:

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