Kakao ログインを連携する

お客さまが Kakao アカウントで登録できるようにするには、まず Kakao 側に自分のサービスを登録して、二つの値を受け取る必要があります。REST API key と Client Secret です。

このページは、その二つの値を受け取る手順を案内します。受け取った値を WEEGLOO に入れる方法は受け取った値を WEEGLOO に入れるにあります。

先にコピーしておくアドレス

お客さまが Kakao でログインを終えると、Kakao はその結果を決まったアドレスへ返します。このアドレスを Kakao に登録する必要があるので、先にコピーしておいてください。5 番目のステップで貼り付けます。

下で自分の Space を選ぶと、識別子が埋まったアドレスになります。

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

自分で埋めたい場合は、{spaceId} のところに自分の Space の識別子を入れてください。コンテンツスタジオでその Space を開いてブラウザのアドレスバーを見ると、/spaces/ の次に来る値が識別子です。

このアドレスは自分のサイトのアドレスではなく、WEEGLOO がログイン結果を受け取る場所です。ですから、自分のサイトをまだ作っていなくても今の時点で決まります。コンテンツスタジオで Kakao を有効にしていれば、Step 1 に同じアドレスが表示されるので、そこからコピーしてもかまいません。

Kakao で二つの値を受け取る

Kakao にログインしたあと、以下の五つのステップを順に進めてください。

1

アプリを作成する

  1. マイアプリケーションの画面(https://developers.kakao.com/console/app)を開いてください。

  2. Create app(アプリ作成)を押してください。

  3. App icon(アプリアイコン)に画像をアップロードしてください。

  4. App name(アプリ名)に、お客さまに見せる名前を入力してください(例: Cozy Closet)。

  5. Company name(会社名)に自分の店や会社の名前を入力してください。アプリ名と同じでもかまいません。

  6. Category(カテゴリ)で自分のサービスに合うものを選んでください(例: Lifestyle)。

  7. App primary domain(アプリの代表ドメイン)に自分のサイトのアドレスを入力してください(例: https://cozy-closet.com)。

  8. 一番下にある運営方針への同意のチェックボックスにチェックを入れてください。

  9. Save(保存)を押してください。

    アプリ作成のモーダル。App icon に画像がアップロードされ、App name と Company name に「Cozy Closet」、App primary domain にサイトのアドレスが入力されています

2

ビジネスアプリに切り替える

ビジネスアプリに切り替えないと、メールを必須の同意項目に設定できません。

  1. いま作成したアプリを開き、App Settings → App → General(アプリ設定 → アプリ → 一般)へ移動してください。

  2. Business information(ビジネス情報)の節を探してください。

    Business information の節。Register business information ボタンと「This app is not a Biz app.」という案内があり、その下に Switch to Biz app for an individual ボタンがあります

ここから先は事業者登録番号があるかどうかで分かれます。自分の状況に合うほうだけを行ってください。

  1. Register business information(事業者情報の登録)を押してください。
  2. Business Type(事業者区分)で Domestic business (Korea)(韓国国内の事業者)を選んでください。韓国国内の事業者でない場合は Overseas business (outside Korea)(韓国国外の事業者)を選んでください。
  3. Business registration number(事業者登録番号)を入力してください。
  4. Confirm(確認)を押してください。

Business information のモーダル。Business Type で Domestic business (Korea) が選択されていて、その下に Business registration number の欄が三つあります

  1. 本人確認を済ませてください。
  2. Switch to Biz app for an individual(個人開発者のビジネスアプリ切り替え)を押してください。
  3. Purpose(切り替えの目的)で To set email to Required consent item(メールを必須同意にするため)を選んでください。
  4. Save を押してください。

Switch to Biz app for an individual のモーダル。Purpose に To set email to Required consent item が選択されています

Kakao Business の統合サービス利用規約に同意したことがない場合は、Save を押したあとに規約同意の画面が開きます。同意すると切り替えが続きます。

どちらの場合も、切り替えが終わるとアプリ名の上のバッジが Biz app(ビジネスアプリ)に変わります。

3

Kakao ログインを有効にする

  1. Product Settings → Kakao Login → General(製品設定 → カカオログイン → 一般)へ移動してください。

  2. Usage settings(使用設定)の State(状態)トグルを有効にしてください。

  3. 確認ダイアログで Activate(有効化)を押してください。

    Product Settings → Kakao Login → General の画面。Usage settings の State トグルが ON になっていて、その下に OpenID Connect のトグルがあります

トグルを有効にすると、下に OpenID Connect のトグルが表示されます。このトグルはそのままにしておいてください。

4

同意項目を設定する

下の三つの項目をすべて Required consent(必須同意)に変える必要があります。

名前同意の目的
EmailMember identification
NicknameDisplay member name
Profile imageDisplay member profile

  1. Product Settings → Kakao Login → Consent Items(製品設定 → カカオログイン → 同意項目)へ移動してください。

  2. Personal information(個人情報)の表で、Email(カカオアカウントのメール)の行にある Set(設定)を押してください。

  3. Required consent を選んでください。

  4. Purpose of consent(同意の目的)に Member identification と入力してください。

  5. Save を押してください。

    同意項目設定のモーダル。Email に Required consent が選択され、Purpose of consent に「Member identification」が入力されています

  6. Nickname(ニックネーム)も 2 番から同じ方法で変えてください。Purpose of consent は Display member name です。

  7. Profile image(プロフィール画像)も 2 番から同じ方法で変えてください。Purpose of consent は Display member profile です。

  8. 三つの項目の State がすべて Required consent になっているか確認してください。

    同意項目画面の Personal information の表。Nickname、Profile image、Email の State がすべて Required consent で、残りの項目は Unauthorized です

三つの項目をすべて変える必要があります

一つでも残しておくと、お客さまはログインを始める前に Kakao のエラー画面で止まります。

5

REST API key と Client Secret をコピーする

  1. App Settings → App → Platform Key(アプリ設定 → アプリ → プラットフォームキー)へ移動してください。

    App Settings → App → Platform Key の画面。REST API key、JavaScript key、Native app key の三つのカードが並んでいます

  2. REST API key のカードを押してください。

    Edit REST API key の画面。一番上に REST API key の値があり、その下に Kakao Login Redirect URI の欄が空のまま表示され、さらに下に Client Secret の Kakao Login の行と Business Authentication の行があります

  3. REST API key の値をコピーしておいてください。

  4. Kakao Login Redirect URI(カカオログインのリダイレクト URI)の欄に、先にコピーしておくアドレスでコピーしたアドレスを貼り付けてください。

  5. Client Secret の Kakao Login の行にある Code(コード)をコピーしておいてください。

  6. Save を押してください。

キーは REST API key、JavaScript key、Native app key の三種類が表示されますが、使うのは REST API key です。Client Secret もコードが Kakao Login と Business Authentication(ビジネス認証)の二行で表示されますが、使うのは Kakao Login の行です。

アドレスはこの欄一つだけで足ります。横の + ボタンはアドレスをさらに登録するときに使うものなので、押さないでください。secret は秘密の値なので、他の人に教えたり、公開された場所に書き残したりしないでください。

受け取った値を WEEGLOO に入れる

これで二つの値が手元にあります。二つの値がコンテンツスタジオのどの欄に入るかは、次のとおりです。

Kakao の画面コンテンツスタジオ
REST API keyREST API key
Client Secret の Kakao Login のコードClient Secret - Kakao Login Code

ここから先は、これまでどのように作業してきたかによって分かれます。

コンテンツスタジオで直接設定していた場合は、次のように進めてください。

  1. サービス会員ログインのソーシャルログインを有効にする手順に戻ってください。
  2. Kakao を有効にしてください。
  3. Step 2 の REST API key の欄に REST API key を入力してください。
  4. Client Secret - Kakao Login Code の欄に Client Secret の Kakao Login のコードを入力してください。
  5. 保存 を押してください。

AI エージェントに連携を任せていて、値を受け取ってくるように案内された場合は、受け取った二つの値をそのままチャットに貼り付けて、作業を続けてください。残りの設定はエージェントが引き続き処理します。

次にやること

  • サービス会員ログイン: 受け取った値をコンテンツスタジオに入力し、会員ログインの残りの設定を終えます。
  • 会員のロールと権限: 登録した会員が何を見て使えるかを定める ServiceUserRole を作ります。
  • Auth API: ログインを自分のサイトのコードに組み込むときに必要となる、リクエスト形式などの技術仕様を扱います。