From 1763a6123a3a4de1d3bb6138efbee1d3f40dd041 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=EA=B0=95=EC=98=81=EB=B3=B4?=
 <lightone2017@codebridge-x.com>
Date: Fri, 20 Mar 2026 08:59:49 +0900
Subject: [PATCH] =?UTF-8?q?docs:=20[bending]=20=EC=9D=B4=EB=AF=B8=EC=A7=80?=
 =?UTF-8?q?=20=EC=A0=91=EA=B7=BC=20=EB=B0=A9=EC=8B=9D=20=EB=AC=B8=EC=84=9C?=
 =?UTF-8?q?=ED=99=94=20(MNG2=20=ED=94=84=EB=A1=9D=EC=8B=9C=20+=20Bearer=20?=
 =?UTF-8?q?=EC=9D=B8=EC=A6=9D)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- FileViewController 프록시 흐름 설명
- resolveApiToken 토큰 자동 재발급
- 필수 .env 설정값 (API_BASE_URL, FLOW_TESTER_API_KEY, INTERNAL_EXCHANGE_SECRET)
---
 dev/dev_plans/bending-management/README.md | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/dev/dev_plans/bending-management/README.md b/dev/dev_plans/bending-management/README.md
index 169cac3..3ff722c 100644
--- a/dev/dev_plans/bending-management/README.md
+++ b/dev/dev_plans/bending-management/README.md
@@ -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 서버와 동일한 값}
+```
+
 ### 이미지 스냅샷 정책
 
 ```