Menghubungkan login Kakao

Agar pengguna layanan Anda bisa mendaftar dengan akun Kakao, Anda harus lebih dulu mendaftarkan layanan Anda di sisi Kakao dan menerima REST API key serta Client Secret.

Halaman ini memandu urutan untuk menerima REST API key dan Client Secret. Cara memasukkan kedua nilai itu ke WEEGLOO ada di Memasukkan REST API key dan Client Secret ke WEEGLOO.

Menerima REST API key dan Client Secret dari Kakao

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

1

Membuat aplikasi

Jika Anda sudah punya aplikasi yang selama ini dipakai, Anda boleh memakai aplikasi itu apa adanya tanpa membuat yang baru. Dalam hal itu, lewati langkah ini dan lanjutkan ke Mengubah menjadi Biz app.

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

  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 pengguna (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://cozy-closet.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.

Jika lencana di atas nama aplikasi sudah Biz app, lewati langkah ini dan lanjutkan ke Menyalakan login Kakao.

  1. Jika layar aplikasi belum terbuka, pada layar daftar aplikasi Anda (https://developers.kakao.com/console/app (terbuka di tab baru)), klik aplikasi yang akan Anda pakai untuk login.

  2. Masuk ke App Settings → App → General.

  3. 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. Jika verifikasi identitas belum Anda selesaikan, selesaikan itu lebih dulu. Anda bisa menuju ke sana dari area profil di kanan atas layar, di bawah Account settings → Identity verification (pengaturan akun → verifikasi identitas).
  2. Kembalilah ke layar ini lalu 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. Jika layar aplikasi belum terbuka, pada layar daftar aplikasi Anda (https://developers.kakao.com/console/app (terbuka di tab baru)), klik aplikasi yang akan Anda pakai untuk login.

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

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

  4. 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

Pada layar Consent Items (item persetujuan) login Kakao, ketiga item berikut harus Anda ubah semuanya menjadi Required consent (persetujuan wajib): Email (alamat email akun Kakao), Nickname (nama panggilan), dan Profile image (foto profil). Jika satu saja Anda biarkan apa adanya, pengguna akan terhenti di layar kesalahan Kakao bahkan sebelum sempat mulai masuk.

  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

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. Kuncinya muncul dalam tiga jenis, dan inilah yang akan Anda pakai.

    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. Tempelkan alamat di bawah ini ke kolom Kakao Login Redirect URI (URI pengalihan login Kakao). Jika Anda memilih Space Anda, pengenalnya akan terisi.

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

    Jika Anda tidak tahu yang mana Space Anda dan integrasinya sudah Anda serahkan kepada agen AI, ada juga cara menanyakannya kepada agen tersebut. Mintalah pada jendela obrolan, "Beri tahu Redirect URI yang harus didaftarkan untuk login Kakao", maka Anda menerima alamat yang sudah lengkap.

  4. Salin nilai REST API key di paling atas.

  5. Salin Code (kode) pada baris Kakao Login di Client Secret. Bukan kode pada baris Business Authentication (autentikasi bisnis) di bawahnya.

  6. Klik Save.

Secret adalah nilai rahasia, jadi jangan beri tahu orang lain dan jangan tulis di tempat yang terbuka untuk umum.

Memasukkan REST API key dan Client Secret ke WEEGLOO

Sekarang REST API key dan Client Secret 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 REST API key dan Client Secret, 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.