Host wirtualny na urządzeniu Edge definiuje domeny i porty routera brzegowego, na których znajduje się serwer proxy API ujawniony, a co za tym idzie, adres URL używany przez aplikacje do uzyskiwania dostępu do serwera proxy interfejsu API. Host wirtualny też określa, czy dostęp do serwera proxy interfejsu API uzyskuje się przez protokół HTTP czy za pomocą zaszyfrowanego protokołu.
W ramach procesu wdrażania Edge musisz utworzyć organizację, środowisko
hosta wirtualnego. Edge udostępnia polecenie setup-org do
proces ten będzie łatwiejszy dla nowych użytkowników.
Podczas tworzenia hosta wirtualnego musisz podać te informacje:
- Nazwa hosta wirtualnego, którego używasz w swoim interfejsie API, aby się do niego odwoływać. serwerów proxy.
- Port w routerze dla hosta wirtualnego. Zwykle te porty zaczyna się od wartości 9001 i zwiększa się o jeden dla każdego nowego hosta wirtualnego.
- Alias hosta wirtualnego. Zwykle jest to nazwa DNS hosta wirtualnego.
Na przykład w pliku konfiguracyjnym przekazywanym do polecenia setup-org możesz określić
te informacje jako:
# Specify virtual host information VHOST_PORT=9001 VHOST_NAME=default # If you have a DNS entry for the virtual host VHOST_ALIAS=myapis.apigee.net
Router brzegowy porównuje nagłówek Host protokołu
przychodzące żądanie do listy dostępnych aliasów hosta w ramach określania serwera proxy interfejsu API,
przetwarza żądanie. Podczas wysyłania żądania za pośrednictwem hosta wirtualnego podaj nazwę domeny
pasujący do aliasu hosta wirtualnego lub określonego adresu IP routera
nagłówek Host zawierający alias hosta.
Jeśli na przykład został utworzony host wirtualny z aliasem hosta myapis.apigee.net na porcie 9001, to żądanie cURL wysyłane do interfejsu API przez ten host wirtualny może używać jednej z tych formularze:
- Jeśli masz wpis DNS dla myapis.apigee.net:
curl http://myapis.apigee.net:9001/proxy-base-path/resource-path
- Jeśli nie masz wpisu DNS dla myapis.apigee.net:
curl http://routerIP:9001/proxy-base-path/resource-path -H 'Host: myapis.apigee.net'
W tym formularzu należy podać adres IP routera i przekazać alias hosta w pliku Nagłówek
Host.
Opcje dostępne, gdy nie masz systemu DNS wpis hosta wirtualnego
Jedną z opcji w przypadku braku wpisu DNS jest ustawienie aliasu hosta na adres IP serwera Router i port hosta wirtualnego, np. routerIP:port. Na przykład:
VHOST_ALIAS=192.168.1.31:9001
Następnie utwórz polecenie curl w formacie poniżej:
curl http://routerIP:9001/proxy-base-path/resource-path
Ta opcja jest preferowana, ponieważ dobrze współpracuje z interfejsem Edge.
Jeśli masz kilka routerów, dodaj alias hosta dla każdego z nich, określając adres IP każdy router i port hosta wirtualnego:
# Specify the IP and port of each router as a space-separated list enclosed in quotes: # VHOST_ALIAS="192.168.1.31:9001 192.168.1.32:9001"
Jako alias hosta możesz też ustawić wartość, np. temp.hostalias.com.
Następnie musisz przekazywać nagłówek Host w każdym żądaniu:
curl -v http://routerIP:9001/proxy-base-path/resource-path -H 'host: temp.hostalias.com'
Możesz też dodać alias hosta do pliku /etc/hosts. Na przykład dodaj ten wiersz
do /etc/hosts:
192.168.1.31 temp.hostalias.com
Następnie możesz wysłać żądanie tak, jakby miał wpis DNS:
curl -v http://myapis.apigee.net:9001/proxy-base-path/resource-path