FAQ Mengonfigurasi Host Virtual

Anda sedang melihat dokumentasi Apigee Edge.
Buka dokumentasi Apigee X. info

Pelanggan Edge Cloud kini dapat membuat, mengubah, dan menghapus host virtual. Sebelumnya, tindakan ini harus dilakukan oleh Dukungan Apigee Edge.

Siapa yang dapat mengonfigurasi host virtual di Edge Cloud?

Hanya pelanggan Cloud dengan akun berbayar yang dapat membuat, mengubah, dan menghapus host virtual. Pengguna yang membuat host virtual harus memiliki peran administrator organisasi, atau memiliki peran kustom dengan izin untuk mengubah host virtual. Pengguna dalam peran lain tidak memiliki otorisasi untuk membuat host virtual.

Peran kustom memerlukan izin GET, PUT, dan DELETE di /environments/*/virtualhosts, atau resource induknya. Lihat Membuat peran dengan API untuk mengetahui informasi selengkapnya.

Bagaimana jika saya memiliki host virtual yang sudah ada yang dibuat oleh Apigee?

Pelanggan Edge Cloud yang sudah ada telah memiliki host virtual yang dibuat oleh Apigee. Sekarang Anda dapat mengubah host virtual tersebut.

Namun, tinjau persyaratan untuk mengubah host virtual di Mengonfigurasi host virtual untuk Cloud sebelum Anda melakukan perubahan apa pun. Misalnya, jika host virtual yang ada dikonfigurasi untuk menggunakan port selain 443, Anda tidak dapat mengubah nomor port atau setelan TLS. Artinya, Anda tidak dapat mengubah setelan TLS dari diaktifkan menjadi dinonaktifkan, atau dari dinonaktifkan menjadi diaktifkan.

Port apa yang dapat saya gunakan di host virtual di Cloud?

Anda hanya dapat menggunakan port 443 di host virtual di Cloud. Anda tidak dapat menggunakan port 80 atau port lainnya.

Mengapa saya tidak dapat menggunakan port 80 di host virtual di Cloud?

Kami mendorong pelanggan Apigee untuk tidak lagi menggunakan host virtual port 80 untuk traffic runtime API karena port 80 tidak aman. Kedua, karena kami tidak dapat memvalidasi kepemilikan domain, host virtual port 80 tidak dapat dibuat swalayan untuk Cloud. Perubahan pada host virtual port 80 dianggap tidak standar dan oleh karena itu, Dukungan Apigee Edge berhak menolak perubahan tersebut.

Apakah TLS diperlukan di semua host virtual baru di Cloud?

Untuk membuat host virtual, Anda harus mengaktifkan TLS di host virtual. Artinya, Anda harus membuat keystore dengan sertifikat dan kunci TLS terlebih dahulu sebelum membuat host virtual.

Anda harus memiliki sertifikat yang ditandatangani oleh entitas tepercaya, seperti Symantec atau VeriSign. Anda tidak dapat menggunakan sertifikat yang ditandatangani sendiri, atau sertifikat leaf yang ditandatangani oleh CA yang ditandatangani sendiri.

Lihat Mengonfigurasi host virtual untuk Cloud untuk mengetahui informasi selengkapnya.

Dapatkah saya menyematkan sertifikat uji coba gratis Apigee?

Demi alasan keamanan, sertifikat uji coba gratis Apigee berakhir setiap tiga bulan. Di akhir tiga bulan tersebut, Apigee akan mengganti sertifikat yang akan berakhir dengan sertifikat baru. Oleh karena itu, Apigee tidak merekomendasikan atau mendukung penyematan sertifikat uji coba gratis.

Dapatkah saya memperbarui sertifikat TLS yang digunakan oleh host virtual?

Jika Anda memiliki host virtual dengan sertifikat TLS yang akan segera berakhir, Anda dapat memperbarui host virtual untuk menggunakan keystore lain yang berisi sertifikat yang valid.

Apa itu referensi?

Referensi adalah variabel yang berisi nama keystore. Untuk mengubah keystore yang digunakan oleh host virtual, Anda memperbarui variabel referensi, bukan host virtual itu sendiri.

Host virtual lama di Apigee Edge mungkin tidak dikonfigurasi untuk menggunakan referensi. Dalam hal ini, Anda harus meminta Dukungan Apigee Edge untuk memperbarui host virtual agar menggunakan referensi. Jangan memperbarui host virtual sendiri untuk mengubahnya agar menggunakan referensi.

Bagaimana cara menentukan apakah host virtual saya menggunakan referensi?

Untuk melihat informasi tentang host virtual tertentu, gunakan API Get Virtual Host:

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

dengan vhost_name adalah nama host virtual. Misalnya, Anda dapat menentukan vhost_name sebagai "secure" untuk melihat konfigurasi host virtual aman default:

<VirtualHost name="secure">
    <HostAliases>
        <HostAlias>orgname-prod.apigee.net</HostAlias>
    </HostAliases>
    <Interfaces/>
    <Port>443</Port>
    <Properties/>
    <SSLInfo>
        <ClientAuthEnabled>false</ClientAuthEnabled>
        <Enabled>true</Enabled>
        <KeyAlias>freetrial</KeyAlias>
        <KeyStore>ref://freetrial</KeyStore>
        <IgnoreValidationErrors>false</IgnoreValidationErrors>
    </SSLInfo>
</VirtualHost>

Perhatikan bahwa dalam contoh ini, nilai elemen <KeyStore> dalam respons dimulai dengan ref://. Awalan tersebut menandakan bahwa keystore menggunakan referensi.

Jika nilai elemen <KeyStore> adalah literal string, maka elemen tersebut tidak menggunakan referensi. Contoh:

<KeyStore>mykeystore</KeyStore>

Jangan memperbarui host virtual sendiri untuk mengubahnya agar menggunakan referensi. Anda harus meminta Dukungan Apigee Edge untuk memperbarui host virtual agar menggunakan referensi. Setelah Apigee memperbarui host virtual untuk menggunakan referensi, Anda dapat mengubah keystore dengan memperbarui variabel referensi.

Lihat Mengonfigurasi host virtual untuk Cloud untuk mengetahui informasi selengkapnya.

Bagaimana cara membuat host virtual?

Gunakan prosedur berikut untuk membuat host virtual:

  1. Buat entri DNS dan data CNAME untuk domain yang menghadap publik yang mengarah ke [org]-[environment].apigee.net. Lihat "Tentang alias host dan nama DNS" di Tentang host virtual untuk mengetahui informasi selengkapnya.
  2. Buat dan konfigurasi keystore menggunakan prosedur seperti yang dijelaskan dalam Membuat keystore dan truststore menggunakan UI Edge.
  3. Upload sertifikat dan kunci Anda ke keystore.
  4. Buat referensi ke keystore seperti yang dijelaskan dalam Mengonfigurasi host virtual untuk Cloud.
  5. Buat host virtual menggunakan API Create a Virtual Host seperti yang dijelaskan dalam Mengonfigurasi host virtual untuk Cloud. Pastikan untuk menentukan referensi keystore yang benar.
  6. Jika Anda memiliki proxy API yang ada, tambahkan host virtual ke elemen <HTTPConnection> di ProxyEndpoint. Host virtual ditambahkan secara otomatis ke semua proxy API baru. Lihat Mengonfigurasi proxy API untuk menggunakan host virtual.

Dapatkah saya meminta Apigee untuk memblokir port TCP 80, 443, atau 15999 di Apigee Edge Cloud?

Karena pelanggan kami mengonfigurasi Virtual Host di port TCP 443 dan terkadang di port TCP 80 (meskipun penggunaan port 80 tidak direkomendasikan), kami tidak dapat memblokir port ini karena tindakan tersebut akan menyebabkan kegagalan semua traffic runtime API.

Port TCP 15999 digunakan secara internal di Cloud untuk menentukan apakah Router dalam kondisi baik atau tidak dan oleh karena itu tidak boleh diblokir karena dapat menyebabkan dampak runtime API yang tidak terduga.