Fehler beim Konfigurieren der benutzerdefinierten Domain mit ungültigem Fehler beim virtuellen Host im integrierten Entwicklerportal

<ph type="x-smartling-placeholder"></ph> Sie sehen die Dokumentation zu Apigee Edge.
Gehen Sie zur Apigee X-Dokumentation. Weitere Informationen

Symptom

Nutzer erhalten bei der Konfiguration der Funktion die Fehlermeldung Ungültiger virtueller Hostwert. Keystore, Alias und Domaininformationen für ein integriertes Entwicklerportal: Veröffentlichen > Portale > Entwicklerportal > Einstellungen > Domains.

Fehlermeldung

Die folgende Fehlermeldung wird angezeigt: 

Invalid virtual host value (id: <value>)

Die Fehlermeldung wird in der Edge-Benutzeroberfläche wie unten dargestellt angezeigt:

Portale > Entwicklerportal > Einstellungen > Domains“ title="Domains">

Mögliche Ursachen

Ursache Beschreibung Anleitungen zur Fehlerbehebung gelten für
Die angegebene TLS-Zertifikatskette liegt nicht im PEM-Format vor. TLS-Zertifikatsketten, die in virtuellen Hosts verwendet werden, müssen im PEM-Format vorliegen. Wenn ein TLS-Zertifikat im Nicht-PEM-Format verwendet wird, schlägt die Konfiguration der benutzerdefinierten Domain fehl. Edge Public Cloud-Nutzer
TLS-Zertifikat und -Schlüssel wurden in einer einzigen Datei bereitgestellt Die TLS-Zertifikatskette und der private Schlüssel müssen beim Hochladen in den keystore. Andernfalls schlägt die Konfiguration der benutzerdefinierten Domain fehl. Edge Public Cloud-Nutzer

Ursache: Die angegebene TLS-Zertifikatskette liegt nicht im PEM-Format vor.

Diagnose

  1. <ph type="x-smartling-placeholder"></ph> Prüfen Sie, ob die TLS-Zertifikatskette im PEM-Format vorliegt. <ph type="x-smartling-placeholder">
  2. Liegt die TLS-Zertifikatskette nicht im PEM-Format vor, führt dies dazu, dass die virtuelle im integrierten Entwicklerportal nicht möglich ist. Daher wird der obige Fehler wird dem Nutzer auf der Konfigurationsseite der Edge-Benutzeroberfläche auf der Konfigurationsseite der benutzerdefinierten Domain angezeigt.

Auflösung

Wenn die TLS-Zertifikatskette nicht im PEM-Format vorliegt, führen Sie den die folgenden Schritte, um das Problem zu beheben:

  1. <ph type="x-smartling-placeholder"></ph> TLS-Zertifikatskette in das PEM-Format konvertieren.
  2. Validieren, dass die TLS-Zertifikatskette gültig ist.
  3. Entfernen Sie die vorhandene TLS-Zertifikatskette und den privaten Schlüssel aus dem jeweiligen Schlüsselspeicher.
  4. Laden Sie die Datei mit der TLS-Zertifikatskette im PEM-Format und die Datei mit den privaten Schlüssel für den Schlüsselspeicher mithilfe eines Schlüsselalias in der Edge-Benutzeroberfläche oder der Management API verwenden.
  5. Konfigurieren Sie den Schlüsselspeicher, den Alias und den Domainnamen im integrierten Entwicklerportal: Veröffentlichen > Portale > Entwicklerportal > Einstellungen > Domains.
  6. Klicken Sie auf Speichern.

Ursache: TLS-Zertifikat und ‐Schlüssel wurden in einer einzigen Datei angegeben

Diagnose

  1. Prüfen Sie, ob die angegebene TLS-Zertifikatskette sowohl die Zertifikate als auch den privaten Schlüssel in in den Schlüsselspeicher hochgeladen.
  2. Sehen Sie sich die ursprüngliche Quelldatei in einem Texteditor auf Ihrem System an, mit dem Sie das TLS hochgeladen haben und den privaten Schlüssel zum Apigee-Schlüsselspeicher hinzufügen.

  3. Wenn die Datei sowohl die TLS-Zertifikate als auch den privaten Schlüssel enthält, hat jedes TLS-Zertifikat in der Zertifikatskette beginnt mit der folgenden Zeile:

    -----BEGIN CERTIFICATE-----

    und endet mit der folgenden Zeile:

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

    Auf die TLS-Zertifikate folgt der private Schlüssel, der mit der folgenden Zeile beginnt:

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

    und endet mit der folgenden Zeile:

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

    wie das folgende Beispiel zeigt:

    -----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. Wenn Sie feststellen, dass die TLS-Zertifikatskette und der private Schlüssel alle in einem einzigen und in den Schlüsselspeicher hochgeladen werden, schlägt die Erstellung des virtuellen Hosts fehl. im integrierten Entwicklerportal. Daher wird die obige Fehlermeldung Nutzer auf der Konfigurationsseite der benutzerdefinierten Domain in der Edge-Benutzeroberfläche.

Auflösung

Wenn die PEM-Datei mit dem TLS-Zertifikat sowohl die TLS-Zertifikate als auch den privaten Schlüssel enthält, führen Sie folgende Schritte aus: die folgenden Schritte, um das Problem zu beheben:

  1. Verschieben Sie den privaten Schlüssel aus der PEM-Datei mit dem TLS-Zertifikat in eine separate Schlüsseldatei.
  2. Entfernen Sie das vorhandene TLS-Zertifikat aus dem jeweiligen Schlüsselspeicher.
  3. <ph type="x-smartling-placeholder"></ph> Prüfen Sie, ob die TLS-Zertifikatskette im PEM-Format vorliegt.
  4. Ist dies nicht der Fall, TLS-Zertifikatskette in das PEM-Format konvertieren.
  5. Validieren, dass die TLS-Zertifikatskette gültig ist.
  6. Laden Sie die Datei mit der in das PEM-Format konvertierten TLS-Zertifikatskette sowie die Datei hoch mit dem privaten Schlüssel für den Schlüsselspeicher mithilfe eines Schlüsselalias in der Edge-Benutzeroberfläche oder der Management API
  7. Konfigurieren Sie den Schlüsselspeicher, den Alias und den Domainnamen im integrierten Entwicklerportal: Veröffentlichen > Portale > Entwicklerportal > Einstellungen > Domains.
  8. Klicken Sie auf Speichern.

Wenn das Problem weiterhin besteht, gehen Sie zu Erfassen von Diagnoseinformationen erforderlich.

Erfassen von Diagnoseinformationen erforderlich

Wenn das Problem weiterhin besteht, nachdem Sie die Schritte oben ausgeführt haben, führen Sie folgende Diagnosen aus: Informationen und geben Sie diese an den Apigee Edge-Support weiter:

  • Name der Apigee Edge Cloud-Organisation
  • Name des integrierten Entwicklerportals von Apigee Edge Cloud
  • Name des in der Portalumgebung erstellten Schlüsselspeichers
  • Alias name
  • Name der benutzerdefinierten Domain
  • Screenshot der Konfigurationsseite der benutzerdefinierten Domain mit der Fehlermeldung
    •