Document toolboxDocument toolbox

cloud.box

Introduction

The tags beginning with cloud.box identify events generated by Box.

Valid tags and data tables

The full tag must have 4 levels. The first two are fixed as cloud.box. The third level identifies the type of events sent, and the fourth level indicates the event subtype.

Technology

Brand

Type

Subtype

cloud

box

  • events
  • json

These are the valid tags and corresponding data tables that will receive the parsers' data:

Tag

Data table

cloud.box.events.json

cloud.box.events

How is the data sent to Devo?

Logs generated by Box are forwarded to Devo using a dedicated collector. Contact us if you need to forward these events to your Devo domain so we can guide you through the process. 

Log samples

The following are sample logs sent to the cloud.box data tables. Also, find how the information will be parsed in your data table under each sample log.

Extra columns

Fields marked as Extra in the table below are not shown by default in data tables and need to be explicitly requested in the query. You can find them marked as Extra when you perform a query so they can be easily identified. Learn more about this in Selecting unrevealed columns.

cloud.box.events.json

2021-07-22 15:19:34.993 macbook-pro.lan=127.0.0.1 cloud.box.events.json: {"source":{"folder_id": "96306441781", "folder_name": "Folder One", "user_id": "465797270", "user_name": "Charles Xavier", "item_type":"file","item_id":"222780919171","item_name":"120414_familysouthafrica_at_2991_2190x1460-small-96.jpg","parent":{"type":"folder","name":"Data","id":"37694211889"},"owned_by":{"type":"user","id":"274090493","name":"Phillip Loughran","login":"phillip.loughran@acme.com"}},"created_by":{"type":"user","id":"274090493","name":"Phillip Loughran","login":"phillip.loughran@acme.com"},"action_by":null,"created_at":"2019-03-27T23:26:54-07:00","event_id":"bbca4613-4eae-41f0-99bb-a92aade8fb7c","event_type":"DELETE","ip_address":"1.2.3.4","type":"event","session_id":null,"additional_details":{"size":20575,"version_id":"235287612547"}}2021-07-22 15:19:34.993 macbook-pro.lan=127.0.0.1 cloud.box.events.json: {"source":{"item_type":"file","item_id":"222780919171","item_name":"120414_familysouthafrica_at_2991_2190x1460-small-96.jpg","parent":{"type":"folder","name":"Data","id":"37694211889"},"owned_by":{"type":"user","id":"274090493","name":"Phillip Loughran","login":"phillip.loughran@acme.com"}},"created_by":{"type":"user","id":"274090493","name":"Phillip Loughran","login":"phillip.loughran@acme.com"},"action_by":null,"created_at":"2019-03-27T23:26:54-07:00","event_id":"bbca4613-4eae-41f0-99bb-a92aade8fb7c","event_type":"DELETE","ip_address":"1.2.3.4","type":"event","session_id":null,"additional_details":{"shared_link_id":"External Shared Link", "size":20575,"version_id":"235287612547"},"accessible_by":{"type":"user","id":"413220813","name":"BLAH BLASH","login":"BLAH.BLASH@custom.com"}}2021-07-22 15:19:34.993 macbook-pro.lan=127.0.0.1 cloud.box.events.json: {"source": {"type": "user", "id": "422385849", "name": "Peter Kilburn", "login": "Peter.Kilburn@acme.com"}, "created_by": {"type": "user", "id": "422385849", "name": "Peter Kilburn", "login": "Peter.Kilburn@acme.com"}, "action_by": null, "created_at": "2019-07-29T01:14:50-07:00", "event_id": "e8b18626-ffe2-4b40-bd96-8cdb1860f709", "event_type": "LOGIN", "ip_address": "165.225.80.104", "type": "event", "session_id": null, "additional_details": null}2021-07-22 15:19:34.993 macbook-pro.lan=127.0.0.1 cloud.box.events.json: {"source": null, "created_by": {"type": "user", "id": "2", "name": "Unknown User", "login": ""}, "action_by": null, "created_at": "2019-12-20T11:38:56-08:00", "event_id": "97f1b31f-f143-4777-81f8-1b557b39ca33", "event_type": "SHIELD_ALERT", "ip_address": "10.1.2.3", "type": "event", "session_id": null, "additional_details": {"shield_alert": {"rule_category": "Suspicious Locations", "rule_id": 123, "rule_name": "Suspicious Location", "risk_score": 60, "alert_summary": {"alert_activities": [{"occurred_at": "2019-12-20T11:37:05-08:00", "event_type": "Download", "item_name": "xyz.txt", "item_type": "file", "item_id": "127", "item_path": "ABC/DEF", "ip_info": {"ip": "1.2.3.4", "latitude": "37.5555", "longitude": "-120.6789", "registrant": "Microsoft Corporation", "country_code": "US", "city_name": "San Jose", "region_name": "California"}, "service_name": "Box Excel Online Previewer"}]}, "alert_id": 2398, "priority": "medium", "user": {"id": 2320, "name": "Some name", "email": "some@email.com"}, "link": "https://app.box.com/master/shield/alerts/1343", "created_at": "2019-12-20T11:37:15-08:00"}}}2021-07-22 15:19:35.080 macbook-pro.lan=127.0.0.1 cloud.box.events.json: {"source": null, "created_by": {"type": "user", "id": "2", "name": "Unknown User", "login": ""}, "action_by": null, "created_at": "2019-12-20T11:38:56-08:00", "event_id": "97f1b31f-f143-4777-81f8-1b557b39ca33", "event_type": "SHIELD_ALERT", "ip_address": "10.1.2.3", "type": "event", "session_id": null, "additional_details": {"shield_alert": {"rule_category": "Suspicious Sessions", "rule_id": 123, "rule_name": "Suspicious Session", "risk_score": 77, "alert_summary": {"description": "First time in prior month user connected from ip 2.3.4.5 First time user agent Some User Agent (Some UA 4.5.6) appeared for user within prior month Apparent distance 9580.0 km between events 59 seconds apart is faster than possible", "sessions": [{"session_type": "suspicious", "activities": [{"occurred_at": "2019-12-19T11:37:00-08:00", "event_type": "Set shared link expiration", "item_name": "xyz.txt", "item_type": "file", "item_id": "123456", "item_path": "ABC/DEF", "ip_info": {"ip": "2.3.4.5", "latitude": "37.5555", "longitude": "-120.6789", "registrant": "Microsoft Corporation", "country_code": "US", "city_name": "San Jose", "region_name": "California"}, "service_name": "ServiceName"}]}, {"session_type": "typical", "activities": [{"occurred_at": "2019-12-19T11:37:59-08:00", "event_type": "Item Modified", "item_name": "abc.boxnote", "item_type": "file", "item_id": "123123", "item_path": "folder/sub folder", "ip_info": {"ip": "4.5.6.7", "latitude": "37.5555", "longitude": "-20.6789", "country_code": "US", "city_name": "Some City", "region_name": "XYZ"}, "service_name": "Box Notes"}]}]}, "alert_id": 500, "priority": "medium", "user": {"id": 50500, "name": "A b c", "email": "a@b.c"}, "link": "https://cloud.app.box.com/master/shield/alerts/500", "created_at": "2019-12-20T11:38:16-08:00"}}}

And this is how the log would be parsed:

Field

Value

Type

Extra field

Field transformation

Source field name

eventdate

2021-07-22 15:19:34.993

timestamp




event_type

DELETE

str




event_id

bbca4613-4eae-41f0-99bb-a92aade8fb7c

str




timestamp

2019-03-28 06:26:54.0

timestamp


parsedate(replace(created_at, "T", " "), "YYYY-MM-DD HH:mm:ssZZ")

created_at

ip_address

/1.2.3.4

ip4




session_id

null

str




created_by_login

phillip.loughran@acme.com

str




created_by_type

user

str




created_by_id

274090493

str




created_by_name

Phillip Loughran

str




accessible_by_login

null

str




accessible_by_type

null

str




accessible_by_id

null

str




accessible_by_name

null

str




source_type

null

str




source_id

null

str




source_name

null

str




source_login

null

str




source_item_id

222780919171

str




source_item_type

file

str




source_item_name

120414_familysouthafrica_at_2991_2190x1460-small-96.jpg

str




source_parent_type

folder

str




source_parent_name

Data

str




source_parent_id

37694211889

str




source_owned_by_login

phillip.loughran@acme.com

str




source_owned_by_type

user

str




source_owned_by_id

274090493

str




source_owned_by_name

Phillip Loughran

str




source_user_name

Charles Xavier

str




source_user_id

465797270

str




source_folder_name

Folder One

str




source_folder_id

96306441781

str




additional_details_service_id

null

str




additional_details_version_id

235287612547

str




additional_details_service_name

null

str




additional_details_size

20575

int8




additional_details_file_path

null

str




additional_details_file_hash

null

str




additional_details_hash_type

null

str




additional_details_shared_link_id

null

str




additional_details_ekm_id

null

str




additional_details_shield_alert_rule_category

null

str




additional_details_shield_alert_rule_id

null

str




additional_details_shield_alert_rule_name

null

str




additional_details_shield_alert_risk_score

null

int4




additional_details_shield_alert_alert_summary

null

str




additional_details_shield_alert_alert_id

null

int4




additional_details_shield_alert_priority

null

str




additional_details_shield_alert_user

null

str




additional_details_shield_alert_link

null

str




additional_details_shield_alert_created_at

null

str




additional_details_shield_external_collab_enforcement_item

null

str




additional_details_shield_external_collab_enforcement_inviter

null

str




additional_details_shield_external_collab_enforcement_invitee

null

str




additional_details_shield_external_collab_enforcement_accessUser

null

str




additional_details_shield_external_collab_enforcement_additionalInfo

null

str




additional_details_shield_external_collab_enforcement_createdAt

null

str




additional_details_shield_external_collab_enforcement_justification

null

str




additional_details_shield_external_collab_enforcement_classification

null

str




additional_details_shield_external_collab_enforcement_service

null

str




additional_details_sharedLinkSettings_newVisibilityStatus

null

str




additional_details_sharedLinkSettings_newIsPasswordProtected

null

bool




additional_details_sharedLinkSettings_newCanPreview

null

bool




additional_details_sharedLinkSettings_newCanEdit

null

bool




additional_details_sharedLinkSettings_newCanDownload

null

bool




additional_details_sharedLinkSettings_newIsExpirationDateSet

null

bool




additional_details_security_information_accessFromSharedObject

null

str




action_by

null

str




message

{"source":{"folder_id": "96306441781", "folder_name": "Folder One", "user_id": "465797270", "user_name": "Charles Xavier", "item_type":"file","item_id":"222780919171","item_name":"120414_familysouthafrica_at_2991_2190x1460-small-96.jpg","parent":{"type":"folder","name":"Data","id":"37694211889"},"owned_by":{"type":"user","id":"274090493","name":"Phillip Loughran","login":"phillip.loughran@acme.com"}},"created_by":{"type":"user","id":"274090493","name":"Phillip Loughran","login":"phillip.loughran@acme.com"},"action_by":null,"created_at":"2019-03-27T23:26:54-07:00","event_id":"bbca4613-4eae-41f0-99bb-a92aade8fb7c","event_type":"DELETE","ip_address":"1.2.3.4","type":"event","session_id":null,"additional_details":{"size":20575,"version_id":"235287612547"}}

str



rawSource

hostchain

macbook-pro.lan=127.0.0.1

str




tag

cloud.box.events.json

str




rawMessage


str



rawSource