Connecting Kakao Login

To let shoppers sign up with a Kakao account, you first register your service with Kakao and receive two values. They are the REST API key and the client secret.

This page covers the order in which you receive those two values. Putting the values you received into WEEGLOO is covered in Putting the values you received into WEEGLOO.

The address to copy first

When a shopper finishes logging in at Kakao, Kakao sends the result back to a set address. You have to register this address with Kakao, so copy it first. You paste it in step 5.

Pick your Space below and you get the address with the identifier filled in.

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

If you would rather fill it in yourself, put the identifier of your Space in the {spaceId} slot. Open that Space in the content studio and look at the browser address bar. The value that comes after /spaces/ is the identifier.

This address is not your site's address. It is where WEEGLOO receives the login result. So it is settled now even if you have not built your site yet. If you turned on Kakao in the content studio, the same address appears in Step 1, so you can copy it from there.

Getting the two values from Kakao

Sign in to Kakao, then work through the five steps below in order.

1

Creating an app

  1. Open the applications screen (https://developers.kakao.com/console/app).

  2. Click Create app.

  3. Upload an image in App icon.

  4. In App name, enter the name shoppers will see (for example, Cozy Closet).

  5. In Company name, enter the name of your shop or company. It can be the same as the app name.

  6. In Category, choose the one that fits your service (for example, Lifestyle).

  7. In App primary domain, enter your site's address (for example, https://cozy-closet.com).

  8. Check the operating policy checkbox at the very bottom.

  9. Click Save.

    The Create app modal. An image is uploaded in App icon, App name and Company name hold Cozy Closet, and App primary domain holds the site address

2

Switching to a Biz app

Until you switch to a Biz app, you cannot set email as a required consent item.

  1. Open the app you just created and go to App Settings → App → General.

  2. Find the Business information section.

    The Business information section. The Register business information button and the notice that this app is not a Biz app are there, with the Switch to Biz app for an individual button below

What comes next splits depending on whether you have a business registration number. Do only the side that fits your situation.

  1. Click Register business information.
  2. In Business Type, choose Domestic business (Korea). If you are not a domestic business, choose Overseas business (outside Korea).
  3. Enter the Business registration number.
  4. Click Confirm.

The Business information modal. Domestic business (Korea) is selected in Business Type, with the three Business registration number boxes below it

  1. Complete identity verification.
  2. Click Switch to Biz app for an individual.
  3. In Purpose, choose To set email to Required consent item.
  4. Click Save.

The Switch to Biz app for an individual modal. Purpose holds To set email to Required consent item

If you have never agreed to the Kakao Business consolidated Terms of Service, a terms agreement screen opens after you click Save. Once you agree, the switch carries on.

Either way, when the switch is finished, the badge above the app name changes to Biz app.

3

Turning on Kakao Login

  1. Go to Product Settings → Kakao Login → General.

  2. Turn on the State toggle in Usage settings.

  3. In the confirmation dialog, click Activate.

    The Product Settings → Kakao Login → General screen. The State toggle under Usage settings is on, with the OpenID Connect toggle below it

When you turn the toggle on, an OpenID Connect toggle appears below it. Leave that toggle as it is.

4

Setting the consent items

You have to change all three items below to Required consent.

NamePurpose of consent
EmailMember identification
NicknameDisplay member name
Profile imageDisplay member profile

  1. Go to Product Settings → Kakao Login → Consent Items.

  2. In the Personal information table, click Set on the Email row.

  3. Choose Required consent.

  4. In Purpose of consent, enter Member identification.

  5. Click Save.

    The consent item setting modal. Required consent is selected for Email, and Purpose of consent holds Member identification

  6. Change Nickname the same way, starting from step 2. Its Purpose of consent is Display member name.

  7. Change Profile image the same way, starting from step 2. Its Purpose of consent is Display member profile.

  8. Check that the State of all three items is Required consent.

    The Personal information table on the Consent Items screen. The State of Nickname, Profile image, and Email is Required consent, and the remaining items are Unauthorized

You have to change all three items

If you leave even one of them out, shoppers are blocked on a Kakao error screen before they can even start logging in.

5

Copying the REST API key and the client secret

  1. Go to App Settings → App → Platform Key.

    The App Settings → App → Platform Key screen. The REST API key, JavaScript key, and Native app key cards sit side by side

  2. Click the REST API key card.

    The Edit REST API key screen. The REST API key value is at the top, the Kakao Login Redirect URI box is empty below it, and further down are the Kakao Login row and the Business Authentication row of Client Secret

  3. Copy the REST API key value.

  4. In the Kakao Login Redirect URI box, paste the address you copied in The address to copy first.

  5. Copy the Code on the Kakao Login row of Client Secret.

  6. Click Save.

Three kinds of key appear, REST API key, JavaScript key, and Native app key, and the one you use is the REST API key. In Client Secret the code also appears on two rows, Kakao Login and Business Authentication, and the one you use is the Kakao Login row.

This single box is all the address takes. The + button next to it is for registering more addresses, so do not click it. The secret is a secret value. Do not tell it to anyone, and do not write it down anywhere public.

Putting the values you received into WEEGLOO

Now you have the two values in hand. Here is which box in the content studio each of the two values goes into.

Kakao screenContent studio
REST API keyREST API key
The Code on the Kakao Login row of Client SecretClient Secret - Kakao Login Code

From here the path splits depending on how you have been working so far.

If you were configuring this directly in the content studio, follow these steps.

  1. Go back to turning on social login in Service Member Login.
  2. Turn on Kakao.
  3. Enter the REST API key in the REST API key box in Step 2.
  4. Enter the client secret's Kakao Login code in the Client Secret - Kakao Login Code box.
  5. Click Save.

If you handed the integration to an AI agent and were told to go and get the values, paste the two values you received into the chat as they are and carry on with what you were doing. The agent handles the rest of the configuration from there.

What to do next

  • Service Member Login: put the values you received into the content studio and finish the rest of the member login configuration.
  • Member Roles and Permissions: create the ServiceUserRole that decides what a signed-up member can see and use.
  • Auth API: covers technical specifications such as the request format you need when wiring login into your own site's code.