# 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`도 지원하므로 추후 같은 방식으로 연결할 수 있다.