【Laravel 11.x】SSL期限切れ・監視コマンドをつくる方法

こんにちは！
九保すこひです（フリーランスのITコンサルタント、エンジニア）

さてさて、先日ウェブサイトを無料でHTTPS化できる有名サービス「Let’s Encrypt」からとても重要なメールが来ていました。

（抜粋）As a Let’s Encrypt Subscriber, you benefit from access to free, automated TLS certificates. One way we have supported Subscribers is by sending expiration notification emails when it’s time to renew a certificate.

We’re writing to inform you that we intend to discontinue sending expiration notification emails. You can learn more in this blog post.

ひと言で意訳「通知メールやめるわ！」

そうです。つまり・・・・・・

cronやsystemdで証明書の自動更新に失敗したら、気づかないうちにHTTPSが切れる

ということです。

最近のブラウザはHTTPSじゃないと警告が出るので、運営者へのマイナスは多大ですよね。

そして、Xにこの事実を投稿したところ、

監視ツールをつかう
Linuxコマンドでチェックする

といった代替案を教えていただきました（ありがとうございます！）

いろいろ検討した結果、Let's Encryptがすすめている監視ツール「Red Sift Certificates Lite」を使うことにしたのですが、無料サービスなので制限が今後どうなるかわかりません。

そこで、念のため「自前でも作っとくか」となりました。

そこで

今回はLaravelで以下3つを実装してみます！

SSL証明書が7日以内ならメールで通知
チェックするドメインは、複数OK
自動で定期的にチェックできる←楽したいので、ここ重要

この記事は以下のような人に向けて書いています。

「自動でSSL証明書を監視したい」
「コピペだけで導入したい」
「定期的に監視したい」
「期限切れになったことがある…」
「複数のドメインを一括で管理したい」
「Let’s Encryptの通知メールで助かったことがある」

ぜひ最後まで読んでくださいね！

年末年始はコロナで予定が吹っとび…
ドラクエ11s真のラスボスを倒しました

目次 [非表示]

1 通知用メールをつくる
2 コマンドをつくる
3 テストしてみる
4 企業様へのご提案
5 おわりに

通知用メールをつくる

今回はArtisanコマンドをつかってSSL証明書のチェックをして通知するので、先にメール部分（Mailable）をつくっておきます。

以下のコマンドを実行してください。

php artisan make:mail SSLCertificateChecked

すると、app/Mail/SSLCertificateChecked.phpというファイルが作成されるので、中身を以下のようにします。

<?php

namespace App\Mail;

use Carbon\Carbon;
use Illuminate\Bus\Queueable;
use Illuminate\Contracts\Queue\ShouldQueue;
use Illuminate\Mail\Mailable;
use Illuminate\Mail\Mailables\Content;
use Illuminate\Mail\Mailables\Envelope;
use Illuminate\Queue\SerializesModels;

class SSLCertificateChecked extends Mailable
{
    use Queueable, SerializesModels;

    /**
     * Create a new message instance.
     */
    public function __construct(private $host, private Carbon $dt)
    {}

    /**
     * Get the message envelope.
     */
    public function envelope(): Envelope
    {
        $to = 'test@example.com';
        $subject = $this->getContent();

        return new Envelope(
            to: $to,
            subject: $subject,
        );
    }

    /**
     * Get the message content definition.
     */
    public function content(): Content
    {
        return new Content(
            htmlString: $this->getContent(),
        );
    }

    /**
     * Get the attachments for the message.
     *
     * @return array<int, \Illuminate\Mail\Mailables\Attachment>
     */
    public function attachments(): array
    {
        return [];
    }

    private function getContent(): string
    {
        $days_in_days = (int) round(
            now()->diffInDays($this->dt)
        );

        return '【'. $this->host .'】有効期限が「'. $days_in_days .'日後」に切れます。';
    }
}

この中では、シンプルに

どのドメインをチェックしたか
そのドメインの証明書が切れるのは何日後か

を送信しているだけです。

コマンドをつくる

続いて、メインの独自のコマンド「CheckSSLCertificateCommand」をつくります。
以下のコマンドを実行してください。

php artisan make:command CheckSSLCertificateCommand

すると、app/Console/Commands/CheckSSLCertificateCommand.phpというファイルが作成されるので、中身を以下のように変更します。

<?php

namespace App\Console\Commands;

use App\Mail\SSLCertificateChecked;
use Carbon\Carbon;
use Illuminate\Console\Command;
use Illuminate\Support\Facades\Cache;
use Illuminate\Support\Facades\Mail;
use Illuminate\Support\Str;

class CheckSSLCertificateCommand extends Command
{
    const CHECK_URLS = [ // チェックするするURL
        'https://amazon.co.jp',
        'https://google.com',
        'https://yahoo.co.jp',
    ];

    /**
     * The name and signature of the console command.
     *
     * @var string
     */
    protected $signature = 'check:ssl-certificate';

    /**
     * The console command description.
     *
     * @var string
     */
    protected $description = 'SSL証明書の有効期限を確認します';

    /**
     * Execute the console command.
     */
    public function handle()
    {
        $url = $this->getCheckUrl();

        if(Str::length($url) === 0) {

            $this->error('URLが取得できませんでした');
            return;

        }

        $this->checkSSLCertificate($url);

    }

    private function getCheckUrl()
    {
        $lastIndex = Cache::get('last_index', 0);
        $nextIndex = ($lastIndex + 1) % count(self::CHECK_URLS);
        Cache::put('last_index', $nextIndex);

        return self::CHECK_URLS[$nextIndex] ?? '';
    }

    private function checkSSLCertificate($url)
    {
        $host = parse_url($url, PHP_URL_HOST);
        $sslUrl = 'ssl://'. $host .':443';
        $streamContext = stream_context_create([
            'ssl' => ['capture_peer_cert' => true]
        ]);

        try {

            $fp = stream_socket_client(
                $sslUrl,
                $errno,
                $errStr,
                30,
                STREAM_CLIENT_CONNECT,
                $streamContext
            );
            $certificate_params = stream_context_get_params($fp);
            $certification_data = openssl_x509_parse($certificate_params['options']['ssl']['peer_certificate']);
            $timestamp = $certification_data['validTo_time_t'];

        } catch (\Exception $e) {

            $this->error('[失敗] SSL証明書の取得: ' . $e->getMessage());
            return;

        }

        $dt = Carbon::createFromTimestamp($timestamp);
        $host = parse_url($url, PHP_URL_HOST);

        Mail::send(new SSLCertificateChecked($host, $dt));

        $this->info('Done!');

    }
}

この中でやっていることは、以下2つです。

CHECK_URLSから順番に1つずつURLを取得
SSL証明書の情報を取得

ちなみに今回openssl_x509_parseという標準関数があることを知りました。
PHPはいろいろ揃っていますね

ちなみに、openssl_x509_parseを使うと、phpstormがちょっとした警告を出していました。

どうやら、「composer.jsonにext-opensslを入れときな！」ってことだったので、以下のように追加することにしました。

{
    "name": "laravel/laravel",
    "type": "project",
    "description": "The skeleton application for the Laravel framework.",
    "keywords": ["laravel", "framework"],
    "license": "MIT",
    "require": {
        "php": "^8.2",
        "laravel/framework": "^11.0",
        "laravel/tinker": "^2.9",
        "ext-openssl": "*"
    },