userAuditLogEntries là nhật ký kiểm tra của tài khoản người dùng: đăng nhập, thay đổi mật khẩu và email, tài khoản liên kết và các thao tác quản trị. Mỗi tài liệu là một sự kiện trên một tài khoản. web sở hữu collection này; schema là services/web/app/src/models/UserAuditLogEntry.mjs, và phần lõi ghi thông qua services/web/app/src/Features/User/UserAuditLogHandler.mjs.
Trường
| Trường | Kiểu | Ý nghĩa | Nguồn |
|---|---|---|---|
_id | ObjectId | Id của mục. | UserAuditLogEntry.mjs:4 |
userId | ObjectId | Tài khoản mà sự kiện liên quan. | UserAuditLogEntry.mjs:6 |
operation | String | Điều gì đã xảy ra, một tên dạng kebab-case như login (xem bảng bên dưới). | UserAuditLogEntry.mjs:11 |
initiatorId | ObjectId | Ai đã làm: chính người dùng, hoặc quản trị viên với các thao tác quản trị. Có thể thiếu ở một vài thao tác, như reset-password (UserAuditLogHandler.mjs:19-33). | UserAuditLogEntry.mjs:9 |
ipAddress | String | Địa chỉ IP của yêu cầu (req.ip). Có thể thiếu ở một vài thao tác (UserAuditLogHandler.mjs:8-17). | UserAuditLogEntry.mjs:10 |
info | Object | Chi tiết sự kiện; các khóa phụ thuộc vào thao tác. | UserAuditLogEntry.mjs:8 |
timestamp | Date | Thời điểm mục được ghi (mặc định Date.now). | UserAuditLogEntry.mjs:12 |
managedSubscriptionId | ObjectId | Gói đăng ký nhóm được quản lý của người dùng. Chỉ được đặt khi tính năng saas bật (UserAuditLogHandler.mjs:92-107), nên không bao giờ có trong CE. | UserAuditLogEntry.mjs:7 |
__v | Number | Khóa phiên bản của Mongoose, được thêm bởi UserAuditLogEntry.create. | UserAuditLogHandler.mjs:109 |
Ai ghi
| Mã | Chức năng |
|---|---|
UserAuditLogHandler.mjs:62-110 (addEntry) | Tạo một mục. Báo lỗi khi thiếu operation, hoặc khi thiếu ipAddress hay initiatorId cho thao tác cần đến chúng. |
UserAuditLogHandler.mjs:112-126 (addEntryInBackground) | Tương tự, nhưng không chờ; lỗi chỉ được ghi log. |
services/web/modules/admin-tools/app/src/AdminAuditLog.mjs:14-38 | Bảng quản trị của chúng tôi: logOnUser ghi các thao tác quản trị lên tài khoản đích với quản trị viên là người khởi tạo; logOnAdmin ghi lên chính tài khoản của quản trị viên khi đích không còn nhật ký (người dùng đã bị xóa vĩnh viễn, một mẫu). |
services/web/modules/authentication/auditLog.mjs:9-21 | Các module LDAP, SAML và OIDC của chúng tôi: logLoginEntry ghi những gì một lần đăng nhập SSO đã làm với tài khoản, với chính tài khoản là người khởi tạo. |
services/web/app/src/Features/User/UserDeleter.mjs:141 | Xóa mọi mục của người dùng đã xóa khi người dùng đã xóa đó hết hạn (expireDeletedUsersAfterDuration). |
AdminAuditLog.mjs:41-43 (deleteUserEntries) | Bảng quản trị của chúng tôi xóa mọi mục của người dùng mà nó xóa vĩnh viễn (services/web/modules/admin-tools/app/src/AdminUserManager.mjs:644). |
tools/migrations/20220913125500_migrate_auditLog_to_collections.mjs | Migration một lần: đã chuyển các mảng users.auditLog cũ vào collection này. |
operation | Vị trí ghi (services/web/app/src/...) |
|---|---|
login | Features/Authentication/AuthenticationController.mjs:225 |
failed-password-match | Features/Authentication/AuthenticationManager.mjs:150 |
logout | Features/User/UserController.mjs:599 |
update-password | Features/User/UserController.mjs:131 |
clear-sessions | Features/User/UserController.mjs:167 |
reset-password | Features/PasswordReset/PasswordResetHandler.mjs:106 |
delete-account | Features/User/UserDeleter.mjs:50 |
account-suspension | Features/User/UserUpdater.mjs:621 |
must-reset-password-unset | Features/User/UserUpdater.mjs:604 |
add-email, remove-email, change-primary-email | Features/User/UserUpdater.mjs:99, :494, :247 |
migrate-default-email | Features/User/UserUpdater.mjs:355 |
clear-institution-sso-data, clear-third-party-identifiers | Features/User/UserUpdater.mjs:160, :196 |
confirm-email | Features/User/UserEmailsController.mjs:750 |
request-add-email-code, add-email-via-code, confirm-email-via-code | Features/User/UserEmailsController.mjs:138, :331, :354 |
resend-add-email-code, resend-confirm-email-code | Features/User/UserEmailsController.mjs:391 (tên tại :417, :423) |
link-sso, unlink-sso | Features/User/ThirdPartyIdentityManager.mjs:64, :131 (được module OIDC của chúng tôi sử dụng) |
link-institution-sso, unlink-institution-sso, migrate-institution-sso-id, unlink-institution-sso-not-migrated | Features/User/SAMLIdentityManager.mjs:103, :293, :424, :462 |
accept-group-invitation, join-group-subscription, leave-group-subscription, remove-from-group-subscription | Features/Subscription/TeamInvitesController.mjs:276, Features/Subscription/SubscriptionUpdater.mjs:104, :133, :193, Features/Subscription/SubscriptionGroupController.mjs:127 |
ai-quota-breach | infrastructure/rate-limiters/AiFeatureUsageRateLimiter.mjs:35, infrastructure/rate-limiters/TokenUsageRateLimiter.mjs:99, :191 |
services/web/modules/...):
operation | Vị trí ghi |
|---|---|
create-account | authentication/ldap/app/src/LDAPAuthenticationManager.mjs:58, authentication/saml/app/src/SAMLAuthenticationManager.mjs:56, authentication/oidc/app/src/OIDCAuthenticationManager.mjs:75, admin-tools/app/src/AdminUserManager.mjs:167 |
remove-password | authentication/ldap/app/src/LDAPAuthenticationManager.mjs:78, authentication/saml/app/src/SAMLAuthenticationManager.mjs:94 |
link-institution-sso | authentication/saml/app/src/SAMLAuthenticationManager.mjs:71 |
change-admin-access, change-name | authentication/auditLog.mjs:37, :47 (đăng nhập SSO); admin-tools/app/src/AdminUserManager.mjs:394, :391 (quản trị) |
failed-password-match | authentication/auditLog.mjs:80 (LDAP) |
logout | authentication/auditLog.mjs:58 |
send-activation-email, send-password-reset-email | admin-tools/app/src/AdminUserManager.mjs:184, :207 |
update-password, change-features, change-ai-features, account-reactivation | admin-tools/app/src/AdminUserManager.mjs:389, :397, :400, :403 |
clear-sessions, transfer-projects, restore-account, reset-ai-usage | admin-tools/app/src/AdminUserManager.mjs:514, :563, :694, :712 |
purge-deleted-user, purge-deleted-project, delete-template (trên tài khoản của quản trị viên) | admin-tools/app/src/AdminUserManager.mjs:645, admin-tools/app/src/AdminProjectManager.mjs:525, admin-tools/app/src/AdminTemplateManager.mjs:67 |
publish-template, edit-template, delete-template | template-gallery/app/src/TemplateGalleryController.mjs:52, :107, :137 |
link-dropbox, unlink-dropbox | dropbox/app/src/DropboxController.mjs:87, :107, dropbox/index.mjs:38 |
link-github, unlink-github | github-sync/app/src/GitHubSyncController.mjs:155, :175 |
integration-account-linked, integration-account-unlinked | Đồng bộ GitLab và Gitea (gitlab-sync/app/src/GitLabSyncController.mjs:155, :181, gitea-sync/app/src/GiteaSyncController.mjs:155, :181), Zotero và Mendeley (tpr-webmodule/app/src/ZoteroController.mjs:77, :99, tpr-webmodule/app/src/MendeleyController.mjs:77, :99) |
create-git-token, delete-git-token | oauth2-server/app/src/OAuthPersonalAccessTokenController.mjs:48, :74 |
Ai đọc
| Mã | Chức năng |
|---|---|
services/web/modules/admin-tools/app/src/AdminAuditLog.mjs:124-126 (listUserEntries) | Tab nhật ký kiểm tra trong bảng quản trị của chúng tôi, GET /admin/user/:userId/audit-log/list (services/web/modules/admin-tools/app/src/AdminToolsRouter.mjs:32-36). |
Chỉ mục
| Tên | Khóa | Tùy chọn | Migration |
|---|---|---|---|
timestamp_1 | { timestamp: 1 } | TTL, expireAfterSeconds: 78840000 (2,5 năm) | tools/migrations/20220913105500_create_auditLog_indexes.mjs |
userId_1_timestamp_-1 | { userId: 1, timestamp: -1 } | tools/migrations/20251117093546_add_timestamp_to_userAuditLogEntries.mjs |
tools/migrations/20220929193200_add_auditLog_indexes.mjs ban đầu tạo user_id_1 trên { userId: 1 }; 20251117093546 thay nó bằng chỉ mục kết hợp. Schema đánh dấu userId và managedSubscriptionId bằng index: true, nhưng tự động tạo chỉ mục của Mongoose đã tắt (services/web/app/src/infrastructure/Mongoose.mjs:7), nên chỉ các migration ở trên tạo chỉ mục. Migration chỉ mục của managedSubscriptionId chỉ được gắn thẻ saas.
Ghi chú
- Các mục hết hạn 2,5 năm sau
timestampthông qua chỉ mục TTL.

