서비스 접근 제어
'서비스 접근 제어'는 사용자 국가 코드, 서버 점검 상태, 앱 클라이언트 버전을 기준으로 접속 제한이나 안내에 필요한 결과를 반환하는 Hive Axyl SDK 기능입니다. 앱은 이 결과에 따라 접속 차단, 안내 화면 표시, 리다이렉트를 구현합니다.
제공 기능
Hive Axyl은 서비스 국가 제한, 서버 점검, 클라이언트 업데이트 기능을 제공합니다. 세 기능은 각각 별도의 메서드로 확인하며, 어떤 기능을 어떤 순서로 호출할지는 앱이 정합니다.
| 기능 | 사용자 앱 접속을 제어하는 기준 | 앱 클라이언트가 처리하는 일 |
|---|---|---|
| 서비스 국가 제한 | 앱이 전달한 사용자 국가 코드와 콘솔에 등록한 차단 국가 목록 | 국가별 사용자 진입 차단 또는 접속 안내 화면 노출 |
| 서버 점검 | 서버 점검 일정 등 점검 설정, 현재 시각 | 접속 제한 또는 점검 안내 화면 노출 |
| 클라이언트 업데이트 | 현재 앱 클라이언트 버전과 콘솔에 등록한 업데이트 대상 버전 | 강제로 앱 클라이언트 업데이트 또는 선택 업데이트 유도 |
-
서비스 국가 제한
서비스 국가 제한은 특정 App ID에 대해 앱이 전달한 사용자 국가 코드가 차단 국가에 해당하는지 확인해 결과를 반환합니다. 차단 대상이면 적용된 서비스 국가 제한 항목에서 해당 App ID에 지정한 차단 국가 목록도 함께 반환합니다. 앱 클라이언트는 이 결과에 따라 사용자의 앱 접속 허용 여부와 안내 화면 노출 방식을 직접 결정해야 합니다.
-
서버 점검
서버 점검은 현재 시각을 기준으로 점검 시작·종료 시간, 점검할 서버 목록, 점검할 버전 목록을 포함한 활성 서버 점검 항목을 반환합니다. 요청에 서버 ID를 지정하면 그 서버에 적용되는 점검만 반환합니다. 앱 버전을 지정하면 그 버전을 대상으로 등록한 점검도 함께 반환합니다.
-
클라이언트 업데이트
클라이언트 업데이트는 현재 앱 클라이언트 버전의 업데이트 필요 여부와 강제 또는 선택 업데이트 여부를 반환합니다. 업데이트가 필요하면 응답에 업데이트 대상 앱 버전도 함께 담깁니다.
안내 문구와 적용 기간
서비스 국가 제한, 서버 점검, 클라이언트 업데이트는 모두 콘솔에 등록한 안내 제목, 본문, 안내 URL을 함께 반환합니다. 안내 문구는 앱이 요청한 언어로 전달하고, 그 언어로 등록한 문구가 없으면 기본 언어의 문구를 전달합니다. 적용 기간을 지정한 항목은 시작·종료 시각과 그 시각을 해석하는 기준 시간대 정보도 반환합니다.