Menyiapkan domain kustom untuk instance Looker (Google Cloud core) yang menggunakan koneksi publik

Anda dapat menayangkan instance melalui domain web kustom, bukan melalui domain default yang disediakan Looker (Google Cloud core).

Halaman dokumentasi ini menjelaskan penyiapan domain kustom untuk instance yang memenuhi salah satu kriteria berikut:

• Instance menggunakan koneksi aman publik saja.
• Instance menggunakan koneksi hybrid. Koneksi hybrid mencakup koneksi aman publik untuk ingress.

Jika Anda membuat domain kustom dengan instance yang menggunakan koneksi jaringan publik, Google akan menyediakan sertifikat SSL terkelola dengan perpanjangan otomatis.

Untuk menerapkan domain kustom untuk jenis instance ini, Anda harus melakukan langkah-langkah berikut:

1. Siapkan domain kustom.
2. Buat data DNS A.
3. Perbarui kredensial OAuth.

Penting: Jika instance Anda memiliki koneksi hybrid, Anda dapat mengikuti petunjuk di halaman ini; namun, jika Anda beralih ke konfigurasi koneksi pribadi kapan saja, domain kustom Anda akan dibatalkan dan Anda harus membuatnya ulang untuk konfigurasi koneksi pribadi Anda.

Menyiapkan domain kustom

Setelah instance Looker (Google Cloud core) dibuat, Anda dapat menyiapkan domain kustom.

Sebelum memulai

Catatan: Domain kustom tidak dapat dibuat menggunakan domain looker.com.

Sebelum Anda dapat menyesuaikan domain instance Looker (Google Cloud core), identifikasi tempat penyimpanan data DNS domain Anda, sehingga Anda dapat memperbaruinya.

Peran yang diperlukan

Untuk mendapatkan izin yang diperlukan guna membuat domain kustom untuk instance Looker (Google Cloud core), minta administrator untuk memberi Anda peran IAM Looker Admin (roles/looker.admin) di project tempat instance berada. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Membuat domain kustom

Catatan: Anda tidak dapat mengubah domain kustom setelah dibuat. Jika Anda ingin melakukan perubahan pada domain kustom, Anda harus menghapus domain kustom yang ada dan membuat yang baru.

Di konsol Google Cloud , ikuti langkah-langkah berikut untuk menyesuaikan domain instance Looker (Google Cloud core):

1. Di halaman Instances, klik nama instance yang ingin Anda siapkan domain kustomnya.
2. Klik tab CUSTOM DOMAIN.

3. Klik ADD A CUSTOM DOMAIN.

   

   Tindakan ini akan membuka panel Tambahkan domain kustom baru.

4. Dengan hanya menggunakan huruf, angka, dan tanda hubung, masukkan nama host hingga 64 karakter untuk domain web yang ingin Anda gunakan — misalnya: looker.examplepetstore.com.

   

5. Klik tombol Continue.

6. Jika Anda belum mengaitkan kredensial OAuth manual dengan instance Looker (Google Cloud core) (misalnya, jika Anda memiliki instance koneksi aman publik dan tidak menambahkan kredensial OAuth secara manual), bagian Kredensial aplikasi OAuth akan terbuka. Ikuti petunjuk untuk menyelesaikan dua tugas berikut:

   1. Buat client ID dan rahasia klien OAuth.
   2. Tambahkan URI pengalihan yang diberi otorisasi di bagian URI pengalihan yang diberi otorisasi pada klien OAuth. Pada tahap ini dalam proses, masukkan URL yang dibuat otomatis Looker yang muncul di halaman Instances dalam konsol Google Cloud . Anda akan memasukkan domain kustom saat memperbarui kredensial OAuth.

   Masukkan kredensial di kolom OAuth Client ID dan OAuth Client Secret, lalu klik tombol Continue.

7. Jika instance Looker (inti Google Cloud) Anda sudah memiliki kredensial OAuth manual yang terkait dengannya (misalnya, jika Anda memiliki instance koneksi hybrid), atau, jika Anda baru saja menambahkan kredensial OAuth di bagian Kredensial aplikasi OAuth pada panel, bagian Perbarui catatan DNS Anda akan terbuka. Gunakan IP publik ingress yang tercantum di kolom Data saat Anda membuat atau memperbarui alamat IP catatan A.

8. Klik SELESAI di panel Tambahkan domain kustom baru untuk kembali ke tab DOMAIN KUSTOM.

Catatan: Diperlukan waktu 10 hingga 15 menit untuk menyelesaikan update domain kustom.

Setelah domain kustom Anda disiapkan, domain tersebut akan ditampilkan di kolom Domain pada tab DOMAIN KUSTOM di halaman detail instance Looker (inti Google Cloud) di konsol Google Cloud .

Setelah domain kustom dibuat, Anda dapat melihat informasi tentangnya, atau menghapusnya.

Mengakses domain kustom

Untuk menyiapkan akses ke domain kustom untuk instance Looker (inti Google Cloud) yang menggunakan koneksi aman publik, buat data DNS dan perbarui kredensial OAuth.

Sebelum memulai

Untuk mendapatkan izin yang diperlukan untuk menyiapkan akses ke domain kustom koneksi aman publik, minta administrator untuk memberi Anda peran IAM berikut pada project tempat instance berada:

• Admin Looker (roles/looker.admin)
• DNS Admin (roles/dns.admin)
• Gunakan OAuth Google: OAuth Config Editor (roles/oauthconfig.editor)

Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Membuat data DNS

Di mana pun data DNS Anda disimpan, buat data A di zona DNS untuk domain Anda. Untuk instance yang menggunakan koneksi jaringan publik, gunakan IP publik ingress instance Looker (Google Cloud core) untuk alamat IP A record. IP publik ingress dapat ditemukan di tab Detail instance Looker (Google Cloud core) di konsol Google Cloud . (CNAME juga ditampilkan di kolom Data di bagian Perbarui data DNS Anda pada panel Tambahkan domain kustom baru.)

Jika tombol VERIFIKASI DOMAIN muncul di tab DOMAIN KUSTOM pada instance Looker (inti Google Cloud), data DNS Anda mungkin memerlukan konfigurasi tambahan. Klik VERIFIKASI DOMAIN untuk menyelesaikan penyiapan domain kustom Anda.

Catatan: Perubahan pada data DNS Anda mungkin memerlukan waktu hingga 24 jam agar diterapkan. Sertifikat SSL yang terkait dengan data DNS Anda mungkin memerlukan waktu beberapa menit untuk diaktifkan.

Setelah data DNS domain Anda diperbarui dan domain Anda telah diverifikasi di Konsol Google Cloud, status domain kustom yang dipetakan ke instance akan diperbarui dari Belum diverifikasi menjadi Tersedia di tab Domain kustom.

Perbarui kredensial OAuth

Catatan: Anda dapat menggunakan klien OAuth apa pun untuk membuat kredensial otorisasi untuk instance Looker (Google Cloud core) Anda. Sebagai contoh, langkah-langkah ini akan memandu Anda memperbarui kredensial menggunakan konsol Google Cloud . Jika Anda menggunakan klien yang berbeda, sesuaikan langkah-langkahnya.

1. Akses klien OAuth Anda dengan membuka Google Cloud konsol ke APIs & Services > Credentials dan memilih ID klien OAuth untuk klien OAuth yang digunakan oleh instance Looker (Google Cloud core) Anda.

2. Klik tombol Tambahkan URI untuk memperbarui kolom Origin JavaScript resmi di klien OAuth Anda agar menyertakan nama DNS yang sama yang akan digunakan organisasi Anda untuk mengakses Looker (inti Google Cloud). Misalnya, jika domain kustom Anda adalah looker.examplepetstore.com, Anda akan memasukkan looker.examplepetstore.com sebagai URI.

   

3. Tambahkan domain kustom ke daftar URI pengalihan yang sah untuk kredensial OAuth yang Anda gunakan saat membuat instance Looker (Google Cloud core). Tambahkan /oauth2callback di akhir URI. Misalnya, jika domain kustom Anda adalah looker.examplepetstore.com, Anda akan memasukkan looker.examplepetstore.com/oauth2callback.

   

   Anda harus mencantumkan URL domain kustom dan URL Looker (Google Cloud core) asli yang dibuat secara otomatis di bagian URI pengalihan yang diotorisasi pada klien OAuth.

Menambahkan pengguna

Setelah langkah-langkah sebelumnya selesai, URL domain kustom dapat diakses oleh pengguna.

Pastikan metode autentikasi pengguna telah disiapkan sepenuhnya untuk instance Looker (Google Cloud core) sebelum menambahkan pengguna ke instance.

Langkah berikutnya

• Mengonfigurasi daftar IP yang diizinkan untuk Looker (Google Cloud core)
• Mengelola pengguna dalam Looker (Google Cloud core)
• Mengonfigurasi instance Looker (Google Cloud core)
• Menghubungkan Looker (Google Cloud core) ke database Anda