Host wirtualny w Edge określa domeny i porty routera Edge, na których jest udostępniany serwer proxy interfejsu API, a co za tym idzie – adres URL, którego aplikacje używają do uzyskiwania dostępu do serwera proxy interfejsu API. Host wirtualny określa też, czy dostęp do serwera proxy interfejsu API jest uzyskiwany za pomocą protokołu HTTP czy szyfrowanego protokołu HTTPS.
W ramach procesu rejestracji w Edge musisz utworzyć organizację, środowisko i
hosta wirtualnego. Edge udostępnia polecenie setup-org, które ułatwia
ten proces nowym użytkownikom.
Podczas tworzenia hosta wirtualnego musisz podać te informacje:
- Nazwa hosta wirtualnego, której używasz do odwoływania się do niego w serwerach proxy interfejsów API
- Port na routerze dla hosta wirtualnego. Zwykle te porty zaczynają się od 9001 i zwiększają się o 1 w przypadku każdego nowego hosta wirtualnego.
- Alias hosta hosta wirtualnego. Zwykle jest to nazwa DNS hosta wirtualnego.
Na przykład w pliku konfiguracyjnym przekazywanym do polecenia setup-org możesz podać
te informacje w ten sposób:
# 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 Edge porównuje nagłówek Host przychodzącego żądania z listą dostępnych aliasów hostów, aby określić serwer proxy interfejsu API, który obsługuje żądanie. W przypadku wysyłania żądania przez hosta wirtualnego podaj nazwę domeny
która pasuje do aliasu hosta hosta wirtualnego, lub adres IP routera i
nagłówek Host zawierający alias hosta.
Jeśli na przykład utworzysz hosta wirtualnego z aliasem hosta myapis.apigee.net na porcie 9001, żądanie cURL do interfejsu API przez tego hosta wirtualnego może mieć jedną z tych postaci:
- 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 tej postaci podajesz adres IP routera i przekazujesz alias hosta w nagłówku
Host.
Opcje, gdy nie masz wpisu DNS dla hosta wirtualnego
Jeśli nie masz wpisu DNS, możesz ustawić alias hosta na adres IP routera i port hosta wirtualnego, czyli routerIP:port. Na przykład:
VHOST_ALIAS=192.168.1.31:9001
Następnie wykonaj polecenie curl w postaci podanej poniżej:
curl http://routerIP:9001/proxy-base-path/resource-path
Ta opcja jest preferowana, ponieważ dobrze współpracuje z nowym interfejsem Edge.
Jeśli masz kilka routerów, dodaj alias hosta dla każdego z nich, podając adres IP każdego routera 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"
Możesz też ustawić alias hosta na wartość, np. temp.hostalias.com.
Następnie musisz przekazać 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