Files
Gnuboard7/plugins/_bundled/sirsoft-verification_kginicis
HeuJung d263f74cae chore(release): 7.0.10 및 동반 확장·언어팩 출시일을 2026-09-06 으로 재정렬
출시가 다시 미뤄져 코어 7.0.10 과 함께 나가는 패키지의 CHANGELOG 출시일을
오늘로 맞췄다. origin/release(7.0.9, 2026-08-24) 페이로드 대비 버전이 오른
패키지 31종 + 코어 = 32건이 대상이며, 최상단 절 헤더 날짜 한 줄씩만 바뀐다.

버전이 오르지 않은 언어팩 10종은 7.0.9 이전 릴리즈분이라 건드리지 않았다.
활성 디렉토리 사본은 gitignore 대상이라 릴리즈 페이로드에 포함되지 않으므로
update 커맨드를 돌리지 않았다.

결제 3종(kginicis·nhnkcp·nicepayments)은 버전 검사 하네스가 차단으로 띄우지만
저장소 릴리즈 미발행 확장이라 origin/release 페이로드가 기준이며, 재실측 결과
셋 다 페이로드 +1 로 정합이다.
2026-09-06 08:24:30 +09:00
..
2026-07-01 10:30:32 +09:00
2026-07-01 10:30:32 +09:00
2026-07-01 10:30:32 +09:00
2026-07-01 10:30:32 +09:00
2026-07-01 10:30:32 +09:00

그누보드7 KG이니시스 본인인증 플러그인

그누보드7 플러그인 · sirsoft-verification_kginicis KG이니시스 통합인증의 본인확인(reqSvcCd=03)을 그누보드7 코어 IDV 인프라에 Provider 로 등록하는 플러그인

version 1.0.5 type 플러그인 그누보드7 >=7.0.8 license MIT


소개 · 주요 기능 · 동작 방식 · 요구 사항 · 설치 · 관리자 설정 · 사용 방법 · 다른 확장과의 연동 · 문서 · 트러블슈팅 · 변경 이력 · 라이선스


소개

KG이니시스 본인확인(휴대폰 인증, reqSvcCd=03)을 그누보드7 코어의 본인인증(IDV) 체계에 연결하는 플러그인입니다. 코어가 정의한 표준 인터페이스를 구현해, 회원가입·비밀번호 찾기·민감작업 등 코어가 IDV 를 요구하는 모든 지점에서 이메일 인증 대신 이니시스 팝업이 동작하게 합니다.

결제 PG 플러그인들과 달리 이 플러그인은 실제 개인식별정보(PII — 이름·생년월일·성별·CI/DI 등)를 직접 보관합니다. 본인확인 결과를 저장해 두어야 이후 재확인 없이 "이 사용자가 본인확인을 완료했는가"를 즉시 판단할 수 있기 때문입니다. sirsoft-ecommerce를 비롯한 어떤 다른 확장에도 의존하지 않고 코어만으로 동작합니다.

주요 기능

영역 설명
본인확인 KG이니시스 통합인증(reqSvcCd=03) 팝업 기반 본인확인
성인인증 만 19세 이상 여부만 확인하는 별도 purpose
중복가입 차단 DI 또는 CI 기준으로 동일인 재가입 차단 (선택)
게스트 처리 비로그인 사용자의 본인확인 결과를 임시 보관 후 가입 완료 시 흡수
개인정보 정리 사용자 탈퇴/삭제 시 보관 중인 PII 레코드 자동 파기
마이페이지 본인확인 완료 상태 카드 노출
관리자 설정 테스트/라이브 모드 전환, 중복가입 판정 기준 설정

동작 방식

flowchart LR
  A[코어가 IDV 요구 · 428] --> B[사용자 클릭 → 팝업 오픈]
  B --> C[이니시스 인증 폼 제출]
  C --> D[인증 완료 → 결과 회수]
  D --> E[SEED 복호화 → PII 확보]
  E -->|로그인 사용자| F[레코드 즉시 저장]
  E -->|비로그인 사용자| G[Cache 임시 보관]
  G --> H[가입 완료 시 레코드로 흡수]

팝업은 반드시 사용자 클릭 이벤트 안에서 열립니다 — 비동기 콜백 이후에 열면 브라우저 팝업 차단기에 걸립니다. 비로그인 사용자(회원가입 도중)의 본인확인 결과는 가입이 실제로 완료되기 전까지 DB 가 아니라 Cache 에만 임시 보관됩니다.

요구 사항

항목 값
그누보드7 코어 >=7.0.8
PHP ^8.2

설치

# 번들 설치 (코어에 동봉된 소스에서 설치)
php artisan plugin:install sirsoft-verification_kginicis

# 활성화
php artisan plugin:activate sirsoft-verification_kginicis

# 업데이트 (번들 소스 기준 강제 반영)
php artisan plugin:update sirsoft-verification_kginicis --force

저장소: https://github.com/gnuboard/g7-plugin-sirsoft-verification_kginicis

관리자 설정

키 의미 기본값
is_test_mode 테스트 모드 true
test_mid 테스트 MID INIiasTest
test_api_key 테스트 API 키 TGdxb2l3enJDWFRTbTgvREU3MGYwUT09
live_mid 라이브 MID -
live_api_key 라이브 API 키 -
duplicate_field 중복 판정 필드 di
duplicate_block_enabled 중복 가입 차단 true

개발자용 상세(타입·검증·저장 위치)는 설정 스키마 를 보세요.

live_mid는 실제 사용 시점(요청 조립 시)에 SRB 프리픽스가 자동으로 붙으므로 프리픽스 없이 입력해도 됩니다. live_mid/live_api_key는 is_test_mode를 끄는(라이브 모드) 순간부터 필수가 됩니다 — 테스트 모드에서는 비워둘 수 있습니다. duplicate_field(di 또는 ci)와 duplicate_block_enabled는 다른 IDV provider(예: sirsoft-verification_nhnkcp)와 별개로 이 provider 를 통해 확인한 사용자에게만 적용됩니다. 라이브 API 키는 외부에 노출하지 마세요.

사용 방법

활성화하기: 플러그인을 활성화하면 자동으로 코어 IDV provider 목록에 등록됩니다. 별도 화면 배치 작업 없이 코어가 이미 정의한 IDV 강제 지점(회원가입 등)에서 즉시 동작합니다. 여러 IDV provider 를 동시에 설치했다면 코어 본인인증 정책 화면에서 어느 provider 를 쓸지 선택합니다.

중복가입 차단 켜기: 동일인이 여러 계정을 만드는 것을 막고 싶다면 duplicate_block_enabled를 켜고 duplicate_field로 DI/CI 중 판정 기준을 고릅니다.

개인정보 보관 정책 확인: 사용자가 탈퇴하거나 관리자가 계정을 삭제하면 보관 중인 본인확인 PII 가 자동으로 파기됩니다 — 별도 운영 작업이 필요 없습니다.

전체 API 목록은 docs/api/ 를, 발행/구독 훅 목록은 docs/extension-points.md 를 참고하세요.

다른 확장과의 연동

이 확장이 의존하는 확장

없음 — 코어만으로 동작합니다.

이 확장에 의존하는 확장 (이 확장을 비활성화하면 함께 영향을 받습니다)

없음.

문서

문서 내용 상태
docs/README.md 문서 통합 목차와 실측 집계 ✅
docs/architecture.md 설계 의도·계층 지도·디렉토리 맵 ✅
docs/extension-points.md 발행/구독 훅·미들웨어·채널·스케줄 ✅
docs/data-model.md 모델·소유 테이블·마이그레이션·Enum ✅
docs/settings.md 설정 스키마·권한·메뉴·라우트·의존 관계 ✅
docs/frontend.md 레이아웃·액션 핸들러·전역 진입점·에셋 ✅
docs/editor-spec.md 레이아웃 편집기에 선언한 팔레트·컨트롤·샘플 데이터 ✅
docs/api/ API 레퍼런스 (엔드포인트별 파라미터·응답 필드) ✅
CHANGELOG.md 변경 이력 ✅

트러블슈팅

증상 원인 조치
인증 버튼을 눌러도 팝업이 안 뜸 브라우저 팝업 차단기 startAuth가 클릭 이벤트 핸들러 안에서 직접 호출되는지 확인 — 비동기 콜백 뒤로 옮기면 차단됨
설정 저장 시 422 오류 라이브 모드인데 live_mid/live_api_key 미입력 is_test_mode를 켜거나 라이브 자격증명을 입력
이미 가입된 사용자인데 중복 오류 없이 재가입됨 duplicate_block_enabled가 꺼져 있거나 duplicate_field 기준이 실제 판정과 다름 관리자 설정에서 두 값을 확인
탈퇴한 사용자의 본인확인 정보가 남아있는 것으로 보임 정리 리스너 실행 여부를 별도로 확인하지 않음 CleanInicisRecordOnUserWithdraw/CleanInicisRecordOnUserDelete 정상 등록 여부를 훅 캐시에서 확인

변경 이력

CHANGELOG.md

라이선스

MIT