Menghubungkan login Kakao

Agar pelanggan bisa mendaftar dengan akun Kakao, Anda harus lebih dulu mendaftarkan layanan Anda di sisi Kakao dan menerima dua nilai. Keduanya adalah REST API key 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 Kakao, Kakao mengembalikan hasilnya ke sebuah alamat yang sudah ditentukan. Alamat ini harus Anda daftarkan ke Kakao, jadi salin dulu sekarang. Anda menempelkannya pada langkah 5.

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

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 Kakao di studio konten, alamat yang sama terlihat pada Step 1, jadi Anda juga bisa menyalinnya dari sana.

Menerima dua nilai dari Kakao

Setelah masuk ke Kakao, kerjakan lima langkah di bawah ini secara berurutan.

1

Membuat aplikasi

  1. Buka layar daftar aplikasi Anda (https://developers.kakao.com/console/app).

  2. Klik Create app (buat aplikasi).

  3. Unggah sebuah gambar pada App icon (ikon aplikasi).

  4. Pada App name (nama aplikasi), masukkan nama yang akan terlihat oleh pelanggan (misalnya Cozy Closet).

  5. Pada Company name (nama perusahaan), masukkan nama toko atau perusahaan Anda. Boleh sama dengan nama aplikasi.

  6. Pada Category (kategori), pilih yang sesuai dengan layanan Anda (misalnya Lifestyle).

  7. Pada App primary domain (domain utama aplikasi), masukkan alamat situs Anda (misalnya https://lemari-hangat.com).

  8. Centang kotak centang persetujuan kebijakan operasional di bagian paling bawah.

  9. Klik Save (simpan).

    Modal Create app. Sebuah gambar sudah diunggah pada App icon, "Cozy Closet" terisi pada App name dan Company name, dan alamat situs terisi pada App primary domain

2

Mengubah menjadi Biz app

Jika tidak Anda ubah menjadi Biz app, email tidak bisa diatur sebagai item persetujuan wajib.

  1. Buka aplikasi yang baru saja Anda buat, lalu masuk ke App Settings → App → General.

  2. Cari bagian Business information (informasi bisnis).

    Bagian Business information. Ada tombol Register business information beserta keterangan "This app is not a Biz app.", dan di bawahnya ada tombol Switch to Biz app for an individual

Berikutnya terbagi dua sesuai ada atau tidaknya nomor registrasi usaha. Cukup kerjakan yang sesuai dengan keadaan Anda.

  1. Klik Register business information (daftarkan informasi bisnis).
  2. Pada Business Type (jenis usaha), pilih Domestic business (Korea) (usaha dalam negeri Korea). Jika usaha Anda bukan usaha Korea, pilih Overseas business (outside Korea) (usaha luar Korea).
  3. Masukkan Business registration number (nomor registrasi usaha).
  4. Klik Confirm (konfirmasi).

Modal Business information. Domestic business (Korea) terpilih pada Business Type, dan di bawahnya ada tiga kolom Business registration number

  1. Selesaikan verifikasi identitas.
  2. Klik Switch to Biz app for an individual (ubah menjadi Biz app untuk perorangan).
  3. Pada Purpose (tujuan), pilih To set email to Required consent item (mengatur email sebagai item persetujuan wajib).
  4. Klik Save.

Modal Switch to Biz app for an individual. To set email to Required consent item terpilih pada Purpose

Jika Anda belum pernah menyetujui ketentuan layanan terpadu Kakao Business, layar persetujuan ketentuan akan terbuka setelah Anda menekan Save. Setelah Anda menyetujuinya, perubahan dilanjutkan.

Apa pun jalurnya, setelah perubahan selesai, lencana di atas nama aplikasi berubah menjadi Biz app.

3

Menyalakan login Kakao

  1. Masuk ke Product Settings → Kakao Login → General.

  2. Nyalakan tombol State (status) pada Usage settings (pengaturan penggunaan).

  3. Klik Activate (aktifkan) pada dialog konfirmasi.

    Layar Product Settings → Kakao Login → General. Tombol State pada Usage settings sudah menyala, dan di bawahnya ada tombol OpenID Connect

Saat tombol itu Anda nyalakan, tombol OpenID Connect muncul di bawahnya. Biarkan tombol itu apa adanya.

4

Mengatur item persetujuan

Ketiga item berikut harus Anda ubah semuanya menjadi Required consent (persetujuan wajib).

NamaTujuan persetujuan
EmailMember identification
NicknameDisplay member name
Profile imageDisplay member profile

  1. Masuk ke Product Settings → Kakao Login → Consent Items.

  2. Pada tabel Personal information (informasi pribadi), klik Set (atur) di baris Email.

  3. Pilih Required consent.

  4. Pada Purpose of consent (tujuan persetujuan), masukkan Member identification.

  5. Klik Save.

    Modal pengaturan item persetujuan. Required consent terpilih untuk Email, dan "Member identification" terisi pada Purpose of consent

  6. Ubah juga Nickname dengan cara yang sama mulai dari nomor 2. Purpose of consent diisi Display member name.

  7. Ubah juga Profile image dengan cara yang sama mulai dari nomor 2. Purpose of consent diisi Display member profile.

  8. Pastikan State ketiga item itu semuanya Required consent.

    Tabel Personal information pada layar item persetujuan. State untuk Nickname, Profile image, dan Email semuanya Required consent, sedangkan item lainnya Unauthorized

Ketiga item harus Anda ubah semuanya

Jika satu saja tertinggal, pelanggan akan terhenti di layar kesalahan Kakao bahkan sebelum sempat mulai masuk.

5

Menyalin REST API key dan Client Secret

  1. Masuk ke App Settings → App → Platform Key.

    Layar App Settings → App → Platform Key. Tiga kartu, yaitu REST API key, JavaScript key, dan Native app key, berjajar

  2. Klik kartu REST API key.

    Layar Edit REST API key. Nilai REST API key ada di paling atas, di bawahnya kolom Kakao Login Redirect URI terlihat masih kosong, dan di bawahnya lagi ada baris Kakao Login dan baris Business Authentication pada Client Secret

  3. Salin nilai REST API key.

  4. Tempelkan alamat yang Anda salin di Alamat yang perlu disalin lebih dulu ke kolom Kakao Login Redirect URI.

  5. Salin Code (kode) pada baris Kakao Login di Client Secret.

  6. Klik Save.

Kuncinya muncul dalam tiga jenis, yaitu REST API key, JavaScript key, dan Native app key, dan yang akan Anda pakai adalah REST API key. Pada Client Secret pun kodenya muncul dalam dua baris, yaitu Kakao Login dan Business Authentication, dan yang akan Anda pakai adalah baris Kakao Login.

Alamatnya cukup pada satu kolom saja. Tombol + di sebelahnya dipakai untuk mendaftarkan alamat tambahan, jadi jangan ditekan. Secret adalah nilai rahasia, jadi jangan beri tahu orang lain dan jangan tulis di tempat yang terbuka untuk umum.

Memasukkan nilai yang diterima ke WEEGLOO

Sekarang dua nilai itu sudah ada di tangan Anda. Berikut kolom di studio konten yang diisi oleh kedua nilai itu.

Layar KakaoStudio konten
REST API keyREST API key
Kode Kakao Login pada Client SecretClient Secret - Kakao Login Code

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 Kakao.
  3. Masukkan REST API key ke kolom REST API key pada Step 2.
  4. Masukkan kode Kakao Login dari Client Secret ke kolom Client Secret - Kakao Login Code.
  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.