HTTPS와 Openssl을 이용한 로컬 SSL 인증서 생성 가이드

HTTPS와 로컬 SSL 인증서 생성: Openssl 활용 가이드

1. HTTPS란 무엇인가?

HTTPS(Hypertext Transfer Protocol Secure)는 웹 브라우저와 웹 서버 간의 통신 프로토콜인 HTTP에 보안 계층(SSL/TLS)을 추가한 것입니다.

• 보안 강화: 클라이언트와 서버 간에 주고받는 모든 데이터를 암호화하여 중간에서 데이터를 가로채거나 변조하는 것을 방지합니다. 민감한 정보(로그인 정보, 결제 정보 등)를 안전하게 전송하는 데 필수적입니다.
• 신뢰성 확보: 인증서를 통해 접속하려는 서버가 신뢰할 수 있는 출처임을 확인시켜 사용자의 불안감을 해소합니다.
• SEO 이점: 검색 엔진들은 HTTPS를 사용하는 웹사이트를 선호하는 경향이 있어 검색 순위에 긍정적인 영향을 줄 수 있습니다.

2. 왜 로컬 SSL 인증서가 필요한가?

대부분의 최신 웹 기술(Service Worker, HTTP/2, 특정 브라우저 API 등)은 보안상의 이유로 HTTPS 환경에서만 작동하거나 권장됩니다. 로컬 개발 환경에서 이러한 기술을 테스트하거나, CORS(Cross-Origin Resource Sharing) 정책으로 인해 발생하는 문제를 회피하기 위해 자체 서명된(Self-Signed) SSL 인증서를 생성하여 로컬 서버를 HTTPS로 구동해야 할 때가 있습니다.

• 로컬 개발 환경: HTTPS가 필수적인 최신 웹 API(예: Geolocation API)를 테스트할 때
• CORS 문제 해결: 브라우저의 보안 정책은 종종 다른 출처(origin)에서의 요청을 제한합니다. 로컬에서 HTTPS를 사용하면 localhost 또는 특정 도메인으로 간주되어 CORS 관련 문제를 줄일 수 있습니다.
• 보안 기능 테스트: 개발 중인 애플리케이션의 보안 관련 기능을 HTTPS 환경에서 테스트할 때

3. Openssl이란?

Openssl은 SSL/TLS 프로토콜 구현을 포함한 강력한 암호화 도구 모음입니다. 이를 사용하여 다양한 암호화 관련 작업을 수행할 수 있으며, 여기서는 자체 서명된 SSL 인증서를 생성하는 데 사용합니다.

4. 로컬 SSL 인증서 생성 단계 (Openssl 사용)

간단한 자체 서명된 SSL 인증서(키와 인증서 파일)를 생성하는 과정입니다. 이 과정은 터미널 또는 명령 프롬프트에서 실행합니다.

단계 1: 개인 키(Private Key) 생성

개인 키는 암호화의 기반이 되는 비밀 정보입니다. 이 키를 안전하게 보관해야 합니다.

openssl genrsa -out localhost.key 2048

• genrsa: RSA 알고리즘을 사용하여 개인 키를 생성하는 명령어입니다.
• -out localhost.key: 생성될 개인 키 파일의 이름을 localhost.key로 지정합니다.
• 2048: 키의 길이를 비트 단위로 지정합니다. 2048은 일반적으로 사용되는 안전한 길이입니다.

단계 2: 인증서 서명 요청(CSR) 파일 생성 (선택 사항이지만 권장)

CSR 파일은 인증서 발급 기관(CA)에 제출하기 위한 정보(도메인 이름, 조직 정보 등)를 담고 있습니다. 자체 서명 인증서에서는 이 정보를 바탕으로 직접 인증서를 생성합니다.

openssl req -new -key localhost.key -out localhost.csr -subj "/C=KR/ST=Seoul/L=Seoul/O=MyOrg/OU=Dev/CN=localhost"

• req: 인증서 관련 작업을 수행하는 명령어입니다.
• -new: 새로운 CSR을 생성합니다.
• -key localhost.key: 이전 단계에서 생성한 개인 키 파일을 사용합니다.
• -out localhost.csr: 생성될 CSR 파일의 이름을 localhost.csr로 지정합니다.
• -subj "...": 인증서에 포함될 주체(Subject) 정보를 직접 지정합니다. CN=localhost는 이 인증서가 localhost에 유효함을 나타냅니다. 다른 도메인(예: yourdomain.local)을 사용하려면 CN=yourdomain.local로 변경해야 합니다.

참고: -subj 옵션을 사용하지 않으면, 명령어 실행 시 각 항목(Country Name, State or Province Name, Locality Name, Organization Name, Common Name 등)을 대화형으로 입력하라는 메시지가 표시됩니다. CN 값은 반드시 localhost 또는 테스트하려는 로컬 도메인으로 설정해야 합니다.

단계 3: 자체 서명된 SSL 인증서 생성

CSR 파일과 개인 키를 사용하여 유효한 SSL 인증서 파일을 생성합니다. 이 인증서는 신뢰할 수 있는 CA에서 발급한 것이 아니므로 브라우저에서 경고가 표시될 수 있습니다.

openssl x509 -req -days 365 -in localhost.csr -signkey localhost.key -out localhost.crt

• x509: X.509 인증서 관련 작업을 수행합니다.
• -req: 입력 파일이 CSR임을 나타냅니다.
• -days 365: 인증서의 유효 기간을 일(day) 단위로 지정합니다. 여기서는 1년(365일)으로 설정했습니다.
• -in localhost.csr: 사용할 CSR 파일입니다.
• -signkey localhost.key: 인증서를 서명하는 데 사용할 개인 키 파일입니다.
• -out localhost.crt: 생성될 SSL 인증서 파일의 이름을 localhost.crt로 지정합니다.

참고: CSR 파일 생성 단계를 건너뛰고 싶다면, openssl req -x509 -nodes -days 365 -newkey rsa:2048 -keyout localhost.key -out localhost.crt -subj "/C=KR/ST=Seoul/L=Seoul/O=MyOrg/OU=Dev/CN=localhost" 명령어를 한 번에 사용할 수도 있습니다. 이 명령어는 개인 키와 인증서를 동시에 생성합니다.

5. 생성된 파일 활용 방법

생성된 localhost.key (개인 키)와 localhost.crt (SSL 인증서) 파일을 로컬 개발 서버 설정에 맞게 사용하면 됩니다.

• Node.js (Express 등):

  const https = require('https');
  const fs = require('fs');
  const express = require('express');
  
  const app = express();
  
  app.get('/', (req, res) => {
    res.send('Hello HTTPS!');
  });
  
  const options = {
    key: fs.readFileSync('localhost.key'),
    cert: fs.readFileSync('localhost.crt')
  };
  
  https.createServer(options, app).listen(3000, () => {
    console.log('HTTPS server listening on port 3000');
  });
  

• Nginx/Apache: 웹 서버 설정 파일에서 SSL 인증서와 키 경로를 지정하여 HTTPS를 활성화합니다.
• 기타 개발 서버: 사용하는 프레임워크나 도구의 HTTPS 설정 가이드를 참조하여 localhost.key와 localhost.crt 파일을 적용합니다.

6. 주의사항

• 보안 경고: 자체 서명된 인증서는 브라우저에서 '안전하지 않음' 경고를 발생시킬 수 있습니다. 이는 정상적인 동작이며,