Menghubungkan login GitHub

Agar pelanggan bisa mendaftar dengan akun GitHub, Anda harus lebih dulu mendaftarkan layanan Anda di sisi GitHub dan menerima dua nilai. Keduanya adalah client ID dan client secret.

Halaman ini memandu urutan untuk menerima kedua nilai itu. Cara memasukkan nilai yang Anda terima ke WEEGLOO ada di Memasukkan nilai yang diterima ke WEEGLOO.

Alamat yang perlu disalin lebih dulu

Saat pelanggan selesai masuk di GitHub, GitHub mengembalikan hasilnya ke sebuah alamat yang sudah ditentukan. Alamat ini harus Anda daftarkan ke GitHub, jadi salin dulu sekarang. Anda menempelkannya pada langkah 1.

Pilih Space Anda di bawah ini, maka alamatnya akan terisi dengan pengenal Space tersebut.

Space
https://auth.weegloo.com/v1/spaces/{spaceId}/login/oauth2/code/github

Jika Anda ingin mengisinya sendiri, masukkan pengenal Space Anda pada bagian {spaceId}. Buka Space itu di studio konten lalu lihat bilah alamat browser. Nilai yang muncul setelah /spaces/ adalah pengenalnya.

Alamat ini bukan alamat situs Anda, melainkan tempat WEEGLOO menerima hasil login. Karena itu alamat ini sudah pasti sekarang walaupun situs Anda belum dibuat. Jika Anda sudah menyalakan GitHub di studio konten, alamat yang sama terlihat pada Step 1, jadi Anda juga bisa menyalinnya dari sana.

Menerima dua nilai dari GitHub

Setelah masuk ke GitHub, kerjakan dua langkah di bawah ini secara berurutan. Yang Anda kerjakan di sini tidak dikenai biaya.

1

Mendaftarkan OAuth App

OAuth yang muncul di layar adalah nama cara yang membuat orang bisa masuk dengan akun GitHub. Dua nilai itu ada di dalam satu aplikasi yang Anda daftarkan di sini.

  1. Buka layar pengaturan pengembang (https://github.com/settings/developers).

  2. Pada menu kiri, klik OAuth Apps.

  3. Klik New OAuth app.

    Layar OAuth Apps. Pada menu kiri ada GitHub Apps, OAuth Apps, dan Personal access tokens; daftarnya kosong dan tombol New OAuth app terlihat

  4. Pada Application name, masukkan nama yang akan terlihat oleh pelanggan (misalnya Lemari Hangat).

  5. Pada Homepage URL, masukkan alamat situs Anda (misalnya https://lemari-hangat.com).

  6. Pada kolom Redirect URI, tempelkan alamat yang Anda salin di Alamat yang perlu disalin lebih dulu.

  7. Klik Register application.

    Formulir Register a new OAuth app. Application name berisi "Lemari Hangat", Homepage URL berisi alamat situs, dan Redirect URI berisi alamat WEEGLOO

Jika situs Anda belum dibuat, tuliskan alamat yang akan Anda pakai nanti pada Homepage URL. Anda bisa mengubahnya kemudian. Application description bersifat opsional, dan isinya ditampilkan apa adanya kepada pelanggan, jadi tulislah kalimat yang akan dibaca pelanggan.

2

Menyalin client ID dan client secret

Saat Anda menekan Register application, layar pengaturan aplikasi yang baru saja Anda daftarkan terbuka. Salah satu dari dua nilai itu, yaitu Client ID, sudah tertulis di sini. Adapun secret Anda buat sekarang dengan menekan tombol.

  1. Salin nilai yang tertulis pada Client ID.

  2. Klik Generate a new client secret di sebelah kanan judul Client secrets.

    Layar pengaturan aplikasi tepat setelah pendaftaran. Nilai Client ID terlihat dan di sebelah kanan judul Client secrets ada tombol Generate a new client secret

  3. Klik ikon salin di sebelah kanan nilai yang telah dibuat untuk menyalin secret.

    Layar tepat setelah secret dibuat. Terlihat keterangan biru beserta nilai Client secret dan ikon salin

Setelah Anda meninggalkan layar ini, secret tidak bisa dilihat lagi

Client ID tetap ada di layar ini sehingga kapan saja bisa Anda lihat lagi, tetapi secret tidak begitu. Jika Anda kehilangannya, buat yang baru lewat Generate a new client secret, lalu masukkan lagi nilai yang baru itu ke WEEGLOO. Client secret adalah rahasia, persis seperti namanya. Jangan beri tahu orang lain, dan jangan tulis di tempat yang terbuka untuk umum.

Email harus dipublikasikan agar login berhasil

Login GitHub punya satu syarat. Akun GitHub yang dipakai masuk harus mempublikasikan emailnya.

Saat pelanggan masuk dengan GitHub, WEEGLOO ikut menerima email publik akun tersebut dan menyimpannya pada anggota. Dalam satu Space yang sama, satu email hanya bisa dipakai mendaftar satu kali. Pada akun yang belum menentukan email publik, nilai ini tidak diserahkan, sehingga pendaftaran berhenti di situ.

Kalau berhenti, pelanggan melihat layar keterangan yang ditampilkan WEEGLOO. Di sana tertulis dalam bahasa pelanggan bahwa emailnya tidak bisa diambil dan apa yang perlu dilakukan, disertai tombol untuk kembali ke situs Anda.

Layar keterangan WEEGLOO yang menyatakan email tidak bisa diambil. Ada penjelasan sebabnya beserta tombol Kembali ke awal

Pada saat itu hasil login tidak sampai ke situs Anda. Karena itu kode situs Anda tidak bisa mengetahui keadaan ini, apalagi menanganinya.

Yang menyelesaikannya adalah pelanggan. Saat pelanggan membuka Public profile pada pengaturan akun GitHub (https://github.com/settings/profile), ada item Public email. Jika di sana ia memilih email yang akan ditampilkan, login berikutnya sudah lolos. Pada akun yang belum memilihnya, hanya tertulis Select a verified email to display.

Layar pengaturan profil GitHub. Public profile terpilih pada menu kiri, dan pada dropdown di bawah Public email terlihat Select a verified email to display

Yang bisa Anda lakukan di situs Anda adalah menuliskan syarat ini lebih dulu di tempat pelanggan masuk dengan GitHub, sehingga pelanggan mengetahuinya sebelum terhalang.

Memasukkan nilai yang diterima ke WEEGLOO

Sekarang dua nilai itu sudah ada di tangan Anda. Dari sini jalurnya terbagi sesuai cara Anda bekerja selama ini.

Jika Anda sedang mengatur langsung di studio konten, lakukan seperti ini.

  1. Kembalilah ke bagian menyalakan login sosial di Login anggota layanan.
  2. Nyalakan GitHub.
  3. Masukkan client ID ke kolom Client ID pada Step 2.
  4. Masukkan client secret ke kolom Client Secret.
  5. Klik Simpan.

Jika Anda menyerahkan integrasinya kepada agen AI dan diminta mengambil nilainya, tempelkan saja kedua nilai yang Anda terima apa adanya ke jendela obrolan lalu lanjutkan pekerjaan Anda. Sisa pengaturannya ditangani agen tersebut.

Langkah berikutnya

  • Login anggota layanan: memasukkan nilai yang Anda terima ke studio konten dan menuntaskan sisa pengaturan login anggota.
  • Peran dan izin anggota: membuat ServiceUserRole yang menentukan apa yang boleh dilihat dan dipakai anggota yang mendaftar.
  • Auth API: membahas spesifikasi teknis seperti format permintaan yang Anda butuhkan saat memasang login ke kode situs Anda sendiri.