连接 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 接收登录结果的位置。所以即使你还没有做好自己的网站,它现在也已经确定。如果你在内容工作室中打开了 KakaoStep 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

切换为 Biz app

不切换为 Biz app 就无法把邮箱设为必填同意项。

  1. 打开刚创建的应用,进入 App Settings → App → General(应用设置 → 应用 → 一般)。

  2. 找到 Business information(企业信息)一节。

    Business information 一节。有 Register business information 按钮和这个应用不是 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(个人开发者切换为 Biz app)。
  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(产品设置 → Kakao 登录 → 一般)。

  2. 打开 Usage settings(使用设置)的 State(状态)开关。

  3. 在确认对话框中点击 Activate(激活)。

    Product Settings → Kakao Login → General 界面。Usage settings 的 State 开关已打开,下方是 OpenID Connect 开关

打开开关后,下方会出现 OpenID Connect 开关。这个开关保持原样。

4

配置同意项

下面三项都要改为 Required consent(必填同意)。

名称同意目的
EmailMember identification
NicknameDisplay member name
Profile imageDisplay member profile
  1. 进入 Product Settings → Kakao Login → Consent Items(产品设置 → Kakao 登录 → 同意项)。

  2. Personal information(个人信息)表中,点击 Email(Kakao 账号邮箱)行的 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 consentDisplay member name

  7. Profile image(头像)也从第 2 步开始用同样的方式修改。Purpose of consentDisplay 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(Kakao 登录重定向 URI)框中,粘贴你在需要先复制的地址中复制的地址。

  5. Client Secret(客户端密钥)的 Kakao Login 行中的 Code(代码)复制下来。

  6. 点击 Save

密钥分为 REST API keyJavaScript key(JavaScript 密钥)、Native app key(原生应用密钥)三种,要用的是 REST API keyClient Secret 的代码也分为 Kakao LoginBusiness Authentication(企业认证)两行,要用的是 Kakao Login 行。

地址只填这一个框就够了。旁边的 + 按钮是用来追加登记地址的,不要点击。Client Secret 是要保密的值,不要告诉别人,也不要写在公开的地方。

把取得的值填入 WEEGLOO

现在你手里有两个值了。这两个值分别填入内容工作室的哪个框,如下所示。

Kakao 界面内容工作室
REST API keyREST API key
Client SecretKakao Login 代码Client Secret - Kakao Login Code

从这里开始,会根据你此前是怎么操作的而分成两条路。

如果你一直在内容工作室中直接配置,请按下面的步骤进行。

  1. 回到服务会员登录的打开社交登录。
  2. 打开 Kakao
  3. Step 2REST API key 框中填入 REST API key。
  4. Client Secret - Kakao Login Code 框中填入 Client Secret 的 Kakao Login 代码。
  5. 点击 保存

如果你把接入工作交给了 AI 智能体,并被告知去取这两个值,就把取得的两个值原样粘贴到对话框中,继续之前的工作。剩下的配置由智能体接着处理。

接下来要做的事

  • 服务会员登录:把取得的值填入内容工作室,完成会员登录的其余配置。
  • 会员角色与权限:创建规定已注册会员能看什么、能用什么的 ServiceUserRole
  • Auth API:介绍把登录接入自己网站代码时所需的请求格式等技术规范。