userAuditLogEntries 는 사용자 계정의 감사 로그입니다. 로그인, 비밀번호 및 이메일 변경, 연결된 계정, 관리자 작업을 기록합니다. 문서 하나는 한 계정에 대한 이벤트 하나입니다. web이 소유하며, 스키마는 services/web/app/src/models/UserAuditLogEntry.mjs이고 코어는 services/web/app/src/Features/User/UserAuditLogHandler.mjs를 통해 기록합니다.
필드
| 필드 | 타입 | 의미 | 출처 |
|---|---|---|---|
_id | ObjectId | 항목 id. | UserAuditLogEntry.mjs:4 |
userId | ObjectId | 이벤트의 대상 계정. | UserAuditLogEntry.mjs:6 |
operation | String | 무슨 일이 있었는지를 나타내는 kebab-case 이름(예: login, 아래 표 참조). | UserAuditLogEntry.mjs:11 |
initiatorId | ObjectId | 수행한 사람: 사용자 본인 또는 관리자 작업의 경우 관리자. reset-password 같은 일부 작업에서는 없을 수 있습니다(UserAuditLogHandler.mjs:19-33). | UserAuditLogEntry.mjs:9 |
ipAddress | String | 요청의 IP 주소(req.ip). 일부 작업에서는 없을 수 있습니다(UserAuditLogHandler.mjs:8-17). | UserAuditLogEntry.mjs:10 |
info | Object | 이벤트의 세부 정보입니다. 키는 작업에 따라 다릅니다. | UserAuditLogEntry.mjs:8 |
timestamp | Date | 항목이 기록된 시각(기본값 Date.now). | UserAuditLogEntry.mjs:12 |
managedSubscriptionId | ObjectId | 사용자의 관리형 그룹 구독. saas 기능이 켜져 있을 때만 설정되므로(UserAuditLogHandler.mjs:92-107) CE에서는 절대 설정되지 않습니다. | UserAuditLogEntry.mjs:7 |
__v | Number | Mongoose 버전 키로, UserAuditLogEntry.create가 추가합니다. | UserAuditLogHandler.mjs:109 |
쓰는 코드
| 코드 | 하는 일 |
|---|---|
UserAuditLogHandler.mjs:62-110 (addEntry) | 항목 하나를 만듭니다. operation이 없거나, 이를 필요로 하는 작업에서 ipAddress 또는 initiatorId가 없으면 오류를 던집니다. |
UserAuditLogHandler.mjs:112-126 (addEntryInBackground) | 같은 작업을 기다리지 않고 수행합니다. 오류는 로그에만 남습니다. |
services/web/modules/admin-tools/app/src/AdminAuditLog.mjs:14-38 | 우리의 관리자 패널: logOnUser는 관리자를 수행자로 하여 대상 계정에 관리자 작업을 기록하고, logOnAdmin은 대상에 남은 로그가 없을 때(영구 삭제된 사용자, 템플릿) 관리자 자신의 계정에 기록합니다. |
services/web/modules/authentication/auditLog.mjs:9-21 | 우리의 LDAP, SAML, OIDC 모듈: logLoginEntry는 SSO 로그인이 계정에 한 일을 계정 자신을 수행자로 하여 기록합니다. |
services/web/app/src/Features/User/UserDeleter.mjs:141 | 삭제된 사용자가 만료되면 그 사용자의 모든 항목을 삭제합니다(expireDeletedUsersAfterDuration). |
AdminAuditLog.mjs:41-43 (deleteUserEntries) | 우리의 관리자 패널은 영구 삭제하는 사용자의 모든 항목을 삭제합니다(services/web/modules/admin-tools/app/src/AdminUserManager.mjs:644). |
tools/migrations/20220913125500_migrate_auditLog_to_collections.mjs | 일회성 마이그레이션: 예전 users.auditLog 배열을 이 컬렉션으로 옮겼습니다. |
operation | 기록 위치 (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 (이름은 :417, :423) |
link-sso, unlink-sso | Features/User/ThirdPartyIdentityManager.mjs:64, :131 (우리의 OIDC 모듈이 사용) |
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 | 기록 위치 |
|---|---|
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 (SSO 로그인); admin-tools/app/src/AdminUserManager.mjs:394, :391 (관리자) |
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 (관리자 계정에 기록) | 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 | GitLab 및 Gitea 동기화 (gitlab-sync/app/src/GitLabSyncController.mjs:155, :181, gitea-sync/app/src/GiteaSyncController.mjs:155, :181), Zotero 및 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 |
읽는 코드
| 코드 | 하는 일 |
|---|---|
services/web/modules/admin-tools/app/src/AdminAuditLog.mjs:124-126 (listUserEntries) | 우리 관리자 패널의 감사 로그 탭, GET /admin/user/:userId/audit-log/list(services/web/modules/admin-tools/app/src/AdminToolsRouter.mjs:32-36). |
인덱스
| 이름 | 키 | 옵션 | 마이그레이션 |
|---|---|---|---|
timestamp_1 | { timestamp: 1 } | TTL, expireAfterSeconds: 78840000 (2.5년) | 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가 처음에 { userId: 1 }에 user_id_1을 만들었고, 20251117093546이 이를 복합 인덱스로 대체합니다. 스키마는 userId와 managedSubscriptionId에 index: true를 표시하지만 Mongoose 자동 인덱싱이 꺼져 있으므로(services/web/app/src/infrastructure/Mongoose.mjs:7) 위의 마이그레이션만 인덱스를 만듭니다. managedSubscriptionId 인덱스 마이그레이션에는 saas 태그만 붙어 있습니다.
참고
- 항목은 TTL 인덱스에 의해
timestamp로부터 2.5년 뒤 만료됩니다.

