Kakao signs users in with their Kakao account, the default consumer identity in South Korea, alongside NAVER.
Copy the redirect URI
In the Authdog console, select the project and environment, open Authentication > Providers, find Kakao, and click Enable. Copy the redirect URI shown in the form:
https://identity.authdog.com/api/v1/callback/<connectionId>Create the application
- Open Kakao Developers and create an application.
- Under App Keys, note the REST API key: that is the client ID.
- Enable Kakao Login and add the redirect URI from Authdog under Redirect URI.
- Under Consent Items, enable the profile and email items. Email requires business verification.
- Under Security, generate a Client Secret and set it to enabled.
Configure Authdog
| Field | Value |
|---|---|
| Client ID | The Kakao REST API key |
| Client Secret | The generated Client Secret, with its status set to enabled |
Save, then toggle the connection active.
What Kakao returns
Authdog requests the profile account_email scopes and reads the profile from https://kapi.kakao.com/v2/user/me.
The user endpoint returns the Kakao id, nickname, profile image, and (when the consent item is approved) the account email with its verified flag.
Email is an optional consent item. Until Kakao approves it for your app, expect users with no email address.
Test it
- Open your environment's hosted sign-in page, or link to
https://identity.authdog.com/api/v1/signin/<connectionId>. - Select the Kakao button and complete the flow.
- Confirm the user appears under Users in the console with a Kakao identity linked.
Troubleshooting
| Symptom | Cause |
|---|---|
KOE006 invalid redirect |
The redirect URI is not registered on the app |
KOE101 invalid client |
The client secret is generated but not enabled |
| No email in the profile | The email consent item is not approved for this app |
| Redirect or callback URL error | The URI registered with the provider does not match Authdog's exactly |
| Works in one environment only | Each environment has its own connectionId, and so its own redirect URI to register |
Related
| Read | To learn how to |
|---|---|
| Connectors | Set up any other social provider |
| NAVER | Add the other major Korean consumer identity |