Menyesuaikan domain

Halaman ini berlaku untuk Apigee dan Apigee hybrid.

Lihat dokumentasi Apigee Edge.

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

https://orgname-portalname.apigee.io

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

Sebelum meluncurkan developer portal, 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, lakukan langkah-langkah berikut:

1. Daftarkan nama domain Anda.
2. Buat sertifikat TLS untuk domain kustom Anda. Anda akan memerlukan sertifikat saat membuat load balancer.
3. Menentukan nama host default untuk portal Anda.
4. Buat grup endpoint jaringan (NEG) internet untuk menentukan endpoint backend ke portal terintegrasi Anda 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 Anda untuk membuat data baru bagi 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 dapat memilih situs pendaftaran domain mana pun.

Saat menentukan nama domain, pertimbangkan bahwa URL yang mudah digunakan dan dapat dibaca manusia adalah komponen utama 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 serupa lainnya.

Langkah 2: Buat sertifikat TLS untuk domain kustom Anda

Buat sertifikat TLS untuk domain kustom 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

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 Location untuk portal yang ingin Anda buat domain kustomnya.

   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, lalu pilih atau buat project Google Cloud.

   Buka halaman Dasbor

2. Pilih Compute Engine > Network endpoint groups 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 Network endpoint group (Internet).
   Endpoint jaringan baru	Tambahkan melalui: Pilih Nama dan port yang sepenuhnya memenuhi syarat. 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 yang tersisa ditetapkan ke defaultnya.

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 workloads, 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	Reservasi alamat IP untuk permintaan klien masuk dan upload sertifikat TLS yang dibuat di Langkah 2: Membuat sertifikat TLS: Di bagian Create global external Application Load Balancer, posisikan kursor ke Frontend configuration, lalu klik panah. Masukkan nama untuk frontend di kolom Name. Pilih HTTPS dari menu drop-down Protokol. Di menu drop-down IP address, pilih Create IP address Dialog Reserve a new static IP address akan ditampilkan. Masukkan nama untuk alamat IP statis di kolom Name. Secara opsional, masukkan deskripsi. Klik Reserve. Simpan alamat IP yang telah direservasi untuk digunakan saat menyiapkan data DNS. Pilih Create a new certificate di menu dropdown Certificate. Slide jendela Buat sertifikat baru akan terbuka. Masukkan nama untuk sertifikat baru di kolom Nama. Pilih Upload my certificate di bagian Create mode. Upload detail sertifikat TLS Anda, termasuk kunci publik, rantai sertifikat, dan kunci pribadi. Klik Create. Klik Done untuk membuat IP dan port frontend baru.
   Konfigurasi backend	Konfigurasikan konfigurasi backend untuk mengarahkan traffic masuk ke NEG Internet yang dibuat di Langkah 4: Membuat grup endpoint jaringan (NEG) Internet: Di bagian Create global external Application Load Balancer, posisikan kursor ke Backend configuration, lalu klik panah. Di bagian Backend services & backend buckets, pilih Backend services > Create a backend service dari drop-down. Jendela Buat layanan backend 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 NEG Internet yang Anda buat di Langkah 4: Membuat grup endpoint jaringan (NEG) Internet di menu drop-down Internet network endpoint group, lalu klik Done. Hapus centang kotak Enable Cloud CDN. Anda dapat membiarkan semua nilai lainnya ditetapkan ke setelan defaultnya. 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 panah. Klik Aturan host dan jalur lanjutan (pengalihan URL, penulisan ulang URL) di bagian Mode. Di bagian New host and path rule: Pilih Rutekan traffic ke satu backend di drop-down Tindakan. 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 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 menu dropdown di menu navigasi atas.
4. Klik tab Domains.
5. Masukkan nama domain kustom Anda di kolom Domain.
6. Klik Aktifkan.

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

Lihat juga Mengedit domain kustom dan Menonaktifkan domain kustom.

Langkah 7: Perbarui DNS Anda

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

Untuk membuat zona Cloud DNS, ikuti langkah-langkah yang dijelaskan di 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. 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 set 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 tentukan 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 ditetapkan ke menit (default).
Alamat IPv4	Masukkan alamat IP eksternal yang Anda cadangkan saat membuat load balancer.

Mengedit domain kustom di portal

Untuk mengedit domain kustom di portal:

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 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

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 di menu navigasi atas atau di halaman landing.
4. Klik tab Domains.
5. Klik Disable.
6. Klik Nonaktifkan pada perintah untuk mengonfirmasi operasi.

Domain kustom dinonaktifkan dan kolom dihapus.