From 9883971beb87d3943982637209ac507daf4696d7 Mon Sep 17 00:00:00 2001 From: king Date: Thu, 22 Oct 2026 16:42:10 +0900 Subject: [PATCH] feat(auth): authorize external modules from ERP permissions --- app/main.py | 35 +++++++++++- docs/CORM_AUTH.md | 107 ++++++++++++++++++++++++++++++++++++ docs/DEPLOYMENT.md | 4 ++ docs/PROJECT_OVERVIEW.md | 7 +++ tests/test_external_auth.py | 83 ++++++++++++++++++++++++++++ 5 files changed, 235 insertions(+), 1 deletion(-) create mode 100644 docs/CORM_AUTH.md create mode 100644 tests/test_external_auth.py diff --git a/app/main.py b/app/main.py index 99745a8..19f3346 100644 --- a/app/main.py +++ b/app/main.py @@ -2,7 +2,7 @@ import inspect import os from contextlib import asynccontextmanager from pathlib import Path -from typing import Any +from typing import Any, Literal from authlib.integrations.starlette_client import OAuth, OAuthError from dotenv import load_dotenv @@ -672,6 +672,39 @@ async def healthz() -> dict[str, str]: return {"status": "ok"} +@app.get("/api/auth/check") +async def external_module_auth( + request: Request, module: Literal["corm", "order"] +) -> JSONResponse: + """외부 서비스 접근을 ERP의 현재 사용자/권한으로 판단한다. + + 세션에 권한을 복제하지 않는다. 삭제·권한 해제는 다음 요청부터 반영된다. + 호출 서비스는 브라우저의 세션 쿠키만 전달하며 이메일을 지정할 수 없다. + """ + headers = {"Cache-Control": "no-store", "Vary": "Cookie"} + user = get_current_user_record(request) + if user is None: + return JSONResponse( + {"detail": "로그인이 필요합니다."}, status_code=401, headers=headers + ) + if not has_module(user, module): + return JSONResponse( + {"detail": "모듈 접근 권한이 없습니다."}, status_code=403, headers=headers + ) + return JSONResponse( + { + "module": module, + "user": { + "email": user["email"], + "name": user.get("name", ""), + "role": user.get("role", "user"), + "is_super_admin": bool(user.get("is_super_admin")), + }, + }, + headers=headers, + ) + + # ── 관리자 페이지 ────────────────────────────────────────────── @app.get("/admin", response_class=HTMLResponse) async def admin_page(request: Request) -> HTMLResponse: diff --git a/docs/CORM_AUTH.md b/docs/CORM_AUTH.md new file mode 100644 index 0000000..8392575 --- /dev/null +++ b/docs/CORM_AUTH.md @@ -0,0 +1,107 @@ +# CORM 로그인·권한 중앙 관리 + +CORM의 업무 코드와 DB는 별도 서비스로 유지한다. 로그인, 로그아웃, 세션 서명·검증, +사용자 등록/삭제, CORM 접근 권한의 최종 판단은 main-app ERP가 담당한다. + +## 요청 흐름 + +1. 브라우저는 같은 도메인의 `/corm/`에 ERP 세션 쿠키를 보낸다. +2. CORM의 `erp_auth.AuthGuardMiddleware`는 해당 쿠키 하나만 ERP에 전달한다. + 기본 주소는 `http://dbx-main:8000/api/auth/check?module=corm`이다. +3. ERP는 세션의 서명·유효기간을 검증하고 현재 `users.json`의 사용자와 `has_module(user, "corm")`을 확인한다. +4. 허용 시 최소 사용자 정보(email/name/role/is_super_admin)를 반환하고 CORM이 업무 요청을 처리한다. + +권한 정보는 쿠키나 CORM 캐시에 저장하지 않는다. 사용자 삭제·권한 해제는 다음 요청부터 적용된다. +진행 중인 요청을 취소하거나 이미 브라우저에 표시된 데이터를 회수하지는 않는다. +수퍼관리자는 기존 ERP 정책대로 전체 접근하며, 일반 Admin도 `corm` 권한을 끄면 차단된다. + +| ERP 응답 | CORM 동작 | +| --- | --- | +| 200 + 유효한 사용자 | 업무 요청 허용 | +| 401(미로그인·만료·잘못된 쿠키·삭제된 사용자) | 화면은 ERP 로그인으로 이동, API는 401 | +| 403(권한 없음) | 화면·API 모두 403 | +| 타임아웃·연결 실패·예상 밖 응답 | 화면·API 모두 503, 업무 요청 미실행 | + +로그인 완료 후 원래 CORM 경로와 검색 조건으로 돌아간다. `/corm/logout`은 ERP `/logout`으로 위임한다. +CORM은 ERP 세션 쿠키를 발급·갱신하지 않고 ERP의 `SESSION_SECRET_KEY`도 사용하지 않는다. +인증 API 응답은 `Cache-Control: no-store`, `Vary: Cookie`로 캐시를 막는다. +전송한 쿠키·토큰·응답 본문은 인증 코드에서 기록하지 않는다. + +## 설정 + +ERP의 기존 Google OAuth와 사용자 관리 화면(`/admin`)을 사용한다. 신규 DB·ERP 환경변수는 없다. +ERP `SESSION_SECRET_KEY`는 유지한다(기존 Order의 세션 공유 설정도 유지). + +CORM `.env`의 설정은 다음과 같다. `.env.example`에 예시가 있다. + +| 변수 | 설명 | +| --- | --- | +| `APP_ROOT_PATH` | 외부 경로, 기본 운영값 `/corm` | +| `SESSION_COOKIE_NAME` | ERP와 같은 쿠키 이름, 기본 `session` | +| `ERP_AUTH_URL` | 인증 API 주소. 기본 `http://dbx-main:8000/api/auth/check`. 쿠키를 전달하므로 신뢰하는 ERP 주소만 사용 | +| `MAIN_LOGIN_URL` | ERP 로그인 주소 | +| `MAIN_LOGOUT_URL` | ERP 로그아웃 주소 | +| `INTERNAL_SERVICE_TOKEN` | 기존 OMS → CORM 시스템 호출용. 직원 로그인·권한과 별개로 유지 | + +현재 compose에서 main-app과 CORM 모두 `postgres_default` 네트워크에 연결되므로 컨테이너명 `dbx-main`으로 접근한다. +네트워크를 바꾼 환경에서는 실제 공통 네트워크와 이름 해석을 확인한다. +브라우저가 ERP 쿠키를 CORM에도 보내도록 같은 도메인의 `/corm/` 프록시를 유지한다. +개발 환경은 `ERP_AUTH_URL`을 개발 ERP에 맞추고 운영 쿠키·비밀값을 사용하지 않는다. + +정적 파일·정확히 지정한 헬스/카페24 콜백·로그인/로그아웃 경로만 사용자 확인에서 제외한다. +기존 `X-Service-Token` 시스템 호출을 보존하므로 NPM이 외부 요청의 이 헤더를 제거하는 설정도 유지한다. + +## 적용 순서와 확인 + +로컬 소스 변경만으로 운영 설정은 바뀌지 않는다. **ERP를 먼저 배포한 뒤 CORM을 배포한다.** +새 CORM을 먼저 띄우면 이전 ERP에 인증 API가 없어 사용자 접근이 503으로 차단된다. +두 저장소의 변경 파일(새 `erp_auth.py` 포함)이 각각 배포 소스에 포함되어야 한다. + +서버에서 먼저 읽기 전용으로 현재 상태를 확인한다. + +```bash +cd /opt/www/main +git status --short +docker compose ps +docker inspect dbx-main --format '{{json .NetworkSettings.Networks}}' + +cd /opt/dbx-corm +git status --short +docker compose ps +docker inspect dbx-corm --format '{{json .NetworkSettings.Networks}}' +``` + +이 작업에는 DB 스키마·데이터 변경이 없다. 설정 변경 전 각 서비스 `.env`의 기존 안전한 백업 위치를 확인하고 +파일 내용을 로그·메신저에 출력하지 않는다. 상태와 배포 소스를 확인한 뒤 기존 절차로 적용한다. + +```bash +cd /opt/www/main +docker compose up --build -d --no-deps web +docker compose ps + +# API 존재 확인: 쿠키가 없으므로 401이 정상, 404라면 새 ERP가 아직 적용되지 않은 것. +docker exec dbx-main python -c "import httpx; r=httpx.get('http://127.0.0.1:8000/api/auth/check',params={'module':'corm'}); print(r.status_code); assert r.status_code == 401" + +cd /opt/dbx-corm +docker compose up --build -d corm-app +docker compose ps + +# CORM → ERP 내부 통신 확인. 쿠키 없이 401이면 연결/API 확인 성공. +docker exec dbx-corm python -c "import os,httpx; r=httpx.get(os.getenv('ERP_AUTH_URL','http://dbx-main:8000/api/auth/check'),params={'module':'corm'},timeout=3); print(r.status_code); assert r.status_code == 401" +``` + +직원 계정으로 ERP 로그인 → 권한이 있는 CORM 진입 → ERP 관리자가 `corm` 권한 끄기 → +같은 CORM 탭에서 새로고침 시 403 → 다시 켜면 접근 복구를 확인한다. +로그아웃 후에는 로그인 이동/API 401인지, 직접 `/corm/`으로 접근해도 같은 정책인지 확인한다. +서비스 헬스(`/corm/health/db`)만으로 사용자 권한 연동 성공을 판단하지 않는다. + +자동 검증: + +```powershell +# Main-app 저장소 +python -m unittest discover -s tests -p test_external_auth.py -v +# CORM-app 저장소 +python -m unittest discover -s tests -v +``` + +Order는 이 변경에서 소비자 연동을 바꾸지 않았다. ERP API는 `module=order`도 지원하므로 추후 같은 방식으로 연결할 수 있다. diff --git a/docs/DEPLOYMENT.md b/docs/DEPLOYMENT.md index 09eb886..b5d369f 100644 --- a/docs/DEPLOYMENT.md +++ b/docs/DEPLOYMENT.md @@ -36,6 +36,10 @@ > main-app 관련 모든 명령/문서 작성 시 `/opt/www/main` 사용. > 새로운 경로가 필요하면 **사용자 지시**를 받은 뒤 결정한다. +CORM 로그인·권한은 ERP 중앙 확인 방식으로 연결한다. CORM의 `ERP_AUTH_URL` +(기본 `http://dbx-main:8000/api/auth/check`)은 매 요청 ERP의 현재 사용자/권한을 확인한다. +ERP를 먼저 배포하고 CORM을 뒤에 배포한다. 설정·상태 확인·검증은 [CORM 중앙 인증](CORM_AUTH.md)을 따른다. + --- ## 사전 준비 diff --git a/docs/PROJECT_OVERVIEW.md b/docs/PROJECT_OVERVIEW.md index 3ced7aa..048ed5a 100644 --- a/docs/PROJECT_OVERVIEW.md +++ b/docs/PROJECT_OVERVIEW.md @@ -40,6 +40,13 @@ | `inout` | 접근 | 입출고 관리 조회. 발주·입고 입력은 모듈 옵션의 발주 담당·입고 담당(ERP 관리자는 둘 다 + 옵션) | | `vacation_approver` | 결재 | 휴가 승인/반려 (모듈 미개발) | +CORM은 별도 서비스로 실행하되 로그인·로그아웃·사용자·접근 권한은 ERP가 관리한다. +CORM은 브라우저의 ERP 세션 쿠키를 `GET /api/auth/check?module=corm`으로 전달하고 +ERP의 현재 사용자/권한을 매 요청 확인한다. CORM은 세션을 발급·갱신하지 않는다. +권한 해제·사용자 삭제는 다음 요청부터 반영되며, ERP 확인 실패 시 503으로 차단한다. +API는 `order` 권한 확인도 지원하지만 Order 서비스 연동은 별도 작업이다. +설정과 배포 순서는 [CORM 중앙 인증](CORM_AUTH.md)을 따른다. + `admin` 역할은 모든 권한 자동 부여. 신규 사용자는 관리자 페이지(`/admin`)에서 이메일만으로 등록 가능. 관리자 등급(2026-10-12): **수퍼관리자**(`SUPER_ADMIN_EMAIL` 한 명 고정 — 변경·삭제·추가 불가) > **Admin**(`role=admin`) > diff --git a/tests/test_external_auth.py b/tests/test_external_auth.py new file mode 100644 index 0000000..bc62e41 --- /dev/null +++ b/tests/test_external_auth.py @@ -0,0 +1,83 @@ +"""실제 ERP 세션과 임시 사용자 저장소로 외부 서비스 권한을 검증한다.""" +import os +import subprocess +import sys +import tempfile +import unittest +from pathlib import Path + + +class ExternalAuthTests(unittest.TestCase): + def test_live_permissions_and_session_validation(self): + env = dict(os.environ) + for module in ( + "ASSET", "CAFE24", "CUPANG", "VACATION", "PROJECT", "DISPATCH", + "PERFORMANCE", "MALAYSIA_STOCK", "ITEMCODE", "EXPENSE", "INOUT", + ): + env[module + "_DB_URL"] = "" + env.update( + SESSION_SECRET_KEY="external-auth-test-only", SESSION_COOKIE_NAME="session", + SESSION_COOKIE_SECURE="false", PERFORMANCE_AUTO_SYNC="false", + PROJECT_REMINDERS="false", + PYTHONIOENCODING="utf-8", + ) + code = ''' +import base64, json +from itsdangerous import TimestampSigner +from fastapi.testclient import TestClient +import app.main as main + +client = TestClient(main.app) +def cookie(email, secret="external-auth-test-only", nested=False): + payload = {"user": {"email": email}} if nested else {"user_email": email} + return TimestampSigner(secret).sign(base64.b64encode(json.dumps(payload).encode())).decode() +def check(value=None, module="corm"): + headers = {"Cookie": "session=" + value} if value else {} + r = client.get("/api/auth/check", params={"module": module}, headers=headers) + if r.status_code != 422: + assert r.headers["cache-control"] == "no-store" + assert "cookie" in {v.strip().lower() for v in r.headers["vary"].split(",")} + return r + +email = "worker@example.test" +main.user_store.create_user(email=email, name="Worker", modules={"corm": True}) +session = cookie(email) +assert check().status_code == 401 +assert check(cookie(email, "wrong-key")).status_code == 401 +assert check(cookie("missing@example.test")).status_code == 401 +r = check(session) +assert r.status_code == 200, r.text +assert r.json() == {"module": "corm", "user": {"email": email, "name": "Worker", "role": "user", "is_super_admin": False}} +assert check(cookie(email, nested=True)).status_code == 200 +assert check(session, "order").status_code == 403 +assert check(session, "admin").status_code == 422 +assert check(session, "unknown").status_code == 422 + +# Same session immediately loses access after permission removal. +main.user_store.update_permissions(email=email, role=None, modules={"corm": False}) +assert check(session).status_code == 403 +main.user_store.update_permissions(email=email, role=None, modules={"corm": True}) +assert check(session).status_code == 200 +main.user_store.delete(email) +assert check(session).status_code == 401 + +# An admin with corm disabled is also denied; super admin keeps full access. +main.user_store.create_user(email="admin@example.test", role="admin", modules={"corm": False}) +assert check(cookie("admin@example.test")).status_code == 403 +from app.store import SUPER_ADMIN_EMAIL +main.user_store.create_user(email=SUPER_ADMIN_EMAIL) +assert check(cookie(SUPER_ADMIN_EMAIL)).status_code == 200 +assert check(cookie(SUPER_ADMIN_EMAIL), "order").status_code == 200 +print("ERP external authorization OK") +''' + with tempfile.TemporaryDirectory(prefix="external-auth-") as directory: + env["DATA_DIR"] = directory + result = subprocess.run( + [sys.executable, "-c", code], cwd=Path(__file__).resolve().parents[1], + env=env, capture_output=True, text=True, encoding="utf-8", timeout=60, + ) + self.assertEqual(result.returncode, 0, result.stdout + result.stderr) + + +if __name__ == "__main__": + unittest.main()