토큰 갱신과 세션 만료
새 토큰 받기
토큰은 짧게 쓰 는 토큰이고, 새 토큰은 LXP만 발급합니다.
- LXP는 만료 전에 iframe 주소의 fragment만 바꿔(
#token=…&baseUrl=…) 새 토큰을 넘깁니다. - 콘텐츠는 다시 로드되지 않고, 그 안에서
hashchange가 일어납니다. - SDK가 다음 호출부터 새 토큰을 쓰고 주소창에서
token을 지웁니다. 자료를 다시 불러오지는 않습니다.
SDK가 서버에 토큰 갱신을 요청하지는 않습니다. 토큰이 바뀐 것을 알아야 하면(예: 동영상 플레이어) sdk.onAccessTokenChange(listener)를 씁니다.
해시 라우팅을 쓰는 콘텐츠
새 토큰이 올 때 콘텐츠의 해시가 LXP가 넘긴 값(token을 지운 뒤, 예: #baseUrl=…)으로 바뀝니다. SDK는 token이 없는 hashchange는 무시하므로, 콘텐츠는 그런 것만 자기 것으로 다루면 됩니다.
- 편집 페이지에서 토큰으로 연 미리보기(
#token=…&preview=1,versionId가 있어도)도 같은 방식으로 새 토큰을 받습니다. - 토큰 없는 미리보기(
#preview=1,#edit=1)는 바꿀 토큰이 없습니다.
세션 만료
새 토큰이 오기 전에 토큰이 만료되거나 서버가 세션을 끝내면 세션이 끝납니다. 이때는 콘텐츠가 "새로고침하세요"만 안내하면 됩니다.
const sdk = new EliceCDK({
onSessionExpired: () => {
alertBanner('학습 시간이 길어졌어요. 페이지를 새로고침해 주세요.');
},
});
- 세션이 끝나면
sdk.isSessionExpired가true가 되고, 이후 모든 호출이session_expired로 실패합니다. - 토큰이 다 돼서 끝난 세션은 그 뒤 새 토큰이 오면 다시 이어집니다.
- 새 토큰 없이 토큰이 만료되면 SDK는 띄운 페이지에
status(failed,reason: 'auth')도 보냅니다(불러오기 상태). onSessionExpired안에서alert는 sandbox라 쓸 수 없습니다. 화면 안에 안내를 띄웁니다.
정리
콘텐츠를 내릴 때는 sdk.dispose()로 만료 타이머와 새 토큰 받기를 멈춥니다.