Menyesuaikan domain Anda

Halaman ini berlaku untuk Apigee dan Apigee hybrid.

Lihat Dokumentasi Apigee Edge.

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

https://orgname-portalname.apigee.io

Jika 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 Anda memberikan 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

Untuk menyesuaikan nama domain Anda, lakukan langkah-langkah berikut:

1. Daftarkan nama domain Anda.
2. Buat sertifikat TLS untuk domain kustom Anda. Anda 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. Update DNS Anda 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 mana.

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

Catatan:

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

Langkah 2: Buat sertifikat TLS untuk domain kustom Anda

Buat sertifikat TLS untuk domain kustom Anda menggunakan alat pilihan Anda, 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

Guna menentukan nama host default untuk portal Anda:

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

2. Salin konten di kolom Location untuk portal tempat Anda ingin membuat domain kustom.

   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 Dashboard dan pilih atau buat project Google Cloud.

   Buka halaman Dasbor

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

3. Klik Create network endpoint group.

4. Konfigurasi kolom berikut:

   Kolom	Nilai
   Nama	Masukkan nama untuk NEG Internet.
   Jenis grup endpoint jaringan	Pilih Network endpoint group (Internet).
   Endpoint jaringan baru	Tambahkan melalui: Pilih Nama dan port domain yang sepenuhnya memenuhi syarat. Fully qualifed domain name: Masukkan nama domain default yang Anda salin pada Langkah 3: Tentukan nama host default untuk portal Anda.

5. Anda dapat membiarkan kolom yang tersisa ditetapkan ke default.

6. Klik Create.

NEG Internet dibuat.

Langkah 5: Buat load balancer

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

Memulai konfigurasi

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 (external), lalu klik Next.
5. Untuk Global or single region deployment, pilih Best for global workload dan klik Next.
6. Untuk Load balancer generation, pilih Global external Load Balancer Aplikasi, lalu klik Berikutnya.
7. Klik Konfigurasikan.

Mengonfigurasi load balancer

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

   Kategori	Langkah
   Konfigurasi frontend	Pesan alamat IP untuk permintaan klien masuk Anda dan upload sertifikat TLS yang dibuat di Langkah 2: Buat sertifikat TLS: Di bagian Create global external Application Load Balancer, posisikan kursor ke Frontend configuration lalu klik tanda panah. Masukkan nama untuk frontend di kolom Nama. Pilih HTTPS dari menu drop-down Protocol. Di menu drop-down Alamat IP, pilih Buat alamat IP Dialog Pesan alamat IP statis baru akan ditampilkan. Masukkan nama untuk alamat IP statis di kolom Nama. Masukkan deskripsi (opsional). Klik Reserve. Menyimpan alamat IP yang telah dicadangkan untuk digunakan saat menyiapkan data DNS. Pilih Create a new certificate di drop-down Sertifikat. Jendela Buat sertifikat baru akan terbuka. Masukkan nama untuk sertifikat baru di kolom Nama. 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 IP frontend dan port yang 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 Anda di atas Backend configuration lalu klik tanda panah. Di Layanan backend & backend bucket, pilih Backend services > Buat layanan backend dari menu drop-down. Jendela Create backend service akan terbuka. Masukkan nama di kolom Nama. Pilih Internet network endpoint group di drop-down Backend type. Pilih HTTPS sebagai protokol. Di bagian New backend, pilih NEG Internet yang Anda buat di Langkah 4: Create an Internet network endpoint group (NEG) di menu drop-down Internet network endpoint group, lalu klik Done. Hapus centang pada kotak Enable Cloud CDN. Anda dapat membiarkan semua nilai lainnya ditetapkan 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 Anda akan diarahkan: Di bagian Create global external Application Load Balancer, posisikan kursor ke Host and path rules, lalu klik tanda panah. Klik Aturan host dan jalur lanjutan (pengalihan URL, penulisan ulang URL) di bagian Mode. Di bagian Aturan host dan jalur baru: Pilih Route traffic to a single backend di drop-down Action. Luaskan Tindakan add-on (penulisan ulang URL). Masukkan nama domain default yang Anda salin di Langkah 3: Tentukan nama host default untuk portal Anda di kolom Tulis 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 Publikasikan > Portal di menu navigasi samping.
   Daftar portal akan ditampilkan.
2. Pilih portal Anda dalam daftar.
3. Pilih Setelan pada halaman landing atau di menu drop-down pada menu navigasi atas.
4. Klik tab Domains.
5. Masukkan nama domain kustom di kolom Domain.
6. Klik Aktifkan.

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

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 Anda membuat zona, di halaman Detail zona, klik Tambahkan kumpulan data dan 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 tetapkan untuk zona Cloud DNS juga ditampilkan, tetapi tidak dapat diedit. Contoh: developers.mycompany.com
Jenis Record Resource	Pilih A (default).
TTL	Tetapkan ke nilai yang diinginkan atau biarkan ditetapkan 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 Publikasikan > Portal di menu navigasi samping.
   Daftar portal akan ditampilkan.
2. Pilih portal Anda dalam daftar.
3. Pilih Setelan di menu drop-down di menu navigasi atas atau di halaman landing.
4. Klik tab Domains.
5. Edit informasi domain kustom.
6. Klik Simpan.

Menonaktifkan domain kustom di portal Anda

Untuk menonaktifkan nama domain kustom di portal Anda:

1. Di UI Apigee, pilih Publikasikan > Portal di menu navigasi samping. Daftar portal akan ditampilkan.
2. Pilih portal Anda dalam daftar.
3. Pilih Setelan di menu drop-down di 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 kolomnya dihapus.