Security Information and Event Management (SIEM) Logs Overview
Security Information and Event Management (SIEM) Logs Overview
Moveworks provides a JSON-based SIEM log export (via SFTP) that captures API calls, authentication events, permission changes, config changes, and other platform activities. These logs can be ingested into any organizational SIEM, data lake, or analytics pipeline to support incident response, monitoring, and compliance workflows.
Customers can export these logs from SFTP into their internal storage systems or forward them using a SIEM/log forwarder.
π File Structure & Delivery Cadence
Directory Layout
Logs are delivered to a versioned subdirectory (v1) within your SFTP bucket:
Example:
logs/v1/2024-08-20/2024-08-20_audit_log.json
Files are delivered under the v1 subdirectory, which denotes the delivery pipeline version. This is separate from the version field inside each log entry, which is the log schema version (currently "2").
Refresh Frequency
Each dayβs log file is updated every 3 hours β new activity is appended to that dayβs existing file; a new file is not created for each refresh.
All date folders and event_time timestamps are in UTC.
π§© Log Schema
All logs use a consistent, well-defined structure. Each supported log type has a documented schema so parsing and integration with your SIEM solution is reliable.
Top-Level Fields
Every log includes the following fields:
The fields inside event_data differ by event_type β see the examples below for the fields included with each type.
Supported Log Types
EXTERNAL_APIEXTERNAL_LDAP_APICONFIG_CHANGEPERMISSION_CHANGEAUTHENTICATIONAGENT_STUDIO_LOGUSER_TOKEN_LOG
π Example Logs
Example payloads for each supported log type are shown below.
EXTERNAL_API
Outbound API calls Moveworks makes to external/integrated systems, including the request URI and method, response status, and timing.
EXTERNAL_LDAP_API
LDAP queries Moveworks issues against your directory (for example, user lookups), including the search request that was run.
CONFIG_CHANGE
Changes to Moveworks configuration, capturing which config was changed, its version, the origin of the change, the operation type, and the specific fields updated.
The operation_type field distinguishes configuration updates from deletions:
Configuration update
Configuration deletion
PERMISSION_CHANGE
Changes to user role and permission assignments across Moveworks apps, including the roles assigned or revoked and the userβs resulting full role set.
AUTHENTICATION
Authentication events such as logins (success or failure), including the app, source IP, and user agent.
AGENT_STUDIO_LOG
Actions taken in Agent Studio, including the method invoked, the result, and the object or log type that was acted on.
USER_TOKEN_LOG
User-token operations, such as retrieving an access token for a connected integration, with sanitized token information.
β FAQ
How do I get SFTP access to these logs?
If SFTP access isnβt set up yet β or youβre missing credentials or the bucket path β contact your Moveworks account team or Moveworks Support.
Why donβt I see logs in my SFTP folder?
Check the versioned directory:
If the folder does not appear, verify your SFTP access configuration and root folder permissions.