feat(portal): 改密碼與忘記密碼合成同一個機制,用連結不用一次性密碼(D62)

leo 2026-08-10 拍板:「這兩個機制其實是一個機制,可以簡化。」
  修改密碼:輸入**現有的** → 輸入新的 → 覆蓋
  忘記密碼:收到**「修改密碼」連結** → **不輸入現有密碼(忽略)** → 輸入新的 → 覆蓋
⇒ 同一個畫面、同一條寫入路徑,差別只有「現有密碼」那一格。

後端(cypher-executor/src/routes/portal.ts)
- POST /portal/password/change =**那一支**。帶 reset_token 就走連結那一格(忽略 current),
  沒帶就要登入 + 正確的 current。兩條路在 writeNewPassword 之後完全相同。
  /portal/me/password 保留成**別名轉呼同一支**(不留第二份實作,兩份必然漂移)。
- POST /portal/password/forgot(公開)/GET /portal/password/reset(看票,不消耗)
- 連結的安全性(承 D50,不可退讓):**一次有效**(用掉即刪,先刪再回)、
  **會過期**(KV TTL 30 分鐘)、**與註冊辨識碼不同源**(現場 crypto 亂數,
  只活在本實例 SESSIONS_KV,與 landing SIGNUPS 那組安裝辨識碼毫無關係)。
  KV 存的是 token 的 sha256,不是 token 本身。
- 🔴 不做一次性密碼(leo:「不要發一次性密碼太麻煩」)。
- 🔴 已否決不准寫回來的三條(D50):console 密碼救援/重裝重設密碼/直接用固定辨識碼。

中央代寄(arcrun-rag landing 那半在該 repo)
leo 給的職責切法:實例產生連結、管一次性/過期;arcrun.dev 只是郵差。
必須這樣切的硬理由:用戶自己的實例**沒有 send_email binding**,根本寄不了信。
🔴 總管紅線:**絕不把整條 URL 交給郵差**——寄件網域帶 DKIM,肯收「任意 URL+任意 email」
就是一台開放的釣魚中繼,燒的是整個網域信譽、不可逆。
故只交出本實例 origin + 一張回呼票,並新增 POST /portal/password/relay-verify:
郵差**回頭打這個 origin** 問「這張票是你發的嗎」,冒用別人網域會被那台實例自己否認
⇒ 主機屬於呼叫方這件事由郵差親自確認,不是相信宣稱。
信裡的連結落點 GET /portal/password/reset-link(主機刻意=被確認過的那個 origin)。

前端(console-ui/public/portal/index.html)
- 登入頁「忘記密碼」入口,**在 portal 不在 console**(leo:「是對 portal 不是對 console,
  這樣 youlin 雖然忘記,我還是可以去 portal 忘記密碼。」)
- 拆掉登入頁原有的「用管理主控台密碼救援自己」連結與「忘記密碼請聯絡管理員」
  ——兩條都是 D50 已否決的做法(console 與 portal 是同一組帳密的兩個鑰匙孔)。
- #v-reset 殼**沒有自己的密碼欄位**:真正的表單是設定頁那唯一一份 #pw-form,
  進入連結模式時被原封不動搬過去,只切換「現有密碼」那一格顯不顯示。
  同一個表單元素、同一支送出函式 —— D62「同一個畫面」的字面落地。

驗證:tsc 與 baseline 同為 23 個既有錯誤(零新增);27/27 既有測試綠;前端 JS node --check 過。
stage 實測見交付回報。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01R8vF2zS2XpaZjzkC75Fjss
This commit is contained in:
Claude
2026-08-10 13:23:44 +00:00
parent 417d69ceb3
commit 8d49d883c0
4 changed files with 484 additions and 34 deletions
+168 -16
View File
@@ -219,12 +219,42 @@ if (!window.ARCRUN_API_BASE) {
<button class="btn" id="login-submit" style="margin-top:6px;padding:15px;font-size:17px;letter-spacing:.2em">登入</button>
<div id="login-status" class="err" style="font-size:14px;min-height:1.2em"></div>
</div>
<div style="font-size:13.5px;color:rgba(var(--ink-rgb),.4);line-height:1.7">帳號由管理員發放。忘記密碼請聯絡管理員重設。</div>
<div style="font-size:13px;color:rgba(var(--ink-rgb),.4);line-height:1.7">你自己就是管理員?<a href="/console/" style="color:var(--amber)">用管理主控台密碼救援自己</a></div>
<!-- 🔴 D50/D62:這裡原本寫「忘記密碼請聯絡管理員重設」+一條「用管理主控台密碼救援自己」
的 console 連結。**兩條都是已否決的做法**,不准寫回來:
① leo:「我要是記得密碼,還來找忘記密碼幹嘛?」——console 登入頁一樣要密碼
② console 與 portal 是安裝時**同一組帳密**寫進兩個地方(D50 補刀)
⇒ console 不是第二道閘,是同一把鎖的第二個鑰匙孔,往它補洞不會多出任何一條路
③ 唯一管理員忘記密碼時「聯絡管理員」=叫他聯絡他自己
leo 2026-08-10:「**是對 portal 不是對 console**,這樣 youlin 雖然忘記,
我還是可以去 portal 忘記密碼。」⇒ 出口就在這裡。 -->
<div style="font-size:13.5px;color:rgba(var(--ink-rgb),.4);line-height:1.7">
忘記密碼了?<a href="#" id="login-forgot" style="color:var(--amber)">寄一條「修改密碼」連結給我</a>
</div>
<div id="forgot-box" class="hide" style="display:flex;flex-direction:column;gap:10px;margin-top:4px">
<input type="email" id="forgot-email" class="txt" placeholder="你註冊時用的 Email" autocomplete="username">
<button class="btn" id="forgot-submit">寄出連結</button>
<div id="forgot-status" style="font-size:13.5px;min-height:1.2em;line-height:1.6"></div>
</div>
<button class="btn3 themelabel" data-themetoggle style="align-self:center;padding:8px 16px;font-size:13.5px;border-radius:999px">☾ 切深色</button>
</div>
</div>
<!-- 修改密碼(D62):忘記密碼點信裡的連結進來的落點。
🔴 這個殼**刻意沒有自己的密碼欄位**——真正的表單是設定頁那一份 #pw-form,
進到這個模式時被 JS 原封不動搬進 #reset-slot。D62:「同一個畫面、同一條寫入路徑,
差別只有一格:現有密碼是要填、還是被連結豁免。」複製一份長得像的就會漂移。 -->
<div class="authwrap view" id="v-reset">
<div class="authbox">
<div>
<div style="font-size:22px;font-weight:600;margin-bottom:6px">設定新密碼</div>
<div id="reset-who" style="font-size:14px;color:rgba(var(--ink-rgb),.55);line-height:1.7;margin-bottom:14px"></div>
<div id="reset-slot"></div>
<div id="reset-error" class="err" style="font-size:14px;line-height:1.7"></div>
<div style="margin-top:16px;font-size:13.5px"><a href="#/" id="reset-back" style="color:var(--amber)">回登入頁</a></div>
</div>
</div>
</div>
<!-- 首次設定(t49leo 07-25:一鍵安裝的用戶打開專屬網址,第一件事就是在這裡建帳號,
不再需要回安裝器那頁。auth-status 說 configured:false 才會出現。)-->
<div class="authwrap view" id="v-firstsetup">
@@ -375,10 +405,14 @@ if (!window.ARCRUN_API_BASE) {
<div class="switch" id="st-theme-switch" data-themetoggle style="cursor:pointer"><i></i></div>
</div>
</div>
<div class="panel">
<div style="font-size:17px;font-weight:600">更改密碼</div>
<div style="margin-top:4px;font-size:14px;color:rgba(var(--ink-rgb),.55)">需輸入舊密碼驗證身分;新密碼至少 8 碼</div>
<div style="margin-top:14px;display:flex;flex-direction:column;gap:10px">
<!-- D62leo 2026-08-10):「改密碼與忘記密碼**這兩個機制其實是一個機制,可以簡化**。」
⇒ 這個表單是**整個站唯一一份**改密碼的表單。忘記密碼點連結進來時,
它會被原封不動搬到 #v-reset 那個殼裡(不是複製一份長得像的)——
差別只有「現有密碼」那一格顯不顯示。同一個畫面、同一條寫入路徑。 -->
<div class="panel" id="st-pw-panel">
<div style="font-size:17px;font-weight:600" id="pw-title">更改密碼</div>
<div style="margin-top:4px;font-size:14px;color:rgba(var(--ink-rgb),.55)" id="pw-sub">需輸入舊密碼驗證身分;新密碼至少 8 碼</div>
<div id="pw-form" style="margin-top:14px;display:flex;flex-direction:column;gap:10px">
<input type="password" id="st-pw-old" class="txt" placeholder="舊密碼" autocomplete="current-password">
<input type="password" id="st-pw-new" class="txt" placeholder="新密碼(至少 8 碼)" autocomplete="new-password">
<input type="password" id="st-pw-new2" class="txt" placeholder="再輸入一次新密碼" autocomplete="new-password">
@@ -817,6 +851,10 @@ function taipeiMonthDay(ms) { var d = new Date(ms + TAIPEI_OFFSET_MS); return {
} catch (e) { /* 登入殼還沒渲染就算了 */ }
}
function boot() {
// D62:信裡的「修改密碼」連結最優先——這個人**就是進不去才收到這封信的**,
// 不可以因為瀏覽器裡剛好還留著一個舊 token 就把他丟去別的畫面。
var rt = (typeof resetTokenFromUrl === 'function') ? resetTokenFromUrl() : '';
if (rt) { showReset(rt); return; }
if (!S.token) { showAuth(); return; }
fetch(API_BASE + '/portal/session', { headers: authHeaders() })
.then(function (r) { return safeJson(r).then(function (d) { return { ok: r.ok, status: r.status, d: d }; }); })
@@ -2041,33 +2079,147 @@ function taipeiMonthDay(ms) { var d = new Date(ms + TAIPEI_OFFSET_MS); return {
'<div class="kvline"><span class="muted">角色</span><span>' + esc(p.role === 'admin' ? '管理員' : '一般用戶') + '</span></div>' +
'<div class="kvline" style="align-items:flex-start"><span class="muted" style="flex:none">可查庫</span><span style="text-align:right;display:flex;gap:6px;flex-wrap:wrap;justify-content:flex-end">' + libHtml + '</span></div>';
}
$('st-pw-save').addEventListener('click', function () {
// ══════════ D62:改密碼與忘記密碼=同一個機制 ══════════
//
// leo 2026-08-10:「這兩個機制其實是一個機制,可以簡化。」
// 修改密碼:輸入**現有的** → 輸入新的 → 覆蓋
// 忘記密碼:收到**「修改密碼」連結** → **不輸入現有密碼(忽略)** → 輸入新的 → 覆蓋
// ⇒ 底下只有**一個表單元素**(#pw-form)與**一支送出函式**,差別只有「現有密碼」那一格
// 顯不顯示、以及帶 current 還是帶 reset_token。兩份長得像的東西必然漂移
// arcrun-rag#40「同一個事實兩份」)。
// 🔴 不做一次性密碼(leo:「不要發一次性密碼太麻煩」)。
var S_RESET_TOKEN = ''; // 非空=現在是「忘記密碼」模式
/** 把那一份唯一的表單搬到指定容器,並決定「現有密碼」那一格出不出現。 */
function mountPasswordForm(host, needCurrent) {
var form = $('pw-form');
if (form && form.parentNode !== host) host.appendChild(form);
$('st-pw-old').classList.toggle('hide', !needCurrent);
$('st-pw-save').textContent = needCurrent ? '更新密碼' : '設定新密碼';
$('st-pw-old').value = ''; $('st-pw-new').value = ''; $('st-pw-new2').value = '';
$('st-pw-status').textContent = '';
}
/** 送出:兩種模式共用。帶 reset_token 就走連結那一格,否則走現有密碼那一格。 */
function submitPasswordChange() {
var needCurrent = !S_RESET_TOKEN;
var oldPw = $('st-pw-old').value;
var newPw = $('st-pw-new').value;
var newPw2 = $('st-pw-new2').value;
var st = $('st-pw-status');
st.className = 'err';
if (!oldPw || !newPw) { st.textContent = '請填舊密碼與新密碼'; return; }
if (needCurrent && !oldPw) { st.textContent = '請填現在的密碼'; return; }
if (!newPw) { st.textContent = '請填新密碼'; return; }
if (newPw.length < 8) { st.textContent = '新密碼至少 8 碼'; return; }
if (newPw !== newPw2) { st.textContent = '兩次輸入的新密碼不一致'; return; }
var body = { 'new': newPw };
if (S_RESET_TOKEN) body.reset_token = S_RESET_TOKEN; else body.current = oldPw;
$('st-pw-save').disabled = true;
st.textContent = '';
fetch(API_BASE + '/portal/me/password', {
st.textContent = '處理中…';
fetch(API_BASE + '/portal/password/change', {
method: 'POST',
headers: Object.assign({ 'Content-Type': 'application/json' }, authHeaders()),
body: JSON.stringify({ current: oldPw, 'new': newPw })
headers: Object.assign({ 'Content-Type': 'application/json' }, needCurrent ? authHeaders() : {}),
body: JSON.stringify(body)
})
.then(function (r) { return safeJson(r).then(function (d) { return { ok: r.ok, status: r.status, d: d }; }); })
.then(function (x) {
$('st-pw-save').disabled = false;
if (guard401(x.status)) return;
if (!x.ok) { st.textContent = x.d.error || '更新失敗'; return; }
// 忘記密碼模式沒有 session,401 不代表「你被登出」——別誤踢
if (needCurrent && guard401(x.status)) return;
if (!x.ok) { st.textContent = (x.d && x.d.error) || '更新失敗'; return; }
st.className = 'ok';
st.textContent = '密碼已更新';
$('st-pw-old').value = ''; $('st-pw-new').value = ''; $('st-pw-new2').value = '';
toast('密碼已更新');
if (S_RESET_TOKEN) {
st.textContent = '密碼已設定好了,正在帶你回登入頁…';
var who = (x.d && x.d.email) || '';
S_RESET_TOKEN = '';
setTimeout(function () {
history.replaceState(null, '', location.pathname);
location.hash = '';
$('v-reset').classList.remove('on');
mountPasswordForm($('st-pw-panel'), true);
showAuth();
if (who) $('login-email').value = who;
$('login-status').className = 'ok';
$('login-status').textContent = '新密碼已生效,請用它登入。';
}, 1200);
} else {
st.textContent = '密碼已更新(你不會被登出,可以繼續操作)';
toast('密碼已更新');
}
})
.catch(function (e) { $('st-pw-save').disabled = false; st.textContent = friendlyErr(e); });
}
$('st-pw-save').addEventListener('click', submitPasswordChange);
// ── 登入頁的「忘記密碼」入口(**在 portal,不是 console**leo 2026-08-10)──
$('login-forgot').addEventListener('click', function (ev) {
ev.preventDefault();
$('forgot-box').classList.remove('hide');
$('forgot-email').value = $('login-email').value.trim();
$('forgot-email').focus();
});
$('forgot-submit').addEventListener('click', function () {
var email = $('forgot-email').value.trim();
var st = $('forgot-status');
st.className = 'err';
if (!email) { st.textContent = '請填 Email'; return; }
$('forgot-submit').disabled = true;
st.textContent = '寄送中…';
fetch(API_BASE + '/portal/password/forgot', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ email: email })
})
.then(function (r) { return safeJson(r).then(function (d) { return { ok: r.ok, status: r.status, d: d }; }); })
.then(function (x) {
$('forgot-submit').disabled = false;
if (!x.ok) { st.textContent = (x.d && x.d.error) || '寄送失敗'; return; }
st.className = 'ok';
st.textContent = (x.d && x.d.message) || '如果這個 email 有帳號,連結已經寄出了。';
})
.catch(function (e) { $('forgot-submit').disabled = false; st.textContent = friendlyErr(e); });
});
/** 點信裡的連結進來:`…/portal/#/reset?token=…`cypher 的 /portal/password/reset-link 導過來的)。 */
function resetTokenFromUrl() {
var m = String(location.hash || '').match(/[?&]token=([^&]+)/);
if (m) return decodeURIComponent(m[1]);
m = String(location.search || '').match(/[?&]token=([^&]+)/);
return m ? decodeURIComponent(m[1]) : '';
}
function showReset(token) {
$('v-login').classList.remove('on');
$('v-firstsetup').classList.remove('on');
$('shell').classList.remove('on');
$('tabbar').classList.remove('on');
$('v-reset').classList.add('on');
$('reset-error').textContent = '';
// 先問一次「這張票還有效嗎」——連結是一次有效、30 分鐘過期的,
// 過期就要當場說清楚,不要讓人填完密碼才被打回票(#49:別把系統狀態講成用戶的錯)。
fetch(API_BASE + '/portal/password/reset?token=' + encodeURIComponent(token))
.then(function (r) { return safeJson(r).then(function (d) { return { ok: r.ok, d: d }; }); })
.then(function (x) {
if (!x.ok || !x.d || x.d.valid !== true) {
$('reset-who').textContent = '';
$('reset-error').textContent = (x.d && x.d.error) || '這條連結已經失效了。請回登入頁重新按一次「忘記密碼」。';
return;
}
S_RESET_TOKEN = token;
$('reset-who').innerHTML = '你正在為 <strong>' + esc(x.d.email) + '</strong> 設定新密碼。<br>這條連結只能用一次,<strong>不需要輸入現在的密碼</strong>。';
mountPasswordForm($('reset-slot'), false); // ← 差別只有這一格
})
.catch(function (e) { $('reset-error').textContent = friendlyErr(e); });
}
$('reset-back').addEventListener('click', function (ev) {
ev.preventDefault();
S_RESET_TOKEN = '';
history.replaceState(null, '', location.pathname);
location.hash = '';
$('v-reset').classList.remove('on');
mountPasswordForm($('st-pw-panel'), true);
showAuth();
});
boot();