본문 바로가기
seungchan.dev
뒤로

병동·스태프·어드민 3단계 권한 토큰을 axios 인터셉터로 자동 매핑하기

WARD·STAFF·ADMIN 세 권한의 JWT를 쿠키에 따로 저장하고, 요청마다 손으로 고르던 토큰을 axios 요청·응답 인터셉터로 자동 첨부·재발급하게 바꾼 과정입니다.

5분 읽기#실무 회고

권한이 셋으로 나뉘자, 팀원들이 API 요청마다 엉뚱한 권한의 토큰을 붙이는 일이 잦아졌습니다. 코드를 바꿀 때마다 모든 요청을 일일이 고쳐야 했습니다.

팀 케어마인더에서 실제 병원 프로덕션에 쓰일 예정인 케어마인더 시스템의 로그인을 만들면서 겪은 일입니다. 요청마다 토큰을 고르던 일을 axios 인터셉터 한 곳으로 옮기자, 새 기능을 만들 때 권한을 신경 쓰지 않아도 됐습니다.

세 권한의 토큰을 요청마다 손으로 고르다 생긴 매핑 실수

WARD·STAFF·ADMIN 세 권한이 각자 토큰을 가지는데, API 요청마다 어떤 토큰을 붙일지 직접 정하다 보니 권한을 잘못 매핑하는 일이 잦아졌습니다.

권한 안에 권한: WARD, STAFF, ADMIN

  • 병동 권한 (Ward Tablet): 병동 태블릿에 해당하며, 병동에서 직접 쓰는 기본 권한입니다.
  • 스태프 권한 (Staff): 간호사 계정에 해당하며, 여러 병동을 관리할 수 있습니다. 각 간호사가 담당 병동을 컨트롤합니다.
  • 어드민 권한 (Admin): 간호사 계정을 관리하고 컨트롤하는 상위 권한입니다. 여러 간호사를 동시에 관리하는 기능이 포함됩니다.

로그인은 JWT 방식을 씁니다. 흐름을 간단히 그리면 이렇습니다.

사용자와 서버 사이에서 Refresh Token으로 Access Token을 재발급받고 Authorization 헤더로 요청하는 JWT 흐름도

accessToken과 refreshToken을 관리해야 하는 상황에서 권한을 세 가지로 나누자, API 요청마다 그 권한에 맞는 토큰이 필요해졌고 이를 관리할 별도 로직이 필요했습니다.

첫 구현: 권한별 쿠키와 Recoil

로그인할 때 권한에 따라 쿠키에 토큰을 저장하도록 설계했습니다. 스태프 계정(STAFF)은 병동 계정(WARD)으로 로그인한 상태에서 특정 페이지에 들어갈 때 추가 권한이 필요하기 때문에, WARD와 STAFF 두 종류의 토큰을 동시에 관리하도록 구현했습니다.

WARD 접근

WARD로 접근했을 때 accessTokenWard·refreshTokenWard에만 값이 들어 있는 쿠키 목록

STAFF 접근

STAFF로 접근했을 때의 권한별 토큰 쿠키 목록

ADMIN 접근

ADMIN으로 접근했을 때 accessTokenAdmin·refreshTokenAdmin에만 값이 들어 있는 쿠키 목록

로그인 시 권한마다 accessToken("권한") 형식의 이름으로 따로 저장했습니다. 그다음 유저 권한을 Recoil 상태에 저장하고, "WARD", "STAFF", "ADMIN" 중 무엇인지에 따라 API 요청마다 해당 권한의 토큰을 담아 보내도록 구현했습니다.

무엇이 깨졌나

권한이 3개로 나뉘고 요청이 복잡해지면서, 다른 팀원들이 작업 중에 API 요청의 권한을 잘못 매핑하는 경우가 잦아졌습니다. 코드를 바꿀 때마다 모든 요청을 일일이 수정해야 하는 문제도 생겼습니다.

요청마다 토큰 지정 vs 인터셉터에서 일괄 매핑

선택지얻는 것잃는 것
요청마다 권한·토큰 지정 (기존)요청 코드만 보면 어떤 토큰을 쓰는지 드러남권한 매핑 실수가 잦고, 바뀔 때마다 모든 요청을 수정
axios 인터셉터에서 일괄 매핑요청 코드가 권한에 의존하지 않음, 매핑 규칙이 한 곳에 모임저장된 유저 권한 값에 따라 모든 요청의 토큰이 정해짐

토큰 선택을 각 요청에서 빼내야 했습니다. 그래서 axios.interceptors로 의존성을 줄이고, API 요청 시 권한에 맞는 토큰을 자동으로 붙이도록 로직을 바꾸기로 했습니다.

axios 요청·응답 인터셉터가 권한에 맞는 토큰을 고른다

Recoil에 유저 권한이 저장돼 있으니, 그 값을 기준으로 요청마다 권한을 자동 매핑하도록 구현했습니다. 요청에 필요한 권한을 동적으로 처리하고, 권한에 맞는 accessToken을 자동으로 설정해 API를 보냅니다.

요청 인터셉터: Authorization 헤더 자동 첨부

ts
axiosInstance.interceptors.request.use(
  (config: InternalAxiosRequestConfig<any>) => {
    let token = "";
    const userState = localStorage.getItem("recoil-persist");
 
    let userType = "";
    if (userState) {
      const userStateObj = JSON.parse(userState as string);
      userType = userStateObj.userState.type;
    }
 
    switch (userType) {
      case "WARD":
        token = Cookies.get("accessTokenWard") as string;
        break;
      case "STAFF":
        token = Cookies.get("accessTokenStaff") as string;
        break;
      case "ADMIN":
        token = Cookies.get("accessTokenAdmin") as string;
        break;
      default:
        null;
    }
 
    if (token) {
      if (!config.headers) {
        config.headers = new AxiosHeaders();
      }
      (config.headers as AxiosHeaders).set("Authorization", `Bearer ${token}`);
 
      config.headers.Authorization = `Bearer ${token}`;
    }
    return config;
  },
  error => {
    return Promise.reject(error);
  },
);
 

응답 인터셉터: 401이면 권한별 토큰 재발급 후 재시도

토큰이 만료돼 401이 오면, 같은 방식으로 권한을 확인해 해당 권한의 토큰을 재발급받고 원래 요청을 다시 보냅니다.

ts
axiosInstance.interceptors.response.use(
  res => {
    return res;
  },
  async error => {
    if (error.response && error.response.status === 401) {
      const userState = localStorage.getItem("recoil-persist");
      let userType = "";
 
      if (userState) {
        const userStateObj = JSON.parse(userState as string);
        userType = userStateObj.userState.type;
      }
 
      let refreshEndpoint = "";
      let accessTokenKey = "";
      let refreshTokenKey = "";
 
      switch (userType) {
        case "WARD":
          accessTokenKey = "accessTokenWard";
          refreshTokenKey = "refreshTokenWard";
          refreshEndpoint = `${SEVER_URL}/users/refresh-token`;
          break;
        case "STAFF":
          accessTokenKey = "accessTokenStaff";
          refreshTokenKey = "refreshTokenStaff";
          refreshEndpoint = `${SEVER_URL}/users/refresh-token`;
          break;
        case "ADMIN":
          accessTokenKey = "accessTokenAdmin";
          refreshTokenKey = "refreshTokenAdmin";
          refreshEndpoint = `${SEVER_URL}/users/refresh-token`;
          break;
        default:
          return Promise.reject(error);
      }
 
      try {
        const response = await axios.post(refreshEndpoint, {
          accessToken: Cookies.get(accessTokenKey),
          refreshToken: Cookies.get(refreshTokenKey),
        });
 
        if (!response.data) {
          return Promise.reject(new Error("토큰 리프레쉬 실패"));
        }
 
        Cookies.set(accessTokenKey, response.data.accessToken);
        Cookies.set(refreshTokenKey, response.data.refreshToken);
 
        // 원래 요청 재시도
        error.config.headers.Authorization = `Bearer ${response.data.accessToken}`;
        return axiosInstance.request(error.config);
      } catch (refreshError) {
        return Promise.reject(refreshError);
      }
    }
 
    return Promise.reject(error);
  },
);

새 기능에서 권한을 신경 쓰지 않게 됐다

의존성을 줄인 결과, 이후에 개발하는 기능에서는 API 권한을 신경 쓸 필요가 없어졌습니다. axios.interceptor가 권한을 자동으로 매핑해 주기 때문입니다. 팀원들의 작업 속도가 빨라졌고, 권한 관리와 시스템 안전성도 크게 개선됐습니다.

배운 것

권한이 늘어날수록 "요청마다 맞는 토큰을 고르는 일"은 사람 손에 맡기기 어려워집니다. 그 선택을 한 곳으로 모은 것이 이번 작업의 핵심이었습니다.