feat(auth): authorize external modules from ERP permissions
This commit is contained in:
@@ -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`) >
|
||||
|
||||
Reference in New Issue
Block a user