Menyesuaikan domain Anda

Halaman ini berlaku untuk Apigee dan Apigee Hybrid.

Baca dokumentasi Apigee Edge.

Saat membuat portal developer, secara default Anda diberi nama domain contoh Apigee untuk mengakses portal live Anda dalam format berikut:

https://orgname-portalname.apigee.io

Dengan orgname adalah nama organisasi dan portalname ditentukan menggunakan nama portal yang dikonversi menjadi semua huruf kecil serta menghapus spasi dan tanda hubung.

Sebelum meluncurkan portal developer, sebaiknya berikan nama domain kustom Anda sendiri. Misalnya, alternatif yang populer adalah:

https://developers.example.com

Catatan: Nama domain hanya dapat disesuaikan untuk akun berbayar.

Untuk pertimbangan penggunaan domain kustom dengan penyedia identitas SAML, lihat Menggunakan domain kustom dengan penyedia identitas SAML.

Langkah-langkah untuk menyesuaikan domain Anda

Untuk menyesuaikan nama domain, lakukan langkah-langkah berikut:

1. Daftarkan nama domain Anda.
2. Buat sertifikat TLS untuk domain kustom Anda. Anda akan memerlukan sertifikat tersebut saat membuat load balancer.
3. Tentukan nama host default untuk portal Anda.
4. Buat grup endpoint jaringan Internet (NEG) untuk menentukan endpoint backend ke portal terintegrasi untuk load balancer.
5. Buat load balancer yang mengarah ke NEG Internet dan mencadangkan IP untuk permintaan klien yang masuk.
6. Konfigurasi domain kustom di portal Anda.
7. Perbarui DNS untuk membuat data baru untuk host domain kustom.

Langkah 1: Daftarkan nama domain Anda

Jika Anda perlu mendaftarkan domain baru, ada banyak situs pendaftaran domain populer yang tersedia, seperti Google Domains. Anda bebas memilih situs pendaftaran domain.

Saat menentukan nama domain Anda, pertimbangkan bahwa URL yang mudah digunakan dan dapat dibaca manusia merupakan komponen penting dalam meningkatkan pengoptimalan mesin telusur, seperti yang dijelaskan dalam Menerapkan pengoptimalan mesin telusur (SEO).

Catatan:

• Jangan gunakan string "apigee" di nama domain kustom Anda.
• Pertimbangkan untuk mengalihkan ke alternatif nama domain lain yang serupa.

Langkah 2: Buat sertifikat TLS untuk domain kustom

Buat sertifikat TLS untuk domain kustom Anda menggunakan alat pilihan, seperti Let's Encrypt. Untuk informasi selengkapnya, lihat:

• Ringkasan sertifikat SSL
• Menggunakan sertifikat SSL yang dikelola sendiri

Langkah 3: Tentukan nama host default untuk portal Anda

Untuk menentukan nama host default untuk portal Anda:

1. Di UI Apigee, pilih Publish > Portals di menu navigasi samping. Daftar portal akan ditampilkan.

2. Salin konten di kolom Lokasi untuk portal yang domain kustomnya ingin Anda buat.

   Anda akan memerlukan nilai ini di langkah berikutnya.

Langkah 4: Buat NEG Internet

Pada langkah ini, Anda akan membuat grup endpoint jaringan Internet (NEG) untuk menentukan endpoint backend ke portal terintegrasi untuk load balancer. Untuk mengetahui informasi selengkapnya, lihat Ringkasan grup endpoint jaringan internet.

1. Di konsol Google Cloud, buka halaman Dasbor dan pilih atau buat project Google Cloud.

   Buka halaman Dashboard

2. Pilih Compute Engine > Grup endpoint jaringan di navigator.

3. Klik Create network endpoint group.

4. Konfigurasikan kolom berikut:

   Kolom	Nilai
   Nama	Masukkan nama untuk NEG Internet.
   Jenis grup endpoint jaringan	Pilih Grup endpoint jaringan (Internet).
   Endpoint jaringan baru	Add-through: Pilih Fully qualified domain name and port. Nama domain yang sepenuhnya memenuhi syarat: Masukkan nama domain default yang Anda salin di Langkah 3: Tentukan nama host default untuk portal Anda.

5. Anda dapat membiarkan kolom lainnya disetel ke default.

6. Klik Create.

NEG Internet dibuat.

Langkah 5: Membuat load balancer

Membuat load balancer yang mengarah ke NEG Internet dan mencadangkan IP untuk permintaan klien yang masuk.

Memulai konfigurasi Anda

1. Di Konsol Google Cloud, buka halaman Load balancing.

   Buka Load balancing

2. Klik Create load balancer.
3. Untuk Type of load balancer, pilih Application Load Balancer (HTTP/HTTPS) lalu klik Next.
4. Untuk Public facing or internal, pilih Public facing (eksternal), lalu klik Next.
5. Untuk Global or single region deployment, pilih Best for global Workload, lalu klik Next.
6. Untuk Load balancer Generation, pilih Global external Application Load Balancer, lalu klik Next.
7. Klik Konfigurasikan.

Mengonfigurasi load balancer

1. Klik setiap kategori dan konfigurasikan load balancer seperti yang dijelaskan dalam tabel berikut.

   Kategori	Langkah
   Konfigurasi frontend	Cadangkan alamat IP untuk permintaan klien masuk dan upload sertifikat TLS yang dibuat di Langkah 2: Buat sertifikat TLS: Di bagian Create global external Application Load Balancer, posisikan kursor di atas Frontend configuration dan klik tanda panah. Masukkan nama untuk frontend di kolom Name. Pilih HTTPS dari menu drop-down Protocol. Di menu drop-down IP address, pilih Create IP address Dialog Cadangkan alamat IP statis baru akan ditampilkan. Masukkan nama untuk alamat IP statis di kolom Name. Jika perlu, masukkan deskripsi. Klik Reserve. Simpan alamat IP yang telah dicadangkan untuk digunakan saat menyiapkan data DNS. Pilih Buat sertifikat baru di drop-down Sertifikat. Jendela Buat sertifikat baru akan terbuka. Masukkan nama untuk sertifikat baru di kolom Name. Pilih Upload sertifikat saya di bagian Buat mode. Upload detail sertifikat TLS Anda, termasuk kunci publik, rantai sertifikat, dan kunci pribadi. Klik Create. Klik Done untuk membuat port dan IP frontend baru.
   Konfigurasi backend	Konfigurasikan konfigurasi backend untuk mengarahkan traffic masuk ke NEG Internet yang dibuat di Langkah 4: Buat grup endpoint jaringan Internet (NEG): Di bagian Create global external Application Load Balancer, posisikan kursor di atas Backend configuration lalu klik tanda panah. Di bagian Backend services & backend buckets, pilih Backend services > Create a backend service dari menu drop-down. Jendela Create backend service akan terbuka. Masukkan nama di kolom Name. Pilih Internet network endpoint group di drop-down Backend type. Pilih HTTPS sebagai protokol. Di bagian New backend, pilih Internet NEG yang Anda buat di Langkah 4: Create an Internet network endpoint group (NEG) pada menu drop-down Internet network endpoint group, dan klik Done. Hapus centang pada kotak Aktifkan Cloud CDN. Anda dapat membiarkan semua nilai lain disetel ke default. Klik Create. Catatan: Cloud CDN tidak didukung untuk digunakan dengan Portal Apigee.
   Aturan host dan jalur	Konfigurasikan aturan host dan jalur untuk menentukan cara traffic akan diarahkan: Di bagian Create global external Application Load Balancer, posisikan kursor di atas Host and path rules, lalu klik tanda panah. Klik Advanced host and path rule (URL redirect, URL draf) di bagian Mode. Di bagian New host and path rule: Pilih Route traffic to a single backend di drop-down Action. Luaskan Add-on action (penulisan ulang URL). Masukkan nama domain default yang Anda salin di Langkah 3: Tentukan nama host default untuk portal Anda di kolom penulisan ulang host. Pilih layanan backend yang Anda konfigurasi di drop-down Backend. Klik Done.

2. Klik Create di halaman Create global external Application Load Balancer.

Langkah 6: Konfigurasikan domain kustom di portal Anda

Untuk mengonfigurasi domain kustom di portal Anda:

1. Di UI Apigee, pilih Publish > Portals di menu navigasi samping.
   Daftar portal akan ditampilkan.
2. Pilih portal Anda dalam daftar.
3. Pilih Setelan di halaman landing atau di drop-down pada menu navigasi atas.
4. Klik tab Domains.
5. Masukkan nama domain kustom Anda di kolom Domain.
6. Klik Enable.

Uji apakah saat Anda mengakses domain kustom di browser, Anda akan diarahkan ke portal terintegrasi.

Lihat juga Mengedit domain kustom dan Menonaktifkan domain kustom.

Langkah 7: Update DNS

Di sistem DNS, buat data baru untuk host domain kustom.

Untuk membuat zona Cloud DNS, ikuti langkah-langkah yang dijelaskan dalam Mengelola Zona. Pastikan Anda mengonfigurasi kolom berikut seperti yang dijelaskan di bawah:

Kolom	Deskripsi
Jenis zona	Pilih Public.
Nama zona	Masukkan nama yang bermakna untuk zona tersebut. Contoh: mycompany-zone
Nama DNS	Masukkan akhiran untuk zona menggunakan nama domain yang Anda miliki. Contoh: mycompany.com

Setelah membuat zona, di halaman detail Zona, klik Tambahkan kumpulan data, lalu ikuti langkah-langkah yang dijelaskan di Mengelola Data. Pastikan Anda mengonfigurasi kolom berikut seperti yang dijelaskan di bawah:

Kolom	Deskripsi
Nama DNS	Tentukan awalan untuk nama DNS Anda. Akhiran yang Anda tentukan untuk zona Cloud DNS juga ditampilkan, tetapi tidak dapat diedit. Contoh: developers.mycompany.com
Jenis Data Resource	Pilih A (default).
TTL	Tetapkan ke nilai yang diinginkan atau biarkan tetapkan ke 5 (default).
Unit TTL	Tetapkan ke nilai yang diinginkan atau biarkan disetel ke menit (default).
Alamat IPv4	Masukkan alamat IP eksternal yang Anda cadangkan saat membuat load balancer.

Mengedit domain kustom di portal Anda

Untuk mengedit domain kustom di portal Anda:

1. Di UI Apigee, pilih Publish > Portals di menu navigasi samping.
   Daftar portal akan ditampilkan.
2. Pilih portal Anda dalam daftar.
3. Pilih Setelan di menu drop-down pada menu navigasi atas atau di halaman landing.
4. Klik tab Domains.
5. Edit informasi domain kustom.
6. Klik Save.

Menonaktifkan domain kustom di portal

Untuk menonaktifkan nama domain kustom di portal Anda:

1. Di UI Apigee, pilih Publish > Portals di menu navigasi samping. Daftar portal akan ditampilkan.
2. Pilih portal Anda dalam daftar.
3. Pilih Setelan di menu drop-down pada menu navigasi atas atau di halaman landing.
4. Klik tab Domains.
5. Klik Disable.
6. Klik Disable pada perintah untuk mengonfirmasi operasi.

Domain kustom dinonaktifkan dan kolom dihapus.