콘텐츠로 이동
EasterAdEasterAdDocs

SDK 키 관리

조직 공용 SDK 키는 해당 조직이 소유한 여러 게임의 클라이언트 빌드에 공통으로 사용할 수 있는 통합 인증 키입니다.

본사 내부 개발팀이 다수의 자사 타이틀을 중앙에서 통합 빌드·배포할 때 유용하며, 최대 2개의 활성 키 슬롯을 제공하여 서비스 중단 없는 무중단 교체(Zero-downtime Rotation)를 지원합니다.

1. 조직 공용 SDK 키 발급

섹션 제목: “1. 조직 공용 SDK 키 발급”
  1. 콘솔 사이드바에서 조직 설정 → SDK 키 메뉴로 이동합니다.
  2. 우측 상단의 SDK 키 발급 버튼을 클릭합니다.
  3. 생성 완료 팝업에서 전체 키(UUID 문자열)를 복사합니다.
  • 최대 2개 슬롯: 조직당 활성화할 수 있는 공용 SDK 키는 최대 2개로 제한됩니다. 2개의 키가 모두 발급되어 있으면 새 키 발급 버튼이 비활성화되며, 두 번째 슬롯은 키 로테이션 작업에 사용됩니다.

2. 서비스 무중단 키 로테이션(2-Key Rotation) 절차

섹션 제목: “2. 서비스 무중단 키 로테이션(2-Key Rotation) 절차”

SDK 키가 노출되었거나 사내 보안 규정에 따라 정기적으로 키를 갱신해야 할 때, 기존 키를 즉시 폐기하면 아직 업데이트하지 않은 유저의 게임에서 광고가 전면 중단됩니다.

EasterAd의 2-Key 슬롯 메커니즘을 활용하여 다음과 같이 무중단으로 교체하세요.

graph LR
    Step1["1. 두 번째 새 키 발급<br/>(기존 1번 키 정상 유지)"]
    Step2["2. 새 키 적용 빌드 배포<br/>(유저 업데이트 전파 대기)"]
    Step3["3. 기존 1번 키 최종 폐기<br/>(전파 완료 후 안전 폐기)"]

    Step1 --> Step2 --> Step3
  1. 두 번째 키 발급: 콘솔에서 SDK 키 발급을 눌러 새 키를 생성합니다. (이 시점에는 기존 1번 키와 신규 2번 키가 모두 유효하게 동작합니다.)
  2. 신규 빌드 배포: 새로 발급받은 2번 키를 게임 클라이언트 설정에 반영하여 스토어에 업데이트 빌드를 배포합니다.
  3. 업데이트 전파 대기: 플레이어들이 신규 빌드로 충분히 전환(통상 80~90% 이상)될 때까지 모니터링하며 기다립니다.
  4. 기존 키 폐기: 전환이 완료되면 콘솔에서 구버전 1번 키 행의 폐기 버튼을 누릅니다.

3. 키 폐기 (Revoke)

섹션 제목: “3. 키 폐기 (Revoke)”

콘솔 목록에서 불필요해진 키의 폐기 버튼을 누르고 확인하면 해당 키는 즉시 영구 무효화됩니다.

  • 폐기된 키로 인입되는 모든 광고 요청은 즉시 거부되므로, 반드시 해당 키를 참조하는 클라이언트가 없는지 확인 후 실행하세요.
  • 키가 폐기되면 슬롯이 다시 1개 비워지므로 새로운 키를 추가 발급할 수 있게 됩니다.

연관 안내서

섹션 제목: “연관 안내서”