5.14 Audit Resources

Info : available in Thru File Sharing version 9.10.8 and later.

5.14.1 ThruPublicAuditFileSystemTransactionAction Object

ThruPublicAuditFileSystemTransactionAction structure contains the extended list of properties which can be filled for FileSystem Log Operations. Depending on operation type some values will be equal to NULL and will not be returned in the response.

Note : Null values will be omitted from the resulting object.

Item Name	Data Type	Sample Value	Comments
FileSystemLogOpId	String	1Q1OBQWVHTROE	Identifier of Log Operation
FileSystemLogId	String	1Q1OBQWVHTROM	Identifier of Log Item
UserID	String	1Q1TUBQWVHJGD	Identifier of User
UserFullName	String	Ad	User’s first name
UserEmail	String	Test	User’s last name
Operation	String	int	Operation Id
OperationName	String	Internal Upload	Operation Name
ClientIPAddress	String		User’s client IP address
OperationDateCreated	DateTime	/Date(1337174868567)/	Log Operation’s date create (UTC) in Unix epoch format including slashes
Note	String		Operation’s note
ApplicationName	String	Web	Application name for the log operation
ApplicationShortName	String	Web	Application short name for the log operation
IsTop	Boolean	True	Log item hierarchy placement.
LogDateCreated	DateTime	/Date(1343838136630)/	Log Item’s date create (UTC) in Unix epoch format including slashes
Status	Boolean	True	Indicates success/failure status of log item
Name	String	Test.jpg	Log Item name, e.g. file name or folder name
NextName	String	NewTest.jpg	New name for the log item’s name
PreviousName	String	Test.jpg	Previous name for the log item’s name
Path	String	/FODLERS/COMMON/Test.jpg	Path to the item
NextPath	String	/FODLERS/COMMON/New Folder/	New path to the item
PreviousPath	String	/FODLERS/COMMON//Test.jpg	Old path to the item
Description	String	New description	Item’s description
PreviousDescription	String	description	Item’s previous description
FolderPermission	Int	7	None = 0x00, // 0 Show = 0x01, // 1 Read = 0x02, // 2 Create = 0x04, // 4 Download = 0x08, // 8 Distribute = 0x010, // 16 Manage = 0x020, // 32 Modify = 0x040, // 64 Delete = 0x080, // 128 FullControl = Read \| Create \| Download \| Distribute \| Manage \| Modify \| Delete
PreviousFolderPermission	Int	3	Previous permission for the item
RelatedUserEmail	String	Testuser@abc.com	Related user’s email for the operation
RelatedUserName	String	User A	Related user’s name for the operation
RelatedUserId	String	1Q1TUBQWVHJFF	Identifier of Related User
Size	Long	100	Item size in bites
FileId	String	331TUBQWVHJFF	File ID
FolderId	String	131TUBQWVHJFF	Folder ID
PartialUpload	Boolean	False	Indicates incomplete upload for an item
ExternalUserEmail	String	Extuser@abc.com	Email of external user which belong to the operation
Priority	String	High	Only for Secure Message High Normal Low
DateDeleted	DateTime	/Date(1343838136630)/	Only for Secure Message Message delete date in Unix epoch format including slashes
DateExpire	DateTime	/Date(1343838136630)/	Only for Secure Message Message expire date in Unix epoch format including slashes
DateSent	DateTime	/Date(1343838136630)/	Only for Secure Message Message sent date in Unix epoch format including slashes
IsExpired	Boolean	False	Only for Secure Message Is message expired
NotifyFlag	Boolean	False	Only for Secure Message Notification required flag
Subject	String	Test	Only for Secure Message Message Subject
TrackingNo	String	T478-014-93928-94469	Only for Secure Message Message Tracking Id
AgreementID	String	1214	Only for Secure Message Reference to Agreement Id used for the message
IsProtected	Boolean	True	Only for Secure Message Indicates if message protected or not
RequestRecipientLogin	Boolean	True	Only for Secure Message Indicates if message requires recipient login

Sample JSON

JSON

{
            "FileSystemLogOpId": "1H5B2YZL2VDJW",
            "FileSystemLogId": "008AOV8Y185FR",
            "UserID": "1UBRSWNZCJDCS",
            "UserFullName": "Ilia Gimpels",
            "UserEmail": "ilia.gimpels@gmail.com",
            "Operation": 8192,
            "OperationName": "Secure Message",
            "ClientIPAddress": "127.0.0.1",
            "OperationDateCreated": "11/1/2023 1:19:47 PM",
            "Note": null,
            "ApplicationName": "Web Edition",
            "ApplicationShortName": "Web",
            "IsTop": null,
            "LogDateCreated": "11/1/2023 1:19:47 PM",
            "Status": true,
            "Name": "Screenshot 2023-10-30 190716.png",
            "Path": "/FOLDERS/OUTBOX/ilia.gimpels.gmail.com/2023-11/01/1698844780695",
            "Size": 151979,
            "FileId": "21EQZ4QYM562Q",
            "Priority": "Normal",
            "DateExpire": "11/15/2023 11:59:00 PM",
            "DateSent": "11/1/2023 1:19:47 PM",
            "IsExpired": true,
            "NotifyFlag": true,
            "Subject": "test2",
            "TrackingNo": "T478-014-93928-94469",
            "IsProtected": false,
            "RequestRecipientLogin": "Yes"
        }

Data Transfer Object

C#

public class ThruPublicAuditFileSystemTransactionAction
{
    public string FileSystemLogOpId { get; set; }
    public string FileSystemLogId { get; set; }
    public string UserID { get; set; }
    public string UserFullName { get; set; }
    public string UserEmail { get; set; }
    public int Operation { get; set; }
    public string OperationName { get; set; }
    public string ClientIPAddress { get; set; }
    public DateTime OperationDateCreated { get; set; }
    public string Note { get; set; }
    public string ApplicationName { get; set; }
    public string ApplicationShortName { get; set; }
    public bool? IsTop { get; set; }
    public DateTime? LogDateCreated { get; set; }
    public bool? Status { get; set; }
    public string Name { get; set; }
    public string NextName { get; set; }
    public string PreviousName{ get; set; }
    public string Path{ get; set; }
    public string NextPath{ get; set; }
    public string PreviousPath{ get; set; }
    public string Description{ get; set; }
    public string PreviousDescription{ get; set; }
    public int? FolderPermission{ get; set; }
    public int? PreviousFolderPermission{ get; set; }
    public string RelatedUserEmail{ get; set; }
    public string RelatedUserName{ get; set; }
    public string RelatedUserId{ get; set; }
    public long? Size{ get; set; }
    public string FileId{ get; set; }
    public string FolderId{ get; set; }
    public bool? PartialUpload{ get; set; }
    public string ExternalUserEmail{ get; set; }
    public string Priority{ get; set; }
    public DateTime? DateDeleted{ get; set; }
    public DateTime? DateExpire{ get; set; }
    public DateTime? DateSent{ get; set; }
    public bool? IsExpired{ get; set; }
    public bool? NotifyFlag{ get; set; }
    public string Subject{ get; set; }
    public string TrackingNo{ get; set; }
    public string AgreementID{ get; set; }
    public bool? IsProtected{ get; set; }
    public string RequestRecipientLogin{ get; set; }   
}

5.14.2 ThruPublicAuditUserGroupAction

ThruPublicAuditUserGroupAction structure contains the extended list of properties which can be filled for User Group Log Operations. Depending of operation type some of them will be equal to NULL.

Item Name	Data Type	Sample Value	Comments
UserGroupLogID	String	1Q1OBQWVHTROE	Identifier of Log Operation
UserID	String	1Q1TUBQWVHJGD	Identifier of User
UserGroupID	String	1Q1TUBQWVHJGD	Identifier of User Group
UserFullName	String	A B	User’s full name
UserEmail	String	Test	User’s last name
Operation	String	int	Operation Id
OperationName	String	Internal Upload	Operation Name
ClientIPAddress	String		User’s client IP address
DateCreated	DateTime	/Date(1337174868567)/	Log Operation’s date create (UTC)
PerformedByUserID	String	1Q1TUBQWVHJGD	Identifier of User who performed the operation
PerformedByUserFullName	String	T C	User’s full name who performed the operation
PerformedByUserEmail	String	TC@abc.com	User’s email who performed the operation
PreviousGroupName	string	Group1	Group name before rename
GroupModifierRole	string	Administrator	User’s role who can modify the group
GroupName	string	Group2	Group name
PreviousGroupModifierRole	String	Test.jpg	Previous user’s role who can modify the group

Sample JSON

JSON

{
            "UserGroupLogID": "FGFHDJGDJHGKJ",
            "UserID": "BNJVKGBGFHJDV",
            "UserGroupID": "XXXXXXXX",
            "UserFullName": "WAS ",
            "UserEmail": "zzzzz@zzzz.com",
            "Operation": 4,
            "OperationName": "Add User",
            "ClientIPAddress": "81.95.27.2",
            "DateCreated": "6/26/2017 2:19:46 PM",
            "PerformedByUserID": "XXXXXXXXX5",
            "PerformedByUserFullName": "Administrator A",
            "PerformedByUserEmail": "operations@thruinc.com",
            "GroupModifierRole": "Administrator",
            "GroupName": "ACCOUNT APPROVALS"
}

Data Transfer Object

C#

public class ThruPublicPrivateAuditUserGroupAction
{
    public string UserGroupLogID { get; set; }
    public string UserID { get; set; }
    public string UserGroupID { get; set; }
    public string UserFullName { get; set; }
    public string UserEmail { get; set; }
    public int Operation { get; set; }
    public string OperationName { get; set; }
    public string ClientIPAddress { get; set; }
    public DateTime DateCreated { get; set; }
    public string PerformedByUserID { get; set; }
    public string PerformedByUserFullName { get; set; }
    public string PerformedByUserEmail { get; set; }
    public string PreviousGroupName { get; set; }
    public string GroupModifierRole { get; set; }
    public string GroupName { get; set; }
    public string PreviousGroupModifierRole { get; set; }
}

5.14.3 ThruPublicAuditUserAction

ThruPublicAuditUserAction structure contains the extended list of properties which can be filled for User Log Operations. Depending of operation type some of them will be equal to NULL.

Item Name	Data Type	Sample Value	Comments
UserLogID	String	1Q1OBQWVHTROE	Identifier of Log Operation
UserID	String	1Q1TUBQWVHJGD	Identifier of User
UserFullName	String	A B	User’s full name
UserEmail	String	Test	User’s last name
OperationId	String	1	Operation Id
OperationName	String	Authenticate User	Operation Name
ClientIPAddress	String		User’s client IP address
ClientVersion	String
DeviceUID	String
ApplicationID	int	1
ApplicationName	String	Web Edition
SSOFlag	Boolean	true
IsApproved	Boolean	true
AgreementID	int
AuthStatus		Approved
DateCreated	DateTime	/Date(1337174868567)/	Log Operation’s date create (UTC) in Unix epoch format including slashes
PerformedByUserID	String	1Q1TUBQWVHJGD	Identifier of User who performed the operation
PerformedByUserFullName	String	T C	User’s full name who performed the operation
PerformedByUserEmail	String	TC@abc.com	User’s email who performed the operation
Note	String		Operation Note

Sample JSON

JSON

{
            "UserLogID": "2CWC3XXXXTFU",
            "UserID": "3IDCCCXX3AAXZP",
            "UserFullName": "xxx A",
            "UserEmail": "xxx@thruinc.com",
            "OperationId": 1,
            "OperationName": "Authenticate User",
            "ClientIPAddress": "1.1.1.1",
            "ClientVersion": null,
            "DeviceUID": null,
            "ApplicationID": 1,
            "ApplicationName": "Web Edition",
            "SSOFlag": false,
            "IsApproved": true,
            "AgreementID": null,
            "AuthStatus": "Approved",
            "DateCreated": "6/16/2017 11:05:35 PM",
            "PerformedByUserID": "3IDVVVV3AAXZP",
            "PerformedByUserFullName": "xxxx",
            "PerformedByUserEmail": "xxxx@thruinc.com",
            "Note": null
        }

Data Transfer Object

C#

public class ThruPublicAuditUserAction
{
    public string UserLogID { get; set; }
    public string UserID { get; set; }
    public string UserFullName { get; set; }
    public string UserEmail { get; set; }
    public int OperationId { get; set; }   
    public string OperationName { get; set; }
    public string ClientIPAddress { get; set; }
    public string ClientVersion { get; set; }
    public string DeviceUID { get; set; } 
    public int ApplicationID { get; set; }
    public string ApplicationName { get; set; }
    public bool SSOFlag { get; set; }
    public bool? IsApproved { get; set; }
    public string AgreementID { get; set; }
    public string AuthStatus { get; set; }
    public DateTime DateCreated { get; set; }
    public string PerformedByUserID { get; set; }
    public string PerformedByUserFullName { get; set; }
    public string PerformedByUserEmail { get; set; }
    public string Note { get; set; }
}