w-web-sso 1.1.13 → 1.1.15
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +69 -0
- package/dist/css/{app.f000459f.css → app.c117e572.css} +1 -1
- package/dist/index.tmp +1 -1
- package/dist/js/app-legacy.7c861154.js +1 -0
- package/dist/js/app.7c861154.js +1 -0
- package/dist/js/{chunk-vendors.97013ddc.js → chunk-vendors-legacy.6cb51be5.js} +2 -2
- package/dist/js/{chunk-vendors-legacy.97013ddc.js → chunk-vendors.6cb51be5.js} +2 -2
- package/dist/w-web-sso.umd.js +4 -4
- package/dist/w-web-sso.umd.js.map +1 -1
- package/docs/WWebSso.html +1 -1
- package/docs/global.html +1 -1
- package/docs/index.html +1 -1
- package/docs/server_WWebSso.mjs.html +25 -1
- package/docs/server_getIgnoredOrmKeys.mjs.html +1 -1
- package/docs/server_lockSave.mjs.html +1 -1
- package/docs/server_ormWrite.mjs.html +1 -1
- package/docs/server_staLogs_resolveShellWorker.mjs.html +1 -1
- package/docs/server_wrapTimer.mjs.html +1 -1
- package/docs/src_components_Common_CheckYesNo.vue.html +1 -1
- package/docs/src_fetchSsoMsg.mjs.html +1 -1
- package/docs/src_httpGetJson.mjs.html +1 -1
- package/docs/src_maskUrl.mjs.html +1 -1
- package/docs/src_plugins_staUsage.mjs.html +1 -1
- package/docs/src_plugins_submitGuard.mjs.html +1 -1
- package/package.json +1 -1
- package/server/WWebSso.mjs +24 -0
- package/server/procCore.mjs +631 -179
- package/server/procLang.mjs +114 -4
- package/server/procStaInfor.mjs +18 -0
- package/src/appUsage.mjs +115 -0
- package/src/components/AppTokenAddDialog.vue +384 -0
- package/src/components/LayoutContentTokens.vue +147 -76
- package/src/components/LayoutContentUsers.vue +22 -17
- package/src/components/PageLogin.vue +3 -3
- package/src/getUserByToken.mjs +4 -1
- package/src/getUserByUserId.mjs +2 -1
- package/src/getUsersByToken.mjs +2 -1
- package/src/schema/tables/tokens.mjs +9 -1
- package/src/usersRedirCheck.mjs +68 -0
- package/src/writeContracts/tokens.mjs +4 -3
- package/src/writeContracts/tokensSession.mjs +1 -1
- package/dist/js/app-legacy.7c006893.js +0 -1
- package/dist/js/app.7c006893.js +0 -1
package/server/procCore.mjs
CHANGED
|
@@ -47,6 +47,7 @@ import createLockSave from './lockSave.mjs'
|
|
|
47
47
|
import ormWrite from './ormWrite.mjs'
|
|
48
48
|
import { maskToken, maskKv, keysUserQuery, capText } from './srLog.mjs'
|
|
49
49
|
import { hasAppPerm, isAppPermsValue, normAppPerms } from '../src/appPerms.mjs'
|
|
50
|
+
import { getAppUsage, getAppId, isAppUsageValue, isAppIdLike, isLegacyAppToken, classifyLegacyAppToken, keyAppUsageRetired } from '../src/appUsage.mjs'
|
|
50
51
|
import contracts from '../src/writeContracts/index.mjs'
|
|
51
52
|
|
|
52
53
|
|
|
@@ -186,6 +187,10 @@ function proc(woItems, procOrm, { srLog, srEmail, salt, minExpired, kpLang, pass
|
|
|
186
187
|
//同一操作者之同一儲存處理中再送出即 reject 'saveInProgress'
|
|
187
188
|
let lockSave = createLockSave(cst)
|
|
188
189
|
|
|
190
|
+
//legacyPm: 進行中之升級遷移(migrateLegacyAppTokens)之 promise, 同時多次呼叫共用同一個; 無進行中為 null.
|
|
191
|
+
//讀取端(loadActor)不依賴遷移狀態: 尚未定案之舊列一律依升級前規則判定, 不在鎖內等待遷移(遷移持 tokens 表鎖, 等待它可與已持鎖之站點互鎖)
|
|
192
|
+
let legacyPm = null
|
|
193
|
+
|
|
189
194
|
//throttle 紀錄: key → timestamp(ms), 用於 resendVerifyEmail / adminResetUserPassword
|
|
190
195
|
//之 30s 內第二次重複觸發判定. 與 mutex 配合: mutex 確保同 key 序列化,
|
|
191
196
|
//throttle 確保序列化後第二次仍會被 reject (避免重複寄信).
|
|
@@ -564,62 +569,194 @@ function proc(woItems, procOrm, { srLog, srEmail, salt, minExpired, kpLang, pass
|
|
|
564
569
|
}
|
|
565
570
|
|
|
566
571
|
|
|
567
|
-
//
|
|
568
|
-
|
|
572
|
+
//loadActor: 由權杖列解析呼叫者身分 (ADR-095; 身分驗證責任之核心, 全部「本人」與管理入口皆經此):
|
|
573
|
+
//- 使用者 token(isApp 非 'y'): { kind: 'user', id: 使用者主鍵, user: 最新使用者列(已去 password) }
|
|
574
|
+
//- 應用系統金鑰・使用者用途: { kind: 'appUser', id: 所綁使用者主鍵, user: 所綁使用者最新列 }, 代表所綁使用者本人(tokens.userId 即所綁使用者)
|
|
575
|
+
//- 應用系統金鑰・系統服務用途: { kind: 'appSystem', id: 'app:<tokens.id>', user: 虛擬使用者 }, 代表外部應用系統本身; tokens.userId 只記建立者, 此處完全不使用
|
|
576
|
+
//- 應用系統金鑰・已失效之舊列(appUsage='retired', 升級前即不可用): { kind: 'appRetired', id: 'app:<tokens.id>', user: null }, 永不可用(isActorLive 恆 false)
|
|
577
|
+
//使用者不存在或已停用(isActive 非 'y')、用途值未登錄 → reject(權杖不可用); 不判逾期 / 封鎖 / 帳號到期 / 驗證, 由 isActorLive 判
|
|
578
|
+
let loadActor = async (tk) => {
|
|
579
|
+
let isApp = get(tk, 'isApp', '') === 'y'
|
|
569
580
|
|
|
570
|
-
|
|
571
|
-
|
|
581
|
+
//使用者 token
|
|
582
|
+
if (!isApp) {
|
|
583
|
+
let u = await getGenUserByUserId(get(tk, 'userId', ''))
|
|
584
|
+
return { kind: 'user', id: get(u, 'id', ''), user: u }
|
|
585
|
+
}
|
|
586
|
+
|
|
587
|
+
//應用系統金鑰
|
|
588
|
+
let usage = getAppUsage(tk)
|
|
589
|
+
|
|
590
|
+
//尚未定案之舊列(缺欄或 ''; 升級遷移尚未處理, 或啟動後才由外部直寫庫): 依升級前規則判定(classifyLegacyAppToken: 合法且未逾期之 timeEnd → 視同系統服務用途, 否則已失效),
|
|
591
|
+
//永遠不比升級前更寬——遷移進行中、遷移失敗或單元測試直接組 procCore 時, 已逾期者皆不因「不設期限」而復活, 升級前可用者照常可用(遷移成功後才定案為不設期限)
|
|
592
|
+
if (isLegacyAppToken(tk)) {
|
|
593
|
+
usage = classifyLegacyAppToken(tk, ot().format('YYYY-MM-DDTHH:mm:ss.SSSZ'))
|
|
594
|
+
}
|
|
595
|
+
if (usage === keyAppUsageRetired) {
|
|
596
|
+
return { kind: 'appRetired', id: getAppId(tk), user: null }
|
|
597
|
+
}
|
|
598
|
+
if (usage === 'user') {
|
|
599
|
+
let u = await getGenUserByUserId(get(tk, 'userId', ''))
|
|
600
|
+
return { kind: 'appUser', id: get(u, 'id', ''), user: u }
|
|
601
|
+
}
|
|
602
|
+
if (usage === 'system') {
|
|
603
|
+
let name = get(tk, 'appName', '')
|
|
604
|
+
let u = {
|
|
605
|
+
id: getAppId(tk), //穩定(隨權杖列主鍵)且不與使用者主鍵相撞(後台清單拒收 'app:' 開頭之使用者主鍵)
|
|
606
|
+
account: 'no account',
|
|
607
|
+
name: isestr(name) ? name : 'no name', //金鑰名稱
|
|
608
|
+
email: 'no email',
|
|
609
|
+
description: 'no description',
|
|
610
|
+
from: 'no from',
|
|
611
|
+
redir: 'no redir',
|
|
612
|
+
isAdmin: 'y', //外部應用系統代表為系統管理員等級; 實際授權依 perms (ADR-069), 不依此欄
|
|
613
|
+
timeVerified: '2000-01-01T00:00:00.000+08:00', //應用系統代表為已驗證
|
|
614
|
+
timeExpired: '',
|
|
615
|
+
timeBlocked: '',
|
|
616
|
+
isActive: 'y',
|
|
617
|
+
}
|
|
618
|
+
return { kind: 'appSystem', id: u.id, user: u }
|
|
619
|
+
}
|
|
620
|
+
srLog.warn({ event: 'fun-checkToken', key: 'appTokenUsageInvalid', token: maskToken(get(tk, 'token', '')) })
|
|
621
|
+
return Promise.reject('invalid app token usage') //用途值未登錄: fail closed
|
|
622
|
+
}
|
|
623
|
+
|
|
624
|
+
|
|
625
|
+
//isUserUsable: 使用者目前可否使用(S-4), 與登入(loginByAccountAndPassword / createToken)同一判準:
|
|
626
|
+
//已驗證(timeVerified 為非空字串; 與登入同, 不要求 timemsTZ 格式, 否則舊格式之驗證時間可登入卻立即被判失效)、帳號未到期(現在 > timeExpired 才算到期)、未被封鎖(現在 <= timeBlocked 為封鎖中)、未被停用(isActive 非 'n')
|
|
627
|
+
//外審 sol#4: 原用 mShare.checkUserBasic(getIsVerified 要求 timemsTZ、isActive 須為 'y'), 與登入不一致
|
|
628
|
+
let isUserUsable = (u) => {
|
|
629
|
+
if (!iseobj(u)) {
|
|
630
|
+
return false
|
|
631
|
+
}
|
|
632
|
+
if (!isestr(get(u, 'timeVerified', ''))) {
|
|
633
|
+
return false
|
|
634
|
+
}
|
|
635
|
+
let tn = ot().format('YYYY-MM-DDTHH:mm:ss.SSSZ')
|
|
636
|
+
let timeExpired = get(u, 'timeExpired', '')
|
|
637
|
+
if (istimemsTZ(timeExpired) && tn > timeExpired) {
|
|
638
|
+
return false
|
|
639
|
+
}
|
|
640
|
+
let timeBlocked = get(u, 'timeBlocked', '')
|
|
641
|
+
if (istimemsTZ(timeBlocked) && tn <= timeBlocked) {
|
|
642
|
+
return false
|
|
643
|
+
}
|
|
644
|
+
if (get(u, 'isActive', '') === 'n') {
|
|
645
|
+
return false
|
|
646
|
+
}
|
|
647
|
+
return true
|
|
648
|
+
}
|
|
649
|
+
|
|
650
|
+
|
|
651
|
+
//isActorLive: 權杖此刻是否可用 (S-4 / S-3 / ADR-095):
|
|
652
|
+
//- 使用者 token: 權杖未逾期, 且使用者目前可用(與登入同一判準 isUserUsable: 已驗證、帳號未到期、未被封鎖、未停用)
|
|
653
|
+
//- 使用者用途: 不給期限(不看 timeEnd); 所綁使用者目前可用(同上), 隨其狀態即時失效、恢復
|
|
654
|
+
//- 系統服務用途: 不給期限, 不隨建立者之狀態失效(由專案方於後台撤銷)
|
|
655
|
+
//- 已失效之舊列(升級前即不可用): 恆不可用
|
|
656
|
+
let isActorLive = async (tk, actor) => {
|
|
657
|
+
if (actor.kind === 'appRetired') {
|
|
658
|
+
return false
|
|
659
|
+
}
|
|
660
|
+
if (actor.kind === 'appSystem') {
|
|
661
|
+
return true
|
|
662
|
+
}
|
|
663
|
+
if (actor.kind === 'user') {
|
|
664
|
+
let timeEnd = get(tk, 'timeEnd', '')
|
|
665
|
+
if (!istimemsTZ(timeEnd)) {
|
|
666
|
+
console.log(`timeEnd`, timeEnd)
|
|
667
|
+
console.log(`invalid timeEnd`)
|
|
668
|
+
return Promise.reject(`invalid timeEnd`)
|
|
669
|
+
}
|
|
670
|
+
let tn = ot().format('YYYY-MM-DDTHH:mm:ss.SSSZ')
|
|
671
|
+
if (!(tn < timeEnd)) { //現在時間<到期時間, 代表尚未到期
|
|
672
|
+
return false
|
|
673
|
+
}
|
|
674
|
+
}
|
|
675
|
+
return isUserUsable(actor.user)
|
|
676
|
+
}
|
|
677
|
+
|
|
678
|
+
|
|
679
|
+
//funCheckAdmin: 管理入口之角色判斷(已驗證、未過期、未封鎖、isAdmin='y'、啟用), 與 WWebSso 傳入各管理入口者同一判準(mShare.checkUserAdmin);
|
|
680
|
+
//procCore 內自有權限閘(adminResetUserPassword)沿用, 使各管理入口對非管理員回相同錯誤鍵 (S-2)
|
|
681
|
+
let funCheckAdmin = (tk, u) => {
|
|
682
|
+
return s.checkUserAdmin(u)
|
|
683
|
+
}
|
|
684
|
+
|
|
685
|
+
|
|
686
|
+
//getTokenRowByToken: 以權杖字串取唯一權杖列, 查無或重複 reject
|
|
687
|
+
let getTokenRowByToken = async (token) => {
|
|
688
|
+
|
|
689
|
+
//tks
|
|
690
|
+
let tks = await woItems.tokens.select({ token })
|
|
691
|
+
//console.log(`...tokens.select`)
|
|
692
|
+
|
|
693
|
+
//ntks
|
|
694
|
+
let ntks = size(tks)
|
|
572
695
|
|
|
573
696
|
//check
|
|
574
|
-
if (
|
|
575
|
-
// console.log(`
|
|
576
|
-
console.log(`
|
|
577
|
-
|
|
578
|
-
|
|
697
|
+
if (ntks === 0) {
|
|
698
|
+
// console.log(`token`, token)
|
|
699
|
+
console.log(`invalid token`)
|
|
700
|
+
return Promise.reject(`invalid token`)
|
|
701
|
+
}
|
|
702
|
+
|
|
703
|
+
//check
|
|
704
|
+
if (ntks >= 2) {
|
|
705
|
+
// console.log(`token`, token)
|
|
706
|
+
console.log(`duplicate tokens`)
|
|
707
|
+
return Promise.reject(`duplicate tokens`)
|
|
579
708
|
}
|
|
580
709
|
|
|
581
|
-
|
|
582
|
-
|
|
583
|
-
|
|
710
|
+
return get(tks, 0, null)
|
|
711
|
+
}
|
|
712
|
+
|
|
713
|
+
|
|
714
|
+
//getActorByToken: 以權杖字串取呼叫者身分(loadActor), 且權杖此刻須可用(isActorLive): 否則 reject 'tokenExpired'
|
|
715
|
+
//供檢查權杖之後需操作者身分的站點使用(自身查詢、改密碼、清單存檔之操作者); 查他人之目標權杖亦經此 (S-4、S-5)
|
|
716
|
+
let getActorByToken = async (token) => {
|
|
717
|
+
let tk = await getTokenRowByToken(token)
|
|
718
|
+
let actor = await loadActor(tk)
|
|
719
|
+
let live = await isActorLive(tk, actor)
|
|
720
|
+
if (!live) {
|
|
721
|
+
return Promise.reject('tokenExpired')
|
|
722
|
+
}
|
|
723
|
+
return actor
|
|
724
|
+
}
|
|
725
|
+
|
|
726
|
+
|
|
727
|
+
//_checkTokenByObj
|
|
728
|
+
//opt.fun: 使用者(使用者 token、使用者用途)之角色判斷 fun(tk, u); opt.perm: 系統服務用途所需之權限(src/appPerms.mjs), 使用者用途不適用 perms
|
|
729
|
+
let _checkTokenByObj = async (tk, opt = {}) => {
|
|
584
730
|
|
|
585
731
|
//fun
|
|
586
732
|
let fun = get(opt, 'fun', null)
|
|
587
733
|
|
|
588
|
-
//perm, 權限閘所需之 app token 權限(src/appPerms.mjs);
|
|
734
|
+
//perm, 權限閘所需之 app token 權限(src/appPerms.mjs); 僅作用於系統服務用途, 使用者 token 與使用者用途仍以 fun 判斷
|
|
589
735
|
let perm = get(opt, 'perm', '')
|
|
590
736
|
|
|
591
|
-
//
|
|
592
|
-
let
|
|
593
|
-
|
|
594
|
-
//
|
|
595
|
-
|
|
737
|
+
//actor
|
|
738
|
+
let actor = await loadActor(tk)
|
|
739
|
+
|
|
740
|
+
//live: 逾期(使用者 token)與使用者當前狀態(S-4)
|
|
741
|
+
let b1 = await isActorLive(tk, actor)
|
|
742
|
+
if (!b1) {
|
|
743
|
+
return false
|
|
744
|
+
}
|
|
596
745
|
|
|
597
|
-
let b1 = tn < timeEnd //現在時間<到期時間, 代表尚未到期
|
|
598
746
|
let b2 = true
|
|
599
|
-
|
|
600
|
-
|
|
601
|
-
//token來自使用者
|
|
747
|
+
if (actor.kind !== 'appSystem') {
|
|
748
|
+
//token 代表使用者本人(使用者 token、使用者用途): 有給定驗證 fun 才執行(取得使用者資訊供驗證), perms 不適用
|
|
602
749
|
|
|
603
750
|
if (isfun(fun)) {
|
|
604
|
-
|
|
605
|
-
|
|
606
|
-
//userId
|
|
607
|
-
let userId = get(tk, 'userId', '')
|
|
608
|
-
|
|
609
|
-
//getGenUserByUserId
|
|
610
|
-
let u = await getGenUserByUserId(userId)
|
|
611
|
-
|
|
612
|
-
//fun
|
|
613
|
-
b2 = fun(tk, u)
|
|
751
|
+
b2 = fun(tk, actor.user)
|
|
614
752
|
if (ispm(b2)) {
|
|
615
753
|
b2 = await b2
|
|
616
754
|
}
|
|
617
|
-
|
|
618
755
|
}
|
|
619
756
|
|
|
620
757
|
}
|
|
621
758
|
else {
|
|
622
|
-
//token
|
|
759
|
+
//token 代表外部應用系統(系統服務用途): 無使用者資訊故不執行 fun, 改依其 perms 判斷 (ADR-069, 取代 ADR-005 之一律視同 admin); 僅由 createAppToken 簽發, 不開放自助
|
|
623
760
|
|
|
624
761
|
if (isestr(perm)) {
|
|
625
762
|
//權限閘有宣告所需權限: 依 perms 判斷(基本權限 readUsers 恆具備, 多元素為聯集)
|
|
@@ -631,7 +768,7 @@ function proc(woItems, procOrm, { srLog, srEmail, salt, minExpired, kpLang, pass
|
|
|
631
768
|
}
|
|
632
769
|
//未給 fun 亦未給 perm: 僅驗 token 本身(checkToken / getUserByToken 等自身權杖操作)
|
|
633
770
|
|
|
634
|
-
//warn, 記錄缺權限之拒絕供稽核與介接排錯(對外仍統一回 tokenExpired, ADR-006)
|
|
771
|
+
//warn, 記錄缺權限之拒絕供稽核與介接排錯(對外仍統一回 tokenExpired, ADR-006); userId 為建立者(稽核), 不當身分使用
|
|
635
772
|
if (!b2) {
|
|
636
773
|
srLog.warn({ event: 'fun-checkToken', key: 'appTokenPermDenied', token: maskToken(get(tk, 'token', '')), userId: get(tk, 'userId', ''), perm })
|
|
637
774
|
}
|
|
@@ -674,8 +811,10 @@ function proc(woItems, procOrm, { srLog, srEmail, salt, minExpired, kpLang, pass
|
|
|
674
811
|
let tk = get(tks, 0, '')
|
|
675
812
|
// console.log('tk', tk)
|
|
676
813
|
|
|
677
|
-
//userId
|
|
678
|
-
|
|
814
|
+
//userId, 呼叫統計(staToken)以此為「誰在呼叫」: 系統服務用途金鑰之 userId 欄為建立者(稽核用, 非身分; ADR-095),
|
|
815
|
+
//統計改記其應用系統身分 app:<金鑰主鍵>, 否則其用量被合併到建立者名下 (外審 sol#11)
|
|
816
|
+
let usageLog = getAppUsage(tk)
|
|
817
|
+
let userId = (get(tk, 'isApp', '') === 'y' && (usageLog === 'system' || usageLog === keyAppUsageRetired)) ? getAppId(tk) : get(tk, 'userId', '')
|
|
679
818
|
|
|
680
819
|
//_checkTokenByObj
|
|
681
820
|
let b = await _checkTokenByObj(tk, opt)
|
|
@@ -797,6 +936,12 @@ function proc(woItems, procOrm, { srLog, srEmail, salt, minExpired, kpLang, pass
|
|
|
797
936
|
let tk = get(tks, 0, '')
|
|
798
937
|
// console.log('tk', tk)
|
|
799
938
|
|
|
939
|
+
//應用系統金鑰不給期限, 無續期可言: 一律拒絕(固定錯誤鍵, ADR-095; 原會把 timeEnd 改為「現在+登入效期」而縮短之, S-3)
|
|
940
|
+
if (get(tk, 'isApp', '') === 'y') {
|
|
941
|
+
srLog.warn({ event: 'fun-refreshToken', key: 'tokenAppNoRefresh', token: maskToken(token) })
|
|
942
|
+
return Promise.reject('tokenAppNoRefresh')
|
|
943
|
+
}
|
|
944
|
+
|
|
800
945
|
//timeEnd
|
|
801
946
|
let timeEnd = get(tk, 'timeEnd', '')
|
|
802
947
|
|
|
@@ -820,6 +965,15 @@ function proc(woItems, procOrm, { srLog, srEmail, salt, minExpired, kpLang, pass
|
|
|
820
965
|
return Promise.reject(`tokenExpired`)
|
|
821
966
|
}
|
|
822
967
|
|
|
968
|
+
//使用者目前須可用(與登入同一判準, S-4): 不存在、停用、被手動封鎖、帳號到期或未驗證者不可續期
|
|
969
|
+
let live = await loadActor(tk)
|
|
970
|
+
.then((actor) => isActorLive(tk, actor))
|
|
971
|
+
.catch(() => false)
|
|
972
|
+
if (!live) {
|
|
973
|
+
console.log(`user is not available`)
|
|
974
|
+
return Promise.reject(`tokenExpired`)
|
|
975
|
+
}
|
|
976
|
+
|
|
823
977
|
//timeEndNew, 依照minExpired(min)更新到期時間
|
|
824
978
|
let timeEndNew = ot().add(minExpired, 'minute').format('YYYY-MM-DDTHH:mm:ss.SSSZ')
|
|
825
979
|
// console.log('timeEndNew', timeEndNew)
|
|
@@ -1080,6 +1234,11 @@ function proc(woItems, procOrm, { srLog, srEmail, salt, minExpired, kpLang, pass
|
|
|
1080
1234
|
//verifyEmail
|
|
1081
1235
|
let verifyEmail = async (token) => {
|
|
1082
1236
|
|
|
1237
|
+
//check allowUserRegistration, 驗證信連結為自助註冊之附屬入口, 隨註冊開關(關閉即一併拒絕, 固定鍵, 不看 token; S-6、原則 13)
|
|
1238
|
+
if (!allowUserRegistration) {
|
|
1239
|
+
return Promise.reject('userRegistrationNotAllowed')
|
|
1240
|
+
}
|
|
1241
|
+
|
|
1083
1242
|
//check token
|
|
1084
1243
|
if (!isestr(token)) {
|
|
1085
1244
|
return Promise.reject('verifyEmailInvalidToken')
|
|
@@ -1131,6 +1290,11 @@ function proc(woItems, procOrm, { srLog, srEmail, salt, minExpired, kpLang, pass
|
|
|
1131
1290
|
//resendVerifyEmail
|
|
1132
1291
|
let resendVerifyEmail = async (lang, account, email) => {
|
|
1133
1292
|
|
|
1293
|
+
//check allowUserRegistration, 重寄驗證信為自助註冊之附屬入口, 隨註冊開關(關閉即一併拒絕, 固定鍵; S-6、原則 13)
|
|
1294
|
+
if (!allowUserRegistration) {
|
|
1295
|
+
return Promise.reject('userRegistrationNotAllowed')
|
|
1296
|
+
}
|
|
1297
|
+
|
|
1134
1298
|
//check
|
|
1135
1299
|
if (!isestr(lang)) {
|
|
1136
1300
|
lang = 'eng'
|
|
@@ -1290,9 +1454,17 @@ function proc(woItems, procOrm, { srLog, srEmail, salt, minExpired, kpLang, pass
|
|
|
1290
1454
|
//checkTokenAndChangePassword
|
|
1291
1455
|
let checkTokenAndChangePassword = async (token, lang, oldPassword, newPassword) => {
|
|
1292
1456
|
|
|
1293
|
-
//checkToken
|
|
1457
|
+
//checkToken (使用者 token 與使用者用途亦隨使用者當前狀態判定, S-4)
|
|
1294
1458
|
await checkToken(token)
|
|
1295
1459
|
|
|
1460
|
+
//actor, 改密碼之對象為權杖所代表之使用者本人: 使用者 token、使用者用途(所綁使用者, 須舊密碼)可; 系統服務用途不綁使用者, 無本人可改, 一律拒絕 (ADR-095)
|
|
1461
|
+
let actor = await getActorByToken(token)
|
|
1462
|
+
if (actor.kind === 'appSystem') {
|
|
1463
|
+
srLog.warn({ event: 'fun-changePassword', key: 'tokenUserOnly', token: maskToken(token) })
|
|
1464
|
+
return Promise.reject('tokenUserOnly')
|
|
1465
|
+
}
|
|
1466
|
+
let userId = actor.id
|
|
1467
|
+
|
|
1296
1468
|
//check
|
|
1297
1469
|
if (!isestr(lang)) {
|
|
1298
1470
|
lang = 'eng'
|
|
@@ -1303,18 +1475,26 @@ function proc(woItems, procOrm, { srLog, srEmail, salt, minExpired, kpLang, pass
|
|
|
1303
1475
|
return Promise.reject('userChangePasswordFail')
|
|
1304
1476
|
}
|
|
1305
1477
|
|
|
1306
|
-
//getUserByToken
|
|
1307
|
-
let uToken = await getUserByToken(token)
|
|
1308
|
-
let userId = get(uToken, 'id', '')
|
|
1309
|
-
|
|
1310
1478
|
//序列化同 userId 之並行 change-password 請求: 防 lost update + 重複寄信.
|
|
1311
1479
|
//第二次同 userId 進入時 mutex 序列化, 第二次因 password 已被第一次改, 走既有
|
|
1312
1480
|
//'incorrect old password' reject 路徑, 自然不會多寄信.
|
|
1313
1481
|
return await kmx(`changeUserPassword:${userId}`, async () => {
|
|
1314
1482
|
|
|
1315
|
-
|
|
1316
|
-
//驗證所依之 DB 雜湊與寫入間不被其他寫入者(
|
|
1317
|
-
|
|
1483
|
+
//讀取、驗舊密碼、撤銷其他 session 與寫入於 [tokens, users] 表鎖內(S07; kmx 在外層、表鎖在內層): password 為伺服器專有欄位、isForceChangePw 為雙方欄位(系統直寫須取表鎖),
|
|
1484
|
+
//驗證所依之 DB 雜湊與寫入間不被其他寫入者(重設密碼、後台存檔、登入建立 session)插隊; 只改不增, 列已被刪則拒絕而不新增殘缺列 (X5)
|
|
1485
|
+
//改密碼後之 session 處置 (R-SESS-01, ADR-093): 保留發出此請求之目前 session(token), 撤銷該使用者其他所有 session 權杖; app 權杖不是 session, 不撤銷
|
|
1486
|
+
let { u, email } = await withTabLocks(['tokens', 'users'], async () => {
|
|
1487
|
+
|
|
1488
|
+
//鎖內再驗呼叫所用之權杖仍有效 (外審 sol#1): 鎖外之 checkToken 通過後、等鎖期間該 session 可能已被同使用者另一個改密碼請求或管理員重設撤銷,
|
|
1489
|
+
//被撤銷之權杖不得再改密碼(否則「保留發出請求之目前 session」不成立, 該請求還會撤銷對方保留之 session); checkToken 只讀不取鎖, 可在鎖內呼叫
|
|
1490
|
+
await checkToken(token)
|
|
1491
|
+
|
|
1492
|
+
//鎖內重新解析權杖所代表之身分, 須與鎖外相同(外審 sol#3): 等鎖期間該權杖列若被改綁(帶基準存檔改 userId)或用途改變, 鎖內驗證之身分與下面寫入之對象即不同
|
|
1493
|
+
//(解析失敗者如使用者已被刪, 照原路徑由後續讀取使用者之步驟拒絕, 沿用既有之對外鍵)
|
|
1494
|
+
let actorNow = await getActorByToken(token).catch(() => null)
|
|
1495
|
+
if (actorNow !== null && (actorNow.kind === 'appSystem' || actorNow.id !== userId)) {
|
|
1496
|
+
return Promise.reject('tokenExpired')
|
|
1497
|
+
}
|
|
1318
1498
|
|
|
1319
1499
|
//getGenUserByUserId (with password)
|
|
1320
1500
|
let u = await _getGenUserByKV('id', userId, { deletePassword: false })
|
|
@@ -1348,6 +1528,21 @@ function proc(woItems, procOrm, { srLog, srEmail, salt, minExpired, kpLang, pass
|
|
|
1348
1528
|
//hash newPassword
|
|
1349
1529
|
let passwordNew = hashPassword(newPassword, salt)
|
|
1350
1530
|
|
|
1531
|
+
//撤銷其他 session(先於密碼寫入, 驗證皆已通過): 撤銷失敗即 reject 且密碼不變, 不會出現「密碼已變更但舊 session 仍有效」(R-SESS-01)
|
|
1532
|
+
//(以布林旗標判失敗而非 errRevoke 是否為 null: reject 值可能為 null / undefined, 外審 sol#2)
|
|
1533
|
+
let revokeFailed = false
|
|
1534
|
+
let errRevoke = null
|
|
1535
|
+
let nRevoked = await revokeSessionTokensLocked(userId, token)
|
|
1536
|
+
.catch((err) => {
|
|
1537
|
+
revokeFailed = true
|
|
1538
|
+
errRevoke = err
|
|
1539
|
+
})
|
|
1540
|
+
if (revokeFailed) {
|
|
1541
|
+
srLog.error({ event: 'fun-changePassword-revokeSessions', key: 'userChangePasswordFail', userId, err: getErrorMessage(errRevoke) })
|
|
1542
|
+
return Promise.reject('userChangePasswordFail')
|
|
1543
|
+
}
|
|
1544
|
+
srLog.info({ event: 'fun-changePassword-revokeSessions', userId, nRevoked })
|
|
1545
|
+
|
|
1351
1546
|
//save (清 isForceChangePw='n', 變更密碼成功後即解除強制變更), 更新者記該使用者本人 (R-CONC-04)
|
|
1352
1547
|
//逐筆檢查(ADR-080): 寫入失敗即 reject, 不寄「密碼已變更」信
|
|
1353
1548
|
let errTemp = null
|
|
@@ -1419,8 +1614,7 @@ function proc(woItems, procOrm, { srLog, srEmail, salt, minExpired, kpLang, pass
|
|
|
1419
1614
|
//
|
|
1420
1615
|
//回傳: { state:'success' } (不含明文密碼, 避免操作者得知)
|
|
1421
1616
|
//失敗 reject:
|
|
1422
|
-
// - token 無效 / 過期
|
|
1423
|
-
// - 操作者非 admin: 'forbidden'
|
|
1617
|
+
// - token 無效 / 過期 / 操作者非管理員(已驗證、未過期、未封鎖、isAdmin='y'、啟用, 同 funCheckAdmin) / 應用系統金鑰缺 writeUsers: 'tokenExpired' (S-2, 與其他管理入口同鍵)
|
|
1424
1618
|
// - userId 空: 'invalid userId'
|
|
1425
1619
|
// - 目標 user 不存在: 'user not found'
|
|
1426
1620
|
// - 對自己觸發: 'cannot reset self'
|
|
@@ -1429,8 +1623,9 @@ function proc(woItems, procOrm, { srLog, srEmail, salt, minExpired, kpLang, pass
|
|
|
1429
1623
|
//寄信失敗 (SMTP 不通) 不視為錯誤, 密碼仍會寫入, 僅記 srLog.error
|
|
1430
1624
|
let adminResetUserPassword = async (token, lang, targetUserId) => {
|
|
1431
1625
|
|
|
1432
|
-
//checkToken,
|
|
1433
|
-
|
|
1626
|
+
//checkToken, 管理員判定與其他管理入口相同(funCheckAdmin: 已驗證、未過期、未封鎖、isAdmin='y'、啟用; 使用者用途依所綁使用者), 非管理員回相同錯誤鍵 tokenExpired (S-2);
|
|
1627
|
+
//系統服務用途須具 writeUsers(其虛擬使用者 isAdmin='y', 故授權不看該欄; ADR-069)
|
|
1628
|
+
await checkToken(token, { fun: funCheckAdmin, perm: 'writeUsers' })
|
|
1434
1629
|
|
|
1435
1630
|
//check lang
|
|
1436
1631
|
if (!isestr(lang)) {
|
|
@@ -1442,14 +1637,9 @@ function proc(woItems, procOrm, { srLog, srEmail, salt, minExpired, kpLang, pass
|
|
|
1442
1637
|
return Promise.reject('anUnexpectedErrorOccurred')
|
|
1443
1638
|
}
|
|
1444
1639
|
|
|
1445
|
-
//
|
|
1446
|
-
let
|
|
1447
|
-
let operatorId =
|
|
1448
|
-
|
|
1449
|
-
//operator 必須為 admin
|
|
1450
|
-
if (get(uOperator, 'isAdmin', '') !== 'y') {
|
|
1451
|
-
return Promise.reject('adminResetPasswordForbidden')
|
|
1452
|
-
}
|
|
1640
|
+
//actor (操作者): 使用者 token / 使用者用途為使用者本人(id 為使用者主鍵), 系統服務用途為應用系統身分(id 為 app:<tokens.id>)
|
|
1641
|
+
let actor = await getActorByToken(token)
|
|
1642
|
+
let operatorId = actor.id
|
|
1453
1643
|
|
|
1454
1644
|
//不可對自己觸發
|
|
1455
1645
|
if (operatorId === targetUserId) {
|
|
@@ -1468,9 +1658,10 @@ function proc(woItems, procOrm, { srLog, srEmail, salt, minExpired, kpLang, pass
|
|
|
1468
1658
|
return Promise.reject('adminResetPasswordAlreadyTriggered')
|
|
1469
1659
|
}
|
|
1470
1660
|
|
|
1471
|
-
//目標 user
|
|
1661
|
+
//目標 user 查找、撤銷其全部 session 與寫入於 [tokens, users] 表鎖內(S08; kmx 在外層、表鎖在內層): password 為伺服器專有欄位、isForceChangePw 為雙方欄位(系統直寫須取表鎖);
|
|
1472
1662
|
//只改不增, 目標已被刪則拒絕而不新增殘缺列 (X5); 更新者記操作管理員 (R-CONC-04)
|
|
1473
|
-
|
|
1663
|
+
//改密碼後之 session 處置 (R-SESS-01, ADR-093): 撤銷對方全部 session 權杖(不含 app 權杖); 呼叫者(管理員 / app 權杖)自己之權杖不在撤銷範圍(目標不得為自己)
|
|
1664
|
+
let { targetAccount, targetName, targetEmail, newPassword } = await withTabLocks(['tokens', 'users'], async () => {
|
|
1474
1665
|
|
|
1475
1666
|
//目標 user (含 password 拿到也不用, 只是確認存在)
|
|
1476
1667
|
let uTarget = null
|
|
@@ -1491,9 +1682,26 @@ function proc(woItems, procOrm, { srLog, srEmail, salt, minExpired, kpLang, pass
|
|
|
1491
1682
|
//產生隨機新密碼 (符合 passwordPolicy + account 限制)
|
|
1492
1683
|
let newPassword = genRandomPassword(passwordPolicy, targetAccount)
|
|
1493
1684
|
|
|
1494
|
-
//hash
|
|
1495
|
-
//逐筆檢查(ADR-080): 寫入失敗即 reject, 不記節流、不寄出未生效之新密碼
|
|
1685
|
+
//hash
|
|
1496
1686
|
let hashed = hashPassword(newPassword, salt)
|
|
1687
|
+
|
|
1688
|
+
//撤銷對方全部 session(先於密碼寫入): 撤銷失敗即 reject 且密碼不變, 不會出現「密碼已重設但舊 session 仍有效」(R-SESS-01)
|
|
1689
|
+
//(以布林旗標判失敗而非 errRevoke 是否為 null: reject 值可能為 null / undefined, 外審 sol#2)
|
|
1690
|
+
let revokeFailed = false
|
|
1691
|
+
let errRevoke = null
|
|
1692
|
+
let nRevoked = await revokeSessionTokensLocked(targetUserId)
|
|
1693
|
+
.catch((err) => {
|
|
1694
|
+
revokeFailed = true
|
|
1695
|
+
errRevoke = err
|
|
1696
|
+
})
|
|
1697
|
+
if (revokeFailed) {
|
|
1698
|
+
srLog.error({ event: 'fun-adminResetUserPassword-revokeSessions', key: 'adminResetPasswordFailed', token: maskToken(token), targetUserId, err: getErrorMessage(errRevoke) })
|
|
1699
|
+
return Promise.reject('adminResetPasswordFailed')
|
|
1700
|
+
}
|
|
1701
|
+
srLog.info({ event: 'fun-adminResetUserPassword-revokeSessions', targetUserId, nRevoked })
|
|
1702
|
+
|
|
1703
|
+
//save (含 isForceChangePw='y')
|
|
1704
|
+
//逐筆檢查(ADR-080): 寫入失敗即 reject, 不記節流、不寄出未生效之新密碼
|
|
1497
1705
|
let errTemp = null
|
|
1498
1706
|
await procOrm(operatorId, 'users', 'save', [{
|
|
1499
1707
|
id: targetUserId,
|
|
@@ -1562,24 +1770,37 @@ function proc(woItems, procOrm, { srLog, srEmail, salt, minExpired, kpLang, pass
|
|
|
1562
1770
|
|
|
1563
1771
|
//revokeTokensByUserId: 撤銷(刪除)使用者名下全部 token, 供刪除 / 停用使用者(updateTabItems)與登入失敗封鎖(procProtect.blockAccount)共用.
|
|
1564
1772
|
//一次刪除該使用者全部 token 並逐筆檢查(ormWrite), 單筆失敗不中斷其餘筆, 有失敗即 reject 錯誤訊息(含失敗筆主鍵)供呼叫端記錄.
|
|
1565
|
-
//冪等(已無 token 時刪 0 筆), resolve 回傳刪除之 token 數.
|
|
1773
|
+
//冪等(已無 token 時刪 0 筆), resolve 回傳刪除之 token 數.
|
|
1774
|
+
//撤銷範圍 (ADR-095, 取代 ADR-037 之「名下一切權杖皆撤」): 該使用者之登入 token(isApp 非 'y'), 另依 opt.includeAppUser 含綁定該使用者之使用者用途金鑰(isApp='y' 且 appUsage='user');
|
|
1775
|
+
//系統服務用途金鑰(含既有無用途欄之列)之 userId 只記建立者(稽核), 不是身分, 建立者被停用 / 刪除 / 封鎖時一律不撤銷.
|
|
1776
|
+
//opt.includeAppUser: 預設 false(登入失敗封鎖、權杖呼叫超限封鎖: 使用者用途金鑰隨所綁使用者之封鎖狀態即時不可用、封鎖到期後恢復, 不刪除,
|
|
1777
|
+
//免得他人以刻意登入失敗使整合金鑰被刪); 刪除 / 停用使用者(updateTabItems users 路徑)給 true: 所綁使用者已不存在或停用, 金鑰隨之撤銷(重新啟用後不恢復).
|
|
1566
1778
|
//S09: 對外之 revokeTokensByUserId 自取 tokens 表鎖; 上游已持 tokens 鎖者(updateTabItems users 路徑、procProtect 封鎖, 皆在 [tokens, users] 鎖內)
|
|
1567
1779
|
//須呼叫 revokeTokensByUserIdLocked(持鎖版), 不可重入 (規格 §7)
|
|
1568
|
-
let revokeTokensByUserId = async (userId) => {
|
|
1569
|
-
return await withTabLocks(['tokens'], () => revokeTokensByUserIdLocked(userId))
|
|
1780
|
+
let revokeTokensByUserId = async (userId, opt = {}) => {
|
|
1781
|
+
return await withTabLocks(['tokens'], () => revokeTokensByUserIdLocked(userId, opt))
|
|
1570
1782
|
}
|
|
1571
1783
|
|
|
1572
1784
|
|
|
1573
1785
|
//revokeTokensByUserIdLocked, 須於 tokens 表鎖內呼叫
|
|
1574
|
-
let revokeTokensByUserIdLocked = async (userId) => {
|
|
1786
|
+
let revokeTokensByUserIdLocked = async (userId, opt = {}) => {
|
|
1575
1787
|
|
|
1576
1788
|
//check
|
|
1577
1789
|
if (!isestr(userId)) {
|
|
1578
1790
|
return Promise.reject(`invalid userId`)
|
|
1579
1791
|
}
|
|
1580
1792
|
|
|
1581
|
-
//
|
|
1793
|
+
//includeAppUser
|
|
1794
|
+
let includeAppUser = get(opt, 'includeAppUser') === true
|
|
1795
|
+
|
|
1796
|
+
//ts, 登入 token, 與(依 opt)綁定該使用者之使用者用途金鑰
|
|
1582
1797
|
let ts = await woItems.tokens.select({ userId })
|
|
1798
|
+
ts = filter(ts, (t) => {
|
|
1799
|
+
if (get(t, 'isApp', '') !== 'y') {
|
|
1800
|
+
return true
|
|
1801
|
+
}
|
|
1802
|
+
return includeAppUser && getAppUsage(t) === 'user'
|
|
1803
|
+
})
|
|
1583
1804
|
|
|
1584
1805
|
//check
|
|
1585
1806
|
if (size(ts) === 0) {
|
|
@@ -1595,6 +1816,40 @@ function proc(woItems, procOrm, { srLog, srEmail, salt, minExpired, kpLang, pass
|
|
|
1595
1816
|
}
|
|
1596
1817
|
|
|
1597
1818
|
|
|
1819
|
+
//revokeSessionTokensLocked: 改密碼後之 session 處置 (R-SESS-01, ADR-093), 須於 [tokens, users] 表鎖內呼叫(與密碼寫入同一組鎖, 不可重入).
|
|
1820
|
+
//只撤銷 userId 名下之 session 權杖(isApp !== 'y', 即使用者登入所發); app 權杖(isApp === 'y')不是 session, 其 userId 為擁有者, 不撤銷
|
|
1821
|
+
//(與 revokeTokensByUserIdLocked 之刪除 / 停用 / 封鎖情境不同: 該情境是使用者本身失效, 名下一切權杖皆撤).
|
|
1822
|
+
//exceptToken: 發出請求之目前 session 權杖字串, 該筆保留(使用者自行改密碼); 管理員重設不給, 全撤.
|
|
1823
|
+
//逐筆檢查(ormWrite), 單筆失敗不中斷其餘筆, 有失敗即 reject(含失敗筆主鍵), resolve 回傳撤銷筆數; 冪等(無可撤者回 0)
|
|
1824
|
+
let revokeSessionTokensLocked = async (userId, exceptToken = '') => {
|
|
1825
|
+
|
|
1826
|
+
//check
|
|
1827
|
+
if (!isestr(userId)) {
|
|
1828
|
+
return Promise.reject(`invalid userId`)
|
|
1829
|
+
}
|
|
1830
|
+
|
|
1831
|
+
//ts
|
|
1832
|
+
let ts = await woItems.tokens.select({ userId })
|
|
1833
|
+
|
|
1834
|
+
//tsDel, session 權杖且非目前 session
|
|
1835
|
+
let tsDel = filter(ts, (t) => {
|
|
1836
|
+
return get(t, 'isApp', '') !== 'y' && !(isestr(exceptToken) && get(t, 'token', '') === exceptToken)
|
|
1837
|
+
})
|
|
1838
|
+
|
|
1839
|
+
//check
|
|
1840
|
+
if (size(tsDel) === 0) {
|
|
1841
|
+
return 0
|
|
1842
|
+
}
|
|
1843
|
+
|
|
1844
|
+
//del
|
|
1845
|
+
await ormWrite(woItems.tokens, 'del', map(tsDel, (t) => {
|
|
1846
|
+
return { id: t.id }
|
|
1847
|
+
}))
|
|
1848
|
+
|
|
1849
|
+
return size(tsDel)
|
|
1850
|
+
}
|
|
1851
|
+
|
|
1852
|
+
|
|
1598
1853
|
//updateTabItems
|
|
1599
1854
|
//後台清單整表存檔(users / tokens / ips), 多人同時編輯之寫入契約 (原則 10; 規格 dspec/多人同時編輯之寫入契約.md; 規則帳本 rulebook_concurrency R-CONC-01~05):
|
|
1600
1855
|
//- 讀取、比對、驗證依賴庫內之項、diff、寫入、撤銷 token、清快取全程在該表表鎖內(users 為 [tokens, users], 因寫入後同鎖撤銷 token); 讀取為鎖內新鮮讀取(無 ORM 快取).
|
|
@@ -1770,7 +2025,6 @@ function proc(woItems, procOrm, { srLog, srEmail, salt, minExpired, kpLang, pass
|
|
|
1770
2025
|
//tokens 路徑: 清單存檔不得新增庫內不存在之 session 列(isApp 非 'y'; ADR-092), 不論帶不帶基準, 整次拒收(零寫入, 回固定語系鍵, 不回顯值):
|
|
1771
2026
|
//session 權杖只由登入產生, 後台清單本就無新增 session 列之入口 (ADR-042); 不帶基準時無從分辨「新增」與「載入後已被登出 / 自動封鎖撤銷之舊列」,
|
|
1772
2027
|
//送回舊列會使其復活而繞過撤銷. 例外: 帶基準而該列在 baselineSession 內者(載入時尚在, 其後被撤銷)不屬新增——管理員未動者下方略過、已動者拒收 saveStale.
|
|
1773
|
-
//應用系統金鑰列(isApp === 'y')新增、既有 session 列之刪除與升級為應用系統金鑰照舊.
|
|
1774
2028
|
if (woName === 'tokens') {
|
|
1775
2029
|
let idsBase = new Set(isBased ? [...po.baseline, ...po.baselineSession].map(([id]) => id) : [])
|
|
1776
2030
|
let rowSessionNew = rows.find((r) => get(r, 'isApp', '') !== 'y' && !nowById.has(r.id) && !idsBase.has(r.id))
|
|
@@ -1780,6 +2034,42 @@ function proc(woItems, procOrm, { srLog, srEmail, salt, minExpired, kpLang, pass
|
|
|
1780
2034
|
}
|
|
1781
2035
|
}
|
|
1782
2036
|
|
|
2037
|
+
//tokens 路徑 (ADR-095, 取代 ADR-042 / ADR-084 之「經清單鑄造」): 清單存檔只改不增、不改身分——
|
|
2038
|
+
//(a) 庫內不存在之應用系統金鑰列整次拒收 tokenAppAddNotAllowed: 應用系統金鑰只能經 createAppToken 鑄造(權杖字串由伺服端產生; 用途、綁定使用者與權限於鎖內驗證);
|
|
2039
|
+
//(b) 既有登入 token 不可升級為應用系統金鑰(isApp 由非 'y' 改 'y') → tokenSessionUpgradeNotAllowed: 登入 token 代表登入者本人且有期限, 升級會使其變成無期限之金鑰而不綁用途;
|
|
2040
|
+
//(c) 既有應用系統金鑰之權杖字串、userId(所綁使用者)、isApp、到期時間不可變更 → tokenAppLocked: 綁定決定其代表誰, 到期時間對應用系統金鑰無意義(不給期限);
|
|
2041
|
+
// 用途(appUsage)與名稱(appName)為伺服器專有欄位(契約 serverOnly), 存檔不採用客戶端值、不寫入; 可改者僅(系統服務用途之)權限.
|
|
2042
|
+
//全部於任何寫入之前判定, 零寫入; 對照庫內新鮮讀取之列(nowById), 與帶不帶基準無關
|
|
2043
|
+
if (woName === 'tokens') {
|
|
2044
|
+
let rowAppNew = rows.find((r) => get(r, 'isApp', '') === 'y' && !nowById.has(r.id))
|
|
2045
|
+
if (rowAppNew !== undefined) {
|
|
2046
|
+
srLog.warn({ event: 'fun-updateTabItems-reject', key: 'tokenAppAddNotAllowed', woName })
|
|
2047
|
+
return Promise.reject('tokenAppAddNotAllowed')
|
|
2048
|
+
}
|
|
2049
|
+
for (let row of rows) {
|
|
2050
|
+
let old = nowById.get(row.id)
|
|
2051
|
+
if (old === undefined) {
|
|
2052
|
+
continue
|
|
2053
|
+
}
|
|
2054
|
+
let oldIsApp = get(old, 'isApp', '') === 'y'
|
|
2055
|
+
let newIsApp = get(row, 'isApp', '') === 'y'
|
|
2056
|
+
if (!oldIsApp && newIsApp) {
|
|
2057
|
+
srLog.warn({ event: 'fun-updateTabItems-reject', key: 'tokenSessionUpgradeNotAllowed', woName })
|
|
2058
|
+
return Promise.reject('tokenSessionUpgradeNotAllowed')
|
|
2059
|
+
}
|
|
2060
|
+
if (oldIsApp) {
|
|
2061
|
+
let locked = !newIsApp ||
|
|
2062
|
+
get(row, 'token', '') !== get(old, 'token', '') ||
|
|
2063
|
+
get(row, 'userId', '') !== get(old, 'userId', '') ||
|
|
2064
|
+
get(row, 'timeEnd', '') !== get(old, 'timeEnd', '')
|
|
2065
|
+
if (locked) {
|
|
2066
|
+
srLog.warn({ event: 'fun-updateTabItems-reject', key: 'tokenAppLocked', woName })
|
|
2067
|
+
return Promise.reject('tokenAppLocked')
|
|
2068
|
+
}
|
|
2069
|
+
}
|
|
2070
|
+
}
|
|
2071
|
+
}
|
|
2072
|
+
|
|
1783
2073
|
//users 路徑: account 唯一性 + 非空驗證 (補 id/email 之外的 account; 防直打 API 寫入空/重複帳號).
|
|
1784
2074
|
//(a) 空值 → reject 'accountRequired'; (b) 本批內重複 或 與既有其他 user 之 account 衝突 → reject 'accountDuplicate'.
|
|
1785
2075
|
//帳號全域唯一, 與既有比對時排除「本批同 id 之自身既有列」(更新自己時 account 可維持不變).
|
|
@@ -1817,6 +2107,12 @@ function proc(woItems, procOrm, { srLog, srEmail, salt, minExpired, kpLang, pass
|
|
|
1817
2107
|
if (errAccount !== null) {
|
|
1818
2108
|
return Promise.reject(errAccount)
|
|
1819
2109
|
}
|
|
2110
|
+
|
|
2111
|
+
//新增列之使用者主鍵不得落在系統服務用途之保留前綴(app:): 該前綴為應用系統身分(getUserByToken 之 id)專用, 使用者主鍵與之相撞會使下游把應用系統誤認為該使用者 (ADR-095);
|
|
2112
|
+
//只檢查庫內不存在之新增列, 既有列不受影響(不使一列之既有資料問題擋住整份清單存檔, 同 ADR-094)
|
|
2113
|
+
if (rows.some((row) => !nowById.has(row.id) && isAppIdLike(row.id))) {
|
|
2114
|
+
return Promise.reject('invalidRows')
|
|
2115
|
+
}
|
|
1820
2116
|
}
|
|
1821
2117
|
|
|
1822
2118
|
//tokens 路徑: 本批有變動(或新增)之列須為未設定或已登錄權限字串之陣列, 任一列不合法則整批 reject 不寫入 (ADR-069).
|
|
@@ -1837,6 +2133,10 @@ function proc(woItems, procOrm, { srLog, srEmail, salt, minExpired, kpLang, pass
|
|
|
1837
2133
|
if (!isAppPermsValue(perms)) {
|
|
1838
2134
|
return Promise.reject('tokenPermsInvalid')
|
|
1839
2135
|
}
|
|
2136
|
+
//使用者用途之權限即所綁使用者之權限, perms 不適用: 不得被設定 (ADR-095)
|
|
2137
|
+
if (old !== undefined && get(old, 'isApp', '') === 'y' && getAppUsage(old) === 'user' && size(normAppPerms(perms)) > 0) {
|
|
2138
|
+
return Promise.reject('tokenAppPermsNotForUser')
|
|
2139
|
+
}
|
|
1840
2140
|
}
|
|
1841
2141
|
}
|
|
1842
2142
|
|
|
@@ -1886,14 +2186,15 @@ function proc(woItems, procOrm, { srLog, srEmail, salt, minExpired, kpLang, pass
|
|
|
1886
2186
|
if (digestRow(sub, contract) === dg) {
|
|
1887
2187
|
continue
|
|
1888
2188
|
}
|
|
1889
|
-
//管理員有動: 已不在庫內或庫內已變 → 拒收; 否則修改(
|
|
2189
|
+
//管理員有動: 已不在庫內或庫內已變 → 拒收; 否則修改(升級為應用系統金鑰已於上方拒收, ADR-095)
|
|
1890
2190
|
if (!live || changedS.has(id)) {
|
|
1891
2191
|
return Promise.reject('saveStale')
|
|
1892
2192
|
}
|
|
1893
2193
|
mods.push(subNorm.get(id))
|
|
1894
2194
|
}
|
|
1895
2195
|
|
|
1896
|
-
//基準之外之列(
|
|
2196
|
+
//基準之外之列(管理員送入而基準與庫內皆無): 上方已拒收(新增 session 列 tokenSessionAddNotAllowed、新增應用系統金鑰列 tokenAppAddNotAllowed),
|
|
2197
|
+
//此處僅剩「他人載入後新增而撞 id」之列(庫內已有、基準內無): 拒收
|
|
1897
2198
|
for (let [id] of subRaw) {
|
|
1898
2199
|
if (baseA.has(id) || baseS.has(id)) {
|
|
1899
2200
|
continue
|
|
@@ -1901,16 +2202,15 @@ function proc(woItems, procOrm, { srLog, srEmail, salt, minExpired, kpLang, pass
|
|
|
1901
2202
|
if (nowById.has(id)) {
|
|
1902
2203
|
return Promise.reject('saveStale')
|
|
1903
2204
|
}
|
|
1904
|
-
adds.push(subNorm.get(id))
|
|
1905
2205
|
}
|
|
1906
2206
|
|
|
1907
2207
|
}
|
|
1908
2208
|
else if (woName === 'tokens') {
|
|
1909
2209
|
|
|
1910
|
-
//不帶基準(app 權杖直呼、已開啟之舊版頁面): 刪除與修改只處理應用系統金鑰列(庫內 isApp === 'y'
|
|
1911
|
-
|
|
1912
|
-
//不刪、不以送入值覆蓋, 載入後才登入之 session 因而不被誤刪 (E1, D3).
|
|
1913
|
-
|
|
2210
|
+
//不帶基準(app 權杖直呼、已開啟之舊版頁面): 刪除與修改只處理應用系統金鑰列(庫內 isApp === 'y');
|
|
2211
|
+
//session 列(登入新增、續期改 timeEnd、登出或封鎖刪除, 系統頻繁增刪)
|
|
2212
|
+
//不刪、不以送入值覆蓋, 載入後才登入之 session 因而不被誤刪 (E1, D3). 新增列已於上方拒收(ADR-095), 升級為應用系統金鑰亦已拒收;
|
|
2213
|
+
//此路徑無基準可辨是否為已被撤銷之 session, 送回之舊 session 列由 ADR-092 之守門拒收
|
|
1914
2214
|
each(ltdtOld, (r) => {
|
|
1915
2215
|
if (isApp(r) && !subRaw.has(r.id)) {
|
|
1916
2216
|
dels.push(r)
|
|
@@ -1919,7 +2219,6 @@ function proc(woItems, procOrm, { srLog, srEmail, salt, minExpired, kpLang, pass
|
|
|
1919
2219
|
for (let [id, sub] of subNorm) {
|
|
1920
2220
|
let old = nowById.get(id)
|
|
1921
2221
|
if (old === undefined) {
|
|
1922
|
-
adds.push(sub)
|
|
1923
2222
|
continue
|
|
1924
2223
|
}
|
|
1925
2224
|
if (!isApp(old) && !isApp(sub)) {
|
|
@@ -2053,14 +2352,8 @@ function proc(woItems, procOrm, { srLog, srEmail, salt, minExpired, kpLang, pass
|
|
|
2053
2352
|
|
|
2054
2353
|
//add
|
|
2055
2354
|
if (size(rowsAdd) > 0) {
|
|
2056
|
-
|
|
2057
|
-
|
|
2058
|
-
//擁有者為空者以操作者補, 不再寫成無擁有者之金鑰
|
|
2059
|
-
await procOrm(operatorId, woName, 'insert', rowsAdd, { keepUserId: true })
|
|
2060
|
-
}
|
|
2061
|
-
else {
|
|
2062
|
-
await procOrm(operatorId, woName, 'insert', rowsAdd)
|
|
2063
|
-
}
|
|
2355
|
+
//tokens 路徑不會有新增列(已於上方拒收, 應用系統金鑰只經 createAppToken 鑄造, ADR-095); 原 keepUserId 分組寫入(ADR-084)隨之移至 createAppToken
|
|
2356
|
+
await procOrm(operatorId, woName, 'insert', rowsAdd)
|
|
2064
2357
|
}
|
|
2065
2358
|
|
|
2066
2359
|
//mod
|
|
@@ -2083,7 +2376,7 @@ function proc(woItems, procOrm, { srLog, srEmail, salt, minExpired, kpLang, pass
|
|
|
2083
2376
|
if (woName === 'users') {
|
|
2084
2377
|
for (let row of dels) {
|
|
2085
2378
|
let userId = get(row, 'id', '')
|
|
2086
|
-
await revokeTokensByUserIdLocked(userId)
|
|
2379
|
+
await revokeTokensByUserIdLocked(userId, { includeAppUser: true }) //刪除使用者: 其登入 token 與綁其之使用者用途金鑰皆撤銷, 系統服務用途金鑰不動 (ADR-095)
|
|
2087
2380
|
.catch((err) => {
|
|
2088
2381
|
srLog.error({ event: 'fun-updateTabItems-revokeTokenOnDelete', userId, err: getErrorMessage(err) })
|
|
2089
2382
|
})
|
|
@@ -2093,7 +2386,7 @@ function proc(woItems, procOrm, { srLog, srEmail, salt, minExpired, kpLang, pass
|
|
|
2093
2386
|
continue
|
|
2094
2387
|
}
|
|
2095
2388
|
let userId = get(row, 'id', '')
|
|
2096
|
-
await revokeTokensByUserIdLocked(userId)
|
|
2389
|
+
await revokeTokensByUserIdLocked(userId, { includeAppUser: true }) //停用使用者: 同上 (停用後重新啟用不恢復已撤銷之金鑰)
|
|
2097
2390
|
.catch((err) => {
|
|
2098
2391
|
srLog.error({ event: 'fun-updateTabItems-revokeTokenOnDisable', userId, err: getErrorMessage(err) })
|
|
2099
2392
|
})
|
|
@@ -2149,92 +2442,18 @@ function proc(woItems, procOrm, { srLog, srEmail, salt, minExpired, kpLang, pass
|
|
|
2149
2442
|
|
|
2150
2443
|
|
|
2151
2444
|
//getUserByToken
|
|
2445
|
+
//反查權杖所代表之身分(ADR-095), 權杖此刻須可用(使用者 token 未逾期; 使用者 token 與使用者用途之使用者目前可用, 與登入同一判準 S-4); 不可用 reject:
|
|
2446
|
+
//- 使用者 token: 該使用者之資料, isApp='n'
|
|
2447
|
+
//- 應用系統金鑰・使用者用途: 所綁使用者之實際資料, isApp='y'
|
|
2448
|
+
//- 應用系統金鑰・系統服務用途: 應用系統身分, isApp='y'、isAdmin='y'; id 為 'app:<tokens.id>'(穩定, 不與使用者主鍵相撞), name 為金鑰名稱, 其餘欄位為佔位字串
|
|
2152
2449
|
let getUserByToken = async (token) => {
|
|
2153
2450
|
|
|
2154
|
-
//
|
|
2155
|
-
let
|
|
2156
|
-
//console.log(`...tokens.select`)
|
|
2157
|
-
|
|
2158
|
-
//ntks
|
|
2159
|
-
let ntks = size(tks)
|
|
2160
|
-
|
|
2161
|
-
//check
|
|
2162
|
-
if (ntks === 0) {
|
|
2163
|
-
// console.log(`token`, token)
|
|
2164
|
-
console.log(`invalid token`)
|
|
2165
|
-
return Promise.reject(`invalid token`)
|
|
2166
|
-
}
|
|
2167
|
-
|
|
2168
|
-
//check
|
|
2169
|
-
if (ntks >= 2) {
|
|
2170
|
-
// console.log(`token`, token)
|
|
2171
|
-
console.log(`duplicate tokens`)
|
|
2172
|
-
return Promise.reject(`duplicate tokens`)
|
|
2173
|
-
}
|
|
2174
|
-
|
|
2175
|
-
//tk
|
|
2176
|
-
let tk = get(tks, 0, null)
|
|
2177
|
-
// console.log('tk', tk)
|
|
2178
|
-
|
|
2179
|
-
//isApp
|
|
2180
|
-
let isApp = get(tk, 'isApp', '')
|
|
2181
|
-
// console.log('isApp', isApp)
|
|
2182
|
-
|
|
2183
|
-
//u
|
|
2184
|
-
let u = null
|
|
2185
|
-
if (isApp !== 'y') {
|
|
2186
|
-
//token來自使用者
|
|
2451
|
+
//actor
|
|
2452
|
+
let actor = await getActorByToken(token)
|
|
2187
2453
|
|
|
2188
|
-
|
|
2189
|
-
|
|
2190
|
-
|
|
2191
|
-
|
|
2192
|
-
//getGenUserByUserId
|
|
2193
|
-
u = await getGenUserByUserId(userId)
|
|
2194
|
-
|
|
2195
|
-
}
|
|
2196
|
-
else {
|
|
2197
|
-
//token來自應用系統, 另外提供虛擬使用者資訊
|
|
2198
|
-
|
|
2199
|
-
//userId
|
|
2200
|
-
let userId = get(tk, 'userId', '')
|
|
2201
|
-
// console.log('userId', userId)
|
|
2202
|
-
|
|
2203
|
-
//check
|
|
2204
|
-
if (!isestr(userId)) {
|
|
2205
|
-
// console.log(`tk`, tk)
|
|
2206
|
-
console.log(`invalid userId from token`)
|
|
2207
|
-
return Promise.reject(`invalid userId from token`)
|
|
2208
|
-
}
|
|
2209
|
-
|
|
2210
|
-
// //timeEnd
|
|
2211
|
-
// let timeEnd = get(tk, 'timeEnd', '')
|
|
2212
|
-
// // console.log('timeEnd', timeEnd)
|
|
2213
|
-
|
|
2214
|
-
// //check
|
|
2215
|
-
// if (!istimemsTZ(timeEnd)) {
|
|
2216
|
-
// console.log(`timeEnd`, timeEnd)
|
|
2217
|
-
// console.log(`invalid timeEnd`)
|
|
2218
|
-
// return Promise.reject(`invalid timeEnd`)
|
|
2219
|
-
// }
|
|
2220
|
-
|
|
2221
|
-
//u
|
|
2222
|
-
u = {
|
|
2223
|
-
id: userId,
|
|
2224
|
-
account: 'no account',
|
|
2225
|
-
name: 'no name',
|
|
2226
|
-
email: 'no email',
|
|
2227
|
-
description: 'no description',
|
|
2228
|
-
from: 'no from',
|
|
2229
|
-
redir: 'no redir',
|
|
2230
|
-
isAdmin: 'y', //應用系統代表為系統管理員
|
|
2231
|
-
timeVerified: '2000-01-01T00:00:00.000+08:00', //應用系統代表為已驗證
|
|
2232
|
-
timeExpired: '',
|
|
2233
|
-
timeBlocked: '',
|
|
2234
|
-
isActive: 'y',
|
|
2235
|
-
}
|
|
2236
|
-
|
|
2237
|
-
}
|
|
2454
|
+
//u, isApp
|
|
2455
|
+
let u = actor.user
|
|
2456
|
+
let isApp = actor.kind === 'user' ? 'n' : 'y'
|
|
2238
2457
|
|
|
2239
2458
|
//uu
|
|
2240
2459
|
let uu = {
|
|
@@ -2259,12 +2478,13 @@ function proc(woItems, procOrm, { srLog, srEmail, salt, minExpired, kpLang, pass
|
|
|
2259
2478
|
|
|
2260
2479
|
|
|
2261
2480
|
//checkTokenAndGetUserByToken
|
|
2481
|
+
//tokenSelf 為查詢方(驗有效與權限), tokenTarget 只用以解析對象; 目標權杖須此刻可用(未逾期, 使用者目前可用), 逾期、查無或不可用一律回 null (S-5; 對外為固定鍵 tokenNoPermission)
|
|
2262
2482
|
let checkTokenAndGetUserByToken = async (tokenSelf, tokenTarget, opt = {}) => {
|
|
2263
2483
|
|
|
2264
2484
|
//checkToken
|
|
2265
2485
|
await checkToken(tokenSelf, opt) //resolve僅回傳true, reject代表無效token或檢測token發生錯誤
|
|
2266
2486
|
|
|
2267
|
-
//getUserByToken
|
|
2487
|
+
//getUserByToken, 內含目標權杖之逾期與使用者狀態判定
|
|
2268
2488
|
let u = await getUserByToken(tokenTarget).catch(() => null)
|
|
2269
2489
|
|
|
2270
2490
|
return u
|
|
@@ -2429,9 +2649,9 @@ function proc(woItems, procOrm, { srLog, srEmail, salt, minExpired, kpLang, pass
|
|
|
2429
2649
|
lang = 'eng'
|
|
2430
2650
|
}
|
|
2431
2651
|
|
|
2432
|
-
//取操作者 id (用於 audit fields userId/userIdUpdate 與 self-lockout 檢查)
|
|
2433
|
-
let
|
|
2434
|
-
let operatorId =
|
|
2652
|
+
//取操作者 id (用於 audit fields userId/userIdUpdate 與 self-lockout 檢查): 使用者 token / 使用者用途為使用者本人, 系統服務用途為 app:<tokens.id>
|
|
2653
|
+
let actor = await getActorByToken(token)
|
|
2654
|
+
let operatorId = actor.id
|
|
2435
2655
|
|
|
2436
2656
|
//rows 來自使用端, 須為陣列才可走訪: 帶數字 length 之物件經 lodash each 會改走索引 0..length-1 (length 極大時空轉阻塞事件迴圈, 且真實鍵被略過) (R-OBJ-ITER-01);
|
|
2437
2657
|
//資料通道入口 (WWebSso updateUsersList) 已以 isearr 守門, 此為縱深, 並使本函數單獨呼叫時亦與 updateTabItems 同回 invalidRows
|
|
@@ -2439,8 +2659,9 @@ function proc(woItems, procOrm, { srLog, srEmail, salt, minExpired, kpLang, pass
|
|
|
2439
2659
|
return Promise.reject('invalidRows')
|
|
2440
2660
|
}
|
|
2441
2661
|
|
|
2442
|
-
|
|
2443
|
-
|
|
2662
|
+
//自我保護適用於代表使用者本人之操作者(使用者 token、使用者用途——後者即所綁使用者, 不得刪除、降權、停用自己, 亦因此不能變更所綁使用者自己之 isActive; ADR-095);
|
|
2663
|
+
//系統服務用途之操作者為應用系統身分, users 表無其列, 無「自己」可刪除/降權/停用 (ADR-069)
|
|
2664
|
+
let isAppOperator = actor.kind === 'appSystem'
|
|
2444
2665
|
if (!isAppOperator) {
|
|
2445
2666
|
|
|
2446
2667
|
//自我鎖死保護: 若 rows 內含操作者自己, 且操作者把自己 isAdmin/isActive 改成非 'y', reject
|
|
@@ -2490,7 +2711,15 @@ function proc(woItems, procOrm, { srLog, srEmail, salt, minExpired, kpLang, pass
|
|
|
2490
2711
|
|
|
2491
2712
|
//list 包含過期 token 供 admin 判斷.
|
|
2492
2713
|
|
|
2493
|
-
|
|
2714
|
+
//尚未定案之舊應用系統金鑰列(缺欄或 ''; 遷移進行中 / 失敗 / 啟動後才直寫庫): 回傳即時判定之用途('system' 或 'retired', 與授權判定 loadActor 同一判準與同一伺服器時間),
|
|
2715
|
+
//使後台顯示與統計(getTokensListCache)皆與授權一致, 不由前端以瀏覽器時間重新推算 (外審 sol F2 / F3 / F4); appUsage 為伺服器專有欄位, 不入寫入基準, 清單存檔不採用客戶端值, 故不影響存檔
|
|
2716
|
+
let tn = ot().format('YYYY-MM-DDTHH:mm:ss.SSSZ')
|
|
2717
|
+
return ts.map((t) => {
|
|
2718
|
+
if (isLegacyAppToken(t)) {
|
|
2719
|
+
return { ...t, appUsage: classifyLegacyAppToken(t, tn) }
|
|
2720
|
+
}
|
|
2721
|
+
return t
|
|
2722
|
+
})
|
|
2494
2723
|
}
|
|
2495
2724
|
|
|
2496
2725
|
|
|
@@ -2545,8 +2774,8 @@ function proc(woItems, procOrm, { srLog, srEmail, salt, minExpired, kpLang, pass
|
|
|
2545
2774
|
await checkToken(token, opt) //resolve僅回傳true, reject代表無效token或檢測token發生錯誤
|
|
2546
2775
|
|
|
2547
2776
|
//操作者 id (雙擊防護之占位 key)
|
|
2548
|
-
let
|
|
2549
|
-
let operatorId =
|
|
2777
|
+
let actor = await getActorByToken(token)
|
|
2778
|
+
let operatorId = actor.id
|
|
2550
2779
|
|
|
2551
2780
|
//雙擊防護(後端): 同一操作者之權杖清單儲存處理中再送出即拒絕 (見 lockSave, ADR-074)
|
|
2552
2781
|
return await lockSave('updateTokensList', operatorId, async () => {
|
|
@@ -2559,6 +2788,226 @@ function proc(woItems, procOrm, { srLog, srEmail, salt, minExpired, kpLang, pass
|
|
|
2559
2788
|
}
|
|
2560
2789
|
|
|
2561
2790
|
|
|
2791
|
+
//migrateLegacyAppTokens (ADR-095 補記; 升級不得使已失效之應用系統金鑰復活, 原則 二.8 改版預設相容)
|
|
2792
|
+
//升級前建立之應用系統金鑰列(isApp='y' 且 appUsage 缺欄 / null / ''; 兩種用途出現前之列)逐列一次性定案, 由伺服器於啟動時呼叫(WWebSso):
|
|
2793
|
+
//- 升級前可用(timeEnd 為合法時間且現在 < timeEnd; 判準同升級前之 _checkTokenByObj, 見 classifyLegacyAppToken) → appUsage='system'(視為系統服務用途, 不設期限)
|
|
2794
|
+
//- 升級前不可用(已逾期、無 timeEnd、timeEnd 格式錯) → appUsage='retired'(維持失效); 列保留不刪, 後台仍可檢視與刪除
|
|
2795
|
+
//為何須在啟動時定案、不於讀取時推導: 「升級前已逾期」是升級當下的時間點事實, 事後無法由欄位推回(升級時未逾期者日後也會成為過去值), 且金鑰改為不設期限後 timeEnd 不再生效;
|
|
2796
|
+
//定案後 appUsage 即為持久標記: 重啟只處理仍缺欄者(冪等, 第二次起零寫入), 已定案之列的 timeEnd 與其他欄位一律不動(含 isApp / perms / userId / token, 不刪列)
|
|
2797
|
+
//寫入: [tokens] 表鎖內重讀庫內列(與 createAppToken / 清單存檔 / 續期 / 登出互斥), 經 procOrm 以 'system' 為更新者、只改不增(mustExist)、單批只寫 appUsage;
|
|
2798
|
+
// appUsage 屬 serverOnly 欄(src/writeContracts/tokens.mjs), 不入清單存檔之基準, 開啟中之清單不因遷移而過期; 寫入後清除權杖清單快取 (ADR-008)
|
|
2799
|
+
//未定案之舊列(遷移進行中、失敗或尚未執行)讀取時依升級前規則判定(loadActor), 永不比升級前更寬: 失敗時已逾期者仍失效、未逾期者仍依其 timeEnd(尚未改為不設期限), 重啟後重試
|
|
2800
|
+
//失敗(讀取 / 寫入 reject)記錄並 reject 固定鍵 tokenAppLegacyMigrateFailed; 已寫入之列保持定案
|
|
2801
|
+
//回傳 { marked, system, retired }: 本次寫入之列數與分項
|
|
2802
|
+
let migrateLegacyAppTokens = () => {
|
|
2803
|
+
|
|
2804
|
+
//進行中: 回同一個 promise(同時多次呼叫只做一次)
|
|
2805
|
+
if (legacyPm !== null) {
|
|
2806
|
+
return legacyPm
|
|
2807
|
+
}
|
|
2808
|
+
|
|
2809
|
+
legacyPm = withTabLocks(['tokens'], async () => {
|
|
2810
|
+
|
|
2811
|
+
//庫內全表重讀(鎖內)
|
|
2812
|
+
let ts = await woItems.tokens.select()
|
|
2813
|
+
|
|
2814
|
+
//逐列定案
|
|
2815
|
+
let tn = ot().format('YYYY-MM-DDTHH:mm:ss.SSSZ')
|
|
2816
|
+
let patch = []
|
|
2817
|
+
let nSystem = 0
|
|
2818
|
+
let nRetired = 0
|
|
2819
|
+
each(ts, (tk) => {
|
|
2820
|
+
let usage = classifyLegacyAppToken(tk, tn)
|
|
2821
|
+
if (usage === '') {
|
|
2822
|
+
return
|
|
2823
|
+
}
|
|
2824
|
+
patch.push({ id: tk.id, appUsage: usage })
|
|
2825
|
+
if (usage === keyAppUsageRetired) {
|
|
2826
|
+
nRetired++
|
|
2827
|
+
}
|
|
2828
|
+
else {
|
|
2829
|
+
nSystem++
|
|
2830
|
+
}
|
|
2831
|
+
})
|
|
2832
|
+
|
|
2833
|
+
//寫入, 只改不增(mustExist: 讀取之後、寫入之前列已被不共用本鎖之寫入者刪除時整批 reject 'rowNotFound', 不把已刪之列以只有 id 與用途之殘缺列新增回庫);
|
|
2834
|
+
//權杖清單快取(統計所讀)不論寫入成敗皆於寫入階段後清除: 逐筆寫入可能部分已落地才 reject (ADR-080 同型; 外審 sol F5)
|
|
2835
|
+
if (size(patch) > 0) {
|
|
2836
|
+
try {
|
|
2837
|
+
await procOrm('system', 'tokens', 'save', patch, { mustExist: true })
|
|
2838
|
+
}
|
|
2839
|
+
finally {
|
|
2840
|
+
ocGetTokensList.clear('fun')
|
|
2841
|
+
}
|
|
2842
|
+
}
|
|
2843
|
+
|
|
2844
|
+
return { marked: size(patch), system: nSystem, retired: nRetired }
|
|
2845
|
+
})
|
|
2846
|
+
.then((r) => {
|
|
2847
|
+
legacyPm = null
|
|
2848
|
+
srLog.info({ event: 'fun-migrateLegacyAppTokens', marked: r.marked, system: r.system, retired: r.retired })
|
|
2849
|
+
return r
|
|
2850
|
+
})
|
|
2851
|
+
.catch((err) => {
|
|
2852
|
+
legacyPm = null
|
|
2853
|
+
srLog.error({ event: 'fun-migrateLegacyAppTokens', key: 'tokenAppLegacyMigrateFailed', err: getErrorMessage(err) })
|
|
2854
|
+
return Promise.reject('tokenAppLegacyMigrateFailed')
|
|
2855
|
+
})
|
|
2856
|
+
|
|
2857
|
+
return legacyPm
|
|
2858
|
+
}
|
|
2859
|
+
|
|
2860
|
+
|
|
2861
|
+
//maxAppNameLength: 應用系統金鑰名稱之字數上限
|
|
2862
|
+
let maxAppNameLength = 60
|
|
2863
|
+
|
|
2864
|
+
|
|
2865
|
+
//createAppToken (ADR-095, 取代經 updateTokensList 新增列之鑄造: ADR-042 / ADR-084)
|
|
2866
|
+
//鑄造應用系統金鑰: 權杖字串與主鍵由伺服端產生(與登入 token 同源之 funNew), 用戶端不得指定; 用途、綁定使用者、名稱與權限於 [tokens, users] 表鎖內驗證後寫入
|
|
2867
|
+
//(同鎖使「綁定者存在且啟用」之檢查與 insert 之間, 該使用者不會被刪除 / 停用而漏撤銷, 刪除與停用於同一組鎖內撤銷其使用者用途金鑰).
|
|
2868
|
+
//data: { name: 金鑰名稱(必填, 1~60 字、不含 HTML 標記), usage: 'user' | 'system'(必填), userId: 使用者用途之所綁使用者主鍵(須存在且啟用; 系統服務用途不得給), perms: 系統服務用途之權限字串陣列(使用者用途不得給) }
|
|
2869
|
+
//opt.operatorId: 操作者(使用者主鍵, 或系統服務用途操作者之 app:<tokens.id>)——寫入層稽核欄(建立者 userId / 更新者 userIdUpdate)記之;
|
|
2870
|
+
// 使用者用途之 userId 為所綁使用者(身分), 系統服務用途之 userId 為建立者(稽核, 不得當身分使用); 不給期限(timeEnd 為 '')
|
|
2871
|
+
//回傳 { id, token, appUsage, appName, userId, perms, timeCreate }; 驗證失敗 reject 固定語系鍵, 零寫入
|
|
2872
|
+
let createAppToken = async (data, opt = {}) => {
|
|
2873
|
+
|
|
2874
|
+
//operatorId
|
|
2875
|
+
let operatorId = get(opt, 'operatorId', '')
|
|
2876
|
+
|
|
2877
|
+
//data
|
|
2878
|
+
if (!isPlainObject(data)) {
|
|
2879
|
+
return Promise.reject('tokenAppUsageInvalid')
|
|
2880
|
+
}
|
|
2881
|
+
|
|
2882
|
+
//name
|
|
2883
|
+
let name = get(data, 'name', '')
|
|
2884
|
+
if (!isestr(name)) {
|
|
2885
|
+
return Promise.reject('tokenAppNameInvalid')
|
|
2886
|
+
}
|
|
2887
|
+
name = name.trim()
|
|
2888
|
+
if (!isestr(name) || name.length > maxAppNameLength) {
|
|
2889
|
+
return Promise.reject('tokenAppNameInvalid')
|
|
2890
|
+
}
|
|
2891
|
+
if (clearXSS(name) !== name) {
|
|
2892
|
+
return Promise.reject('htmlMarkupNotAllowed') //procOrm 寫入時會改寫, 儲存值將與送入值不同 (ADR-081)
|
|
2893
|
+
}
|
|
2894
|
+
|
|
2895
|
+
//usage
|
|
2896
|
+
let usage = get(data, 'usage', '')
|
|
2897
|
+
if (!isAppUsageValue(usage)) {
|
|
2898
|
+
return Promise.reject('tokenAppUsageInvalid')
|
|
2899
|
+
}
|
|
2900
|
+
|
|
2901
|
+
//userId, perms
|
|
2902
|
+
let userId = ''
|
|
2903
|
+
let perms = []
|
|
2904
|
+
if (usage === 'user') {
|
|
2905
|
+
userId = get(data, 'userId', '')
|
|
2906
|
+
if (!isestr(userId)) {
|
|
2907
|
+
return Promise.reject('tokenAppUserInvalid')
|
|
2908
|
+
}
|
|
2909
|
+
if (clearXSS(userId) !== userId) {
|
|
2910
|
+
//procOrm 寫入時會把 userId 改寫為另一個字串(可能恰為另一位使用者之主鍵): 驗證所綁之使用者與實際寫入者不同, 一律拒絕 (外審 sol#1)
|
|
2911
|
+
return Promise.reject('tokenAppUserInvalid')
|
|
2912
|
+
}
|
|
2913
|
+
let permsRaw = get(data, 'perms')
|
|
2914
|
+
if (!(permsRaw === undefined || permsRaw === null || permsRaw === '' || (isarr(permsRaw) && size(permsRaw) === 0))) {
|
|
2915
|
+
return Promise.reject('tokenAppPermsNotForUser') //使用者用途之權限即所綁使用者之權限, perms 不適用
|
|
2916
|
+
}
|
|
2917
|
+
}
|
|
2918
|
+
else {
|
|
2919
|
+
let userIdRaw = get(data, 'userId', '')
|
|
2920
|
+
if (userIdRaw !== undefined && userIdRaw !== null && userIdRaw !== '') {
|
|
2921
|
+
return Promise.reject('tokenAppUserNotForSystem') //系統服務用途不綁使用者
|
|
2922
|
+
}
|
|
2923
|
+
let permsRaw = get(data, 'perms')
|
|
2924
|
+
if (!isAppPermsValue(permsRaw)) {
|
|
2925
|
+
return Promise.reject('tokenPermsInvalid')
|
|
2926
|
+
}
|
|
2927
|
+
perms = normAppPerms(permsRaw)
|
|
2928
|
+
}
|
|
2929
|
+
|
|
2930
|
+
//insert, [tokens, users] 表鎖內(依表名碼元序取鎖, 與 updateTabItems users 路徑同組)
|
|
2931
|
+
let rejectKey = null
|
|
2932
|
+
let errTemp = null
|
|
2933
|
+
let isErr = false //以旗標判定失敗, 不以「錯誤值是否為真」: reject 值可能為 null / undefined (外審 sol#10; R-SESS-01 第 6 點同型)
|
|
2934
|
+
let t = null
|
|
2935
|
+
await withTabLocks(['tokens', 'users'], async () => {
|
|
2936
|
+
|
|
2937
|
+
//鎖內再驗操作者仍有權鑄造 (外審 sol#2): 鎖外 checkToken 通過後、等鎖期間操作者可能已被停用、降權或撤銷, 不得再鑄出永久之應用系統金鑰;
|
|
2938
|
+
//checkToken 只讀不取鎖, 可於鎖內呼叫 (同 checkTokenAndChangePassword 之鎖內再驗)
|
|
2939
|
+
if (isfun(get(opt, 'recheck'))) {
|
|
2940
|
+
let okRe = await opt.recheck().then(() => true).catch(() => false)
|
|
2941
|
+
if (!okRe) {
|
|
2942
|
+
rejectKey = 'tokenExpired'
|
|
2943
|
+
return
|
|
2944
|
+
}
|
|
2945
|
+
}
|
|
2946
|
+
|
|
2947
|
+
//使用者用途: 綁定者須存在且啟用
|
|
2948
|
+
if (usage === 'user') {
|
|
2949
|
+
let us = await woItems.users.select({ id: userId })
|
|
2950
|
+
if (size(us) !== 1 || get(us, '0.isActive', '') !== 'y') {
|
|
2951
|
+
rejectKey = 'tokenAppUserInvalid'
|
|
2952
|
+
return
|
|
2953
|
+
}
|
|
2954
|
+
}
|
|
2955
|
+
|
|
2956
|
+
//t, 主鍵與權杖字串由 funNew 產生; 擁有者 userId: 使用者用途為所綁使用者, 系統服務用途為建立者(稽核)
|
|
2957
|
+
t = ds.tokens.funNew({
|
|
2958
|
+
userId: usage === 'user' ? userId : operatorId,
|
|
2959
|
+
isApp: 'y',
|
|
2960
|
+
appUsage: usage,
|
|
2961
|
+
appName: name,
|
|
2962
|
+
perms,
|
|
2963
|
+
})
|
|
2964
|
+
t.timeEnd = '' //不給期限
|
|
2965
|
+
|
|
2966
|
+
//keepUserId: tokens 之 userId 不被改寫為寫入參數 (w-serv-orm 1.1.17; ADR-084); userIdUpdate 記操作者
|
|
2967
|
+
await procOrm(operatorId, 'tokens', 'insert', [t], { keepUserId: true })
|
|
2968
|
+
|
|
2969
|
+
})
|
|
2970
|
+
.catch((err) => {
|
|
2971
|
+
isErr = true
|
|
2972
|
+
errTemp = err
|
|
2973
|
+
})
|
|
2974
|
+
|
|
2975
|
+
//check
|
|
2976
|
+
if (rejectKey !== null) {
|
|
2977
|
+
return Promise.reject(rejectKey)
|
|
2978
|
+
}
|
|
2979
|
+
if (isErr) {
|
|
2980
|
+
srLog.error({ event: 'fun-createAppToken', key: 'tokenAppCreateFailed', usage, err: getErrorMessage(errTemp) })
|
|
2981
|
+
return Promise.reject('tokenAppCreateFailed')
|
|
2982
|
+
}
|
|
2983
|
+
|
|
2984
|
+
//清除權杖清單快取 (ADR-008)
|
|
2985
|
+
ocGetTokensList.clear('fun')
|
|
2986
|
+
|
|
2987
|
+
//info, 不記權杖字串
|
|
2988
|
+
srLog.info({ event: 'fun-createAppToken', id: t.id, usage, operatorId })
|
|
2989
|
+
|
|
2990
|
+
return { id: t.id, token: t.token, appUsage: usage, appName: name, userId: t.userId, perms: t.perms, timeCreate: t.timeCreate }
|
|
2991
|
+
}
|
|
2992
|
+
|
|
2993
|
+
|
|
2994
|
+
//checkTokenAndCreateAppToken
|
|
2995
|
+
//權限閘同 updateTokensList(管理者 / 具 writeTokens 之系統服務用途); 雙擊防護(後端): 同一操作者之鑄造處理中再送出即拒絕 (lockSave, ADR-074)
|
|
2996
|
+
let checkTokenAndCreateAppToken = async (token, data, opt = {}) => {
|
|
2997
|
+
|
|
2998
|
+
//checkToken
|
|
2999
|
+
await checkToken(token, opt) //resolve僅回傳true, reject代表無效token或檢測token發生錯誤
|
|
3000
|
+
|
|
3001
|
+
//操作者 id
|
|
3002
|
+
let actor = await getActorByToken(token)
|
|
3003
|
+
let operatorId = actor.id
|
|
3004
|
+
|
|
3005
|
+
return await lockSave('createAppToken', operatorId, async () => {
|
|
3006
|
+
return await createAppToken(data, { operatorId, recheck: () => checkToken(token, opt) })
|
|
3007
|
+
})
|
|
3008
|
+
}
|
|
3009
|
+
|
|
3010
|
+
|
|
2562
3011
|
//getIpsList
|
|
2563
3012
|
let getIpsList = async () => {
|
|
2564
3013
|
|
|
@@ -2614,8 +3063,8 @@ function proc(woItems, procOrm, { srLog, srEmail, salt, minExpired, kpLang, pass
|
|
|
2614
3063
|
await checkToken(token, opt) //resolve僅回傳true, reject代表無效token或檢測token發生錯誤
|
|
2615
3064
|
|
|
2616
3065
|
//操作者 id (雙擊防護之占位 key)
|
|
2617
|
-
let
|
|
2618
|
-
let operatorId =
|
|
3066
|
+
let actor = await getActorByToken(token)
|
|
3067
|
+
let operatorId = actor.id
|
|
2619
3068
|
|
|
2620
3069
|
//雙擊防護(後端): 同一操作者之 IP 清單儲存處理中再送出即拒絕 (見 lockSave, ADR-074)
|
|
2621
3070
|
return await lockSave('updateIpsList', operatorId, async () => {
|
|
@@ -2697,6 +3146,9 @@ function proc(woItems, procOrm, { srLog, srEmail, salt, minExpired, kpLang, pass
|
|
|
2697
3146
|
getTokensListCache,
|
|
2698
3147
|
checkTokenAndGetTokensList,
|
|
2699
3148
|
checkTokenAndUpdateTokensList,
|
|
3149
|
+
createAppToken,
|
|
3150
|
+
checkTokenAndCreateAppToken,
|
|
3151
|
+
migrateLegacyAppTokens, //升級遷移: 伺服器啟動時呼叫一次 (WWebSso)
|
|
2700
3152
|
|
|
2701
3153
|
getIpsList,
|
|
2702
3154
|
getIpsListCache,
|