feat(admin): verify the backoffice password with PBKDF2, not plaintext compare

- ui/auth.js: derive PBKDF2-HMAC-SHA256(name:password) with a per-deploy salt
  (250k iterations) and compare against the verifier in constant time
- config/admin-credentials.json holds salt/iterations/verifier only — no password
- server/set-admin-password.mjs generates/rotates that file (CLI or hidden prompt)
- login is async now: button shows a pending state; config load errors surface in the form
- SW precaches the credentials file; version bumped to 2026.11.19.4
- docs: README/AGENTS explain rotation and the residual limits of a client-side gate
This commit is contained in:
Bkk1234 committed 2026-11-19 11:32:48 +07:00
1 parent cd5cb5dd08
commit a629e67ca4
8 files changed
+249 -32

No files matched your search

+5 -3
View File
@@ -37,7 +37,9 @@ PUBLISH_PUSH=0 node server/publish.mjs # เขียน+commit แต่ไ
| `ui/data.js` | อ่าน/เขียนข้อมูล, normalize, ฉบับร่าง (localStorage), `PUT api/projects` |
| `ui/ui.js` | ชุดไอคอน SVG, escape, toast, ตรวจ URL/อีเมล |
| `ui/views/home.js` | ฮีโร่ + ค้นหา + การ์ดโปรเจค |
| `ui/auth.js` | ด่านชื่อ+รหัสของหลังบ้าน (sessionStorage, ล็อก 30 วิเมื่อผิด 5 ครั้ง) |
| `ui/auth.js` | ด่านชื่อ+รหัสของหลังบ้าน: PBKDF2 เทียบกับ verifier ใน `config/admin-credentials.json` (sessionStorage, ล็อก 30 วิเมื่อผิด 5 ครั้ง) |
| `config/admin-credentials.json` | salt + iterations + verifier ของรหัสหลังบ้าน (ไม่มีรหัสจริง) — สร้างด้วยสคริปต์เท่านั้น |
| `server/set-admin-password.mjs` | ตั้ง/เปลี่ยนรหัสหลังบ้าน → เขียน `config/admin-credentials.json` |
| `ui/views/admin.js` | หลังบ้าน: ล็อกอิน → ฟอร์มแก้ไข, เรียงลำดับ, ลบ, เผยแพร่, ดาวน์โหลด JSON |
| `server/publish.mjs` | static server + `GET/PUT api/projects` + git commit/push |
| `data/projects.json` | ข้อมูลจริง (คีย์เต็มคำ: `project_name`, `project_description`, `project_url`, `contact_email`, `icon`) |
@@ -63,9 +65,9 @@ PUBLISH_PUSH=0 node server/publish.mjs # เขียน+commit แต่ไ
## หลังบ้านถูกล็อกด้วยชื่อ+รหัส
`ui/auth.js` เก็บชื่อและรหัสไว้ในไฟล์ (แก้ที่ค่าคงที่ `ADMIN_NAME` / `ADMIN_PASSWORD`) และจำสถานะใน `sessionStorage` → ปิดแท็บแล้วต้องใส่ใหม่
รหัสไม่ได้อยู่ในโค้ด: `ui/auth.js` เก็บเฉพาะวิธีตรวจ (PBKDF2-HMAC-SHA256, 250,000 รอบ, salt 16 ไบต์, เทียบแบบ constant-time) ส่วนค่า salt/verifier อยู่ใน `config/admin-credentials.json` — สร้างใหม่ด้วย `node server/set-admin-password.mjs admin <รหัสใหม่>` และจำสถานะล็อกอินใน `sessionStorage` → ปิดแท็บแล้วต้องใส่ใหม่
**ข้อจำกัดที่ต้องรู้:** ด่านนี้เป็นฝั่งเบราว์เซอร์ ลอกโค้ดไปอ่านได้ จึงกันคนเดินผ่านหน้าจอ ไม่ใช่กันผู้โจมตี — การป้องกันจริงคือ `ADMIN_TOKEN` ของ `server/publish.mjs` ซึ่งต้องตั้งทุกครั้งที่เปิดเซิร์ฟเวอร์ให้เครื่องอื่นเข้าถึง
**ข้อจำกัดที่ต้องรู้:** การทำ hash กันไม่ให้รหัสโผล่ใน source แต่ไม่ได้กันคนที่เปิด devtools (แก้ JS ให้ `isAuthed()` คืน true ได้เลย) และ verifier ที่ได้ก็ถูกเดารหัส offline ได้ถ้ารหัสอ่อน — การป้องกันจริงคือ `ADMIN_TOKEN` ของ `server/publish.mjs` ซึ่งต้องตั้งทุกครั้งที่เปิดเซิร์ฟเวอร์ให้เครื่องอื่นเข้าถึง
## ขั้นตอนตรวจก่อนส่งงาน
+9 -1
View File
@@ -4,7 +4,15 @@
- เว็บจริง: https://www.hobbypj.com
- ข้อมูลทั้งหมดอยู่ในไฟล์เดียว: `data/projects.json`
- หน้าแก้ไข: `#/admin` (หรือกดปุ่ม “แก้ไขรายการ” มุมขวาบน)
- หน้าแก้ไข: `#/admin` (หรือกดปุ่ม “แก้ไขรายการ” มุมขวาบน) — ต้องใส่ชื่อและรหัสก่อน
ตั้ง/เปลี่ยนรหัสหลังบ้าน:
```bash
node server/set-admin-password.mjs admin <รหัสใหม่>
```
คำสั่งนี้เขียน `config/admin-credentials.json` (salt + verifier ของ PBKDF2) — ตัวเว็บจะไม่เก็บรหัสจริงไว้เลย
## รันในเครื่อง
+9
View File
@@ -0,0 +1,9 @@
{
"note": "สร้างด้วย node server/set-admin-password.mjs — อย่าแก้ด้วยมือ",
"algorithm": "PBKDF2-HMAC-SHA256",
"iterations": 250000,
"key_length": 32,
"salt": "ptORi5IP7LqBNiK7FFBMlw==",
"verifier": "7/yYWnhNh9bczDNYWsazdhsckDazbogyPdGDe5dsdQ4=",
"created_at": "2026-11-19T04:31:23.900Z"
}
+1 -1
View File
@@ -22,7 +22,7 @@
content="รายชื่อโปรเจคอดิเรกของเรา เลือกโปรเจคที่อยากดูได้เลย"
/>
<meta name="theme-color" content="#8A4722" />
<meta name="app-version" content="2026.11.19.3" />
<meta name="app-version" content="2026.11.19.4" />
<link rel="manifest" href="manifest.json" />
<link rel="icon" type="image/png" sizes="192x192" href="icons/icon-192.png" />
<link rel="icon" type="image/png" sizes="64x64" href="icons/favicon-64.png" />
+93
View File
@@ -0,0 +1,93 @@
#!/usr/bin/env node
/**
* server/set-admin-password.mjs — สร้าง/เปลี่ยนรหัสเข้าหลังบ้าน
*
* node server/set-admin-password.mjs admin "รหัสใหม่ที่ตั้ง"
* node server/set-admin-password.mjs # ถามทางคีย์บอร์ด (ซ่อนรหัส)
* ADMIN_PASSWORD=xxx node server/set-admin-password.mjs admin
*
* เขียนผลลัพธ์ลง config/admin-credentials.json (salt + verifier เท่านั้น ไม่มีรหัสจริง)
* ฝั่งเว็บ (ui/auth.js) จะ PBKDF2 จากสิ่งที่ผู้ใช้พิมพ์ด้วยค่า salt/iterations ชุดเดียวกันแล้วเทียบ
*/
import { pbkdf2Sync, randomBytes } from "node:crypto";
import { mkdir, writeFile } from "node:fs/promises";
import { stdin, stdout } from "node:process";
import path from "node:path";
import { fileURLToPath } from "node:url";
import readline from "node:readline";
const ITERATIONS = Number(process.env.PBKDF2_ITERATIONS || 250_000);
const KEY_LENGTH = 32;
const HERE = path.dirname(fileURLToPath(import.meta.url));
const ROOT = path.resolve(HERE, "..");
const OUT_FILE = path.join(ROOT, "config", "admin-credentials.json");
function ask(question, { hidden = false } = {}) {
return new Promise((resolve) => {
const rl = readline.createInterface({ input: stdin, output: stdout, terminal: true });
if (!hidden) {
rl.question(question, (answer) => {
rl.close();
resolve(answer);
});
return;
}
const onData = (char) => {
const text = String(char);
if (text === "\n" || text === "\r" || text === "\u0004") return;
stdout.write("*");
};
rl._writeToOutput = (text) => {
if (text.includes(question)) stdout.write(question);
};
stdin.on("data", onData);
rl.question(question, (answer) => {
stdin.off("data", onData);
stdout.write("\n");
rl.close();
resolve(answer);
});
});
}
function derive(name, password, salt, iterations) {
return pbkdf2Sync(`${name}:${password}`, salt, iterations, KEY_LENGTH, "sha256");
}
async function main() {
const name = (process.argv[2] || (await ask("ชื่อผู้ใช้ [admin]: ")) || "admin").trim();
let password = process.argv[3] || process.env.ADMIN_PASSWORD || "";
if (!password) password = await ask("รหัสผ่านใหม่: ", { hidden: true });
if (!password || password.length < 6) {
console.error("รหัสต้องยาวอย่างน้อย 6 ตัวอักษร");
process.exit(1);
}
const salt = randomBytes(16);
const verifier = derive(name, password, salt, ITERATIONS);
const payload = {
note: "สร้างด้วย node server/set-admin-password.mjs — อย่าแก้ด้วยมือ",
algorithm: "PBKDF2-HMAC-SHA256",
iterations: ITERATIONS,
key_length: KEY_LENGTH,
salt: salt.toString("base64"),
verifier: verifier.toString("base64"),
created_at: new Date().toISOString(),
};
await mkdir(path.dirname(OUT_FILE), { recursive: true });
await writeFile(OUT_FILE, `${JSON.stringify(payload, null, 2)}\n`, "utf8");
console.log(`เขียนแล้ว: ${path.relative(ROOT, OUT_FILE)}`);
console.log(` algorithm = ${payload.algorithm} · iterations = ${ITERATIONS}`);
console.log(` salt = ${payload.salt}`);
console.log(` verifier = ${payload.verifier.slice(0, 16)}…`);
console.log("รหัสจริงไม่ถูกบันทึกที่ไหน — ถ้าลืมให้รันสคริปต์นี้ใหม่");
}
main().catch((error) => {
console.error(error);
process.exit(1);
});
+2 -1
View File
@@ -2,7 +2,7 @@
กติกา: bump VERSION เฉพาะเมื่อแก้ไฟล์นี้หรือรายการ PRECACHE
เนื้อหา (HTML/CSS/JS/JSON) ใช้ network-first จึงไม่ต้อง bump */
const VERSION = "2026.11.19.3";
const VERSION = "2026.11.19.4";
const CACHE = `hobbypj-${VERSION}`;
const PRECACHE = [
@@ -23,6 +23,7 @@ const PRECACHE = [
"./ui/views/home.js",
"./ui/views/admin.js",
"./data/projects.json",
"./config/admin-credentials.json",
"./icons/icon-192.png",
"./icons/icon-512.png",
"./fonts/k2d-400-thai.woff2",
+108 -20
View File
@@ -1,16 +1,26 @@
/* auth.js — ประตูหน้าหลังบ้าน (ชื่อ + รหัส)
หมายเหตุความปลอดภัย: นี่คือ "ด่านหน้า" ฝั่งเบราว์เซอร์ ทำให้คนเดินผ่านหน้าจอ
ไม่เข้าไปแก้ข้อความได้ง่าย ๆ เท่านั้น ไม่ใช่ระบบยืนยันตัวตนจริง
การป้องกันจริงอยู่ที่ ADMIN_TOKEN ของ server/publish.mjs (ฝั่งเซิร์ฟเวอร์)
ห้ามใช้รหัสเดียวกับระบบอื่น และอย่าเปิดหลังบ้านให้เครื่องอื่นโดยไม่ตั้ง ADMIN_TOKEN */
/* auth.js — ด่านหน้าหลังบ้าน: ตรวจรหัสแบบ PBKDF2 (ไม่มีรหัสจริงอยู่ในไฟล์นี้)
*
* วิธีทำงาน
* 1. อ่าน salt / iterations / verifier จาก config/admin-credentials.json (คนละไฟล์กับโค้ดนี้)
* 2. ผู้ใช้พิมพ์ "ชื่อ" + "รหัส" → PBKDF2-HMAC-SHA256("ชื่อ:รหัส", salt, iterations)
* 3. เทียบผลลัพธ์แบบ constant-time กับ verifier ในไฟล์ config
*
* ทำไมยังไม่ใช่ความปลอดภัยเต็มรูปแบบ
* - ด่านนี้อยู่ฝั่งเบราว์เซอร์ ใครแก้ JS ใน devtools ก็ข้ามได้ และ verifier ที่ได้มาก็ถูกเดารหัส
* แบบ offline ได้ (รหัสสั้น/เดาง่าย = แตกเร็ว) — สิ่งที่ได้คือ "ไม่มีรหัสจริงใน source"
* - การป้องกันจริงคือ ADMIN_TOKEN ของ server/publish.mjs (ฝั่งเซิร์ฟเวอร์)
*
* เปลี่ยนรหัส: node server/set-admin-password.mjs admin <รหัสใหม่>
*/
const ADMIN_NAME = "admin";
const ADMIN_PASSWORD = "admin007";
const CONFIG_URL = "config/admin-credentials.json";
const SESSION_KEY = "hobbypj.admin.session.v1";
const MAX_ATTEMPTS = 5;
const LOCK_MS = 30_000;
let cachedConfig = null;
let configPromise = null;
let failures = 0;
let lockedUntil = 0;
@@ -22,15 +32,101 @@ export function isAuthed() {
}
}
/** @returns {{ok:boolean, locked?:boolean, retryIn?:number, remaining?:number}} */
export function login(name, password) {
export function logout() {
try {
sessionStorage.removeItem(SESSION_KEY);
} catch {
/* ignore */
}
}
async function loadConfig() {
if (cachedConfig) return cachedConfig;
if (!configPromise) {
configPromise = fetch(CONFIG_URL, { cache: "no-store" })
.then((res) => {
if (!res.ok) throw new Error(`HTTP ${res.status}`);
return res.json();
})
.then((json) => {
cachedConfig = json;
return json;
})
.catch((error) => {
configPromise = null;
throw error;
});
}
return configPromise;
}
function base64ToBytes(value) {
const binary = atob(String(value || ""));
const bytes = new Uint8Array(binary.length);
for (let i = 0; i < binary.length; i += 1) bytes[i] = binary.charCodeAt(i);
return bytes;
}
function equalConstantTime(a, b) {
if (!a || !b || a.length !== b.length) return false;
let diff = 0;
for (let i = 0; i < a.length; i += 1) diff |= a[i] ^ b[i];
return diff === 0;
}
async function deriveVerifier(name, password, config) {
const encoder = new TextEncoder();
const material = await crypto.subtle.importKey(
"raw",
encoder.encode(`${name}:${password}`),
"PBKDF2",
false,
["deriveBits"],
);
const bits = await crypto.subtle.deriveBits(
{
name: "PBKDF2",
salt: base64ToBytes(config.salt),
iterations: Number(config.iterations) || 250_000,
hash: "SHA-256",
},
material,
(Number(config.key_length) || 32) * 8,
);
return new Uint8Array(bits);
}
/**
* @returns {Promise<{ok:boolean, locked?:boolean, retryIn?:number, remaining?:number, error?:string}>}
*/
export async function login(name, password) {
const now = Date.now();
if (now < lockedUntil) {
return { ok: false, locked: true, retryIn: Math.ceil((lockedUntil - now) / 1000) };
}
const ok = String(name ?? "").trim() === ADMIN_NAME && String(password ?? "") === ADMIN_PASSWORD;
if (!ok) {
if (!globalThis.crypto?.subtle) {
return {
ok: false,
error: "เบราว์เซอร์นี้ตรวจรหัสไม่ได้ — ต้องเปิดผ่าน https หรือ localhost",
};
}
let config;
try {
config = await loadConfig();
} catch (error) {
return { ok: false, error: `อ่านไฟล์รหัสไม่ได้ (${CONFIG_URL}) — ${error.message}` };
}
let computed;
try {
computed = await deriveVerifier(String(name ?? "").trim(), String(password ?? ""), config);
} catch (error) {
return { ok: false, error: `ตรวจรหัสไม่สำเร็จ: ${error.message}` };
}
if (!equalConstantTime(computed, base64ToBytes(config.verifier))) {
failures += 1;
if (failures >= MAX_ATTEMPTS) {
failures = 0;
@@ -45,15 +141,7 @@ export function login(name, password) {
try {
sessionStorage.setItem(SESSION_KEY, "1");
} catch {
/* โหมดส่วนตัวที่ปิด storage → ให้เข้าได้เฉพาะรอบนี้ */
/* โหมดที่ปิด storage → เข้าได้เฉพาะรอบนี้ */
}
return { ok: true };
}
export function logout() {
try {
sessionStorage.removeItem(SESSION_KEY);
} catch {
/* ignore */
}
}
+22 -6
View File
@@ -97,7 +97,7 @@ export function adminView(ctx) {
root.querySelector("#login-name")?.focus({ preventScroll: true });
form.addEventListener("submit", (event) => {
form.addEventListener("submit", async (event) => {
event.preventDefault();
errorEl.textContent = "";
[nameEl, passEl].forEach((field) => field.closest(".field").classList.remove("field--error"));
@@ -106,17 +106,33 @@ export function adminView(ctx) {
(nameEl.value.trim() ? passEl : nameEl).focus();
return;
}
const labelEl = submitEl.querySelector("span");
const originalLabel = labelEl ? labelEl.textContent : "";
submitEl.disabled = true;
const result = login(nameEl.value, passEl.value);
submitEl.disabled = false;
if (labelEl) labelEl.textContent = "กำลังตรวจสอบ…";
let result;
try {
result = await login(nameEl.value, passEl.value);
} catch (error) {
result = { ok: false, error: `ตรวจรหัสไม่สำเร็จ: ${error.message}` };
} finally {
submitEl.disabled = false;
if (labelEl) labelEl.textContent = originalLabel;
}
if (result.ok) {
mount(root);
toast("เข้าสู่หน้าจัดการแล้ว");
return;
}
const message = result.locked
? `ลองผิดหลายครั้งเกินไป — รออีก ${result.retryIn} วินาที`
: `ชื่อหรือรหัสไม่ถูกต้อง (ลองได้อีก ${result.remaining} ครั้ง)`;
const message =
result.error ||
(result.locked
? `ลองผิดหลายครั้งเกินไป — รออีก ${result.retryIn} วินาที`
: `ชื่อหรือรหัสไม่ถูกต้อง (ลองได้อีก ${result.remaining} ครั้ง)`);
errorEl.textContent = message;
passEl.value = "";
[nameEl, passEl].forEach((field) => field.closest(".field").classList.add("field--error"));