サーバ構築編#8
NginxでBasic認証を設定

NginxでBasic認証を設定できるように、apache2-utilsをインストールしてhtpasswdコマンドを利用可能に

初回公開日2025/6/20

最終更新日2025/6/20

サーバ構築編第8回は、NginxでBasic認証を利用可能にします。サイト構築中は、保護できるようにします。 Nginx単体には htpasswd を作成する機能がないので、apache2-utils をインストールして htpasswd コマンドを使えるようにします。

1.apache2-utils をインストール

apache2-utilsは、Apacheに関連する便利なツールが含まれたパッケージです。ただ、Nginxで利用するのはhtpasswdだけになると思います。

bash

sudo apt update
sudo apt install apache2-utils -y

これで htpasswd コマンドが使えるようになります。

2.認証用の .htpasswd ファイルを作成

初回

adminというユーザ名で/etc/nginx/.htpasswd に登録を行います。

bash

sudo htpasswd -c /etc/nginx/.htpasswd admin

パスワードを2回入力して設定

bash

New password:
Re-type new password:

/etc/nginx/.htpasswd に admin の認証情報が保存されます
-c オプションは最初にユーザを作成する時だけ(.htpasswdを新規作成する)。ユーザを追加する時に-cをつけると登録済みのユーザが消えてしまうので注意

追加ユーザーを登録(運用時はこれ！)

bash

sudo htpasswd /etc/nginx/.htpasswd user2

user2 を追加（-c は不要！）

3.Nginx の設定に Basic 認証を追加

Nginxでは.htaccess は使えないため、nginx.conf や conf.d/*.conf に直接、Basic認証の設定を書く必要があります。

Nginxが .htaccessをサポートしない理由

Nginx は .htaccess のような動的設定を嫌う！
.htaccess を使うと、ディレクトリごとに設定を解析するため、パフォーマンスが低下する！
そのため、すべての設定を .conf に記述し、一括ロードするのが Nginx の設計方針！

というわけで、confファイルへBasic認証の設定を追記します。

bash

sudo vi /etc/nginx/conf.d/example.com.conf

サイト全体に認証をかける場合

bash

server {
    server_name example.com;

# Basic認証
    auth_basic "Restricted Area"; # <-認証プロンプトのタイトル
    auth_basic_user_file /etc/nginx/.htpasswd; # <-認証ファイルのパス
##

    root /var/www/example.com/html;
    index index.html;

    location / {
        try_files $uri $uri/ =404;
    }

    listen 443 ssl; # managed by Certbot
    ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem; # managed by Certbot
    ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem; # managed by Certbot
    include /etc/letsencrypt/options-ssl-nginx.conf; # managed by Certbot
    ssl_dhparam /etc/letsencrypt/ssl-dhparams.pem; # managed by Certbot

}

特定のディレクトリだけに認証をかける場合

bash

server {
    server_name example.com;

    root /var/www/example.com/html;
    index index.html;

    location / {
        try_files $uri $uri/ =404;
    }

 # /test 配下を Basic 認証
    location /test {
        auth_basic "Restricted Area";  # 認証プロンプトのメッセージ
        auth_basic_user_file /etc/nginx/.htpasswd;
    }

    listen 443 ssl; # managed by Certbot
    ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem; # managed by Certbot
    ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem; # managed by Certbot
    include /etc/letsencrypt/options-ssl-nginx.conf; # managed by Certbot
    ssl_dhparam /etc/letsencrypt/ssl-dhparams.pem; # managed by Certbot

}