Login
This guide explains how to integrate login functionality in the game.
What Does It Mean to Login?
Login is the process of being authenticated by the Kakao platform server after the authentication of various IDPs (Kakao, Facebook, Google, or Apple).
Users can use the functions provided by the platform service and IDP service after login.
Login Policy by Country
IDP
Authentication methods may be newly added or discontinued depending on the circumstances of the service provider.
Supported IDP
Guest
Kakao
Facebook
Google
Apple
Twitter “X”
Domestic
For iOS, according to App Store policies, if a developer's proprietary authentication system is not provided and only social IDPs are supported, "Sign in with Apple" must be supported as a mandatory option.
If you want to receive Google features domestically, you must implement the following functions on Android. (For more details, contact the Kakao business manager.)
When using Kakao Login, Google authentication must be applied in the background.
Support guest login, and when switching to a Kakao account, Google authentication must also be applied in the background.
Integration with Google Achievements.
International(Global)
If you want to receive Google features internationally, you can implement multi-login that includes Google Login. (Kakao Login is not required.)
For users who logged in as guests, provide an account linking feature that allows them to link their account to Google, Facebook, Kakao, Apple, or Twitter.
Apple Login is also supported on Android.
Login Process
(1) IDP(identity provider) Login
Login SDK ExampleThe kakaogames SDK performs user authentication via the IDP and returns the result after going through a procedure that verifies the IDP accessToken via the kakaogames API.
You can obtain authentication information that includes the "Player ID" and "accessToken."
(7) Game Server > Token Validation (User Validation)
Validation (/auth) | /auth/validationThe validity is verified through the "KG APP ID," "Access Platform," and "accessToken" headers.
If there is a game server, this step must be performed to verify the validity of the game client connected to the game server.
In cases of abnormal status (protection, sanctions, withdrawal) or incorrect information requests, the process will be blocked at steps (3) and (7).