BOARD 문제 해결

그누보드 로그인 및 회원가입 페이지 SSL/HTTPS 적용 가이드

페이지 정보

작성자 최고관리자
댓글 0건 조회 12회 작성일 26-09-28 17:56

본문

그누보드 운영자 및 개발자를 위해 로그인 및 회원가입 페이지에 SSL(HTTPS)을 적용하는 설정 방법과 필수 확인 사항을 안내합니다.

그누보드 config.php에서 HTTPS 도메인 설정 방법

그누보드 설치 경로 내에 있는 config.php 파일을 편집기로 열어 보안서버(HTTPS) 주소를 지정할 수 있습니다. 파일 내 경로 상수 하단에서 다음과 같이 설정을 진행합니다.

1. 파일 위치 확인

웹호스팅의 그누보드 설치 폴더 하위 경로에서 config.php 파일을 찾습니다.
- 예시 경로: \public_html\config.php

2. 도메인 상수 수정

config.php 파일을 열어 G5_DOMAIN과 G5_HTTPS_DOMAIN 값을 환경에 맞게 입력합니다.

보안서버 주소를 지속적으로 사용하는 경우
```
define('G5_DOMAIN', '');
define('G5_HTTPS_DOMAIN', 'https://도메인:443');
```
(예시: define('G5_HTTPS_DOMAIN', 'https://www.example.com'); 또는 포트 번호를 포함한 형식으로 지정)

보안서버 주소를 사용 후 일반 주소로 돌아오는 경우

define('G5_DOMAIN', 'http://도메인');
define('G5_HTTPS_DOMAIN', 'https://도메인');

3. 다음 행동 및 주의사항

도메인 설정 전 서버단에 SSL 인증서가 정상적으로 설치되어 있는지 확인해야 합니다.
설정 완료 후 로그인 및 회원가입 페이지에 접속하여 주소창의 자물쇠 아이콘(HTTPS)과 스타일시트·자바스크립트가 정상 로드되는지 확인합니다.

SSL 적용 후 로그인 문제 원인 및 확인 사항

그누보드에 SSL(HTTPS)을 적용한 뒤 로그인 시 화면이 깨지거나 로그인이 풀리는 현상은 주로 도메인 설정 누락, 쿠키 공유 범위 불일치, 또는 혼합 콘텐츠(Mixed Content) 문제로 인해 발생합니다.

주요 원인과 확인 위치

config.php 도메인 설정 누락: config.php 파일에서 G5_DOMAIN과 G5_HTTPS_DOMAIN 값이 올바르게 입력되지 않았거나 비어 있는 경우 발생할 수 있습니다.
쿠키 도메인 불일치: www가 붙은 주소와 붙지 않은 주소를 혼용할 때, G5_COOKIE_DOMAIN 설정이 올바르지 않으면 도메인 간 쿠키가 공유되지 않아 로그인이 즉시 풀릴 수 있습니다.
프로토콜 불일치: HTTPS 페이지 내에서 이미지, CSS, 자바스크립트 등의 리소스가 http:// 경로로 호출되면 브라우저가 보안상 차단하여 화면이 깨지거나 정상 작동하지 않을 수 있습니다.

다음 행동 및 조치 방법

설정 파일 확인: config.php 파일에서 G5_DOMAIN과 G5_HTTPS_DOMAIN에 올바른 도메인 주소가 입력되어 있는지 확인합니다.
쿠키 설정 확인: www 포함 여부에 따른 쿠키 공유 문제가 의심될 경우 G5_COOKIE_DOMAIN 설정을 점검합니다.
리소스 경로 점검: 브라우저 개발자 도구의 콘솔(Console) 탭을 열어 Mixed Content 경고가 발생하는지 확인하고, 스킨 파일 등의 링크 경로가 HTTPS를 지원하는지 점검합니다.

사이트 전체 HTTPS 리다이렉트 설정 방법

그누보드 운영 시 방문자가 HTTP로 접속하더라도 자동으로 안전한 HTTPS 주소로 이동하도록 설정하려면 아파치(Apache) 서버 환경 기준으로 사이트 루트 디렉토리에 있는 .htaccess 파일을 수정합니다.

1. 사전 확인 사항

서버단에 SSL 인증서가 정상적으로 설치되어 있는지 먼저 확인합니다.
호스팅 관리 콘솔에 HTTPS 강제 사용 옵션이 따로 있는 경우에는 해당 옵션을 켜는 것이 안전할 수 있습니다. .htaccess 설정과 호스팅 옵션을 동시에 처리하면 무한 리다이렉트가 발생할 수 있으므로 주의합니다.

2..htaccess 설정 추가

사이트 루트 디렉토리의 .htaccess 파일에 아래의 코드를 추가합니다.

RewriteEngine On
RewriteCond %{HTTPS} off
RewriteRule ^(.*)$ https://%{HTTP_HOST}%{REQUEST_URI} [L,R=301]

R=301은 영구 이동을 뜻하므로 검색엔진이 새 주소를 학습하게 됩니다. 임시로 테스트할 때만 302를 사용합니다.

3. 그누보드 확장 파일 이용 방식 (참고)

그누보드 환경에 따라 www/extend/user.config.php 파일 상단에 코드를 추가하여 HTTPS 접속을 강제할 수도 있습니다.

if(!isset($_SERVER["HTTPS"])) {
 header('Location: https://gnuwiz.com');
}

(주의: 위 코드의 도메인은 운영 중인 실제 사이트 주소로 변경하여 적용합니다.)

4. 혼합 콘텐츠(Mixed Content) 정리

HTTPS 주소로 접속했음에도 브라우저 주소창에 자물쇠 경고가 뜬다면 페이지 내에 여전히 HTTP로 불러오는 이미지, 외부 스크립트, 폰트 등의 자원이 남아 있다는 뜻이므로 해당 경로를 모두 수정합니다.

상황별 적용 가이드

1. 보안서버(SSL) 인증서 설치 확인

상황: 호스팅사 관리 콘솔 또는 서버 환경에서 SSL 인증서가 정상적으로 설치되었는지 확인합니다.
선택 기준: 인증서가 설치되지 않은 상태에서 설정을 변경하면 사이트 접속 오류가 발생합니다.
다음 행동: 인증서 설치 완료 후 config.php 파일 수정을 진행합니다.

2. config.php 설정

상황: 로그인 및 회원가입 페이지에 HTTPS를 적용하고자 할 때.
선택 기준: 보안서버 주소를 지속적으로 사용하는지, 혹은 일반 주소와 병행하는지에 따라 G5_DOMAIN과 G5_HTTPS_DOMAIN 값을 설정합니다.
다음 행동: define('G5_HTTPS_DOMAIN', 'https://도메인');을 입력하고 저장합니다.

3. 적용 후 확인

상황: 설정 적용 후 페이지 접속 시.
선택 기준: 브라우저 주소창의 자물쇠 아이콘 표시 여부와 스타일시트(CSS) 로드 상태를 확인합니다.
다음 행동: 화면이 깨지거나 로그인이 풀린다면 G5_COOKIE_DOMAIN 설정을 점검합니다.

자주 묻는 질문(FAQ)

Q. 로그인이 즉시 풀리는 이유는 무엇인가요?
- www가 붙은 도메인과 그렇지 않은 도메인은 서로 다른 도메인으로 인식됩니다. config.php의 G5_COOKIE_DOMAIN 항목에 .도메인 (예: .example.com)을 입력하여 쿠키 공유 범위를 설정하십시오.
Q. HTTPS 적용 후 화면이 깨져 보입니다.
- HTTPS 페이지 내에서 이미지나 CSS가 http:// 경로로 호출되면 브라우저가 보안상 차단할 수 있습니다. 개발자 도구(F12)의 콘솔 탭에서 'Mixed Content' 경고를 확인하고 해당 리소스 경로를 수정하십시오.
Q. 사이트 전체를 HTTPS로 강제하고 싶습니다.
- 특정 페이지뿐만 아니라 사이트 전체를 HTTPS로 운영하려면 아파치 서버 기준 루트 디렉토리의 .htaccess 파일에 RewriteCond %{HTTPS} off 규칙을 추가하여 강제 리다이렉트를 설정할 수 있습니다.

참고자료

기타 참고자료

이전글네이버 소셜 로그인 연동 해지 방법과 외부 사이트 연결 관리 가이드 26.09.29
다음글그누보드4 단어 필터링 강화 및 writeupdate.php 스팸 차단 방법 26.09.28

댓글목록

등록된 댓글이 없습니다.