ログイン機能を作る①|管理者ユーザーとHTTPSを設定する
自作CMSのログイン機能に向けて、ユーザー権限を追加し、管理者ユーザーを作成します。さらにログイン画面をHTTPSで公開します。
🎯 目的
前回までに、ログイン機能を作るための基本的な構成を整理しました。
今回は実際にユーザー権限を追加し、管理者ユーザーを作成します。
さらに、ログイン画面をHTTPSで安全に通信できる状態にします。
今回やること
- usersテーブルにroleを追加する
- adminユーザーを作成する
- パスワードをハッシュ化して保存する
- login.phpを作る
- HTTPでログイン画面を確認する
- SSL/TLS証明書を発行する
- HTTPSでログイン画面を確認する
↓
usersテーブル
↓
adminユーザー
↓
login.php
↓
HTTPS
STEP 1|usersテーブルにroleを追加する
ユーザーごとの役割を管理できるように、
usersテーブルにroleカラムを追加します。
ALTER TABLE users
ADD COLUMN role VARCHAR(20) NOT NULL DEFAULT 'writer';
ALTER TABLE users = 既存のusersテーブルの構造を変更します。ADD COLUMN = 新しいカラムを追加します。role = 追加するカラム名です。ユーザーの役割を保存します。VARCHAR(20) = 最大20文字の可変長文字列です。NOT NULL = NULLを許可しません。DEFAULT 'writer' = 値を指定しなかった場合、writerを初期値として使います。→ usersテーブルに「このユーザーは何の役割か」を保存できるようにしています。
これで、ユーザーごとに
writerやadminなどの役割を持たせられるようになります。
role = 役割・役職という意味です。writer → 記事を書くユーザー
admin → 管理を行うユーザー
→ あとでroleを条件として、「誰に何を許可するか」を分けるためのデータになります。
STEP 2|adminユーザーを作成する
管理画面を操作するための管理者ユーザーを作成します。
SELECT id, username, role, created_at
FROM users;
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
);
$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 = 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 = HTTP over TLSとして使われる、暗号化されたWeb通信です。HTTPSではTLSによって通信を保護します。
ログイン画面ではパスワードなどを送信するため、暗号化された通信を使うことが重要です。
「SSL証明書」という呼び方も広く使われますが、 現在のHTTPSで実際に使われる仕組みはTLSです。
Certbotによって証明書が発行され、 nginxにもHTTPS設定が反映されました。
この環境では証明書の自動更新が設定されています。
→ 証明書には有効期限があるため、更新の仕組みも重要です。
STEP 7|HTTPSでログイン画面を確認する
最後にHTTPSでログイン画面へアクセスします。
https://it-textbook.duckdns.org/login.php
http:// → 通常のHTTP通信https:// → TLSで保護されたHTTP通信→ URLの先頭が変わるだけに見えますが、 通信の途中で送受信するデータを保護する仕組みが加わっています。
ログイン画面が表示されれば、HTTPS化まで完了です。
今回の仕組み
↓ HTTPS
it-textbook.duckdns.org
↓
nginx
↓
PHP-FPM / PHP
↓
login.php
📘 013と014のつながり
認証・パスワードハッシュ・セッションという仕組みを整理した。
014
usersテーブルにroleを追加し、 adminユーザーとlogin.phpを用意して、 HTTPSでログイン画面へアクセスできるところまで進めた。
→ 013が「仕組みを理解する回」、014が「実際に土台を作る回」です。
📘 科目Bにつなげる:役割による条件分岐
roleはadminか?
↓
YES → 管理者用の操作を許可
NO → 管理者用の操作を許可しない
→ DBに保存した値を条件として、プログラムの処理を変えることができます。
📘 処理の流れを読む
DB:usersテーブルにroleを追加する
↓
ユーザー:adminの役割を持つユーザーを用意する
↓
パスワード:平文ではなくハッシュを保存する
↓
画面:login.phpを作る
↓
通信:HTTPSで通信できるようにする
↓
次回:入力された情報とDBを照合して認証する
→ 「ユーザー情報 → 権限 → パスワード保護 → ログイン画面 → 通信保護」 という順番で認証の土台を作っています。
📝 今回の忘備録
usersテーブルにユーザーの役割を追加し、 adminユーザーを作成。
パスワードは平文ではなく、 password_hash()で作成したハッシュを保存します。
さらにlogin.phpを作成し、 HTTPSでアクセスできる状態まで設定しました。
ただし、現時点ではまだ ログインフォームとDBを接続した認証処理は完成していません。
この先やること
- login.phpとMariaDBを接続する
- password_verify()でパスワードを確認する
- セッションでログイン状態を管理する
- admin.phpを認証で保護する
- logout.phpを作る