Membuat klien dan kredensial OAuth untuk instance Looker (Google Cloud core)

Halaman dokumentasi ini menjelaskan cara menyiapkan klien OAuth dan mengaitkan kredensial OAuth secara manual dengan instance Anda selama pembuatan instance.

Waktu untuk membuat kredensial OAuth

Jenis instance Looker (inti Google Cloud) berikut mengharuskan Anda membuat kredensial OAuth dan mengaitkannya dengan instance selama pembuatan instance, meskipun Anda ingin menggunakan metode autentikasi yang berbeda untuk mengautentikasi pengguna ke instance:

Instance yang menggunakan koneksi pribadi
Instance yang menggunakan konfigurasi koneksi hybrid

Selain itu, jika Anda ingin menambahkan domain kustom ke instance Looker (inti Google Cloud) yang menggunakan koneksi aman publik, kredensial OAuth harus dibuat dan kemudian dikaitkan secara manual dengan instance saat menyiapkan domain kustom.

Instance Looker (Google Cloud core) yang hanya menggunakan koneksi aman publik tidak mengharuskan Anda membuat kredensial OAuth atau mengaitkannya dengan instance. Untuk jenis instance tersebut, Looker (Google Cloud core) menetapkan klien dan rahasia OAuth yang dikelola Looker untuk instance.

Peran yang diperlukan

Untuk menggunakan konsol Google Cloud guna membuat dan mengedit kredensial OAuth, Anda memerlukan izin berikut. (Untuk menyembunyikan daftar izin, ciutkan bagian Izin yang diperlukan.)

Izin yang diperlukan

clientauthconfig.&ast;

clientauthconfig.brands.create
clientauthconfig.brands.delete
clientauthconfig.brands.get
clientauthconfig.brands.list
clientauthconfig.brands.update
clientauthconfig.clients.create
clientauthconfig.clients.createSecret
clientauthconfig.clients.delete
clientauthconfig.clients.get
clientauthconfig.clients.getWithSecret
clientauthconfig.clients.list
clientauthconfig.clients.listWithSecrets
clientauthconfig.clients.undelete
clientauthconfig.clients.update

oauthconfig.&ast;

oauthconfig.clientpolicy.get
oauthconfig.testusers.get
oauthconfig.testusers.update
oauthconfig.verification.get
oauthconfig.verification.submit
oauthconfig.verification.update

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya. Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat halaman Mengelola akses ke project, folder, dan organisasi dalam dokumentasi Identity and Access Management (IAM).

Sebelum Anda membuat instance Looker (Google Cloud core)

Sebelum membuat instance Looker (Google Cloud core), selesaikan langkah-langkah yang dijelaskan di bagian berikut:

Buat client ID dan rahasia klien OAuth
Mengonfigurasi layar izin pengguna, cakupan, dan pengguna pengujian

Buat client ID dan rahasia klien OAuth

Pertama, buat klien OAuth dan buat client ID serta rahasia klien untuk klien tersebut. Nilai ini diperlukan selama pembuatan instance Looker (Google Cloud core).

Anda dapat menyiapkan klien OAuth di project Google Cloud mana pun yang Anda inginkan. Project ini tidak harus sama dengan project instance Looker (Google Cloud core). Namun, Looker (Google Cloud core) API harus diaktifkan di project ini.

Untuk membuat klien dan kredensialnya, ikuti langkah-langkah berikut:

Buka project tempat Anda ingin membuat klien OAuth.
Buka APIs & Services > Credentials.
Dari halaman Credentials, klik Create Credentials.
Dari menu drop-down, pilih OAuth client ID.
Di drop-down Application type, pilih Web application.
Di kolom Name, masukkan nama untuk klien OAuth Anda.
Pada tahap ini, Anda tidak perlu menambahkan URI di bagian Authorized JavaScript origins atau Authorized redirect URIs.
Klik Create.

Setelah Anda mengklik Buat, jendela Klien OAuth dibuat akan muncul. Jendela ini menampilkan client ID dan rahasia klien yang dibuat untuk klien OAuth Anda. Nilai ini akan diperlukan saat Anda membuat instance Looker (Google Cloud core).

Secara opsional, klik Download JSON untuk mendownload informasi kredensial dalam file JSON. Untuk menutup jendela, klik Oke.

Mengonfigurasi layar izin pengguna, cakupan, dan pengguna pengujian

Selanjutnya, Anda dapat mengonfigurasi layar izin. Layar izin ditampilkan kepada pengguna instance Looker (Google Cloud core) saat login pertama kali dan kapan saja saat otorisasi mereka berakhir atau dicabut oleh pengguna.

Ikuti petunjuk di halaman dokumentasi Mengonfigurasi layar izin OAuth dan memilih cakupan. Saat mengonfigurasi layar, selesaikan setelan berikut seperti yang dijelaskan:

Di bagian Branding, di bagian Authorized domains, domain harus cocok dengan domain instance Looker (inti Google Cloud) yang menggunakan kredensial OAuth. Jika Anda akan membuat domain kustom untuk instance Looker (Google Cloud core) dan mengetahui domain yang akan ditetapkan ke instance tersebut, Anda dapat memasukkannya sekarang. Atau, Anda dapat mengosongkan kolom ini; kolom ini akan diisi otomatis saat Anda menambahkan URI pengalihan yang sah setelah instance Looker (Google Cloud core) dibuat.
Di bagian Audiens, di bagian Jenis Pengguna, pilih salah satu opsi berikut:
- Internal: Setelan ini adalah default. Hanya pengguna dalam organisasi Anda yang dapat mengakses instance setelah mereka ditambahkan melalui IAM.
- Jadikan eksternal: Pengguna dengan Akun Google jenis apa pun dapat mengakses instance setelah ditambahkan melalui IAM.
Catatan: Jika Anda ingin pengguna seperti Dukungan Google mengakses instance Anda menggunakan OAuth dan IAM, Jenis Pengguna harus ditetapkan ke Eksternal, dan pengguna Dukungan harus ditambahkan melalui IAM. Anda dapat mengedit setelan Jenis Pengguna kapan saja.

Selama pembuatan instance Looker (Google Cloud core)

Saat Anda membuat instance Looker (Google Cloud core), tambahkan client ID OAuth dan rahasia klien di bagian OAuth Application Credentials. Anda tidak dapat membuat instance tanpa kredensial OAuth. Temukan ID klien OAuth dan rahasia klien dengan membuka klien OAuth di konsol Google Cloud .

Setelah Anda membuat instance Looker (Google Cloud core)

Selesaikan petunjuk berikut untuk menyelesaikan konfigurasi. Saat Anda menambahkan URI pengalihan yang diotorisasi, URI tersebut akan ditambahkan ke layar izin OAuth Anda sebagai domain yang diotorisasi.

Tambahkan URI pengalihan yang sah ke klien OAuth

Jika Anda belum melakukannya, ikuti langkah-langkah berikut untuk memasukkan URL instance Looker (Google Cloud core) yang baru dibuat ke klien OAuth.

Setelah membuat instance Looker (Google Cloud core), temukan dan salin URL untuk instance tersebut. Anda dapat menemukan URL di halaman Instances.

Catatan: Jika Anda menyiapkan domain kustom untuk instance, pastikan untuk menyelesaikan penyiapan tersebut sebelum menyalin URL. Setelah Anda menambahkan domain kustom ke klien OAuth, pengguna tidak akan lagi dapat login ke URL instance yang dibuat otomatis yang diberikan saat instance dibuat, meskipun domain tersebut juga ada di klien OAuth.
Di konsol Google Cloud , buka APIs & Services > Credentials.
Di bagian heading Client ID OAuth 2.0, klik nama klien yang Anda buat.
Di bagian URI pengalihan yang sah, klik Tambahkan URI.
Tempel URL instance Looker (Google Cloud core) ke kolom URI. Tambahkan /oauth2callback di akhir URL. Misalnya: https://uuid.looker.app/oauth2callback

Jika Anda akan menyiapkan otorisasi OAuth untuk BigQuery, Anda juga dapat menambahkan URI pengalihan kedua yang mengarah ke URL instance Looker (Google Cloud core) yang diikuti dengan /external_oauth/redirect yang ditambahkan di akhir URL. Misalnya: https://uuid.looker.app/external_oauth/redirect
Klik Save.

Diperlukan waktu lima menit hingga beberapa jam agar update diterapkan.

Kelola pengguna

Setelah klien OAuth dikonfigurasi dan instance Looker (Google Cloud core) dibuat, Anda dapat login ke instance menggunakan OAuth. Kemudian, Anda dapat memilih metode autentikasi untuk instance Anda.

Jika menggunakan OAuth sebagai metode autentikasi utama, selesaikan langkah-langkah seperti yang dijelaskan di halaman dokumentasi Menggunakan Google OAuth untuk autentikasi pengguna Looker (inti Google Cloud) untuk menyelesaikan penyiapan OAuth untuk autentikasi pengguna.

Setelah metode autentikasi disiapkan, Anda dapat menambahkan atau menghapus pengguna melalui penyedia identitas dan mengelolanya di Looker.

Melihat jenis kredensial OAuth untuk instance Anda

Kredensial OAuth tidak dicantumkan langsung di halaman konfigurasi instance di konsol Google Cloud . Klik Edit di halaman konfigurasi instance untuk melihat bagian OAuth application credentials.

Jika kredensial OAuth disetel ke Dikelola Looker, Looker (inti Google Cloud) akan menetapkan kredensial OAuth yang dikelola Looker untuk instance Anda selama pembuatan instance dan ID klien serta secret klien tidak akan ditampilkan.

Jika kredensial OAuth disetel ke Manual, kredensial OAuth kustom ditambahkan ke instance Anda selama atau setelah pembuatan instance. Client ID dan rahasia klien tidak ditampilkan; sebagai gantinya, bagian ini menampilkan placeholder ****.

Mengedit klien OAuth untuk instance Looker (Google Cloud core)

Jika ingin, Anda dapat menambahkan, mengedit, atau mengubah kredensial OAuth untuk instance Looker (inti Google Cloud) dengan mengikuti langkah-langkah berikut:

Siapkan klien atau kredensial baru.
Di konsol Google Cloud , dari halaman Instances, klik nama instance untuk membuka halaman DETAILS.
Dari halaman DETAIL, klik Edit.
Di halaman Edit instance Looker (Google Cloud core), buka bagian OAuth application credentials, lalu pilih Manual, jika belum dipilih.
Masukkan nilai baru di kolom OAuth Client ID dan OAuth Client Secret.
Klik Save.

Jika kredensial aplikasi OAuth Anda disetel ke Dikelola Looker, Anda tidak dapat menambahkan atau mengedit kredensial. Beralih ke setelan Manual untuk mengedit atau menambahkan kredensial.