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

Sie lesen gerade die Dokumentation zu Apigee Edge.
Zur Dokumentation zu Apigee X. info

Symptom

Nutzer erhalten den Fehler Invalid virtual host value (Ungültiger Wert für virtuellen Host), wenn sie die Informationen zu Keystore, Alias und Domain für ein integriertes Entwicklerportal konfigurieren: Publish > Portals > Developer Portal > Settings > Domains (Veröffentlichen > Portale > Entwicklerportal > Einstellungen > Domains).

Fehlermeldung

Die folgende Fehlermeldung wird angezeigt:

Invalid virtual host value (id: <value>)

Die Fehlermeldung wird in der Edge-UI wie unten dargestellt angezeigt:

Portals > Developer Portal > Settings > Domains" title="Domains">

Mögliche Ursachen

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

Diagnose

1. Prüfen Sie, ob die TLS-Zertifikatskette im PEM-Format vorliegt.
2. Wenn die spezifische TLS-Zertifikatskette nicht im PEM-Format vorliegt, schlägt die Erstellung des virtuellen Hosts im integrierten Entwicklerportal fehl. Daher wird dem Nutzer die oben genannte Fehlermeldung auf der Konfigurationsseite für benutzerdefinierte Domains der Edge-UI angezeigt.

Auflösung

Wenn Sie festgestellt haben, dass die TLS-Zertifikatskette nicht im PEM-Format vorliegt, führen Sie die folgenden Schritte aus, um dieses Problem zu beheben:

1. Konvertieren Sie die TLS-Zertifikatskette in das PEM-Format.
2. Prüfen Sie, ob die TLS-Zertifikatskette gültig ist.
3. Entfernen Sie die vorhandene TLS-Zertifikatskette und den privaten Schlüssel aus dem jeweiligen Keystore.
4. Laden Sie die Datei mit der TLS-Zertifikatskette im PEM-Format und die Datei mit dem privaten Schlüssel über einen Alias in der Edge-UI oder der Management API in den Keystore hoch.
5. Konfigurieren Sie den Keystore, den Alias und den Domainnamen im integrierten Entwicklerportal: Publish > Portals > Developer Portal > Settings > Domains (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 derselben Datei enthält, die in den Keystore hochgeladen wurde.
2. Sehen Sie sich die ursprüngliche Quelldatei in einem Texteditor auf Ihrem System an, mit der Sie die TLS Zertifikatskette und den privaten Schlüssel in den Apigee-Keystore hochgeladen haben.

3. Wenn die Datei sowohl die TLS-Zertifikate als auch den privaten Schlüssel enthält, beginnt jedes TLS-Zertifikat in der Zertifikatskette 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 im folgenden Beispiel gezeigt:

   -----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 in einer einzigen Datei kombiniert und in den Keystore hochgeladen wurden, ist dies die Ursache dafür, dass die Erstellung des virtuellen Hosts im integrierten Entwicklerportal fehlschlägt. Daher wird dem Nutzer die oben genannte Fehlermeldung auf der Konfigurationsseite für benutzerdefinierte Domains der Edge-UI angezeigt.

Auflösung

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

1. Verschieben Sie den privaten Schlüssel aus der PEM-Datei des TLS-Zertifikats in eine separate Schlüsseldatei.
2. Entfernen Sie das vorhandene TLS-Zertifikat aus dem jeweiligen Keystore.
3. Prüfen Sie, ob die TLS-Zertifikatskette im PEM-Format vorliegt.
4. Wenn nicht, konvertieren Sie die TLS-Zertifikatskette in das PEM-Format.
5. Prüfen Sie, ob die TLS-Zertifikatskette gültig ist.
6. Laden Sie die Datei mit der in das PEM-Format konvertierten TLS-Zertifikatskette und die Datei mit dem privaten Schlüssel über einen Alias in der Edge-UI oder der Management API in den Keystore hoch.
7. Konfigurieren Sie den Keystore, den Alias und den Domainnamen im integrierten Entwicklerportal: Publish > Portals > Developer Portal > Settings > Domains (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 nach Befolgen der obigen Anweisungen weiterhin besteht, erfassen Sie die folgenden Diagnose informationen und teilen Sie sie dem Apigee Edge-Support mit:

• Name der Apigee Edge Cloud-Organisation
• Name des integrierten Entwicklerportals von Apigee Edge Cloud
• Name des in der Portalumgebung erstellten Keystores
• Alias name
• Benutzerdefinierter Domainname
• Screenshot der Konfigurationsseite für benutzerdefinierte Domains mit der Fehlermeldung