feat(auth): authorize external modules from ERP permissions
This commit is contained in:
+34
-1
@@ -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:
|
||||
|
||||
@@ -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`도 지원하므로 추후 같은 방식으로 연결할 수 있다.
|
||||
@@ -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)을 따른다.
|
||||
|
||||
---
|
||||
|
||||
## 사전 준비
|
||||
|
||||
@@ -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`) >
|
||||
|
||||
@@ -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()
|
||||
Reference in New Issue
Block a user