---
url: https://developers.webzenk.kr/guide/login.md
---
# 로그인·계정

## 로그인 수단

| 수단 | 설명 | 필요한 연동 |
|---|---|---|
| 게스트 | 기기 ID로 바로 시작. **기기 단위**라 앱을 지우면 사라져요 | 없음 |
| Google | Google Sign-In / Credential Manager의 ID 토큰 | Google 클라이언트 ID |
| Play Games | Play Games Services v2 서버 인증 코드 | Play Games 서버 클라이언트 ID·Secret |
| Apple | Sign in with Apple의 identity token | 번들 ID (웹은 Services ID) |
| 삼성 계정 | 삼성 Instant Plays에서만 — [삼성 Instant Plays](./samsung) | 삼성 로그인 서명 공개키 |

로그인 플러그인(Google Sign-In, Sign in with Apple 등)은 게임에서 골라 쓰고, SDK·API에는 **받은 토큰만** 넘겨요.

## 계정 연결

게스트로 시작한 유저에게 Google·Apple 계정을 **연결**하면, 다른 기기에서 그 계정으로 로그인해도 같은 유저로 이어져요.
진행이 어느 정도 쌓이면 계정 연결을 안내하세요.

* 이미 다른 유저에 연결된 계정이면 연결할 수 없어요 (`ALREADY_LINKED`). 그 계정으로 로그인하면 그 유저로 들어가요.
* 같은 종류 계정을 두 개 연결할 수는 없어요 (`PROVIDER_ALREADY_LINKED`).

## 세션

* 로그인하면 **Access Token**(기본 1시간)과 **Refresh Token**(기본 30일)을 받아요. SDK는 만료되면 자동으로 갱신해요.
* Refresh Token은 쓸 때마다 새것으로 바뀌어요. 이미 쓴 토큰을 다시 쓰면 탈취로 보고 **그 유저의 모든 세션을 끊어요**.
* 제재된 유저는 로그인·토큰 갱신이 막혀요 (`PLAYER_BANNED`). 이미 받은 Access Token은 만료(최대 1시간)까지 쓸 수 있어요.

## 탈퇴

게임 안에 **탈퇴 메뉴**를 꼭 넣어 주세요. Apple App Store와 Google Play 모두 계정을 만드는 앱에 계정 삭제 기능을 요구해요.
탈퇴를 요청하면 모든 세션이 끝나고, 유예 기간(기본 30일) 안에는 철회할 수 있어요. 자세한 내용은 [개인정보·탈퇴](./privacy)를 보세요.

**관련 문서** · [로그인 API](/api/auth) · [Unity](/sdk/unity/features#로그인) · [HTML5](/sdk/html5/features#로그인)
