목차
슈퍼유저 권한을 서비스로 옮긴 Superuser Gateway (2026-02)
원문 정보
- 원문: Superuser Gateway: Guardrails for Privileged Command Execution
- 매체 · 게시일: Uber Engineering Blog · 2026-02-26
- 저자: Pavi Subenderan(Staff Software Engineer, Data Security), Jyoti Grewal(Software Engineer, Data Security)
- 원문 내용을 바탕으로 재구성한 요약입니다.
없앨 수 없었던 슈퍼유저 작업
잘못 붙인 플래그 하나로도 충분합니다. 슈퍼유저가 실행한 명령은 프로덕션 데이터셋을 지우거나, 조직 전체가 핵심 테이블에 접근하지 못하게 하거나, 권한을 조용히 없애 버릴 수 있습니다. 엉뚱한 경로에 실행한 hdfs dfs -rm -r나 chmod -R 하나가 광범위한 장애와 긴 복구 작업으로 이어질 수 있는 것입니다.
우버 데이터 플랫폼은 GCS, OCI, Apache HDFS에 의존합니다. 소수의 엔지니어는 데이터를 옮기고 권한을 고치며 손상된 경로를 정리하거나 장애를 해결하려고 슈퍼유저 권한을 사용했습니다. 자주 하는 작업은 아니어도 권한은 필요했습니다. 특히 온콜 엔지니어에게는 데이터 문제를 빨리 고칠 수단이 있어야 했습니다.
이런 사정은 데이터 플랫폼에만 있지 않습니다. DBA, SRE처럼 강한 권한을 가진 소수의 담당자가 대량 삭제, 권한 재작성, 설정 변경을 맡는 시스템은 많습니다. 영향이 큰 작업인데 시간까지 촉박하니 실수를 하기 쉽고, 실행 전에 발견하기도 어렵습니다. 우버가 데이터 플랫폼을 첫 적용 대상으로 고른 이유도 수동 작업의 성격과 빈도에 있었습니다.
기존 절차는 단순했습니다. 엔지니어가 슈퍼유저 자격 증명이나 관리자 토큰을 받아 셸에서 명령을 실행하고, 작업을 마치면 로그아웃했습니다. 자격 증명을 얻은 뒤에는 개별 명령을 막아 줄 안전장치가 거의 없었습니다. 동료 리뷰도 비공식적으로 하거나 생략했고, 로컬에서 실행하는 작업에 슈퍼유저 권한이 적절하게 쓰이는지 중앙에서 확인할 방법도 없었습니다.
로그만으로 실행자를 찾기도 어려웠습니다. 감사 로그에 남는 이름은 명령을 입력한 개인보다 슈퍼유저 같은 공용·역할 계정이어서, 누가 무엇을 했는지 확인하려면 로그인 감사 로그와 명령 실행 로그를 대조해야 했습니다.
우버의 해법은 개인에게서 슈퍼유저 권한을 회수하고, 필요한 명령을 검토한 뒤 대신 실행하는 서비스를 두는 것이었습니다. 그렇게 만든 Superuser Gateway는 동료 리뷰와 자동 검증, 승인 확인, 원격 실행을 하나의 절차로 연결합니다. 운영 작업은 계속하되, 슈퍼유저 권한은 Gateway 백엔드만 갖도록 바꿨습니다.
PR 링크를 돌려주는 superuser-cli
명령을 작성하는 습관은 유지했습니다. 엔지니어는 예전과 같은 HDFS 명령을 쓰고, superuser-cli cmd "<command>"로 제출합니다. 스크립트도 실행 전에 검토받도록 제출할 수 있습니다.
여기서 CLI가 돌려주는 것은 실행 결과가 아닌 PR 링크입니다. superuser-cli는 요청받은 명령을 전용 Git 저장소의 PR로 만들고, CI 작업은 그 PR에서 자동으로 명령을 검사합니다. 변경 담당자가 적절한 동료에게 리뷰를 요청하면, 리뷰어는 다른 GitHub PR을 보듯 명령과 검증 결과를 읽고 승인합니다. 승인된 명령을 실제로 실행하는 일은 백엔드 서비스가 맡습니다.
이 흐름에서 각 구성 요소의 역할이 드러납니다. CLI는 명령을 받고, Git 저장소는 검토할 명령과 리뷰 기록을 보관합니다. CI는 실행 전에 오류와 영향을 점검하며, 백엔드는 슈퍼유저로 명령을 실행하고 출력을 사용자에게 스트리밍합니다. PR 승인과 원격 실행은 이 절차에서 빠질 수 없는 단계입니다.
요청과 승인을 데이터베이스에 저장하는 시스템도 후보였습니다. 우버가 Git을 택한 이유는 이미 갖춰진 리뷰 경험에 있었습니다. 댓글을 달고 승인하며 이력을 남기는 기능을 쓸 수 있고, 기존 CI와 연결해 Gateway가 만든 PR에 전용 린터와 검증 작업을 실행할 수도 있습니다. 지난 요청을 되짚을 때는 PR과 당시의 리뷰 댓글을 함께 찾아볼 수 있습니다.
삭제 규모를 먼저 살피는 리뷰
리뷰어에게 명령만 던져 주지는 않습니다. PR마다 자동 검증을 실행해 각 줄이 유효한 명령인지, 명백하게 잘못된 입력은 없는지 검사합니다. 요청자가 사내 정책상 그 작업을 수행할 권한이 있는지도 확인합니다. 동료 엔지니어의 검토는 이 자동 검사와 함께 진행됩니다.
영향을 추정할 수 있는 작업에는 예상 규모도 붙입니다. 예를 들어 rm -r 요청이 들어오면 검증 작업이 파일시스템 이미지를 조회해 삭제될 파일 수를 추정하고 PR에 댓글로 남깁니다. 리뷰어는 삭제 명령의 경로뿐 아니라, 그 명령으로 얼마나 많은 파일이 지워질지도 검토할 수 있습니다. 모든 명령의 영향을 알아내는 것은 아니며, 추정이 가능한 경우에 제공하는 정보입니다.
승인이 끝나면 원격 실행 서비스가 요청을 받습니다. 백엔드는 PR이 승인됐는지와 사용자가 Gateway를 이용할 권한이 있는지를 확인하고, HDFS, GCS, OCI에 필요한 인증을 처리합니다. 명령은 통제된 원격 환경에서 슈퍼유저로 실행되며 결과는 사용자에게 스트리밍됩니다.
리뷰를 우회하지 못하게 하는 장치는 권한의 위치입니다. 자격 증명과 실행 환경을 서비스가 관리하므로 엔지니어의 로컬 머신에는 슈퍼유저 티켓이 남지 않습니다. 개인이 직접 슈퍼유저가 될 수 없으니, 동료 승인을 건너뛰고 로컬 셸에서 명령을 실행할 수도 없습니다.
별도 경로를 둔 읽기 전용 디버깅
리뷰에는 대기 시간이 붙습니다. 드물게 하는 유지보수라면 받아들일 만한 지연이지만, 데이터를 읽으며 문제를 추적하는 디버깅에서는 그 대기가 걸림돌이 됩니다. 슈퍼유저 명령이라는 이유로 모든 작업을 같은 승인 절차에 넣을 수는 없었습니다.
그래서 우버는 Gateway의 적용 범위를 위험한 쓰기 작업으로 좁혔습니다. 시스템 상태를 바꾸지 않고 데이터를 살펴보는 읽기 전용 명령에는 더 간편한 별도 경로를 두었습니다. 사고를 일으킬 수 있는 변경에는 검토를 요구하면서, 조사에 필요한 읽기 작업의 부담은 줄인 선택입니다.
쓰기 작업의 리뷰 시간을 줄이는 방안도 살펴보고 있습니다. AI 리뷰로 동료 리뷰어의 판단을 보조하고 검토를 빠르게 하려는 구상입니다. 아직 검토 중인 방안이며, 도입 결과로 제시한 내용은 아닙니다.
수백 건의 실행 뒤에 남은 과제
2025년 말부터 모든 관리자 엔지니어가 이 흐름으로 전환했고, 서비스를 거쳐 실행한 명령은 수백 건에 이릅니다. 엔지니어가 필요한 운영 작업을 계속 수행하면서도, 권한이 필요한 CLI 명령을 동료 리뷰와 자동 검증에 맡기는 절차가 자리 잡았습니다.
첫 적용 대상은 데이터 저장 시스템입니다. 하지만 처음부터 수동 슈퍼유저 작업 전반에 쓸 수 있는 모델을 염두에 뒀고, 다음 과제는 우버의 다른 시스템에서 필요한 특권 접근으로 지원을 넓히는 일입니다. 명령을 더 깊이 정적으로 분석해 실수일 가능성이 큰 부분을 찾아내고, 영향도 더 정밀하게 추정하려고 합니다.
우버 엔지니어들이 독자에게 건네는 제안도 직접적입니다. 엔지니어가 위험한 명령을 실행하는 빈도가 마음에 걸린다면, 여러분의 시스템에도 Superuser Gateway를 만들어 보라는 것입니다.
구성 요소와 적용 범위
| 항목 | 내용 |
|---|---|
| 첫 적용 대상 | 데이터 플랫폼(GCS, OCI, Apache HDFS) |
| 구성 요소 | superuser-cli, Git 기반 저장소, CI 작업, 백엔드 실행 서비스 |
| 자동 검증 | 구문 검증, 권한 검증, 영향 추정(rm -r 시 파일시스템 이미지로 삭제 파일 수 추정) |
| 범위 | 위험한 쓰기 작업 (읽기 전용 명령은 별도의 낮은 마찰 경로) |
| 이전 완료 | 2025년 말부터 모든 관리자 엔지니어, 수백 건의 명령 실행 |
| 후속 | 다른 권한 시스템으로 확대, 정적 분석 강화, AI 리뷰 보조 검토 |