ログイン機能を作る①|管理者ユーザーとHTTPSを設定する

自作CMSのログイン機能に向けて、ユーザー権限を追加し、管理者ユーザーを作成します。さらにログイン画面をHTTPSで公開します。

🎯 目的

前回までに、ログイン機能を作るための基本的な構成を整理しました。

今回は実際にユーザー権限を追加し、管理者ユーザーを作成します。

さらに、ログイン画面をHTTPSで安全に通信できる状態にします。

今回やること

  1. usersテーブルにroleを追加する
  2. adminユーザーを作成する
  3. パスワードをハッシュ化して保存する
  4. login.phpを作る
  5. HTTPでログイン画面を確認する
  6. SSL/TLS証明書を発行する
  7. HTTPSでログイン画面を確認する
MariaDB
↓
usersテーブル
↓
adminユーザー
↓
login.php
↓
HTTPS

STEP 1|usersテーブルにroleを追加する

ユーザーごとの役割を管理できるように、 usersテーブルにroleカラムを追加します。

ALTER TABLE users
ADD COLUMN role VARCHAR(20) NOT NULL DEFAULT 'writer';
📘 SQLを読む
ALTER TABLE users = 既存のusersテーブルの構造を変更します。
ADD COLUMN = 新しいカラムを追加します。
role = 追加するカラム名です。ユーザーの役割を保存します。
VARCHAR(20) = 最大20文字の可変長文字列です。
NOT NULL = NULLを許可しません。
DEFAULT 'writer' = 値を指定しなかった場合、writerを初期値として使います。

→ usersテーブルに「このユーザーは何の役割か」を保存できるようにしています。

これで、ユーザーごとに writerやadminなどの役割を持たせられるようになります。

📘 roleとは
role = 役割・役職という意味です。

writer → 記事を書くユーザー
admin → 管理を行うユーザー

→ あとでroleを条件として、「誰に何を許可するか」を分けるためのデータになります。

STEP 2|adminユーザーを作成する

管理画面を操作するための管理者ユーザーを作成します。

SELECT id, username, role, created_at
FROM users;
📘 SQLを読む
SELECT = DBからデータを取得します。
id, username, role, created_at = 取得するカラムです。
FROM users = usersテーブルから取得します。

→ usersテーブルに保存されているユーザー情報を確認しています。

作成したユーザーのroleが adminになっていることを確認します。

確認結果
username:admin
role:admin
📘 認証と権限は別
認証 = 「あなたは誰ですか?」を確認する仕組み
権限 = 「その人は何をしてよいですか?」を決める仕組み

→ usernameやパスワードで本人を確認し、 roleを使って操作できる範囲を分ける構造にしていきます。

STEP 3|パスワードをハッシュ化する

パスワードは、そのままデータベースに保存しません。

PHPのpassword_hash()を利用して、 ハッシュ化した値を保存します。

$hash = password_hash(
    $password,
    PASSWORD_DEFAULT
);
📘 PHPを読む
$password = 元のパスワードが入った変数です。
password_hash() = パスワード保存用のハッシュを作るPHP関数です。
PASSWORD_DEFAULT = PHPが推奨するデフォルトの方式を使用します。
$hash = 作成されたハッシュを受け取る変数です。

→ DBには元のパスワードではなく、作成されたハッシュを保存します。
重要
実際のパスワードそのものはDBに保存しません。

STEP 4|login.phpを作る

ユーザー名とパスワードを入力できるログイン画面を作ります。

sudo nano /var/www/it-textbook/login.php
📘 コマンドを読む
sudo = 必要な権限でコマンドを実行します。
nano = ターミナル上で使うテキストエディタです。
/var/www/it-textbook/login.php = 編集するPHPファイルの場所です。

→ login.phpを作成・編集しています。

今回はまず、ログイン画面を表示できるところまで作りました。

今回の段階では
まだDBとの照合によるログイン認証処理は実装していません。

→ 「ログイン画面がある」ことと「認証機能が完成している」ことは別です。

STEP 5|HTTPでログイン画面を確認する

まずHTTPS化する前に、HTTPでPHPが正常に動作することを確認します。

http://it-textbook.duckdns.org/login.php
📘 HTTPとは
HTTP = Hypertext Transfer Protocol。
WebブラウザとWebサーバーがデータをやり取りするためのプロトコルです。

Protocol(プロトコル) = 通信するときの決まり・手順です。

ブラウザにログイン画面が表示されれば、 nginxとPHP-FPMを経由してPHPページを表示できています。

ブラウザ
↓ HTTPリクエスト
nginx
↓
PHP-FPM / PHP
↓
login.phpの処理
↓
nginx
↓ HTTPレスポンス
ブラウザ

STEP 6|SSL/TLS証明書を発行する

次に、Let's EncryptのCertbotを使って、 it-textbook.duckdns.org用の証明書を発行します。

sudo certbot --nginx -d it-textbook.duckdns.org
📘 コマンドを読む
sudo = 必要な権限でコマンドを実行します。
certbot = Let's Encryptなどの証明書を取得・管理するためのツールです。
--nginx = nginx用のプラグインを使います。
-d = 証明書の対象となるドメイン名を指定します。
it-textbook.duckdns.org = 今回証明書を取得するドメインです。
📘 HTTPSとは
HTTPS = HTTP over TLSとして使われる、暗号化されたWeb通信です。

HTTPSではTLSによって通信を保護します。
ログイン画面ではパスワードなどを送信するため、暗号化された通信を使うことが重要です。

「SSL証明書」という呼び方も広く使われますが、 現在のHTTPSで実際に使われる仕組みはTLSです。

Certbotによって証明書が発行され、 nginxにもHTTPS設定が反映されました。

ポイント
この環境では証明書の自動更新が設定されています。

→ 証明書には有効期限があるため、更新の仕組みも重要です。

STEP 7|HTTPSでログイン画面を確認する

最後にHTTPSでログイン画面へアクセスします。

https://it-textbook.duckdns.org/login.php
📘 HTTPとHTTPS
http:// → 通常のHTTP通信
https:// → TLSで保護されたHTTP通信

→ URLの先頭が変わるだけに見えますが、 通信の途中で送受信するデータを保護する仕組みが加わっています。

ログイン画面が表示されれば、HTTPS化まで完了です。

今回の仕組み

ブラウザ
↓ HTTPS
it-textbook.duckdns.org
↓
nginx
↓
PHP-FPM / PHP
↓
login.php

📘 013と014のつながり

013
認証・パスワードハッシュ・セッションという仕組みを整理した。

014
usersテーブルにroleを追加し、 adminユーザーとlogin.phpを用意して、 HTTPSでログイン画面へアクセスできるところまで進めた。

→ 013が「仕組みを理解する回」、014が「実際に土台を作る回」です。

📘 科目Bにつなげる:役割による条件分岐

roleは、あとで条件分岐に利用できます。

roleはadminか?
↓
YES → 管理者用の操作を許可
NO → 管理者用の操作を許可しない

→ DBに保存した値を条件として、プログラムの処理を変えることができます。

📘 処理の流れを読む

今回は、まだログイン認証そのものを完成させる回ではなく、 そのための土台を作る回です。

DB:usersテーブルにroleを追加する
↓
ユーザー:adminの役割を持つユーザーを用意する
↓
パスワード:平文ではなくハッシュを保存する
↓
画面:login.phpを作る
↓
通信:HTTPSで通信できるようにする
↓
次回:入力された情報とDBを照合して認証する

→ 「ユーザー情報 → 権限 → パスワード保護 → ログイン画面 → 通信保護」 という順番で認証の土台を作っています。

📝 今回の忘備録

今回は、ログイン機能の土台を作りました。

usersテーブルにユーザーの役割を追加し、 adminユーザーを作成。

パスワードは平文ではなく、 password_hash()で作成したハッシュを保存します。

さらにlogin.phpを作成し、 HTTPSでアクセスできる状態まで設定しました。

ただし、現時点ではまだ ログインフォームとDBを接続した認証処理は完成していません。

この先やること

タグ: PHP / MariaDB / SQL / Authentication / Authorization / role / password_hash / HTTP / HTTPS / TLS / nginx / Certbot