본문으로 건너뛰기

토큰 갱신과 세션 만료

새 토큰 받기​

토큰은 짧게 쓰는 토큰이고, 새 토큰은 LXP만 발급합니다.

  1. LXP는 만료 전에 iframe 주소의 fragment만 바꿔(#token=…&baseUrl=…) 새 토큰을 넘깁니다.
  2. 콘텐츠는 다시 로드되지 않고, 그 안에서 hashchange가 일어납니다.
  3. 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()로 만료 타이머와 새 토큰 받기를 멈춥니다.