refactor: 문서 개선 중

This commit is contained in:
donghyeon-ka
2026-09-21 14:30:55 +09:00
parent c93cdea150
commit 805a18f486
1497 changed files with 525837 additions and 59152 deletions
@@ -13,11 +13,11 @@
"long_description": "브라우저가 AP4_SESSION cookie로 Nginx의 /api/edge를 호출한다. Nginx는 oauth2-proxy의 internal auth endpoint에 subrequest를 보내고 인증된 user와 email 결과를 받는다. 이어서 client가 보낸 동명 header를 사용하지 않고 oauth2-proxy 결과와 Nginx 환경의 internal token으로 /edge/me 요청을 새로 조립한다. Spring controller가 user header와 internal token을 함께 확인해 identity JSON을 만들고 Nginx가 브라우저에 전달한다.",
"source_context": {
"document": "document.md",
"document_sha256": "df4d1a604c74e756672b5b40510abfedb8c67b39af280a5f51985ea9972f5371",
"document_sha256": "ea10df24b892e2c57123a37a4b4f0d821e4f394353e6746f50df6a48342353e9",
"anchor": {
"kind": "marker",
"value": "ap4-edge-forward-auth-flow",
"line": 1108
"line": 1148
}
},
"composition": {
@@ -39,8 +39,8 @@
"description": "AP4_SESSION cookie와 함께 edge endpoint를 호출하는 외부 client.",
"evidence": [
{
"start_line": 992,
"end_line": 1007
"start_line": 1032,
"end_line": 1047
}
],
"assumption": false
@@ -54,12 +54,12 @@
"description": "Internal auth subrequest를 만들고 인증 결과를 allowlisted upstream header와 internal token으로 재조립한다.",
"evidence": [
{
"start_line": 914,
"end_line": 939
"start_line": 954,
"end_line": 979
},
{
"start_line": 1009,
"end_line": 1028
"start_line": 1049,
"end_line": 1068
}
],
"assumption": false
@@ -72,12 +72,12 @@
"description": "AP4_SESSION을 검증하고 인증된 user, email과 필요 시 갱신 cookie를 auth response로 돌려준다.",
"evidence": [
{
"start_line": 980,
"end_line": 990
"start_line": 1020,
"end_line": 1030
},
{
"start_line": 1009,
"end_line": 1015
"start_line": 1049,
"end_line": 1055
}
],
"assumption": false
@@ -90,12 +90,12 @@
"description": "Identity header와 internal token을 함께 검증해 allowlisted identity JSON을 반환한다.",
"evidence": [
{
"start_line": 1017,
"end_line": 1026
"start_line": 1057,
"end_line": 1066
},
{
"start_line": 1030,
"end_line": 1063
"start_line": 1070,
"end_line": 1103
}
],
"assumption": false
@@ -111,8 +111,8 @@
"order": 1,
"evidence": [
{
"start_line": 992,
"end_line": 999
"start_line": 1032,
"end_line": 1039
}
],
"assumption": false
@@ -126,12 +126,12 @@
"order": 2,
"evidence": [
{
"start_line": 922,
"end_line": 939
"start_line": 962,
"end_line": 979
},
{
"start_line": 1009,
"end_line": 1009
"start_line": 1049,
"end_line": 1049
}
],
"assumption": false
@@ -146,8 +146,8 @@
"order": 3,
"evidence": [
{
"start_line": 1009,
"end_line": 1015
"start_line": 1049,
"end_line": 1055
}
],
"assumption": false
@@ -162,8 +162,8 @@
"order": 4,
"evidence": [
{
"start_line": 1017,
"end_line": 1026
"start_line": 1057,
"end_line": 1066
}
],
"assumption": false
@@ -178,8 +178,8 @@
"order": 5,
"evidence": [
{
"start_line": 1030,
"end_line": 1048
"start_line": 1070,
"end_line": 1088
}
],
"assumption": false
@@ -194,12 +194,12 @@
"order": 6,
"evidence": [
{
"start_line": 1039,
"end_line": 1048
"start_line": 1079,
"end_line": 1088
},
{
"start_line": 1065,
"end_line": 1076
"start_line": 1105,
"end_line": 1116
}
],
"assumption": false