멀티테넌트 SaaS: 데이터 격리와 대리점 권한 계층

핵심 요약: 멀티테넌트 시스템이 가장 두려워하는 사고는 테넌트 A가 테넌트 B의 데이터를 보는 것입니다. 공유 데이터베이스에 테넌트 열을 두는 방식은 대부분의 B2B SaaS에 합리적인 출발점이지만, 테넌트 필터링이 개발자 각자의 기억에 기대지 않는다는 전제가 있어야 합니다. 테넌트 컨텍스트는 인증 시점에만 정하고, 데이터 접근 계층이 필터를 일괄 주입하며, 데이터베이스는 행 수준 보안으로 한 번 더 막습니다. 플랫폼·대리점·하위 계정 계층은 명시적으로 모델링하고, 권한 테스트는 기능 테스트보다 먼저 씁니다.

멀티테넌트 다이어그램. 위쪽은 요청 경로로, 토큰이나 세션을 가진 요청이 인증 미들웨어를 거치며 테넌트·역할·범위가 정해지고, 데이터 접근 계층이 테넌트 필터를 일괄 주입하며, 데이터베이스가 행 수준 보안으로 강제합니다. 테넌트 ID는 인증 결과에서만 가져옵니다. 아래쪽은 조직 트리로, 플랫폼 운영자 아래 대리점 두 곳이 있고 그중 한 대리점 아래 하위 계정 두 개가 있으며, 점선 영역이 그 대리점이 볼 수 있는 범위를 나타냅니다.
그림 1. 요청 경로와 조직 트리. 대리점이 보는 것은 자기 하위 트리이며, 그보다 많지도 적지도 않습니다.

1.0 세 가지 격리 방식

방식장점대가적합한 경우
테넌트별 데이터베이스격리가 가장 강하고, 테넌트 단위로 백업·이전·복원이 가능마이그레이션을 N번 실행해야 하고, 연결 수와 운영 부담이 테넌트 수와 함께 늘어남테넌트가 적거나 계약상 물리적 분리가 필요한 경우
공유 데이터베이스, 테넌트별 스키마격리가 강함스키마가 많아지면 마이그레이션과 모니터링이 복잡해짐테넌트 수가 중간 정도
공유 테이블 + 테넌트 열운영이 가장 단순하고 테넌트 간 집계가 쉬움격리가 전적으로 코드와 데이터베이스 정책에 달림테넌트가 많고 테넌트당 데이터가 많지 않은 경우

섞어 쓸 수도 있습니다. 대형 고객은 전용 데이터베이스, 나머지는 공유. 다만 테넌트의 데이터가 어디 있는지를 데이터 접근 계층이 감추고, 업무 코드는 신경 쓰지 않아도 되어야 합니다.

2.0 테넌트 컨텍스트는 어디서 오는가

테넌트 ID는 인증 결과, 즉 토큰의 클레임이나 서버 측 세션에서만 가져옵니다. 요청 파라미터나 클라이언트가 마음대로 설정할 수 있는 헤더에서 가져와서는 안 됩니다. 요청마다 미들웨어가 테넌트, 역할, 데이터 범위를 정해 요청 컨텍스트에 넣고, 이후 코드는 거기서만 읽습니다.

백그라운드 작업과 메시지 소비자에도 테넌트 컨텍스트가 필요하며, 가장 자주 빠지는 곳이 여기입니다. 예약 작업에는 요청도 미들웨어도 없어서 자칫하면 테이블 전체를 처리합니다. 우리는 작업마다 어떤 테넌트를 처리하는지 명시하게 하고, 명시하지 않은 작업은 실행되지 않게 합니다.

3.0 필터링을 개인의 주의력에 맡기지 않는다

  • ORM 계층에서 테넌트 조건을 일괄 추가합니다. 전역 필터나 리포지토리 기반 클래스로 구현해 업무 코드는 기본적으로 다른 테넌트의 데이터에 닿지 못하고, 테넌트를 넘나들려면 명시해야 합니다.
  • PostgreSQL이라면 행 수준 보안(RLS)을 두 번째 방어선으로 쓸 수 있습니다. 직접 쓴 SQL이 조건을 빠뜨려도 데이터베이스가 거부합니다. 커넥션 풀을 쓸 때 세션 변수의 설정과 초기화에 주의해야 하며, 그렇지 않으면 이전 요청의 테넌트가 다음 요청으로 새어 나갑니다.
  • 정말로 테넌트를 넘나드는 작업(플랫폼 운영 보고서, 데이터 복구 등)은 별도의 역할과 코드 경로를 거치고 감사 로그를 남깁니다.
  • 유일 제약과 인덱스에는 테넌트 열을 포함합니다. 그렇지 않으면 두 테넌트가 같은 번호를 쓸 때 충돌합니다.

4.0 대리점 계층

많은 제품은 테넌트가 평평하게 나열된 구조가 아니라 플랫폼, 대리점, 하위 계정 또는 최종 고객으로 이어지는 계층입니다. 잘 통하는 방법은 다음과 같습니다.

  • 조직 관계를 트리로 저장하고, 대리점에는 자기 하위 트리 안의 데이터만 보여 줍니다. 하위 트리 조회에는 클로저 테이블이나 구체화 경로를 쓰고, 요청마다 재귀 쿼리를 날리지 않습니다.
  • 역할과 데이터 범위를 따로 모델링합니다. 역할은 어떤 작업을 할 수 있는지, 범위는 어떤 조직에 대해 할 수 있는지를 정합니다. 조합마다 새 역할을 만들면 역할 테이블이 금세 감당할 수 없게 됩니다.
  • 계층마다 프런트엔드가 따로 있는 경우가 많지만(플랫폼 관리 콘솔, 대리점 콘솔, 하위 계정용 모바일 화면 등) 백엔드 권한 모델은 하나입니다. 버튼을 숨기는 것은 권한 제어가 아니며, API가 호출마다 확인합니다.

5.0 가장 먼저 써야 할 테스트

  • 권한 매트릭스: 역할과 계층별로 자기 데이터, 같은 계층 데이터, 상위 데이터에 대한 접근과 기대 결과를 표로 만들어 자동 실행한다.
  • ID 바꿔치기: 요청의 리소스 ID를 다른 테넌트 것으로 바꾸면 API는 ‘권한 없음’이나 ‘존재하지 않음’을 돌려줘야 하며, 절대로 데이터를 돌려주면 안 된다.
  • 백그라운드 작업: 여러 테넌트의 데이터가 섞인 상태에서 작업을 돌리고, 의도한 테넌트만 처리했는지 확인한다.

이 테스트는 기능 테스트보다 먼저 쓸 가치가 있습니다. 기능 버그는 사용성 문제지만, 권한 버그는 사고입니다.

새 SaaS 관리 시스템을 만들거나 기존 시스템에 테넌트 격리를 더하려면 웹·클라우드·디바이스 관리를 참고하거나 프로젝트 상담으로 연락 주세요.

참고 자료

자주 묻는 질문

공유 테이블로 시작합니다. 나중에 대형 고객만 전용 데이터베이스로 옮길 수 있나요?

관건은 데이터 접근 계층이 처음부터 테넌트별로 라우팅하는지, 아니면 곳곳에서 같은 연결을 직접 쓰는지입니다. 라우팅이 되어 있다면 테넌트를 떼어 내는 일은 데이터 내보내기, 라우팅 전환, 결과 확인으로 끝나고, 비용은 대부분 리허설에 듭니다.

행 수준 보안이 쿼리를 느리게 하나요?

정책은 사실상 각 쿼리에 붙는 추가 조건이라, 비용은 그 조건이 인덱스를 탈 수 있느냐에 달려 있습니다. 복합 인덱스 맨 앞에 테넌트 열을 두면 대개 영향이 작습니다. 짐작하지 말고 운영에 가까운 데이터 양으로 실행 계획을 확인한 뒤 판단합니다.

대리점끼리 데이터를 공유할 수 있나요?

명시적 권한 부여로 모델링합니다. 한 조직이 특정 종류의 데이터를 다른 조직에 부여하고, 그 부여는 기록되며 철회할 수 있습니다. 기본값은 공유하지 않음이라, 계층 구조의 부작용으로 남의 데이터가 보이는 일이 없습니다.

하위 계정 담당자가 퇴사하면 데이터는 누구 것인가요?

데이터는 개인 계정이 아니라 조직에 속합니다. 계정을 비활성화해도 데이터는 원래 조직에 남고 상위 관리자가 다시 배정합니다. 이 원칙은 모델을 설계할 때 정해야 하며, 나중에 바꾸면 많은 테이블이 영향을 받습니다.