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

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

  1. Sprawdź, czy łańcuch certyfikatów TLS jest w formacie PEM.
  2. 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:

  1. Przekonwertuj łańcuch certyfikatów TLS na format PEM.
  2. Sprawdź, czy łańcuch certyfikatów TLS jest prawidłowy.
  3. Usuń dotychczasowy łańcuch certyfikatów TLS i klucz prywatny z danego magazynu kluczy.
  4. 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.
  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 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. 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.
  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ę 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-----
  4. 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:

  1. Przenieś klucz prywatny z pliku PEM certyfikatu TLS do osobnego pliku klucza.
  2. Usuń dotychczasowy certyfikat TLS z danego 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 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.
  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 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
  •