그누보드5 기본 캡차를 구글 리캡차(reCAPTCHA)로 교체하는 방법

• 목록
• 스크랩

그누보드5 기본 캡차를 구글 리캡차(reCAPTCHA)로 교체하는 방법

그누보드5 기본 문자 캡차(kcaptcha) 대신 구글 리캡차를 적용하여 보안성과 가독성을 높이려는 운영자·개발자를 위한 키 발급, 설정 및 적용 가이드입니다.

구글 리캡차 키 발급 방법

구글 리캡차(reCAPTCHA)를 사용하려면 Site Key와 Secret Key가 필요합니다. 키를 발급받는 절차와 주의사항은 다음과 같습니다.

1. 웹사이트 도메인 등록: 구글 리캡차 관리자 페이지(https://www.google.com/recaptcha/admin)에 접속하여 리캡차를 사용하려는 웹사이트 도메인을 등록합니다.
2. 키 발급: 도메인 등록 후 사이트 정보가 포함된 Site Key와 Secret Key를 발급받습니다.

유의사항

• 리캡차를 사용하려는 웹사이트 도메인 정보와 구글에 등록한 도메인 정보가 일치해야 합니다. 도메인 정보가 일치하지 않으면 구글 리캡차가 정상적으로 동작하지 않습니다.

구글 리캡차 키 입력 및 플러그인 업로드 방법

발급받은 Site Key와 Secret Key를 적용하고 서버에 파일을 배치하는 절차는 다음과 같습니다.

1. 플러그인 파일에 키 입력

• 발급받은 Site Key와 Secret Key를 플러그인 폴더 안에 있는 recaptcha_api.php 파일을 열어 상단의 변수값에 입력합니다.

2. 서버 업로드 경로

• 키 값이 입력된 플러그인 폴더 전체를 그누보드의 plugin 폴더에 업로드합니다.
• 업로드 시 폴더명을 변경한 경우 환경에 맞게 적절히 맞춰줍니다.

config.php 파일 캡차 설정 변경 방법

그누보드 루트 폴더에 있는 config.php 파일에서 기본 캡차 경로로 지정된 상수를 수정해야 합니다.

• 수정 위치: 그누보드 루트 폴더의 config.php
• 수정 대상 상수: G5_CAPTCHA_DIR
• 변경 전 코드: define('G5_CAPTCHA_DIR', 'kcaptcha');
• 변경 후 코드: define('G5_CAPTCHA_DIR', 'recaptcha'); (업로드한 폴더명에 따라 변경 가능)

이 설정을 통해 시스템이 기본 kcaptcha 대신 구글 리캡차 폴더를 참조하도록 경로를 전환할 수 있습니다.

구글 리캡차 연동 시 PHP 환경 및 도메인 제약 사항

그누보드5에 구글 리캡차를 연동할 때 확인해야 할 주요 제한 사항은 다음과 같습니다.

• PHP curl 모듈 설치 필수: 리캡차 기능은 내부적으로 curl을 이용하므로 서버에 PHP curl 모듈이 설치되어 있어야 정상적으로 동작합니다. 일반적으로는 기본 설치되어 있으나, 동작하지 않을 경우 서버의 curl 모듈 설치 여부를 확인해야 합니다. 만약 file_get_contents를 사용하려면 소스 코드의 수정이 필요합니다.
• 도메인 정보 일치 여부: 구글 리캡차 관리자 페이지에 등록한 웹사이트 도메인 정보와 실제 리캡차를 사용하려는 웹사이트 도메인이 일치해야 합니다. 도메인 정보가 일치하지 않으면 리캡차가 정상적으로 작동하지 않습니다.
• 한글 도메인 브라우저 제약: 한글 도메인(예: 한글.한국, 한글.com, 한글.kr)을 사용하는 경우, 인터넷 익스플로러(IE) 6, 7, 8, 9 구버전에서는 리캡차를 사용할 수 없는 제약 사항이 존재합니다.

상황별 판단 및 행동 가이드

내 상황	우선할 판단	다음 행동
구글 리캡차 키가 없는 경우	도메인 일치 여부 확인	구글 리캡차 관리자 페이지에서 사용할 웹사이트 도메인을 등록하고 Site Key와 Secret Key를 발급받는다.
플러그인 파일을 준비한 경우	키 값 설정 및 파일 업로드	recaptcha_api.php 파일 상단 변수에 발급받은 키를 입력하고, 해당 플러그인 폴더를 그누보드 plugin 폴더에 업로드한다.
업로드를 완료한 운영 환경	캡차 경로 상수 변경	그누보드 루트의 config.php 파일에서 G5_CAPTCHA_DIR 값을 recaptcha로 변경하여 기본 캡차를 교체한다.

실전 FAQ

Q. 구글에 등록한 도메인과 실제 웹사이트 주소가 다르면 어떻게 되나요?

• 도메인 정보가 일치하지 않으면 구글 리캡차가 정상적으로 동작하지 않으므로 반드시 실제 운영 중인 정확한 도메인을 등록해야 합니다.

Q. 한글 도메인을 사용할 때 주의할 점이 있나요?

• 한글 도메인(한글.한국, 한글.com 등)을 사용하는 경우 익스플로러 6, 7, 8, 9 구버전에서는 리캡차를 사용할 수 없는 제약 사항이 존재합니다.

Q. 서버에서 캡차가 작동하지 않고 오류가 발생할 때는 무엇을 확인해야 하나요?

• 리캡차 기능은 내부적으로 curl을 이용하므로 서버에 PHP curl 모듈이 설치되어 있는지 확인해야 합니다.

참고자료

기타 참고자료

• sir.kr — 구글 리캡차 reCAPTCHA 를 그누보드 기본 캡차로 변경하는 플러그인 - 그누보드 5.2 용 - SIR - 개발자 커뮤니티
• happyjung.com — G5 구글 리캡차 reCAPTCHA 를 그누보드 기본 캡차로 변경 > 기술자료 | 해피정닷컴