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.
Files changed (43) hide show
  1. package/README.md +69 -0
  2. package/dist/css/{app.f000459f.css → app.c117e572.css} +1 -1
  3. package/dist/index.tmp +1 -1
  4. package/dist/js/app-legacy.7c861154.js +1 -0
  5. package/dist/js/app.7c861154.js +1 -0
  6. package/dist/js/{chunk-vendors.97013ddc.js → chunk-vendors-legacy.6cb51be5.js} +2 -2
  7. package/dist/js/{chunk-vendors-legacy.97013ddc.js → chunk-vendors.6cb51be5.js} +2 -2
  8. package/dist/w-web-sso.umd.js +4 -4
  9. package/dist/w-web-sso.umd.js.map +1 -1
  10. package/docs/WWebSso.html +1 -1
  11. package/docs/global.html +1 -1
  12. package/docs/index.html +1 -1
  13. package/docs/server_WWebSso.mjs.html +25 -1
  14. package/docs/server_getIgnoredOrmKeys.mjs.html +1 -1
  15. package/docs/server_lockSave.mjs.html +1 -1
  16. package/docs/server_ormWrite.mjs.html +1 -1
  17. package/docs/server_staLogs_resolveShellWorker.mjs.html +1 -1
  18. package/docs/server_wrapTimer.mjs.html +1 -1
  19. package/docs/src_components_Common_CheckYesNo.vue.html +1 -1
  20. package/docs/src_fetchSsoMsg.mjs.html +1 -1
  21. package/docs/src_httpGetJson.mjs.html +1 -1
  22. package/docs/src_maskUrl.mjs.html +1 -1
  23. package/docs/src_plugins_staUsage.mjs.html +1 -1
  24. package/docs/src_plugins_submitGuard.mjs.html +1 -1
  25. package/package.json +1 -1
  26. package/server/WWebSso.mjs +24 -0
  27. package/server/procCore.mjs +631 -179
  28. package/server/procLang.mjs +114 -4
  29. package/server/procStaInfor.mjs +18 -0
  30. package/src/appUsage.mjs +115 -0
  31. package/src/components/AppTokenAddDialog.vue +384 -0
  32. package/src/components/LayoutContentTokens.vue +147 -76
  33. package/src/components/LayoutContentUsers.vue +22 -17
  34. package/src/components/PageLogin.vue +3 -3
  35. package/src/getUserByToken.mjs +4 -1
  36. package/src/getUserByUserId.mjs +2 -1
  37. package/src/getUsersByToken.mjs +2 -1
  38. package/src/schema/tables/tokens.mjs +9 -1
  39. package/src/usersRedirCheck.mjs +68 -0
  40. package/src/writeContracts/tokens.mjs +4 -3
  41. package/src/writeContracts/tokensSession.mjs +1 -1
  42. package/dist/js/app-legacy.7c006893.js +0 -1
  43. package/dist/js/app.7c006893.js +0 -1
@@ -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
- //_checkTokenByObj
568
- let _checkTokenByObj = async (tk, opt = {}) => {
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
- //timeEnd
571
- let timeEnd = get(tk, 'timeEnd', '')
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 (!istimemsTZ(timeEnd)) {
575
- // console.log(`tk`, tk)
576
- console.log(`timeEnd`, timeEnd)
577
- console.log(`invalid timeEnd`)
578
- return Promise.reject(`invalid timeEnd`)
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
- //isApp
582
- let isApp = get(tk, 'isApp', '')
583
- // console.log('isApp', isApp)
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); 僅作用於 app token, 使用者 token 仍以 fun 判斷
734
+ //perm, 權限閘所需之 app token 權限(src/appPerms.mjs); 僅作用於系統服務用途, 使用者 token 與使用者用途仍以 fun 判斷
589
735
  let perm = get(opt, 'perm', '')
590
736
 
591
- //tn
592
- let tn = ot().format('YYYY-MM-DDTHH:mm:ss.SSSZ')
593
- // console.log('tn ', tn)
594
- // console.log('timeEnd', timeEnd)
595
- // console.log('tn < timeEnd', tn < timeEnd)
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
- //app token (isApp='y') 無使用者資訊故不執行 fun, 改依其 perms 判斷 (ADR-069, 取代 ADR-005 之一律視同 admin); 應僅由內部 token creation 路徑簽發, 不開放外部註冊.
600
- if (isApp !== 'y') {
601
- //token來自使用者
747
+ if (actor.kind !== 'appSystem') {
748
+ //token 代表使用者本人(使用者 token、使用者用途): 有給定驗證 fun 才執行(取得使用者資訊供驗證), perms 不適用
602
749
 
603
750
  if (isfun(fun)) {
604
- //有給定驗證fun才執行取得使用者資訊供驗證
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
- let userId = get(tk, 'userId', '')
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
- //讀取、驗舊密碼與寫入於 users 表鎖內(S07; kmx 在外層、表鎖在內層): password 為伺服器專有欄位、isForceChangePw 為雙方欄位(系統直寫須取表鎖),
1316
- //驗證所依之 DB 雜湊與寫入間不被其他寫入者(重設密碼、後台存檔)插隊; 只改不增, 列已被刪則拒絕而不新增殘缺列 (X5)
1317
- let { u, email } = await withTabLocks(['users'], async () => {
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, app token 須具 writeUsers(其虛擬使用者 isAdmin='y', 故不可只靠下方 isAdmin 判斷; ADR-069); 使用者 token 不受 perm 影響
1433
- await checkToken(token, { perm: 'writeUsers' })
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
- //getUserByToken (操作者)
1446
- let uOperator = await getUserByToken(token)
1447
- let operatorId = get(uOperator, 'id', '')
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 查找與寫入於 users 表鎖內(S08; kmx 在外層、表鎖在內層): password 為伺服器專有欄位、isForceChangePw 為雙方欄位(系統直寫須取表鎖);
1661
+ //目標 user 查找、撤銷其全部 session 與寫入於 [tokens, users] 表鎖內(S08; kmx 在外層、表鎖在內層): password 為伺服器專有欄位、isForceChangePw 為雙方欄位(系統直寫須取表鎖);
1472
1662
  //只改不增, 目標已被刪則拒絕而不新增殘缺列 (X5); 更新者記操作管理員 (R-CONC-04)
1473
- let { targetAccount, targetName, targetEmail, newPassword } = await withTabLocks(['users'], async () => {
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 + save (含 isForceChangePw='y')
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 數. 使用者設計上不持有 isApp='y' token, 故一併撤 (ADR-037).
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
- //ts
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
- //基準之外之列(管理員新增): 已存在於庫內(他人載入後新增而撞 id)→ 拒收; 否則新增
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
- //修改另含送出 isApp === 'y' 者, 即升級為應用系統金鑰); session 列(登入新增、續期改 timeEnd、登出或封鎖刪除, 系統頻繁增刪)
1912
- //不刪、不以送入值覆蓋, 載入後才登入之 session 因而不被誤刪 (E1, D3). 新增列(送出而庫內無此 id)照常新增,
1913
- //含直打 API 鑄造使用者 token 與應用系統金鑰(ADR-042, ADR-084); 此路徑無基準可辨是否為已被撤銷之 session, 該風險由帶基準之後台頁(X1)承擔防護
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
- if (woName === 'tokens') {
2057
- //tokens 之 userId 為令牌擁有者(非建立者): keepUserId 保留列上非空之擁有者, userIdUpdate 記操作者 (ADR-042, ADR-084; w-serv-orm 1.1.17);
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
- //tks
2155
- let tks = await woItems.tokens.select({ token })
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
- //userId
2189
- let userId = get(tk, 'userId', '')
2190
- // console.log('userId', userId)
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 uOperator = await getUserByToken(token)
2434
- let operatorId = get(uOperator, 'id', '')
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
- //自我保護僅適用於使用者操作者: app token 之操作者為虛擬使用者, users 表無其列, 無「自己」可刪除/降權/停用 (ADR-069)
2443
- let isAppOperator = get(uOperator, 'isApp', '') === 'y'
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
- return ts
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 uOperator = await getUserByToken(token)
2549
- let operatorId = get(uOperator, 'id', '')
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 uOperator = await getUserByToken(token)
2618
- let operatorId = get(uOperator, 'id', '')
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,