Setelan admin - Mengelola Klien OAuth

Di Looker, administrator dapat menggunakan halaman Manage OAuth Clients untuk mengelola akses OAuth 2.0 berbasis identitas untuk aplikasi eksternal tanpa membuat kunci API atau menggunakan API Explorer. Dokumen ini menjelaskan cara mengaktifkan aplikasi yang telah dikonfigurasi sebelumnya, mendaftarkan klien OAuth kustom, dan mengelola pencabutan token.

Halaman Manage OAuth Clients terletak di bagian Authentication pada panel Admin Looker. Looker Developer Portal menyediakan antarmuka terpusat untuk memberikan akses ke alat developer seperti Looker CLI, klien Model Context Protocol (MCP) agen AI, dan konektor business intelligence (BI).

Catatan: Jika Anda memiliki izin yang hanya memberikan akses ke halaman tertentu di panel Admin, seperti manage_schedules, manage_themes, atau see_admin, tetapi Anda tidak memiliki Peran admin, halaman yang dijelaskan di sini mungkin tidak terlihat oleh Anda di panel Admin.

Persyaratan

Untuk mengakses dan mengelola halaman Kelola Klien OAuth, persyaratan berikut harus dipenuhi:

• Instance Looker Anda harus dihosting oleh Looker. Instance Looker yang dihosting pelanggan tidak didukung.
• Anda harus memiliki peran Admin di instance Looker Anda.

Ringkasan

Halaman Manage OAuth Clients mengatur aplikasi klien ke dalam dua tab:

• Application Library: Katalog aplikasi OAuth yang telah dikonfigurasi sebelumnya dan dikelola Looker, termasuk klien Model Context Protocol (MCP) agen AI, konektor business intelligence (BI), dan alat developer.
• Klien Kustom: Antarmuka pengelolaan untuk mendaftarkan dan mengonfigurasi aplikasi klien OAuth kustom Anda sendiri dengan URI pengalihan callback dan kontrol akses grup yang dapat disesuaikan.

Kotak penelusuran di bagian atas halaman memungkinkan Anda memfilter aplikasi di kedua tab secara real time.

Tab Application Library

Tab Application Library berisi klien OAuth yang telah dikonfigurasi sebelumnya dan dikelola oleh Looker. Sebaiknya periksa tab Library Aplikasi terlebih dahulu sebelum membuat klien kustom. Jika alat yang ingin Anda hubungkan sudah dikonfigurasi sebelumnya di library, Anda dapat mengaktifkannya tanpa mendaftarkan klien kustom baru, kecuali jika Anda memerlukan URI atau port pengalihan yang berbeda.

Library Aplikasi menyertakan klien yang telah dikonfigurasi sebelumnya untuk integrasi berikut:

• Klien MCP agen AI: Cursor, VS Code, Claude Code, Claude Desktop, ChatGPT, Gemini CLI, Cline, Windsurf, Antigravity, dan Looker Extension untuk VS Code.
• Konektor BI: Sheet yang Terhubung, Data Studio, Tableau Desktop, Microsoft Power BI, dan Microsoft Excel.
• Alat developer: Looker CLI.

Mengaktifkan dan menonaktifkan aplikasi library

Setiap aplikasi klien yang telah dikonfigurasi sebelumnya di Library Aplikasi memiliki tombol Aktifkan:

• Enable: Aktifkan tombol untuk mengizinkan pengguna melakukan autentikasi ke Looker dari aplikasi klien tersebut menggunakan OAuth.
• Nonaktifkan: Nonaktifkan tombol untuk memblokir permintaan otorisasi dari aplikasi klien tersebut. Menonaktifkan aplikasi akan langsung mencabut dan membatalkan semua token OAuth aktif yang diberikan kepada pengguna untuk aplikasi tersebut.

Catatan: Aplikasi yang telah dikonfigurasi sebelumnya di Library Aplikasi tidak dapat dihapus. Fitur ini hanya dapat diaktifkan atau dinonaktifkan.

Client ID untuk setiap aplikasi klien yang telah dikonfigurasi sebelumnya ditampilkan di barisnya. Anda dapat menyalin client ID untuk digunakan dalam konfigurasi sisi klien, tetapi client ID untuk aplikasi library tidak dapat diubah dan tidak dapat dimodifikasi.

Sinkronisasi dengan halaman BI Connectors

Status pengaktifan konektor BI (termasuk Spreadsheet yang Terhubung, Data Studio, Tableau Desktop, Microsoft Power BI, dan Microsoft Excel) otomatis disinkronkan antara halaman Manage OAuth Clients dan halaman BI Connectors:

• Mengubah status pengaktifan tombol konektor BI di halaman Kelola Klien OAuth akan otomatis memperbarui tombol konektor yang sesuai di halaman Konektor BI.
• Mengubah status pengaktifan tombol konektor BI di halaman BI Connectors akan otomatis memperbarui statusnya di halaman Manage OAuth Clients.

Catatan: Halaman BI Connectors tetap tersedia untuk mengonfigurasi setelan Enable Connected Sheets quick link keluar.

URI pengalihan dan konfigurasi port dinamis

Looker memerlukan URI pengalihan OAuth agar sama persis dengan nilai yang terdaftar dan tidak mendukung URI pengalihan karakter pengganti.

• Konektor BI standar: Menggunakan URI pengalihan yang telah dikonfigurasi sebelumnya dan tidak dapat diubah, yang cocok dengan endpoint autentikasi resmi layanan.
• Agen AI dan klien MCP: Beberapa alat AI menggunakan port lokal dinamis atau sementara secara default saat memulai pengalihan OAuth (seperti Claude Code atau Cline). Untuk mengakomodasi alat ini, Looker mendaftarkan terlebih dahulu port default tetap untuk setiap klien library (misalnya, port 8080 untuk Claude Code dan Cline, atau port 7777 untuk Gemini CLI).

Untuk menggunakan klien library yang telah dikonfigurasi sebelumnya dan memerlukan port tetap, pilih salah satu opsi berikut:

1. Konfigurasi klien untuk menggunakan port statis yang telah didaftarkan sebelumnya: Di setelan aplikasi klien atau flag startup, tentukan port yang telah didaftarkan sebelumnya (misalnya, jalankan Claude Code dengan --callback-port 8080).
2. Mendaftarkan klien kustom: Jika Anda ingin menggunakan port lain atau URL callback kustom, daftarkan klien baru di tab Custom Clients dengan URI pengalihan pilihan Anda.

Tab Custom Clients

Tab Klien Kustom memungkinkan Anda mendaftarkan dan mengelola aplikasi klien OAuth 2.0 kustom untuk alat internal, integrasi eksklusif, atau aplikasi pihak ketiga yang tidak tersedia di Library Aplikasi.

Mendaftarkan klien OAuth kustom

Untuk mendaftarkan klien OAuth kustom baru, ikuti langkah-langkah berikut:

1. Di panel Admin, buka bagian Authentication, lalu pilih Kelola Klien OAuth.
2. Pilih tab Custom Clients.
3. Klik Add New.
4. Di panel samping, lengkapi kolom berikut:
   • Client ID: Masukkan ID string unik untuk aplikasi Anda. Client ID tidak boleh diawali dengan com.looker., yang dicadangkan untuk aplikasi yang dikelola Looker.
   • Client Name: Masukkan nama tampilan deskriptif untuk aplikasi.
   • Deskripsi (Opsional): Masukkan deskripsi singkat yang menjelaskan tujuan aplikasi.
   • Redirect URIs: Masukkan satu atau beberapa URI callback yang diizinkan (misalnya, https://mycompany.com/oauth/callback atau http://localhost:8080/callback). Anda dapat memasukkan beberapa URI pengalihan untuk mendukung lingkungan atau port yang berbeda.
   • Restrict to Group ID (Opsional): Masukkan ID numerik grup pengguna Looker. Jika ID numerik ditentukan, hanya pengguna yang termasuk dalam grup tersebut yang dapat memberikan otorisasi dan melakukan autentikasi ke Looker menggunakan aplikasi ini.
5. Klik Add untuk membuat klien kustom.

Melihat detail klien

Untuk melihat informasi mendetail untuk aplikasi klien kustom, ikuti langkah-langkah berikut:

1. Di tab Custom Clients, klik ikon chevron chevron_right di baris klien dalam tabel.
2. Panel samping akan terbuka, menampilkan nama klien, client ID, deskripsi, daftar lengkap URI pengalihan yang diizinkan, dan, jika dikonfigurasi, batasan ID grup.

Mengedit klien kustom

Untuk mengupdate aplikasi klien OAuth kustom yang ada, ikuti langkah-langkah berikut:

1. Di tab Custom Clients, temukan aplikasi klien, lalu klik ikon edit Edit di barisnya.

2. Di panel samping edit, perbarui kolom Client Name, Description, Redirect URIs, atau Restrict to Group ID sesuai kebutuhan.

   Catatan: Kolom Client ID tidak dapat diubah setelah pendaftaran. Jika Anda perlu mengubah client ID, hapus klien dan daftarkan klien baru.

3. Klik Update untuk menyimpan perubahan.

Menghapus klien kustom

Untuk menghapus aplikasi klien OAuth kustom, ikuti langkah-langkah berikut:

1. Di tab Custom Clients, temukan aplikasi klien, lalu klik ikon delete Delete (tempat sampah) di barisnya.
2. Pada dialog konfirmasi, klik Delete.

Peringatan: Menghapus klien kustom akan menghapus pendaftaran klien secara permanen dari Looker dan langsung membatalkan semua kode otorisasi OAuth, token akses, dan token refresh aktif yang dikeluarkan untuk aplikasi tersebut.

Pembatalan validasi token dan keamanan

Untuk menjaga keamanan di seluruh aplikasi yang terhubung, Looker otomatis menerapkan pencabutan token. Jika administrator menghapus aplikasi klien kustom atau menonaktifkan aplikasi di tab Application Library atau Custom Clients, Looker akan segera mencabut semua token refresh OAuth aktif yang diberikan kepada semua pengguna untuk aplikasi tersebut. Kode otorisasi apa pun yang terkait dengan aplikasi tersebut akan dibatalkan secara permanen.

Catatan: Jika aplikasi dihapus atau dinonaktifkan, token akses baru tidak dapat dibuat, dan token akses yang sudah dikeluarkan akan habis masa berlakunya dalam waktu 60 menit.

Jika pengguna atau aplikasi mencoba terhubung menggunakan kredensial yang dicabut, Looker akan menolak otorisasi dan menampilkan error yang menunjukkan bahwa klien OAuth tidak ditemukan atau tidak diaktifkan.