> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# User Audit Log Entries 컬렉션

`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`). |

CE 코어에는 이 로그를 보여 주는 페이지가 없습니다.

#### 인덱스

| 이름 | 키 | 옵션 | 마이그레이션 |
| - | - | - | - |
| `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년 뒤 만료됩니다.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.