NHN KCP 휴대폰 본인인증 V2 패치 적용 및 설정 가이드

• 목록
• 스크랩

NHN KCP 휴대폰 본인인증 V2 패치 적용 및 설정 가이드

그누보드5 운영 중 NHN KCP 휴대폰 본인인증 V2 전환 요청에 대응하여 필수 파일 패치, config.php 상수 설정 및 스킨 오류를 해결하는 방법을 알아봅니다.

NHN KCP 휴대폰 본인인증 V2 패치 사전 준비 및 수정 파일 범위

그누보드5 환경에서 기존 V1 또는 그 이전 버전의 NHN KCP 휴대폰 본인인증 방식을 V2로 전환하기 위해서는 사전 백업과 버전 확인이 필수적입니다.

사전 준비 사항

• 전체 파일 및 데이터 백업: 커스터마이징된 파일을 그대로 덮어쓰면 오류가 발생할 수 있으므로, 패치 진행 전 반드시 전체 소스와 파일을 백업해야 합니다.
• 그누보드 버전 확인 및 업데이트: NHN KCP 휴대폰 본인인증 V2 패치는 그누보드 5.6.30 버전(최소 5.6.28 버전 이상)까지 온전히 적용해야 정상적으로 사용할 수 있습니다.

수정 대상 파일 범위 및 핵심 구성

• 수정 범위: adm/config_form.php, adm/config_form_update.php, js/certify.js 등 총 35개 파일을 수정해야 합니다. 커스터마이징된 사이트라면 패치 파일의 코드를 기존 파일과 비교하여 수동 병합(Merge)해야 합니다.
• 핵심 상수 및 디렉터리: config.php 파일 내 G5_KCPCERT_V2_DIR / URL / PATH 상수 정의와 plugin/kcpcert_v2/ 디렉터리가 적용되어야 합니다.
• 인증 URL 연결: 회원가입, 아이디·비밀번호 찾기, 본인확인 갱신 화면 및 소셜 회원 스킨 등에서 인증 URL을 kcpcert_v2/kcpcert_form.php로 연결하고 PC, 모바일, 테마의 인증 버튼과 콜백 처리를 수정해야 합니다.

그누보드 config.php KCP V2 상수 정의 방법

그누보드에서 NHN KCP 휴대폰 본인인증 V2 모듈을 정상적으로 작동시키려면 /config.php 파일에 관련 경로 및 디렉터리 상수가 정의되어 있어야 합니다.

설정 위치 및 코드

/config.php 파일에 해당 코드가 누락되어 있다면 파일 맨 아래에 아래 상수를 추가합니다.

if (!defined('G5_KCPCERT_V2_DIR')) define('G5_KCPCERT_V2_DIR', 'kcpcert_v2');
if (!defined('G5_KCPCERT_V2_URL')) define('G5_KCPCERT_V2_URL', G5_PLUGIN_URL.'/'.G5_KCPCERT_V2_DIR);

공식 소스 기준 전체 정의 형태는 다음과 같습니다.

• define('G5_KCPCERT_V2_DIR', 'kcpcert_v2');
• define('G5_KCPCERT_V2_URL', G5_PLUGIN_URL.'/'.G5_KCPCERT_V2_DIR);
• define('G5_KCPCERT_V2_PATH', G5_PLUGIN_PATH.'/'.G5_KCPCERT_V2_DIR);

다음 행동 및 주의사항

• 코드를 수정하기 전 반드시 기존 파일을 백업해야 합니다.
• 상수가 올바르게 설정되었는지 확인한 후 관리자 페이지 기본환경설정에서 KCP V2 사이트 코드 및 ENC_KEY 등의 설정값이 올바르게 입력되었는지 점검합니다.

KCP V2 인증 오류 시 스킨 코드 수정 방법

그누보드 버전 업데이트 이후 회원가입, 아이디·비밀번호 찾기, 본인확인 갱신 화면 등에서 '기본환경설정에서 휴대폰 본인확인 설정을 해주십시오' 오류 메시지가 발생하는 경우, 스킨 파일 내의 인증 방식 분기 처리와 인증 URL 연결 코드가 올바르게 수정되어 있는지 확인해야 합니다.

확인 및 수정 위치

스킨 파일(PC 및 모바일 스킨, 소셜 회원 스킨) 내에서 본인인증 타입과 인증 URL을 처리하는 switch 문을 점검합니다.

• 수정 대상 파일 예시:
  • skin/member/basic/register_form.skin.php
  • skin/member/basic/password_lost.skin.php
  • skin/member/basic/member_cert_refresh.skin.php
  • skin/social/social_register_member.skin.php
  • 모바일 스킨 및 테마 경로의 동일 파일들

코드 수정 조건 및 내용

switch 문 안에 kcp_v2 케이스가 누락되어 있으면 기본 default 구문으로 빠지면서 오류 경고창이 출력됩니다. 따라서 각 스킨 파일의 switch 구문에 아래와 같이 kcp_v2 분기 처리가 포함되어 있는지 확인하고 추가합니다.

case 'kcp_v2':
 $cert_url = G5_KCPCERT_V2_URL.'/kcpcert_form.php';
 $cert_type = 'kcp_v2-hp';
 break;

다음 행동

1. FTP 등을 통해 현재 사용하는 테마 및 기본 스킨 디렉터리 내의 회원 관련 파일(register_form.skin.php, password_lost.skin.php 등)을 엽니다.
2. switch 문 내에 kcp_v2 설정이 빠져 있는지 확인하고 위 코드를 추가합니다.
3. 수정 완료 후 회원가입 및 본인확인 페이지에서 정상적으로 인증 창이 호출되는지 테스트합니다.

KCP V2 패치 파일 업로드 시 권장 전송 방식

FTP를 통해 KCP V2 패치 파일을 서버에 업로드할 때 파일 손실과 인코딩 오류를 방지하기 위해 알집FTP 대신 파일질라FTP(FileZilla)를 사용하여 바이너리 모드로 업로드해야 합니다. 알집FTP를 사용할 경우 일부 파일이 손실되어 업로드될 수 있으므로 주의가 필요합니다.

NHN KCP V2 패치 상황별 판단 기준

내 상황	우선할 판단	다음 행동
그누보드5 커스텀 사이트 운영 중	전체 소스 및 데이터 백업 선행	파일질라FTP 바이너리 모드로 패치 적용
V1에서 V2 전환 및 인증 오류 발생	그누보드 5.6.30 이상 버전 업데이트 확인	config.php 상수 정의 및 스킨 파일 kcp_v2 분기 처리 추가

실전 FAQ

Q. 버전업 후 '기본환경설정에서 휴대폰 본인확인 설정을 해주십시오' 오류가 계속 발생합니다.

• 원인 및 대책: 회원가입, 비밀번호 찾기, 본인확인 갱신 등의 스킨 파일(register_form.skin.php, password_lost.skin.php 등) 내 switch 문에 kcp_v2 분기 처리가 누락되어 기본 default 구문으로 빠질 때 발생합니다. 해당 스킨 파일의 switch 문에 $cert_url = G5_KCPCERT_V2_URL.'/kcpcert_form.php'; 코드가 포함되어 있는지 확인하고 추가해야 합니다.

참고자료

기타 참고자료

• sir.kr — NHN_KCP 휴대폰 본인인증 V2 패치 적용하기 - SIR - 개발자 커뮤니티
• sir.kr — 버전업 이후 kcp 휴대폰 본인인증 오류 - SIR - 개발자 커뮤니티
• github.com — gnuboard5/config.php at master · gnuboard/gnuboard5 · GitHub