70. 본인인증

본인인증 연동

연동 방식

카카오게임SDK에서는 아래 2가지 방식으로 본인인증을 지원합니다.

1. 특정 시점에 본인 인증을 진행

2. 카카오 로그인 과정에서 본인인증을 진행

개발사에서는 게임 기획에 따라 적절한 방식을 선택할 수 있습니다. 선택한 방식에 따라 게임 설정이 달라지므로 반드시 카카오에 어떤 방식으로 사용할 것인지 전달해야합니다.

1. 특정 시점에서 본인인증을 진행

개발사에서 특정 시점(예> 경매장)에 본인인증을 진행하고 싶은 경우에 사용합니다.

1-1. 나이 제한 유저는 게임 플레이를 막는 게임인 경우

로그인 시에는 SDK가 내부적으로 본인 인증을 상태를 확인하여 나이 제한 미만 유저인 경우 안내 팝업을 노출하고 게임을 종료시킵니다. 

그외 본인인증을 한적이 없는 경우에는 SMS 본인 인증 절차를 진행하지 않고 로그인이 성공합니다.

본인인증을 원하는 특정 시점에서 KGKakaoProfile.requestAgeVerification (이하 본인인증API)을 호출하면 본인 인증을 진행하여 유저의 나이 제한 상태를 확인할 수 있습니다.

본인인증 API를 호출하면, SDK내부적으로 아래와 그림과 같이 처리하고 있으니, 참고해주세요.

Open

본인인증 완료 후 결과가 미성년자인 경우 UnderAgePlayer에러가 반환됩니다. 

UnderAgePlayer인 경우, 미성년자가 플레이할 수 없는 게임에서는 유저에게 안내메시지 노출 후 로그아웃 시키고 앱을 종료시켜야 합니다.

해당 유저가 동일한 계정으로 다시 로그인을 진행할 경우 미성년자 정보가 있기때문에 로그인에 실패하고 자동으로 게임이 종료 됩니다.

1-2. 나이 제한 유저도 플레이 가능하지만 특정 컨텐츠에만 제한될 경우

이 경우 본인 인증이 여부나 결과가 로그인에 아무런 영향을 미치지 않기 때문에 모든 유저가 로그인 가능합니다. 

게임에서는 로그인 이후 KGKakaoProfile.requestAgeVerification 를 호출하여 유저의 상태 정보를 가져와 게임의 기획에 따라 자유롭게 이용할 수 있습니다.

1-2번 방식으로 본인 인증을 처리하고자 하는 경우, kakao_game_sdk_configuration.xml에 아래와 같이 키를 지정합니다.

예시) 

2. 카카오 로그인 과정에서 본인 인증을 진행

카카오게임SDK가 카카오 로그인 과정에서 본인 인증을 처리 합니다. 

2-1. 나이 제한 유저는 게임 플레이를 막는 게임인 경우

본인 인증을 진행하지 않은 유저의 경우 SMS 본인 인증이 진행되고 나이제한 미만 유저로 판명될 경우 로그인에 실패합니다.

본인 인증을 진행하지 않으면 게임에 로그인 할 수 없습니다.

2-2. 나이 제한 유저도 플레이 가능하지만 특정 컨텐츠에만 제한될 경우

만약 제한 나이 미만인 경우에도 로그인은 성공하고 특정 컨텐츠 이용에만 제한을 둘 경우 개발사에서 config 파일로 조정할 수 있습니다.

본인 인증을 진행하지 않은 유저의 경우 SMS 본인 인증이 진행되고 나이제한 미만 유저인 경우에도 로그인에 성공합니다.

로그인 성공 이후 1번 API를 이용하여 유저의 상태를 체크합니다.

2-2번 방식으로 본인인증을 처리하고자 하는 경우, kakao_game_sdk_configuration.xml에 아래와 같이 두 개의 키를 지정합니다.

예시)