docs: [bending] 이미지 접근 방식 문서화 (MNG2 프록시 + Bearer 인증)

- FileViewController 프록시 흐름 설명
- resolveApiToken 토큰 자동 재발급
- 필수 .env 설정값 (API_BASE_URL, FLOW_TESTER_API_KEY, INTERNAL_EXCHANGE_SECRET)
This commit is contained in:
강영보
2026-03-20 08:59:49 +09:00
parent 8b72f8133d
commit 1763a6123a

View File

@@ -269,6 +269,27 @@ docker cp /home/kkk/sam/5130/bottombar docker-api-1:/tmp/legacy_5130/bottombar
> **이미지 업로드 안내**: 레거시 이미지 파일을 docker 컨테이너에 복사 후 artisan 커맨드 실행 필요 (위 "전체 복원 커맨드" 참조)
### 이미지 접근 방식 — MNG2 프록시 (Bearer 인증)
```
브라우저 <img src="mng2.sam.kr/files/{id}/view">
→ FileViewController (MNG2 서버)
→ API KEY + Bearer 토큰 자동 첨부 (resolveApiToken)
→ api.sam.kr/api/v1/files/{id}/view
→ R2 이미지 반환
인증 흐름:
1. MNG2 로그인 시 ApiTokenService.exchangeToken() → 세션에 Bearer 토큰 저장
2. FileViewController에서 resolveApiToken() → 만료 시 자동 재발급
3. API KEY (.env FLOW_TESTER_API_KEY) + Bearer 토큰으로 API 호출
4. SSL 자체서명 인증서 → withoutVerifying() 적용
필수 .env 설정 (MNG2):
API_BASE_URL=https://api.sam.kr
FLOW_TESTER_API_KEY={api_keys 테이블의 key}
INTERNAL_EXCHANGE_SECRET={API 서버와 동일한 값}
```
### 이미지 스냅샷 정책
```