Host virtual di Edge menentukan domain dan port Edge Router tempat proxy API diekspos, dan, secara ekstensi, URL yang digunakan aplikasi untuk mengakses proxy API. Host virtual juga menentukan apakah proxy API diakses menggunakan protokol HTTP, atau menggunakan protokol HTTPS terenkripsi.
Sebagai bagian dari proses orientasi Edge, Anda harus membuat organisasi, lingkungan, dan
host virtual. Edge menyediakan perintah setup-org untuk mempermudah
proses ini bagi pengguna baru.
Saat membuat host virtual, Anda harus menentukan informasi berikut:
- Nama host virtual yang Anda gunakan untuk mereferensikannya di proxy API
- Port di Router untuk host virtual. Biasanya port ini dimulai dari 9001 dan bertambah satu untuk setiap host virtual baru.
- Alias host host virtual. Biasanya nama DNS host virtual.
Misalnya, dalam file konfigurasi yang diteruskan ke perintah setup-org, Anda dapat menentukan
informasi ini sebagai:
# 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
Edge Router membandingkan header Host dari permintaan masuk dengan daftar alias host yang tersedia sebagai bagian dari penentuan proxy API yang menangani permintaan. Saat membuat permintaan melalui host virtual, tentukan nama domain
yang cocok dengan alias host host virtual, atau tentukan alamat IP Router dan
header Host yang berisi alias host.
Misalnya, jika Anda membuat host virtual dengan alias host myapis.apigee.net di port 9001, permintaan cURL ke API melalui host virtual tersebut dapat menggunakan salah satu bentuk berikut:
- Jika Anda memiliki entri DNS untuk myapis.apigee.net:
curl http://myapis.apigee.net:9001/proxy-base-path/resource-path
- Jika Anda tidak memiliki entri DNS untuk myapis.apigee.net:
curl http://routerIP:9001/proxy-base-path/resource-path -H 'Host: myapis.apigee.net'
Dalam formulir ini, Anda menentukan alamat IP Router, dan meneruskan alias host di dalam
Hostheader.
Opsi jika Anda tidak memiliki entri DNS untuk host virtual
Salah satu opsi jika Anda tidak memiliki entri DNS adalah menetapkan alias host ke alamat IP Router dan port host virtual, sebagai routerIP:port. Contoh:
VHOST_ALIAS=192.168.1.31:9001
Kemudian, Anda membuat perintah curl dalam bentuk di bawah ini:
curl http://routerIP:9001/proxy-base-path/resource-path
Opsi ini lebih disukai karena berfungsi baik dengan UI Edge Baru.
Jika Anda memiliki beberapa Router, tambahkan alias host untuk setiap Router, dengan menentukan alamat IP setiap Router dan port host virtual:
# 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"
Atau, Anda dapat menetapkan alias host ke nilai, seperti temp.hostalias.com.
Kemudian, Anda harus meneruskan header Host pada setiap permintaan:
curl -v http://routerIP:9001/proxy-base-path/resource-path -H 'host: temp.hostalias.com'
Atau, tambahkan alias host ke file /etc/hosts. Misalnya, tambahkan baris ini
ke /etc/hosts:
192.168.1.31 temp.hostalias.com
Kemudian, Anda dapat membuat permintaan seolah-olah Anda memiliki entri DNS:
curl -v http://myapis.apigee.net:9001/proxy-base-path/resource-path