> For the complete documentation index, see [llms.txt](/llms.txt)

# GS2-Account API 레퍼런스

계정 관리 기능




사용자를 식별하기 위한 계정 관리 기능을 제공하는 서비스입니다.<br>
기기 변경이나 분실에 대비하여, 이메일 주소+비밀번호 또는 소셜 계정을 이용한 데이터 인계 기능을 지원합니다.

### 익명 계정

GS2-Account가 발행하는 것은 익명 계정입니다.<br>
일반적인 계정과 마찬가지로 로그인ID와 비밀번호를 가지지만, 그 두 가지 모두를 시스템이 무작위로 발행하며 사용자에게 입력을 요구하지 않는 것이 특징입니다.<br>
발행된 인증 정보를 디바이스의 로컬 스토리지에 저장해 두고, 두 번째 실행부터는 그 정보로 로그인하여 게임을 재개합니다.

사용자는 등록의 번거로움 없이 플레이를 시작할 수 있고, 게임 측은 개인정보를 보관하지 않아도 됩니다.

### 인계

인증 정보를 디바이스의 로컬 스토리지에만 보관하면, 단말의 고장·분실·기기 변경으로 계정을 잃게 됩니다.<br>
이를 피하기 위해 사용자는 원하는 시점에 인계 정보를 등록할 수 있습니다.

인계 정보에는 각종 플랫폼의 ID 기반이나 SNS 계정으로 인증하여 얻은 사용자ID 등을 기록합니다.<br>
새로운 디바이스에서 같은 ID 기반에 로그인하고, 거기서 얻은 사용자ID로 인계를 실행하면 원래의 익명 계정으로 로그인하기 위한 정보를 취득할 수 있습니다.<br>
취득한 정보를 다시 로컬 스토리지에 저장하여 이후의 로그인에 이용합니다.

인계 정보는 슬롯 번호 0~1024 범위에서 관리되며, 최대 1,025종류까지 등록할 수 있습니다.<br>
슬롯마다 다른 인증 수단을 할당할 수 있으므로, 사용자가 인계 수단을 선택하도록 하는 운용도 가능합니다.

### OpenID Connect 연동

인계 정보의 등록과 인계의 실행에 OpenID Connect를 준수하는 인증 시스템을 이용할 수 있습니다.<br>
연동 대상은 마스터 데이터의 슬롯마다 Discovery 엔드포인트 URL·클라이언트ID·클라이언트 시크릿으로 지정합니다.<br>
Sign in with Apple의 경우에는 클라이언트 시크릿 대신 Team ID·Key ID·개인키(PEM)를 지정합니다.

OpenID Connect 연동이 설정된 슬롯은 임의의 사용자 식별자와 비밀번호를 사용한 인계 정보 등록 및 인계 실행을 할 수 없게 됩니다.

[마이크로서비스 소개 / GS2-Account](../../microservices/account)



- [GS2-Account Deploy/CDK 레퍼런스](/ko/api_reference/account/deploy/)
  
- [GS2-Account SDK API 레퍼런스](/ko/api_reference/account/sdk/)
  
- [GS2-Account SDK for Game Engine API 레퍼런스](/ko/api_reference/account/game_engine/)
  
- [GS2-Account 마스터 데이터 레퍼런스](/ko/api_reference/account/master_data/)
  
- [GS2-Account 스크립트 트리거 레퍼런스](/ko/api_reference/account/script/)