---
url: https://developers.webzenk.kr/guide/html5.md
---
# 웹 (HTML5)

브라우저에는 Secret을 둘 수 없어서, HTML5 게임은 **App Key + 허용 도메인**으로 접속합니다. 로그인한 뒤에는 앱과 같은 유저 토큰을 씁니다.

## 준비

1. 게임이 열리는 주소를 운영 담당자에게 전달해 **허용 도메인**으로 등록합니다.
   * `https://game.example.com` — 이 주소만
   * `https://*.example.com` — 하위 도메인 전체 (상위 도메인 자체는 아님)
   * `http://localhost:8080` — 개발용 (http는 localhost만)
2. [HTML5 SDK](/sdk/html5/)를 넣고 App Key만으로 초기화합니다.

## 웹에서 다른 점

| 항목 | 웹 |
|---|---|
| 인증 | App Key + 브라우저가 붙이는 `Origin`. App Secret 서명 없음 |
| 로그인 | 게스트, Google·Apple(직접 받은 ID 토큰), 플랫폼 계정 |
| 결제 | 플랫폼 결제만 (삼성 Instant Plays). Google Play·App Store 검증은 막혀 있습니다 |
| 광고 | 플랫폼 광고 SDK (서버 콜백 없음) |
| 저장·랭킹·이벤트 | 앱과 같습니다 |

자주 보는 오류:

* `403 ORIGIN_NOT_ALLOWED` — 지금 주소가 허용 도메인에 없습니다.
* `403 WEB_NOT_ENABLED` — 게임에 웹이 아직 켜지지 않았습니다.
* `403 WEB_NOT_SUPPORTED` — 웹에서 쓸 수 없는 API입니다 (스토어 결제·MAX 광고).

::: tip Unity WebGL
Unity WebGL 빌드도 브라우저라서 같은 규칙입니다. Unity SDK에서 `AppSecret`을 비우면 웹 모드로 동작합니다.
:::
