리프레시 토큰(Refresh Token)은 놀이공원 하루 입장권을 매일 새로 받게 해 주는 연간 회원증 같은 것 — 짧게 쓰고 만료되는 액세스 토큰을 다시 로그인하지 않고 새로 발급받을 때 쓰는 장기 인증 값이에요.
놀이공원 하루 입장권은 그날만 쓸 수 있지만, 연간 회원증이 있으면 매번 줄 서서 신분 확인을 다시 하지 않아도 새 입장권을 받을 수 있어요. 인증에서도 비슷해요. 실제 요청에 쓰는 액세스 토큰은 보안을 위해 금방 만료되고, 리프레시 토큰은 그 액세스 토큰을 다시 받아 오는 데 쓰는 오래가는 증표예요. 덕분에 사용자가 매번 로그인 창을 거치지 않아도 연결이 이어져요.
강의에서는 두 장면에서 쓰여요. 첫째, 유튜브 API를 계속 쓰려면 OAuth 인증 후 받은 리프레시 토큰을 저장해 둬요. 이때 구글 클라우드의 앱 상태가 테스트 모드면 토큰이 금방 만료되므로, 앱을 Production(게시)으로 바꾼 뒤 다시 인증하면 오래 쓰지 않고 방치하는 경우가 아니면 재인증이 필요 없다고 설명해요. 둘째, Claude·Codex·ChatGPT 로그인 인증은 각각 수명이 달라 만료되면 에이전트가 폴백 모델로 넘어가요. 무인으로 돌리기 위해 갱신 주기에 맞춰 자동 재인증을 하게 하고, 실패하면 텔레그램으로 알리도록 세팅해요.
'리프레시 토큰은 언제 만료되나요?'에 대한 답은 서비스마다 다르다는 거예요. 구글처럼 앱 상태나 미사용 기간에 따라 만료되는 경우도 있고, 비밀번호를 바꾸면 무효가 되기도 해요. 그래서 '만료되지 않게'보다 '만료되면 바로 알게' 만드는 게 현실적이에요. 리프레시 토큰은 사실상 장기 열쇠라서 유출되면 위험해요. 코드나 공개 저장소에 올리지 말고 비밀값으로 안전하게 보관하세요.
AI와 함께 나만의 사이트·서비스를 만드는 법을 강의에서 배워보세요.