BOLA(Broken Object Level Authorization)는 OWASP API Security Top 10의 첫 번째 항목입니다. 로그인 여부만 확인하고 그 객체가 이 사용자의 것인지는 확인하지 않아서, /orders/1을 /orders/2로 바꾸기만 해도 남의 데이터가 나옵니다. 이 글에서는 시험용 API를 내 컴퓨터에서만 띄워 소유자 확인이 있을 때와 없을 때의 차이를 확인합니다.
한 문장 답
조회 API는 토큰이 유효한지만이 아니라 요청한 객체의 소유자가 토큰의 사용자와 같은지까지 확인해야 합니다. 소유자가 다를 때는 403 대신 404를 돌려주면 그 번호의 객체가 존재하는지도 감출 수 있습니다.
준비물
| 항목 | 내용 |
|---|---|
| 파이썬 | Python 3.8 이상, 표준 라이브러리만 사용 |
| 포트 | 127.0.0.1의 18091, 18092(스크립트가 종료되면 닫힘) |
| 데이터 | 스크립트 안의 가짜 사용자 alice, bob과 주문 두 건 |
외부에 연결하지 않고, 이미 있는 다른 서비스를 대상으로 시험하지 않습니다. 시험은 자신이 소유하거나 허락받은 API에서만 합니다.
시험 스크립트
bola_lab.py는 같은 API를 두 판으로 실행합니다. 취약한 판은 토큰만 확인하고, 고친 판은 소유자까지 비교합니다. 두 판에 같은 요청 두 개를 보냅니다. alice가 자기 주문 1을 조회하는 요청과 alice가 bob의 주문 2를 조회하는 요청입니다.
#!/usr/bin/env python3
# 사용: python bola_lab.py
# 127.0.0.1 에 시험용 주문 API 를 임시로 띄워, 같은 요청이 취약한 판과 고친 판에서 어떻게 다른지 확인한다.
# BOLA(객체 수준 권한 검증 누락): 로그인은 했지만 남의 주문 번호를 넣어도 조회되는 문제.
# 토큰은 시험용 문자열이고, 서버는 스크립트가 끝나면 함께 종료된다.
import json
import threading
import urllib.error
import urllib.request
from http.server import BaseHTTPRequestHandler, HTTPServer
TOKENS = {"token-alice": "alice", "token-bob": "bob"}
ORDERS = {1: {"owner": "alice", "item": "keyboard"}, 2: {"owner": "bob", "item": "monitor"}}
def make_handler(check_owner):
class H(BaseHTTPRequestHandler):
def log_message(self, *args):
pass
def reply(self, code, body):
data = json.dumps(body).encode()
self.send_response(code)
self.send_header("Content-Type", "application/json")
self.end_headers()
self.wfile.write(data)
def do_GET(self):
user = TOKENS.get(self.headers.get("Authorization", "").replace("Bearer ", ""))
if not user:
return self.reply(401, {"error": "login required"})
order = ORDERS.get(int(self.path.rsplit("/", 1)[1]))
if not order:
return self.reply(404, {"error": "not found"})
if check_owner and order["owner"] != user:
return self.reply(404, {"error": "not found"})
return self.reply(200, order)
return H
def get(port, order_id, token):
req = urllib.request.Request(f"http://127.0.0.1:{port}/orders/{order_id}", headers={"Authorization": f"Bearer {token}"})
try:
with urllib.request.urlopen(req) as r:
return r.status, r.read().decode()
except urllib.error.HTTPError as e:
return e.code, e.read().decode()
for label, check_owner, port in (("취약한 판", False, 18091), ("고친 판", True, 18092)):
server = HTTPServer(("127.0.0.1", port), make_handler(check_owner))
threading.Thread(target=server.serve_forever, daemon=True).start()
print(f"== {label}")
print("alice 가 자기 주문 1 조회:", *get(port, 1, "token-alice"))
print("alice 가 bob 의 주문 2 조회:", *get(port, 2, "token-alice"))
server.shutdown()
핵심은 do_GET의 if check_owner and order["owner"] != user: 한 줄입니다. 이 줄이 없으면 토큰만 유효하면 어떤 번호든 조회됩니다.
실행 결과
python bola_lab.py

출력은 다음과 같습니다.
== 취약한 판
alice 가 자기 주문 1 조회: 200 {"owner": "alice", "item": "keyboard"}
alice 가 bob 의 주문 2 조회: 200 {"owner": "bob", "item": "monitor"}
== 고친 판
alice 가 자기 주문 1 조회: 200 {"owner": "alice", "item": "keyboard"}
alice 가 bob 의 주문 2 조회: 404 {"error": "not found"}
확인할 내용은 세 가지입니다.
- 취약한 판의 두 번째 줄: alice의 토큰으로 bob의 주문이 그대로 조회됩니다. 로그인 검증은 통과했으나 소유자 검증이 없었기 때문입니다.
- 고친 판의 두 번째 줄: 같은 요청에 404가 반환됩니다. 존재하지 않는 주문 번호와 다른 사용자의 번호에 같은 응답을 반환하므로, 번호의 존재 여부도 알 수 없습니다.
- 자기 주문은 두 판 모두 200: 코드를 수정해도 정상 요청은 그대로 처리됩니다.
우리 API에서 확인하는 방법
모든 조회, 수정, 삭제 API에서 경로나 본문의 객체 번호를 받는 위치를 확인합니다. 시험 계정 두 개를 만들어 한 계정의 토큰으로 다른 계정의 객체 번호를 요청했을 때 200이 반환되면 BOLA에 해당합니다. 번호를 순차적으로 늘려 가며 대량으로 시도하지 않고, 계정 두 개로 소수의 요청만 확인합니다. 번호를 추측하기 어려운 UUID로 변경하는 조치는 보조 수단일 뿐이며, 소유자 비교를 대체하지 못합니다.
정리
- 객체 번호를 받는 API마다 소유자 비교 로직이 있는지 확인했습니다.
- 시험 계정 두 개로 다른 계정의 객체 번호를 요청해 404 또는 403이 반환되는지 확인했습니다.
- 번호를 UUID로 바꾸는 조치를 소유자 비교의 대체 수단으로 사용하지 않았습니다.
이 글의 다음 단계
- API 과다 응답 걸러 내기: FastAPI response_model과 응답 필드 점검 게이트저장된 사용자 기록을 그대로 반환하는 연습용 FastAPI 앱에서 해시된 비밀번호, 내부 메모, 다른 사용자의 이메일과 전화번호까지 응답에 나가는 것을 curl로 확인합니다. 응답 모델로 고친 수정판과 비교하고, 허용 필드 목록 대조와 민감 키 이름 탐지를 하는 점검 스크립트를 CI 게이트로 붙입니다.
- API 대량 할당 막기: FastAPI Pydantic extra=forbid요청 JSON을 그대로 사용자 기록에 합치는 연습용 FastAPI 앱에서 일반 사용자가 role을 admin으로 올리는 과정을 curl로 확인합니다. 같은 API를 Pydantic 허용 필드 모델로 고치면 422로 거절되는 것을 비교하고, 회귀를 막는 pytest 게이트를 붙입니다.
이 내용을 팀 교육으로 진행하고 싶으신가요?
인원, 수준, 일정에 맞춰 실습 환경까지 준비해 진행합니다. 대상과 기간을 알려 주시면 구성을 제안해 드립니다.
교육 문의하기메일로 보내실 수도 있습니다: fankh111@gmail.com