[Linux] Let’s Encrypt 와일드카드 인증서 설치(Certbot, Feat. Cloudflare)

그동안 let’s Encrypt 일반 인증서를 Certbot 설치 후 사용하다가 Let’s Encrypt 와일드카드 인증서를 설치해서 사용해야 겠다는 생각을 하게 되었습니다.

현재 서버는 LightSail Alma Linux apache로 구동되는 서버인데 차후 상황을 봐서 Open Lightspeed 서버로 변경을 고려중이지만 한참 뒤가 될 것 같습니다. 현재는 apache 기준으로 Let’s Encrypt 와일드카드 인증서를 설치합니다.

와일드카드 SSL 설치 조건 중 하나가 Certbot의 DNS 플러그인 중 하나를 사용히는 조건이 있습니다. 그동안 와일드카드 인증서를 사용하지 못하고 일반 인증서를 사용한 이유도 여기 있으며, 여러 DNS 공급자 중에 하나를 사용해야 한다는 조건 떄문에 고민하다 포기했었습니다. 이번에 DNS Route53과 Cloudflare 중에 DNS를 특이 사항이 없다면 영구적으로 사용하는 전제를 걸고 고민하다 Cloudflare DNS를 사용하기로 결정했습니다.

  • certbot-dns-cloudflare
  • certbot-dns-digitalocean
  • certbot-dns-dnsimple
  • certbot-dns-dnsmadeeasy
  • certbot-dns-gehirn
  • certbot-dns-google
  • certbot-dns-linode
  • certbot-dns-luadns
  • certbot-dns-nsone
  • certbot-dns-ovh
  • certbot-dns-rfc2136
  • certbot-dns-route53
  • dns-bunny
  • certbot-dns-sakuracloud

✅ snap 및 certbot 설치

snap과 certbot 설치 과정은 일반 Let’s Encrypt SSL 설치 방법과 과정이 동일합니다. 링크를 참조해서 기본 설치를 진행하면 될 것 같습니다.

✅ Let’s Encrypt 와일드카드 인증서 설치 진행

Certbot에서 Cloudflare API를 이용해 SSL 인증서를 자동 갱신하려면 Cloudflare 네임서버를 사용해야 하며, API 인증 정보가 필요합니다. 대상 도메인의 네임서버를 이미 Cloudflare로 설정한 상태입니다. API 인증을 위한 Cloudflare에서 공급하는 DNS 플러그인 설치를 진행하겠습니다.

🔲 Python 모듈

Cloudflare 토큰을 사용하려면 Python 모듈의 최소 버전 2.3.1이 필요합니다 
cloudflare . 이 플러그인과 함께 자동으로 설치된 버전이 그보다 오래되었고 시스템에서 업그레이드할 수 없는 경우 Global 키를 고수해야 합니다.

참조 : certbot-dns-cloudflare 문서

Cloudflare 플러그인을 사용하기 위한 전제 조건이 파이썬이 서버에 설치되어야 사용 가능함을 확인했습니다.

~]# python3 --version
Python 3.9.18

파이썬이 이미 호환 가능한 버전으로 설치되어 있어 다음 단계로 넘어갑니다.

🔲 플러그인 설치

~]# snap install certbot-dns-cloudflare
error: cannot perform the following tasks:
- Run hook prepare-plug-plugin of snap "certbot" (run hook "prepare-plug-plugin":
-----
Only connect this interface if you trust the plugin author to have root on the system.
Run `snap set certbot trust-plugin-with-root=ok` to acknowledge this and then run this command again to perform the connection.
If that doesn't work, you may need to remove all certbot-dns-* plugins from the system, then try installing the certbot snap again.

# 플러그인이 루트 권한을 필요로 하기 때문에, 설치 전에 신뢰를 확인해야 한다는 내용을 확인 했습니다.
# 신뢰(trust)를 확인하는 명령어 실행 후 다시 진행합니다.

~]# snap set certbot trust-plugin-with-root=ok
~]# snap install certbot-dns-cloudflare
certbot-dns-cloudflare 3.3.0 from Certbot Project (certbot-eff✓) installed

🔲 API 자격 증명 설정

certbot-dns-cloudflare 문서의 내용을 정리하면서 진행해 보겠습니다.

  • API 토큰 생성
  • Cloudflare에서 생성한 API 토큰을 사용하고, 그 토큰에는 Zone:DNS:Edit 권한만 부여합니다.
  • 토큰 생성을 위해 클라우드플레어 API 토큰 생성 페이지로 이동합니다.
  • 이 토큰은 특정 도메인에 대해서만 권한을 부여할 수 있어, 보안에 더 안전합니다.
Let's Encrypt 와일드카드 인증서 설치를 위한 클라우드플레어 API 토큰 생성 페이지

[토큰 생성] 버튼을 클릭해서 사용자 API 톸ㄴ에서 [영역 DNS 편집]으로 이동합니다.

Let's Encrypt 와일드카드 인증서 설치를 위한 클라우드플레어 영역 DNS 토큰 생성

▼ 토큰 설정할 도메인을 선택합니다.

클라우드플레어 DNS API토큰 생성(도메인만)

▼ 토큰 생성 전 메시지입니다.

클라우드플레어 DNS API토큰 생성 요약 안내

▼ 토큰 생성이 완료 되었습니다.

클라우드플레어 DNS API토큰 생성 완료
  • 자격 증명 파일 생성
  • 자격 증명 파일에는 dns_cloudflare_api_token = <API 토큰> 형태로 토큰을 입력해야 합니다.
  • 파일 경로는 --dns-cloudflare-credentials 옵션을 통해 Certbot에 전달됩니다.
###v 퍄일 예시 ##
# 도메인 1의 Cloudflare API token
dns_cloudflare_api_token_domain1 = 0123456789abcdef0123456789abcdef01234567

# 도메인 2의 Cloudflare API token
dns_cloudflare_api_token_domain2 = 89abcdef0123456789abcdef0123456789abcdef01

~]# cd ~/
~]# mkdir .secrets/certbot
~]# vi .secrets/certbot/cloudflare.ini
dns_cloudflare_api_token_domain1 = 0123456789abcdef0123456789abcdef01234567

#여러 도메인을 한 서버에서 사용할 때 # 
dns_cloudflare_email = myemail@구글.com
dns_cloudflare_api_key = 0123456789abcdef0123456789abcdef01234567

# 자격증명 입력 후 저장하고 나가기 > 파일 권한 설정 # 
chmod 600 .secrets/certbot/cloudflare.ini
  • ~/.secrets/certbot/는 기본적으로 Certbot이 자격 증명 파일을 저장하고 찾는 경로입니다. snap 폴더는 snap 패키지 관리자로 설치된 프로그램들이 사용하는 디렉토리로, Certbot이 해당 경로를 인식할 수 있도록 설정되지 않았습니다. 따라서, snap 폴더에 만들면 Certbot이 자격 증명 파일을 찾지 못할 수 있습니다. 권장되는 경로는 ~/.secrets/certbot/입니다.
  • [Linux] Let’s Encrypt 와일드카드 인증서 발급 받기
certbot certonly \
  --dns-cloudflare \
  --dns-cloudflare-credentials ~/.secrets/certbot/cloudflare.ini \
  -d example.com \
  -d "*.example.com"
  
  # 두 개의 다른 도메인 한꺼번에 받기 # 
  certbot certonly \
  --dns-cloudflare \
  --dns-cloudflare-credentials ~/.secrets/certbot/cloudflare.ini \
  -d domain1.com \
  -d "*.domain.com" \
  -d domain2.com \
  -d "*.domain2.com"
# 자동 갱신 테스트 #
certbot renew --dry-run
# ssl.conf 설정하기 # 
<VirtualHost *:443>
    ServerName mydomain.com
    ServerAlias *.mydomain.com www.mydomain.com
    DocumentRoot /home/myhost/www
    SuexecUserGroup myhost nobody
   <Directory /home/myhost/www>
        Options -Indexes +FollowSymLinks
        AllowOverride All
        Require all granted
  </Directory>
SSLEngine on
SSLCertificateFile /etc/letsencrypt/live/mydomain.com/cert.pem
SSLCertificateKeyFile /etc/letsencrypt/live/mydomain.com/privkey.pem
SSLCertificateChainFile /etc/letsencrypt/live/mydomain.com/chain.pem
SSLCACertificateFile /etc/letsencrypt/live/mydomain.com/fullchain.pem
</VirtualHost>
## 아파치 재시작 # 
systemctl restart httpd

Similar Posts

  • cp 명령어 옵션 및 실행 시 일괄 덮어쓰기 설정 | yes, \(역슬래쉬) 2가지 설정

    cp 명령어는 Copy의 약자로 파일 및 디렉토리를 복사합니다. 기본 사용법은 간단하게 복사할 대상과 새로운 이름 등을 설정하여 사용할 수 있습니다. cp 명령어를 실행할 때 같은 이름의 대상 파일이 있을 때는 사용자에게 묻지 않고 덮어쓰기가 되는데, 이를 방지하기 위해 alias “cp=’cp -i”로 설정되어 있습니다. 목차✅ snap 및 certbot 설치✅ Let’s Encrypt 와일드카드 인증서 설치 진행🔲…

  • 리눅스 cat 명령어

    리눅스에서 텍스트 파일을 출력하는 간단한 ‘cat 명령어’는 명령어 뒤에 파일명을 적어 표준 출력(Standard Output)을 할 수 있습니다. cat은 “연결시키다”, “연관시키다” 등의 뜻을 가지고 있는 영어단어 “concatenate”에서 유래되었습니다. 목차✅ snap 및 certbot 설치✅ Let’s Encrypt 와일드카드 인증서 설치 진행🔲 Python 모듈🔲 플러그인 설치🔲 API 자격 증명 설정1. cat 명령어 특징 출력과 비슷한 의미의 단어가 아닌…

  • 리눅스 셸 환경(Shell Environment) 정의 및 이해와 쉘 환경변수 | Shell 시작 파일 2가지

    셸 세션을 이용해서 서버와 상호 작용을 할 때 해당 동작과 리소스에 대한 연결을 결정하기 위해 컴파일 하는 많은 정보가 있습니다. 이러한 서정 중 일부는 구성 설정에 포함되어 있으며, 다른 설정은 사용자 입력에 의해 결정됩니다. 리눅스 셸 환경은 셸의 구성 설정과 사용자 입력에 의해 결정된 설정을 유지관리 영역을 이용해 관리하는 가장 일반적인 방법을 이용하게…

  • 리눅스 uniq 명령어

    리눅스 uniq 명령어는 “unique”의 약자이며, 텍스트 파일에서 중복된 행을 제거하고 하나의 행만 출력하는데 사용됩니다. 중복된 텍스트 데이터를 제거하고 몇 번의 반복이 있었는지 등을 확인할 때 매우 유용하게 사용할 수 있습니다. 목차✅ snap 및 certbot 설치✅ Let’s Encrypt 와일드카드 인증서 설치 진행🔲 Python 모듈🔲 플러그인 설치🔲 API 자격 증명 설정✅ 리눅스 uniq 명령어 기본 사용법…

  • SSH 설정 – /etc/ssh/sshd_config 파일 기능 및 설정

    SSH(Secure Shell)은 리눅스 원격 컴퓨터로 접속하기 위해 사용되는 인터넷 프로토콜입니다. 보안 셸이란 이름처럼 기존 텔넷에서 업그레이드 된 보안 접속 시스템입니다. 기본적인 보안 기능 외에도 추가로 SSH 설정을 통해 보안을 강화할 수 있습니다. SSH를 사용하면 암호화된 통신을 통해 데이터의 무단 접근을 방지할 수 있으며, 더 안전한 원격 작업을 수행할 수 있습니다. SSH는 네트워크를 통해…

  • RAID 구성 | RAID Level 0, 1, 4, 5, 6, 1+0, 0+1

    RAID(Redundant Array of Independent Disks 또는 Redundant Array of Inexpensive Disks)는 뜻 하는 내용처럼 여러 개의 디스크를 스토리지 하나처럼 운영하여 스토리지의 안정성을 확보하는 기술입니다. 저렴한(Independent) 디스크의 복수 배열의 뜻에서 독립적인 디스크의 복수 배열이란 뜻으로 많이 사용되고 있습니다. 이유는 단독으로 사용하기에 부족한 성능을 가진 디스크를 하나의 논리 디스크로 정렬해서 재활용하는데 목적이 있었기 때문입니다. 디스크…

답글 남기기

이메일 주소는 공개되지 않습니다. 필수 필드는 *로 표시됩니다

Prove your humanity: 0   +   7   =