Diese Seite wurde von der Cloud Translation API übersetzt.

Virtuelle Hosts konfigurieren

Sie sehen die Dokumentation zu Apigee Edge.
Zur Apigee X-Dokumentation weitere Informationen

Ein Cloud-Kunde mit einem kostenpflichtigen Konto und alle Edge for Private Cloud-Kunden können einen virtuellen Host in einer Organisation erstellen. Der Nutzer, der den virtuellen Host erstellt, muss die Rolle Organisationsadministrator oder eine benutzerdefinierte Rolle mit Berechtigungen zum Ändern eines virtuellen Hosts haben. Nutzer mit anderen Rollen sind nicht zum Erstellen virtueller Hosts autorisiert.

Sehen Sie sich ein Einführungsvideo zu virtuellen Hosts an.

Virtuellen Host erstellen

Erstellen Sie den virtuellen Host anhand des folgenden grundlegenden Verfahrens. Das tatsächlich verwendete Verfahren hängt davon ab, ob Sie Cloud- oder Private Cloud-Kunde sind und ob TLS aktiviert ist:

Erstellen Sie einen DNS-Eintrag und einen CNAME-Eintrag für Ihre öffentlich zugängliche Domain.
Hinweis: Private Cloud-Kunden können ohne DNS-Eintrag und CNAME-Eintrag einen virtuellen Host aus einer IP-Adresse erstellen. Weitere Informationen finden Sie unter Virtuelle Hosts für die Private Cloud konfigurieren.
Wenn Sie TLS auf dem virtuellen Host aktivieren:

Erstellen und konfigurieren Sie einen Schlüsselspeicher mit dem hier beschriebenen Verfahren: Schlüsselspeicher und Truststores.
Hinweis: Wenn Sie ein kostenpflichtiges Edge for Cloud-Konto und noch kein TLS-Zertifikat und keinen TLS-Schlüssel haben, können Sie einen virtuellen Host erstellen, der das kostenlose Apigee-Testzertifikat und den kostenlosen Apigee-Schlüssel verwendet. Weitere Informationen finden Sie unter Virtuelle Hosts für die Cloud konfigurieren.
Laden Sie Ihr Zertifikat und Ihren Schlüssel in den Schlüsselspeicher hoch. Achten Sie darauf, dass der in Ihrem Zertifikat angegebene Domainname mit dem Hostalias übereinstimmt, den Sie für den virtuellen Host verwenden möchten.
Erstellen Sie mithilfe der Edge-Benutzeroberfläche oder der API einen Verweis auf den Schlüsselspeicher. Der Verweis gibt den Namen des Schlüsselspeichers und den Referenztyp als KeyStore an. Weitere Informationen zum Erstellen und Ändern von Referenzen finden Sie unter Mit Referenzen arbeiten.
Wenn Sie Zwei-Wege-TLS ausführen, erstellen Sie einen Truststore, laden Sie das Zertifikat hoch und erstellen Sie einen Verweis auf den Truststore. Erstellen Sie den Truststore gemäß dem hier beschriebenen Verfahren: Schlüsselspeicher und Truststores.

Erstellen Sie den virtuellen Host mit der Create a Virtual Host API. Wenn Sie TLS aktivieren, müssen Sie die richtige Keystore-Referenz, Truststore-Referenz und den richtigen Schlüsselalias angeben.
Wenn Sie bereits API-Proxys haben, fügen Sie den virtuellen Host zu ProxyEndpoint hinzu. Der virtuelle Host wird automatisch allen neuen API-Proxys hinzugefügt. Siehe API-Proxy für die Verwendung eines virtuellen Hosts konfigurieren.

Achtung: Alle virtuellen Hosts werden automatisch allen neuen API-Proxys hinzugefügt. Wenn Sie daher einen neuen API-Proxy erstellen, der über einen bestimmten virtuellen Host nicht zugänglich sein soll, müssen Sie den API-Proxy bearbeiten, um diesen virtuellen Host aus seinem ProxyEndpoint zu entfernen.

Nachdem Sie einen API-Proxy aktualisiert, um den virtuellen Host zu verwenden, und den DNS-Eintrag und den CNAME-Eintrag für den Host-Alias erstellt haben, können Sie wie unten dargestellt auf den API-Proxy zugreifen:

https://api.myCompany.com/v1/project-base-path/resource-path

Beispiel:

https://api.myCompany.com/v1/weather/forecastrss?w=12797282

Virtuellen Host mithilfe der API oder Benutzeroberfläche erstellen

Sie können einen virtuellen Host mithilfe der Edge API oder der Edge-Benutzeroberfläche erstellen.

In den meisten der folgenden Beispiele wird die Edge API verwendet. So greifen Sie auf die Benutzeroberfläche zu, um virtuelle Hosts in der Edge-Benutzeroberfläche zu erstellen, zu ändern und zu löschen:

Melden Sie sich unter apigee.com/edge an.
Edge for Private Cloud-Kunden verwenden http://ms-ip:9000 (lokal), wobei ms-ip die IP-Adresse oder der DNS-Name des Verwaltungsserverknotens ist.
Wählen Sie in der linken Navigationsleiste Admin > Virtuelle Hosts aus.
Wählen Sie die Umgebung aus, z. B. prod oder test.
Die für die Umgebung definierten virtuellen Hosts werden angezeigt.
Wählen Sie + Virtueller Host aus, um einen virtuellen Host zu erstellen, oder wählen Sie den Namen eines vorhandenen virtuellen Hosts aus, um ihn zu bearbeiten.

Virtuellen Host für HTTP erstellen

Edge for Private Cloud-Kunden können mit HTTP einen virtuellen Host erstellen.

Wenn Sie einen virtuellen Host erstellen möchten, der TLS nicht unterstützt, erstellen Sie ein XML-Objekt, das den virtuellen Host definiert. Das folgende XML-Objekt definiert beispielsweise einen virtuellen Host, der das HTTP-Protokoll verwendet:

<VirtualHost name="myVHost">
   <HostAliases>
     <HostAlias>api.myCompany.com</HostAlias>
   </HostAliases>
   <Interfaces/>
   <Port>80</Port>
</VirtualHost>

In dieser Definition tun Sie Folgendes:

Geben Sie als Name myVHost an. Verwenden Sie den Namen, um auf den virtuellen Host in einem API-Proxy oder in einem API-Aufruf zu verweisen.
Geben Sie als Hostalias api.myCompany.com an. Dies ist die öffentlich zugängliche Domain, die gemäß der DNS-Definition und dem CNAME-Eintrag für den Zugriff auf Ihre APIs verwendet wird.
Geben Sie als port-Nummer 80 an. Wenn keine Angabe gemacht wird, wird der Port standardmäßig auf 443 festgelegt.
Es gibt zusätzliche Eigenschaften, die Sie im virtuellen Host festlegen können. Eine Referenz für alle Attribute finden Sie unter Referenz für virtuelle Hostattribute.

Wenn Sie bereits API-Proxys haben, fügen Sie den virtuellen Host dem <HTTPConnection>-Element im Proxy-Endpunkt hinzu. Der virtuelle Host wird automatisch allen neuen API-Proxys hinzugefügt. Siehe API-Proxy für die Verwendung eines virtuellen Hosts konfigurieren. Wenn Sie einen neuen API-Proxy erstellen, der über einen bestimmten virtuellen Host nicht zugänglich sein soll, müssen Sie den API-Proxy bearbeiten, um diesen virtuellen Host aus seinem ProxyEndpoint zu entfernen.

Sie können dann über diesen virtuellen Host auf einen API-Proxy zugreifen, indem Sie eine Anfrage an:

http://api.myCompany.com/proxy-base-path/resource-path
https://api.myCompany.com/proxy-base-path/resource-path

Erstellen Sie den virtuellen Host mithilfe der Create a Virtual Host API:

curl -X POST -H "Content-Type:application/xml" \
  http://ms-IP:8080/v1/o/org_name/environments/env_name/virtualhosts \
  -d '<VirtualHost name="myVHost">
        <HostAliases>
            <HostAlias>api.myCompany.com</HostAlias>
        </HostAliases>
        <Interfaces/>
        <Port>80</Port>
    </VirtualHost>' \
  -u sysAdminEmail:password

Hinweis: In Edge for Private Cloud führen Sie API-Aufrufe an den Domainnamen ms-ip:8080 aus, wobei ms-ip die IP-Adresse des Edge-Management-Servers ist. Edge für die Cloud-Kunden stellen Anfragen an die Domain api.enterprise.apigee.com

Virtuellen Host für One-Way-TLS erstellen

Das folgende XML-Objekt definiert einen virtuellen Host für One-Way-TLS:

<VirtualHost name="myTLSVHost">
    <HostAliases>
        <HostAlias>api.myCompany.com</HostAlias>
    </HostAliases>
    <Port>443</Port>
    <SSLInfo>
        <Enabled>true</Enabled>
        <ClientAuthEnabled>false</ClientAuthEnabled>
        <KeyStore>ref://myTestKeystoreRef</KeyStore>
        <KeyAlias>myKeyAlias</KeyAlias>
    </SSLInfo>
</VirtualHost>

In dieser Definition aktivieren Sie TLS. Dazu setzen Sie das Element <Enable> auf „true“ und verwenden die Elemente <KeyStore> und <KeyAliase>, um den von der TLS-Verbindung verwendeten Keystore und Schlüsselalias anzugeben.

Hinweis: Da Edge SSL ursprünglich unterstützt hat, heißt das Tag, mit dem Sie TLS konfigurieren, <SSLInfo>.

Weitere Informationen zur Verwendung von TLS finden Sie unter TLS/SSL.

Festlegen, wie der Schlüsselspeicher- und Truststore-Name im virtuellen Host angegeben werden

Wenn Sie einen virtuellen Host für die Unterstützung von TLS konfigurieren, geben Sie mithilfe einer Referenz einen Schlüsselspeicher an. Ein Verweis ist eine Variable, die den Namen des Schlüsselspeichers oder Truststores enthält, anstatt den Namen des Schlüsselspeichers oder Truststores wie unten dargestellt direkt anzugeben:

    <SSLInfo>
        <Enabled>true</Enabled>
        <ClientAuthEnabled>false</ClientAuthEnabled>
        <KeyStore>ref://myTestKeystoreRef</KeyStore>
        <KeyAlias>myKeyAlias</KeyAlias>
    </SSLInfo>

Der Vorteil eines Verweises besteht darin, dass Sie den Wert des Verweises ändern können, um den vom virtuellen Host verwendeten Schlüsselspeicher zu ändern. Dies liegt normalerweise daran, dass das Zertifikat im aktuellen Schlüsselspeicher in naher Zukunft abläuft. Zum Ändern des Referenzwerts müssen Sie den Edge Router nicht neu starten. Weitere Informationen zum Erstellen und Ändern von Referenzen finden Sie unter Mit Referenzen arbeiten.

Sie können nur einen Verweis auf den Schlüsselspeicher und Truststore verwenden. Sie können keinen Verweis auf den Alias verwenden. Wenn Sie den Verweis auf einen Schlüsselspeicher ändern, achten Sie darauf, dass der Aliasname des Zertifikats mit dem alten Schlüsselspeicher identisch ist.

Einschränkungen bei der Verwendung von Verweisen auf Schlüsselspeicher und Truststore

Beachten Sie die folgende Einschränkung, wenn Sie Verweise auf Schlüsselspeicher und Truststores verwenden:

Sie können Schlüsselspeicher- und Truststore-Referenzen nur in virtuellen Hosts verwenden, wenn Sie SNI unterstützen und SSL auf den Apigee-Routern beenden.
Wenn sich vor den Apigee-Routern ein Load-Balancer befindet und Sie TLS auf dem Load-Balancer beenden, können Sie keine Keystore- und Truststore-Verweise in virtuellen Hosts verwenden.

Virtuellen Host für Zwei-Wege-TLS erstellen

Legen Sie zum Aktivieren von Zwei-Wege-TLS das Element <ClientAuthEnabled> auf true fest und geben Sie einen Truststore an. Verwenden Sie dazu eine Referenz mit dem Element <TrustStore>. Der Truststore enthält den Zertifikatsaussteller des Clients und die erforderliche CA-Kette des Zertifikats. Außerdem muss der Client richtig für die Zwei-Wege-TLS-Konfiguration konfiguriert sein.

Um einen virtuellen Host für Zwei-Wege-TLS zu erstellen, erstellen Sie ein XML-Objekt, das den virtuellen Host definiert:

<VirtualHost name="myTLSVHost">
    <HostAliases>
        <HostAlias>api.myCompany.com</HostAlias>
    </HostAliases>
    <Port>443</Port>
    <SSLInfo>
        <Enabled>true</Enabled>
        <ClientAuthEnabled>true</ClientAuthEnabled>
        <KeyStore>ref://myTestKeystoreRef</KeyStore>
        <KeyAlias>myKeyAlias</KeyAlias>
        <TrustStore>ref://myTestTruststoreRef</TrustStore>
    </SSLInfo>
</VirtualHost>

In dieser Definition tun Sie Folgendes:

Aktivieren Sie die Zwei-Wege-TLS-Funktion, indem Sie <ClientAuthEnabled> auf „true“ setzen.
Geben Sie den Verweis auf den Truststore mit dem Element <TrustStore> an. Der Truststore enthält den Zertifikatsaussteller des Clients und die erforderliche CA-Kette des Zertifikats.

Weitere Informationen zur Verwendung von TLS finden Sie unter TLS/SSL.

Virtuellen Host ändern

Ein Cloud-Kunde mit einem kostenpflichtigen Konto und alle Edge for Private Cloud-Kunden können die Update a Virtual Host API verwenden, um einen virtuellen Host zu aktualisieren. Mit dieser API können Sie alle Eigenschaften für den virtuellen Host festlegen, der unter Referenz zu virtuellen Hosts beschrieben wird.

Aktualisieren Sie den virtuellen Host mithilfe der API zum Aktualisieren eines virtuellen Hosts. Wenn Sie die API verwenden, müssen Sie die vollständige Definition des virtuellen Hosts im Anfragetext angeben, nicht nur die Elemente, die Sie ändern möchten.

In diesem Beispiel legen Sie den Wert des Attributs proxy_read_timeout fest:

curl -X PUT -H "Content-Type:application/xml" \
    https://api.enterprise.apigee.com/v1/o/org_name/e/env_name/virtualhosts/vhost_name \
    -d '<VirtualHost  name="myTLSVHost">
         <HostAliases>
           <HostAlias>api.myCompany.com</HostAlias>
         </HostAliases>
         <Port>443</Port>
         <SSLInfo>
           <Enabled>true</Enabled>
           <ClientAuthEnabled>false</ClientAuthEnabled>
           <KeyStore>ref://myTestKeystoreRef</KeyStore>
           <KeyAlias>myKeyAlias</KeyAlias>
         </SSLInfo>
         <Properties>
           <Property name="proxy_read_timeout">50</Property>
         </Properties>
     </VirtualHost>' \
    -u orgAdminEmail:password

Virtuellen Host löschen

Bevor Sie einen virtuellen Host aus einer Umgebung löschen können, müssen Sie alle API-Proxys aktualisieren, die auf den virtuellen Host verweisen, um den Verweis zu entfernen. Weitere Informationen finden Sie unter API-Proxy für die Verwendung eines virtuellen Hosts konfigurieren.

Löschen Sie den virtuellen Host mithilfe der Delete a Virtual Host API:

curl -X DELETE \
  https://api.enterprise.apigee.com/v1/o/org_name/e/env_name/virtualhosts/vhost_name \
  -u orgAdminEmail:password

Informationen zu einem virtuellen Host ansehen

Sehen Sie sich Informationen zu den virtuellen Hosts an, die in einer Umgebung definiert sind, wie unten beschrieben.

Edge

So zeigen Sie Informationen zu einem virtuellen Host mithilfe der Edge-Benutzeroberfläche an:

Melden Sie sich unter apigee.com/edge an.
Edge for Private Cloud-Kunden verwenden http://ms-ip:9000 (lokal), wobei ms-ip die IP-Adresse oder der DNS-Name des Verwaltungsserverknotens ist.
Wählen Sie in der linken Navigationsleiste Admin > Virtual Hosts (Verwaltung > Virtuelle Hosts) aus.
Wählen Sie die Umgebung aus, z. B. prod oder test.
Die für die Umgebung definierten virtuellen Hosts werden angezeigt. Wenn der virtuelle Host für die Verwendung eines Schlüsselspeichers oder Truststores konfiguriert ist, klicken Sie auf Anzeigen, um weitere Informationen zu erhalten.

Wenn der virtuelle Host für die Verwendung von TLS/SSL konfiguriert ist, wird neben dem Namen des virtuellen Hosts ein Schlosssymbol angezeigt. Dies bedeutet, dass ein TLS/SSL-Zertifikat, ein Schlüssel und eine Zertifikatskette in Edge hochgeladen und mit dem virtuellen Host verknüpft wurden. So rufen Sie Informationen zu den verfügbaren Zertifikaten auf:

Wählen Sie in der linken Navigationsleiste Verwaltung > Umgebung > TLS-Schlüsselspeicher aus.
Wählen Sie die Umgebung aus (normalerweise prod oder test).
Maximieren Sie die Schlüsselspeicher, um das Zertifikat anzusehen.

Classic Edge (Private Cloud)

So zeigen Sie Informationen zu einem virtuellen Host mithilfe der Classic Edge-Benutzeroberfläche an:

Melden Sie sich bei http://ms-ip:9000 an, wobei ms-ip die IP-Adresse oder der DNS-Name des Knotens des Verwaltungsservers ist.
Wählen Sie in der linken Navigationsleiste Admin > Virtual Hosts (Verwaltung > Virtuelle Hosts) aus.
Wählen Sie die Umgebung aus, z. B. prod oder test.
Klicken Sie auf den Tab Virtuelle Hosts.
Die für die Umgebung definierten virtuellen Hosts werden angezeigt. Wenn der virtuelle Host für die Verwendung eines Schlüsselspeichers oder Truststores konfiguriert ist, klicken Sie auf Anzeigen, um weitere Informationen zu erhalten.

Wählen Sie in der oberen Navigationsleiste Admin > TLS-Zertifikate aus.
Wählen Sie die Umgebung aus (normalerweise prod oder test).
Maximieren Sie die Schlüsselspeicher, um das Zertifikat anzusehen.

Virtuellen Host mit der Edge API ansehen

Sie können auch die Edge-APIs verwenden, um Informationen zu virtuellen Hosts anzuzeigen. Die List Virtual Hosts API gibt beispielsweise eine Liste aller virtuellen Hosts zurück:

curl -X GET -H "accept:application/xml" \
    https://api.enterprise.apigee.com/v1/o/org_name/environments/env_name/virtualhosts \
    -u orgAdminEmail:pWord

Dabei ist orgAdminEmail:pWord der Nutzername und das Passwort des Organisationsadministrators und org_name/env_name geben die Organisation und die Umgebung an, die den virtuellen Host enthalten. Beispielantwort:

[
 "default",
 "secure"
]

Mit der Get Virtual Host API können Sie Informationen zu einem bestimmten virtuellen Host abrufen:

curl -X GET -H "accept:application/xml" \
    https://api.enterprise.apigee.com/v1/o/org_name/environments/env_name/virtualhosts/vhost_name \
    -u orgAdminEmail:pWord

Dabei ist vhost_name der Name des virtuellen Hosts. Sie können beispielsweise vhost_name als "sicher" angeben, um die Konfiguration des von Apigee erstellten sicheren virtuellen Standardhosts anzuzeigen:

<VirtualHost name="secure">
    <HostAliases>
        <HostAlias>api.myCompany.com</HostAlias>
    </HostAliases>
    <Port>443</Port>
    <Properties/>
    <Interfaces/>
    <RetryOptions/>
    <SSLInfo>
        <ClientAuthEnabled>false</ClientAuthEnabled>
        <Enabled>true</Enabled>
        <KeyAlias>freetrial</KeyAlias>
        <KeyStore>ref://freetrial</KeyStore>
        <IgnoreValidationErrors>false</IgnoreValidationErrors>
    </SSLInfo>
</VirtualHost>

Hinweis: Ersetzen Sie in Edge für Private Cloud den Domainnamen api.enterprise.apigee.com durch ms-ip:8080, wobei ms-ip die IP-Adresse des Edge-Management-Servers ist.

API-Proxy für die Verwendung eines virtuellen Hosts konfigurieren

Wenn Sie einen neuen API-Proxy erstellen, konfiguriert Edge ihn automatisch so, dass alle verfügbaren virtuellen Hosts in der Organisation verwendet werden. Eine Anfrage an einen API-Proxy über einen virtuellen Host verwendet das folgende Format:

https://host-alias/proxy-base-path/resource-path

Wobei:

host-alias ist in der Regel der DNS-Name des virtuellen Hosts.
proxy-base-path wird beim Erstellen eines API-Proxys definiert und ist für jeden API-Proxy eindeutig.
resource-path ist der Pfad zu einer Ressource, auf die über den API-Proxy zugegriffen werden kann.

Von einem API-Proxy verwendete virtuelle Hosts steuern

In der XML-Konfiguration eines API-Proxys verwenden Sie das Tag virtualhost, um den Namen des virtuellen Hosts anzugeben, der mit dem API-Proxy verknüpft ist:

<HTTPProxyConnection>
  <BasePath>/v1/my/proxy/basepath</BasePath>
  <VirtualHost>secure</VirtualHost>
  <VirtualHost>default</VirtualHost>
</HTTPProxyConnection>

<VirtualHost>secure</VirtualHost> bedeutet beispielsweise, dass ein Client den API-Proxy mithilfe des Hostalias des „sicheren“ virtuellen Hosts aufrufen kann.

In der Regel ändern Sie die mit einem API-Proxy verknüpften virtuellen Hosts in den folgenden Fällen:

Sie erstellen einen neuen virtuellen Host und haben vorhandene API-Proxys. Sie müssen alle vorhandenen API-Proxys bearbeiten, um den neuen virtuellen Host hinzuzufügen.
Sie erstellen einen neuen API-Proxy, der nicht über einen bestimmten virtuellen Host zugänglich sein soll. Sie müssen den API-Proxy bearbeiten, um diesen virtuellen Host aus seiner Definition zu entfernen.

So ändern Sie die mit einem API-Proxy verknüpften virtuellen Hosts:

Rufen Sie den API-Proxy-Editor wie unten beschrieben auf.
Edge

So greifen Sie über die Edge-Benutzeroberfläche auf den API-Proxy-Editor zu:
1. Melden Sie sich unter apigee.com/edge an.
  Edge for Private Cloud-Kunden verwenden http://ms-ip:9000 (lokal), wobei ms-ip die IP-Adresse oder der DNS-Name des Verwaltungsserverknotens ist.
2. Wählen Sie in der linken Navigationsleiste Develop > API Proxy (Entwickeln > API-Proxys) aus.
3. Wählen Sie in der Liste den API-Proxy aus, den Sie bearbeiten möchten.
Classic Edge (Private Cloud)

Hinweis: Die Classic Edge-Benutzeroberfläche ist nur mit Edge für Private Cloud verfügbar.

So greifen Sie über die Classic Edge-Benutzeroberfläche auf den API-Proxy-Editor zu:
1. Melden Sie sich bei http://ms-ip:9000 an, wobei ms-ip die IP-Adresse oder der DNS-Name des Knotens des Verwaltungsservers ist.
2. Wählen Sie in der oberen Navigationsleiste APIs > API-Proxys aus.
3. Wählen Sie in der Liste den API-Proxy aus, den Sie bearbeiten möchten.
Klicken Sie auf den Tab Entwickeln.
Wählen Sie unter Proxyendpunkte die Option default aus.
Im Codebereich:
1. Entfernen Sie alle <VirtualHost>-Elemente für virtuelle Hosts, die nicht vom API-Proxy unterstützt werden.
2. Fügen Sie ein neues <VirtualHost>-Element mit dem Namen des neuen virtuellen Hosts hinzu. Lautet der neue virtuelle Host beispielsweise MyVirtualHost, fügen Sie das folgende Tag hinzu:
```
<HTTPProxyConnection>
  <BasePath>/v1/my/proxy/basepath</BasePath>
  <VirtualHost>default</VirtualHost>
  <VirtualHost>secure</VirtualHost>
  <VirtualHost>MyVirtualHost</VirtualHost>
</HTTPProxyConnection>
```
Speichern Sie den API-Proxy. Wenn der API-Proxy bereitgestellt wurde, wird er beim Speichern mit der neuen Einstellung neu bereitgestellt.

Festlegen der Basis-URL, die von der Edge-Benutzeroberfläche für einen API-Proxy angezeigt wird

In der Edge-Benutzeroberfläche wird die URL eines API-Proxys basierend auf den Einstellungen im virtuellen Host angezeigt, der dem Ort entspricht, auf dem der Proxy bereitgestellt wird. In dieser Anzeige kann die Portnummer des Routers des virtuellen Hosts angezeigt werden.

In den meisten Fällen ist die in der Edge-Benutzeroberfläche angezeigte URL die richtige URL für externe Anfragen an den Proxy. Bei einigen Konfigurationen ist die angezeigte URL jedoch nicht korrekt. Beispielsweise kann jede der folgenden Konfigurationen dazu führen, dass die angezeigte URL nicht der tatsächlichen URL entspricht, die für externe Anfragen an den Proxy verwendet wird:

SSL-Beendigung erfolgt an einem Load-Balancer
Portzuordnung zwischen einem Load-Balancer und Apigee-Routern erfolgt
Einen Load-Balancer mit Umschreibung des Pfads

Edge unterstützt ein Attribut auf dem virtuellen Host namens <BaseUrl>, mit dem Sie die von der Edge-Benutzeroberfläche angezeigte URL überschreiben können. Das folgende Beispiel zeigt das Objekt des virtuellen Hosts mit dem Attribut <BaseUrl>. In diesem Beispiel wird der Wert "http://myCo.com" in der Edge-Benutzeroberfläche angezeigt:

<VirtualHost name="myTLSVHost">
  <HostAliases>
    <HostAlias>api.myCompany.com</HostAlias>
  </HostAliases>
  <BaseUrl>http://myCo.com</BaseUrl>
  <Port>443</Port>
  <SSLInfo>
    <Enabled>true</Enabled>
    <ClientAuthEnabled>false</ClientAuthEnabled>
    <KeyStore>ref://myTestKeystoreRef</KeyStore>
    <KeyAlias>myKeyAlias</KeyAlias>
  </SSLInfo>
</VirtualHost>

Der Wert von <BaseUrl> muss das Protokoll enthalten (d. h. „http://“ oder „https://“).

Wenn <BaseUrl> nicht festgelegt ist, wird die von der Edge-Benutzeroberfläche gerenderte Standard-URL als „api.myCompany.com“ angezeigt, während der tatsächliche Hostalias „http://myCo.com“ ist.