허용 목록

'허용 목록'은 접근 제한과 관계없이 앱에 접근할 대상을 등록하고 관리하는 화면입니다. 등록한 항목은 수정하거나 적용을 멈추고 삭제할 수 있습니다.

➡️ 콘솔 경로: 서비스 접근 제어 > 허용 목록

허용 목록에 등록한 대상은 서버 점검, 클라이언트 업데이트, 서비스 국가 제한 조건과 관계없이 앱에 접근합니다. 앱을 공개하기 전이나 점검 중에 내부 계정으로 기능을 확인할 때 사용합니다.

서버는 접근 제어를 처리할 때 허용 목록을 자동으로 적용합니다. 앱이 허용 목록을 따로 조회하지는 않지만 대상을 판별할 값은 필요합니다. 앱이 Player ID나 접속 IP를 함께 전달하도록 개발을 마치세요.

허용 목록 항목 등록

새 허용 목록을 선택하면 등록 화면이 열립니다. 하나의 항목에는 App ID 하나와 앱 버전 하나를 지정하고 허용 대상은 여러 개 등록합니다.

설정 방법:

새 허용 목록을 선택하세요.
제목을 입력하고 App ID를 고르세요.
대상 유형을 고르고 허용할 IP 또는 Player ID를 입력하세요.
허용 기간을 지정하세요.
저장을 선택하세요.

적용 범위

제목은 콘솔에서 항목을 구분하는 관리용 이름입니다. 목록의 제목 열과 제목 검색은 이 값을 기준으로 합니다. 내부 QA 허용 목록처럼 나중에 찾기 쉬운 이름을 입력하세요.

허용 목록은 선택한 App ID에만 적용합니다. 앱 버전까지 입력하면 해당 버전에만 적용되고 버전을 비워 두면 해당 App ID의 모든 버전에 적용됩니다. 앱 버전은 1.2.0과 같은 형식으로 입력합니다. 한 항목에는 버전을 하나만 입력할 수 있으므로 여러 버전을 허용하려면 항목을 나누어 등록하세요.

허용 대상

대상 유형은 IP와 Player ID 중 하나를 고릅니다. 두 유형을 한 항목에 함께 등록할 수는 없으므로, 둘 다 허용하려면 항목을 나누어 등록합니다.

두 유형 모두 여러 개를 넣을 때는 쉼표로 구분하며, 한 항목에 최대 100개까지 입력합니다.

IP

IP는 IPv4와 IPv6 형식을 지원하며 210.123.45.0/24처럼 CIDR 범위로도 입력합니다. 사무실이나 QA 환경처럼 대역이 정해진 경우에는 범위로 등록하세요.

Player ID

Player ID는 사용자를 구분하는 값으로 유저 조회에서 확인합니다. 콘솔은 Player ID의 유효성을 확인하지 않으므로 등록하기 전에 값이 정확한지 확인하세요.

허용 기간

허용 목록이 적용되는 기간을 시작일시와 종료일시로 지정합니다. 허용 기간이 지나면 등록한 대상도 다른 사용자와 같은 접근 제한을 받습니다.

종료 시점 없이 계속 허용해야 하는 대상은 상시 사용으로 등록합니다. 상시 사용을 선택하면 기간 입력 항목이 비활성화되고, 등록한 항목은 즉시 적용됩니다. 비활성으로 변경하기 전까지 종료 시점 없이 유지됩니다.

기간은 타임존을 기준으로 입력합니다. 기본값은 콘솔 소유자의 타임존이며, 등록한 항목의 상태는 이 허용 기간을 기준으로 계산됩니다. 상태별 적용 기준은 아래와 같습니다.

예정: 허용 기간이 아직 시작되지 않음
사용 중: 현재 허용 기간에 포함됨
종료: 허용 기간이 끝남
비활성: 허용 기간과 관계없이 적용을 멈춤

사용 중인 항목만 서버의 접근 제어 처리에 반영됩니다.

등록한 항목 관리

목록의 대상 열에는 등록한 IP나 Player ID의 개수만 표시됩니다. 실제 값은 제목을 선택해 상세 화면에서 확인하세요.

등록한 항목이 목록에 보이지 않는 경우

목록의 허용 기간 검색 조건에는 최근 한 달이 기본값으로 설정됩니다. 검색 기간은 최대 1년까지 지정합니다. 허용 기간을 미래에 시작하도록 등록했다면 기본 검색 범위를 벗어나 목록에 표시되지 않습니다. 등록은 정상으로 처리된 상태이므로 검색 기간을 등록한 기간이 포함되도록 넓힌 뒤 다시 검색하세요.

등록한 내용 수정

목록에서 제목을 선택하면 등록할 때 입력한 내용이 담긴 상세 화면이 열립니다. 허용 목록에는 유형 구분이 없으므로 상세 화면의 모든 항목을 수정합니다. 허용 대상을 추가하거나 제거할 때도 이 화면을 사용합니다.

적용 중지

허용 기간이 남아 있어도 허용을 즉시 중지해야 하면 비활성으로 변경합니다. 비활성으로 변경한 항목은 허용 기간에 포함되어도 접근 제어 처리에 반영되지 않습니다. 따라서 등록한 대상도 다른 사용자와 같은 제한을 받습니다.

설정 방법:

목록에서 멈출 항목의 제목을 선택하세요.
상세 화면 맨 위 현재 상태에서 활성 여부를 끄세요.
확인 창에서 비활성을 선택하세요.

확인 창에서 비활성을 선택하면 즉시 적용되고 상세 화면이 닫힙니다. 따로 저장을 선택할 필요가 없습니다. 활성 여부를 다시 켜면 원래 설정한 값과 기간으로 돌아갑니다.

항목 삭제

삭제할 수 있는 항목은 상태가 예정이거나 종료인 항목뿐입니다. 비활성으로 변경한 항목을 정리하려면 활성 여부를 켜서 예정 또는 종료 상태로 되돌린 뒤 삭제하세요. 삭제한 항목은 되돌릴 수 없습니다.

다음 단계

국가, 서버 점검, 앱 버전으로 접근을 제어하려면 서비스 접근 제어 항목을 참조하세요.