HeuJung
8328b1db77
S1 파일럿 3종(sirsoft-board · sirsoft-gdpr · sirsoft-admin_basic)에 이어
결제·본인인증 동형군 6종의 AGENTS.md · README.md · docs/ 5문서를 집필했다.
확장을 고치려는 쪽이 매번 src/ 를 훑어 구조를 재발견하지 않도록, 설계 의도와
확장점(발행·구독 훅)·수정 시 동반 의무·금지 패턴을 코드 근거로 서술했다.
생성기(ExtensionDocScaffolder)에서 표를 무의미하게 만들던 세 결함을 함께 고쳤다.
getLayoutExtensions 기본 구현이 돌려주는 절대경로가 파일 목록과 중복돼 로컬
머신 경로가 커밋 문서에 실리던 문제, getNotificationDefinitions 를 'key'/'event'
로 읽어 모든 행이 '-' 로 찍히던 문제, getSettingsLayout 절대경로가 정규화 없이
노출되던 문제다. 셋 다 예외를 남기지 않고 표만 조용히 망가뜨리므로
ExtensionDocContractTest 에 각각의 되돌림 red 를 확인한 단언을 두었다.
템플릿의 extensions/{id}/ 는 모듈·플러그인의 발행과 반대 방향(오버라이드)이라
별도 블록(template-overrides)으로 분리했다.
sirsoft-admin_basic 의 컴포넌트·핸들러·레이아웃 문서를 코어 docs/ 에서 그 템플릿
소유로 이관하고, 남은 참조 6축을 재는 가드를 추가했다. 이관 후 남은 옛 경로는
오류가 아니라 헛걸음으로만 나타나 드러나지 않는다. 의 상대 링크가
한 단계 얕아 공유 docs/ 대신 를 가리키던 문제도 함께 고쳤다.
README 상단의 확장명 이미지 배지를 평문 H1 로 바꿨다( 지시 2026-08-31).
루트 README.md · README.ko.md 도 같은 기준을 적용했다. 정보 배지는 유지한다.
sirsoft-gdpr: 회원탈퇴로 자동 철회된 동의가 관리자 동의 이력 화면의 출처 필터로
걸러지지 않던 문제를 고쳤다. Repository 가 'withdraw' 리터럴을 직접 UPDATE 에
싣는데 그 값이 ConsentSource enum 에 없어, 화면 필터 옵션·라벨 어느 쪽에도
도달하지 못했다. 어휘를 enum 단일 출처로 모으고 ko·en·ja 라벨과 필터 옵션을
함께 채웠으며, 어휘 대조 테스트의 모집단에 Repository 를 편입했다.
4.9 KiB
KG이니시스 본인인증 — 설정·권한·라우트
설정 스키마·권한·메뉴·라우트·의존 관계 · 진입점: AGENTS.md
설정 스키마
| 키 | 타입 | 기본값 | 설명 |
|---|---|---|---|
is_test_mode |
boolean |
true |
테스트 모드 |
test_mid |
string |
INIiasTest |
테스트 MID |
test_api_key |
string |
TGdxb2l3enJDWFRTbTgvREU3MGYwUT09 |
테스트 API 키 |
live_mid |
string |
- | 라이브 MID |
live_api_key |
string |
- | 라이브 API 키 |
duplicate_field |
enum |
di |
중복 판정 필드 |
duplicate_block_enabled |
boolean |
true |
중복 가입 차단 |
기본값 파일: config/settings/defaults.json · 설정 화면 레이아웃: resources/layouts/admin/plugin_settings.json
결제 PG 플러그인들의 test_*/live_* 쌍과 같은 구조이지만 필드는 단 2개(test_mid/
test_api_key, live_mid/live_api_key)뿐입니다 — 본인확인 API 는 결제와 달리 사인키·
INIAPI 키·모바일 해시키처럼 기능별로 분리된 자격증명이 필요 없습니다. live_mid는
InicisIdentityProvider::buildLiveMid()가 그 값을 요청 조립 시점에 쓸 때 SRB 프리픽스를
동적으로 부착하므로(DB 저장값은 원본 그대로) 운영자가 프리픽스를 직접 입력할 필요가
없습니다. live_mid/live_api_key는 is_test_mode=false일 때만
ValidateInicisSettingsListener가 required로 강제합니다(§AGENTS.md "핵심 흐름").
duplicate_field/duplicate_block_enabled는 sirsoft-ecommerce와 무관한 코어 레벨
회원가입 규칙입니다 — 이 플러그인은 이커머스에 의존하지 않습니다(§의존 관계).
권한
선언된 권한이 없습니다.
본인인증 설정 접근 권한은 코어의 관리자 권한 체계 안에서 다뤄집니다 — IDV provider 마다 별도 권한을 선언하면 provider 를 여러 개 설치했을 때 "본인인증 설정을 볼 수 있는 사람"이 provider 수만큼 중복 정의됩니다.
메뉴
등록하는 메뉴가 없습니다.
설정 화면(plugin_settings.json)은 코어의 "플러그인 관리 > 설정" 공통 진입점을 통해
접근합니다 — IDV provider 마다 전용 사이드바 메뉴를 만들면 provider 를 여러 개 설치했을
때 메뉴가 난립합니다.
라우트
| 종류 | 파일 | URL prefix |
|---|---|---|
api |
src/routes/api.php |
/api/plugins/sirsoft-verification_kginicis/... |
web |
src/routes/web.php |
/plugins/sirsoft-verification_kginicis/... |
확장 라우트는 활성 상태인 확장의 것만 등록됩니다. 라우트 정의를 바꾸면 라우트 캐시 재생성이 필요합니다.
web 라우트는 CSRF 검증을 명시적으로 제외합니다(ValidateCsrfToken 제외 그룹) — 이니시스
결제창이 팝업 안에서 우리 서버로 폼을 직접 POST 하는데, 그 요청은 우리 CSRF 토큰을 모르기
때문입니다. popup-bridge는 팝업과 opener 창 사이의 postMessage 중계용 정적 페이지라
별도 인증이 필요 없습니다. api는 로그인 사용자가 Bearer 토큰으로 자기 본인확인 상태를
조회하는 마이페이지 엔드포인트(GET /me/identity/inicis)입니다 — 챌린지 시작 자체는
코어 /api/identity/challenges가 담당하므로 이 플러그인의 api 라우트에는 없습니다.
의존 관계
이 확장이 의존하는 확장
없음 — 코어만으로 동작합니다.
이 확장에 의존하는 확장 (이 확장을 비활성화하면 함께 영향을 받습니다)
없음.
결제 PG 플러그인들과 달리 이 플러그인은 sirsoft-ecommerce에 의존하지 않습니다 — 본인확인은
결제와 무관하게 회원가입·비밀번호 찾기 등 코어 인증 흐름 전반에 쓰이는 기능이라, 이커머스가
설치되지 않은 사이트(게시판만 운영하는 등)에서도 단독으로 동작해야 합니다.