포스트

Superset에 다운로드 사유를 남기자는 SIP-230 제안

Superset에 다운로드 사유를 남기자는 SIP-230 제안

개인정보가 들어 있는 테이블을 Superset으로 보고 있다면 매달 비슷한 일이 생긴다.

  1. 분석가가 12일에 고객 세그먼트 차트를 CSV로 내려받는다.
  2. 다음 달 1일, 보안 담당자가 Action Log를 점검하다 그 다운로드를 본다. 무엇 때문에 받았는지는 어디에도 없다.
  3. 보안 담당자가 분석가에게 묻는다. “12일에 고객 테이블 3만 건 받으셨던데 어디에 쓰셨어요?” 분석가는 티켓을 뒤져서 이틀 뒤에 답한다.
  4. 그 답은 로그 옆에 따로 둔 스프레드시트에 붙여 넣는다. 감사 때 보여 줘야 하니까.

개인정보의 안전성 확보조치 기준 제8조(개정안 시행 전 현행 기준)는 접속기록을 점검하다 개인정보 다운로드가 발견되면 그 사유를 확인하라고 한다. Superset의 Action Log에는 누가, 어떤 차트나 쿼리 결과를, 언제 내려받았는지는 남는다. 왜 받았는지만 없다.

그래서 다운로드할 때 사유를 입력하게 하고, 그 사유를 기존 Action Log에 같이 남기는 기능을 만들었다. PR(#44499)은 2026년 9월에 올렸는데, 아직 머지되지 않았다. 지금은 Superset의 기능 제안 절차인 SIP 투표를 기다리고 있다.

apache/superset SIP-230 이슈 화면 SIP-230

기능은 작게, 저장은 있던 곳에

설정 하나(REQUIRE_DOWNLOAD_REASON, 기본값 꺼짐)로 켜고 끈다. 켜면 CSV나 XLSX를 받을 때 사유를 묻는 창이 뜬다. 취소하면 다운로드도 안 된다. JSON 내보내기는 묻지 않는다.

새 테이블이나 마이그레이션은 만들지 않았다. Superset의 이벤트 로거는 이미 요청의 쿼리스트링과 폼 값을 logs.json에 같이 저장한다. 그래서 다운로드 요청에 download_reason 파라미터만 붙이면 사유가 기존 다운로드 기록 옆에 그대로 남는다. 관리자는 Security → Action Log에서 원래 보던 화면 그대로 확인하면 된다.

경로처리
차트 데이터 API (csv, xlsx)설정이 켜져 있는데 사유가 없으면 400
SQL Lab CSV, 스트리밍 CSV같음
대시보드 전체 Excel 내보내기같음
예약 리포트(Alerts & Reports)실행기가 Scheduled report: <이름> (id=<id>)를 자동으로 붙임
Explore의 화면 기준 CSV브라우저에서 바로 만들어 서버를 거치지 않으므로, 프런트엔드 로그 이벤트에 사유를 남김

예약 리포트도 같은 내보내기 API를 부른다. 자동 사유가 없으면 설정을 켜는 순간 예약 리포트가 전부 400으로 막히고, 막히지 않더라도 사람이 받은 것과 기계가 받은 것을 구분할 수 없다.

사유는 GET 요청 URL에도 실리기 때문에 255자로 제한했다.

리뷰어가 먼저 물은 건 코드가 아니었다

PR을 올린 날 리뷰어 한 명이 SIP를 열어 달라고 했다. 사용 사례를 더 알고 싶고, 왜 설정값이 아니라 새 기능 플래그로 만들었는지도 궁금하다며, PR에 hold:sip! 라벨을 붙였다. 처음 버전은 기능 플래그였다.

SIP(Superset Improvement Proposal)는 Superset에 새 기능이나 큰 변경을 넣기 전에 공개적으로 논의하는 문서다. 이슈로 제안서를 올리고, dev@ 메일링 리스트에서 [DISCUSS] 스레드로 논의한 뒤 [VOTE]로 투표한다.

다음 날 SIP-230을 올렸다. 위에 적은 월말 점검 시나리오, 사유가 있으면 점검표가 어떻게 바뀌는지, 점검표가 어떻게 바뀌는지는 표로, 사고가 났을 때 90일치 다운로드 40건을 추려 내는 과정은 예시로 적었다.

메일링 리스트를 구독하고 [DISCUSS] 스레드를 열었다. 가장 큰 쟁점은 기능 플래그냐 설정값이냐였고, 사유를 묻고 확인하는 부분을 한곳에 모아 나중에 다른 기능도 쓸 수 있게 해 달라는 요청도 있었다. 기능 플래그는 점진적으로 켜다가 언젠가 없앨 기능에 쓰는 것이고, 이건 배포 정책이니 설정값이 맞다는 의견이 스레드에서 나왔다. 동의하고 FEATURE_FLAGS에서 빼서 일반 설정 키로 옮겼다. 설정을 읽는 곳도 백엔드 함수 하나(is_download_reason_required())로 모았다.

2026년 11월 현재 [VOTE] 스레드가 열려 있다. 마감은 11월 20일로 한 번 연장됐고, binding +1이 하나 있고 반대는 없다.

그 사이에 master CI를 고쳤다

PR의 CI가 빨갛게 나왔는데, 원인은 master에 있었다. 그날 새벽 머지된 다른 PR이 getClientErrorObject를 쓰면서 import를 빠뜨렸고, 번역 템플릿(messages.pot)도 갱신이 안 돼 있었다.

두 개를 고치는 작은 PR(#44513)을 따로 올렸고, 같은 날 머지됐다. 그 뒤 원래 PR 브랜치에 master를 머지해 반영했다.

English summary

I proposed an optional download reason for CSV and XLSX exports in Apache Superset. When the REQUIRE_DOWNLOAD_REASON setting is on, users must give a reason before downloading, and the reason is stored in the existing Action Log with no new table. Scheduled reports send an automatic reason so they keep working. Maintainers asked for a SIP first, so I wrote SIP-230, ran the discussion on the dev@ mailing list, and changed the feature flag to a config setting as agreed. The vote is still open, and while waiting I also fixed a broken master build in a separate PR.

이 기사는 저작권자의 CC BY 4.0 라이센스를 따릅니다.