📝

Let's Encrypt証明書をmacOSで作成する

2020/10/20に公開

SSL

tech

今さらですが、自端末（macOS）で Let's Encrypt を用いて SSL 証明書を発行したかったので試してみたメモです。

2020/12/01追記

クリーンインストールした macOS Big Sur(11.0.1) 環境でも問題なく certbot はインストールできた。
後述している emacs 関連エラーは発生せず。

前提

Macbook Pro(macOS Catalina)
Homebrew インストール済み

Certbotをインストール

Let's Encryptの証明書をコマンドラインで生成する Certbot をインストールする。

brew install certbot

# version
certbot --version
certbot 1.9.0

※自環境だと、途中で emacs 関連エラーが発生した。

==> Installing emacs
==> Pouring emacs-27.1.catalina.bottle.tar.gz
==> Caveats
To have launchd start emacs now and restart at login:
  brew services start emacs
Or, if you don't want/need a background service you can just run:
  emacs
==> Summary
🍺  /usr/local/Cellar/emacs/27.1: 4,009 files, 104.0MB
Removing: /usr/local/Cellar/emacs/26.3... (3,986 files, 101.4MB)
==> Checking for dependents of upgraded formulae...
Error: No such file or directory - /usr/local/Cellar/emacs/26.3

下記対応でクリア。

# すでに emacs は入っていたため依存関係を無視して一旦アンインストール
brew uninstall --ignore-dependencies emacs

# 再度 certbot をインストール
# `install` だと `To reinstall 1.9.0, run `brew reinstall certbot` となったので `reinstall` を使用
brew reinstall certbot

証明書を発行する

1. 証明書発行コマンドを実行

# 発行したいドメインを指定する
# ex: example.com
sudo certbot certonly --manual --domain example.com
Password: # パスワード入力

2. 対話式の質問に回答する

Saving debug log to /var/log/letsencrypt/letsencrypt.log
Plugins selected: Authenticator manual, Installer None
Enter email address (used for urgent renewal and security notices)
 (Enter 'c' to cancel): # メールアドレス（後で非公開にするから何でもいい）

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Please read the Terms of Service at
https://letsencrypt.org/documents/LE-SA-v1.2-November-15-2017.pdf. You must
agree in order to register with the ACME server at
https://acme-v02.api.letsencrypt.org/directory
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
(A)gree/(C)ancel: A    # 利用規約に同意する

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Would you be willing, once your first certificate is successfully issued, to
share your email address with the Electronic Frontier Foundation, a founding
partner of the Let's Encrypt project and the non-profit organization that
develops Certbot? We'd like to send you email about our work encrypting the web,
EFF news, campaigns, and ways to support digital freedom.
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
(Y)es/(N)o: N         # メールアドレスを公開しないにしておく
Obtaining a new certificate
Performing the following challenges:
http-01 challenge for example.com

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
NOTE: The IP of this machine will be publicly logged as having requested this
certificate. If you're running certbot in manual mode on a machine that is not
your server, please ensure you're okay with that.

Are you OK with your IP being logged?
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
(Y)es/(N)o: Y        # IPアドレスのロギング

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Create a file containing just this data:

# ランダムな文字列1

And make it available on your web server at this URL:

http://example.com/.well-known/acme-challenge/# ランダムな文字列2

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Press Enter to Continue

3. ドメイン所有を確認する

下記の対応を実施することで、証明書を発行しようとしている example.com ドメインを所有していることを確認する。

http://example.com/.well-known/acme-challenge/ 配下に ランダムな文字列2 のファイル名でファイルを設置し、 ランダムな文字列1 を内容として保存する。
指定された URL にアクセスし、当該ファイルにアクセスできることを確認する。
ターミナルに戻り、 Enter を押す。

4. 証明書ファイルが生成されたことを確認する

Waiting for verification...
Cleaning up challenges

IMPORTANT NOTES:
 - Congratulations! Your certificate and chain have been saved at:
   /etc/letsencrypt/live/example.com/fullchain.pem
   Your key file has been saved at:
   /etc/letsencrypt/live/example.com/privkey.pem
   Your cert will expire on 2021-01-18. To obtain a new or tweaked
   version of this certificate in the future, simply run certbot
   again. To non-interactively renew *all* of your certificates, run
   "certbot renew"
 - Your account credentials have been saved in your Certbot
   configuration directory at /etc/letsencrypt. You should make a
   secure backup of this folder now. This configuration directory will
   also contain certificates and private keys obtained by Certbot so
   making regular backups of this folder is ideal.
 - If you like Certbot, please consider supporting our work by:

   Donating to ISRG / Let's Encrypt:   https://letsencrypt.org/donate
   Donating to EFF:                    https://eff.org/donate-le

成功していれば、下記にファイルが生成されている。

サーバ証明書と中間CA証明書が結合された証明書
/etc/letsencrypt/live/example.com/fullchain.pem
秘密鍵
/etc/letsencrypt/live/example.com/privkey.pem

ちなみに、 /etc/letsencrypt/live/example.com/ 配下に他ファイルがある。

サーバ証明書
/etc/letsencrypt/live/example.com/cert.pem
中間CA証明書
/etc/letsencrypt/live/example.com/chain.pem

5. サーバに証明書を設定して動作確認する

上記で生成された証明書ファイルをサーバに設定して動作確認をします。

例： nginx での設定。
SSL関連ディレクティブにそれぞれ下記ファイルを設置すればOKです。

ssl_certificate
cert.pem
ssl_trusted_certificate
fullchain.pem
ssl_certificate_key
privkey.pem

参考

https://neos21.hatenablog.com/entry/2019/03/11/080000