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 |