# API BOLA 점검: 로그인한 사용자가 남의 주문 번호로 조회되는지 직접 시험하기

> BOLA는 로그인은 했지만 남의 객체 번호를 넣어도 조회되는 API 권한 검증 누락입니다. 127.0.0.1에 시험용 주문 API를 임시로 띄워 같은 요청이 취약한 판에서는 200, 고친 판에서는 404가 되는 것을 Python 스크립트로 확인합니다.

- 주소: https://copyandrun.com/blog/api-bola-object-level-authz-test/
- 분야: API 보안
- 발행일: 2026-11-08
- 태그: BOLA, API 보안, OWASP API Top 10, 권한 검증, Python

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를 조회하는 요청입니다.

```python
#!/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:` 한 줄입니다. 이 줄이 없으면 토큰만 유효하면 어떤 번호든 조회됩니다.

## 실행 결과

```powershell
python bola_lab.py
```

![터미널에서 취약한 판은 alice가 bob의 주문 2를 200으로 조회하고 고친 판은 같은 요청이 404로 막힌 것을 확인합니다.](https://copyandrun.com/img/api-bola-object-level-authz-test/01-check-run.png)

출력은 다음과 같습니다.

```text
== 취약한 판
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"}
```

확인할 내용은 세 가지입니다.

1. **취약한 판의 두 번째 줄**: alice의 토큰으로 bob의 주문이 그대로 조회됩니다. 로그인 검증은 통과했으나 소유자 검증이 없었기 때문입니다.
2. **고친 판의 두 번째 줄**: 같은 요청에 404가 반환됩니다. 존재하지 않는 주문 번호와 다른 사용자의 번호에 같은 응답을 반환하므로, 번호의 존재 여부도 알 수 없습니다.
3. **자기 주문은 두 판 모두 200**: 코드를 수정해도 정상 요청은 그대로 처리됩니다.

## 우리 API에서 확인하는 방법

모든 조회, 수정, 삭제 API에서 경로나 본문의 객체 번호를 받는 위치를 확인합니다. 시험 계정 두 개를 만들어 한 계정의 토큰으로 다른 계정의 객체 번호를 요청했을 때 200이 반환되면 BOLA에 해당합니다. 번호를 순차적으로 늘려 가며 대량으로 시도하지 않고, 계정 두 개로 소수의 요청만 확인합니다. 번호를 추측하기 어려운 UUID로 변경하는 조치는 보조 수단일 뿐이며, 소유자 비교를 대체하지 못합니다.

## 정리

- [ ] 객체 번호를 받는 API마다 소유자 비교 로직이 있는지 확인했습니다.
- [ ] 시험 계정 두 개로 다른 계정의 객체 번호를 요청해 404 또는 403이 반환되는지 확인했습니다.
- [ ] 번호를 UUID로 바꾸는 조치를 소유자 비교의 대체 수단으로 사용하지 않았습니다.
