v1.3.0

[v1.3.0] - August 1st, 2024

Added

• Categories

  1. Added Remediation category. #1066

• Event Classes

  1. Added Event Log Activity event class to the System Activity category. #1014
  2. Added Remediation Activity, File Remediation Activity, Process Remediation Activity, Network Remediation Activity event classes to the Remediation category. #1066
  3. Added Windows Service Activity event class to the System Activity category via Windows extension. #1103
  4. Added Software Inventory Info event class to the Discovery category. #1134

• Profiles

  1. Added osint Profile based on the osint object. #992

• Objects

  1. Added d3fend, d3f_tactic, d3f_technique MITRE objects. #1066
  2. Added ja4_fingerprint object. #834
  3. Added ja4_fingerprint_list as a list of ja4_fingerprint objects. #834
  4. Added ticket object. #1068
  5. Added osint object. #992
  6. Added signatures object, an array of signature objects. #992
  7. Added whois object. #992
  8. Added domain_contact and array-typed domain_contacts object for use with whois object. #992
  9. Added Windows Service object to the Windows extension. #1103
  10. Added timespan object. #1125

Improved

• Categories

  n/a

• Event Classes

  1. Added file_result to File Hosting Activity. #1045
  2. Added entries to injection_type_id enum (Process Activity) and activity_id enum (Memory Activity). #1060
  3. Added a Restart, Enable, Disable, and Update activity_id to the Application Lifecycle class. #1064
  4. Added ja4_fingerprint_list to base network event class. #834
  5. Added ticket to Incident Finding event class. #1068
  6. Added new activities Enroll, Activate, Deactivate, Suspend, and Resume to the Entity Management class. #1095
  7. Added new activity Listen to Network Activity and relax requirement of src_endpoint. #1147
  8. Added state, state_id to Device Config State Change. #1143
  9. Added resources attribute to Vulnerability Finding and Compliance Finding. #1150

• Profiles

  n/a

• Objects

  1. Added ext to File object. #1046
  2. Added account, device, email, url, user to evidences in detection finding. #1000
  3. Added state_id, state to Digital Signature object. #1069
  4. Added domain to Uniform Resource Locator object. #1096
  5. Added reg_key and reg_value to Evidence Artifacts object. #1078
  6. Added type_id and associated entity objects to Managed Entity. #1094
  7. Added vendor_name, type, type_id to object package. #1093
  8. Added router, ids, and ips entries to type_id enum in the Endpoint object. #1121
  9. Added job to Evidence Artifacts object. #1130
  10. Added ip to object load_balancer. #1138
  11. Added cpe_name and hash to Software Package object. #1142
  12. Added avg_timespan to the kb_article object. #1125
  13. Added created_time,desc, short_desc, reputation, src_url to enrichment object. #1149
  14. Added compliance_references, compliance_standards to the compliance object. #1110

Bugfixes

1. Fixed the host profile construction in patch_state event class. #1087
2. Removed the optional requirement overrides for name and uid in _resource as they are part of a constraint. #1087
3. Fixed declarations of data_lifecycle_state_id, integrity, opcode_id, risk_level, and analytic.type_id. #1111

Deprecated

1. Deprecated resource in Vulnerability Finding and Compliance Finding event classes in favor of resources. #1150

Breaking changes

n/a

Misc

1. Colorized validator output #1048
   • Updated the GitHub workflow for the ocsf-validator to print colorized output.
2. Clarify how to reference profiles in metadata #1056
   • Updated the description of metadata.profiles to clarify the correct way to reference a profile in that list.
3. Added a gitignore file. #1071
4. New Extension registration for Cisco #1074
5. Cleaned up MITRE trademarks and registrations for captions and descriptions.
6. Declared enums in dictionary.json have sane "0" (Unknown) and "99" (Other) declarations and descriptions where appropriate #1111
7. Adds support for suppress_checks controls in attributes to allow tools to automatically validate conventions #1063
   • Updated several attributes that do not follow conventions to disable linting for them
8. Added credential_uid as an Observable type - type_id: 19. #1137
9. New Extension registration for US Gov #1140
10. Enum definitions are now refactored such that generic enum descriptions have "See specific usage" in the description #1146

v1.2.0

[v1.2.0] - April 23rd, 2024

Added

• Categories

  n/a

• Event Classes

  1. Added Data Security Finding event class. #953
  2. Added File Query event class. #967
  3. Added Folder Query event class. #967
  4. Added Group Query event class. #967
  5. Added Job Query event class. #967
  6. Added Kernel Object Query event class. #967
  7. Added Module Query event class. #967
  8. Added Network Connection Query event class. #967
  9. Added Networks Query event class. #967
  10. Added Peripheral Device Query event class. #967
  11. Added Prefetch Query event class. #967
  12. Added Process Query event class. #967
  13. Added Registry Key Query event class. #967
  14. Added Registry Value Query event class. #967
  15. Added Service Query event class. #967
  16. Added Session Query event class. #967
  17. Added User Query event class. #967
  18. Added Tunnel Activity event class. #1012

• Profiles

  1. Added data_classification profile. #998

• Objects

  1. Added auth_factor object. #949
  2. Added data_security object. #953
  3. Added autonomous_system object. #978
  4. Added agent object. #987
  5. Added data_classification object. #998

• Observables

  1. Added port_t subnet_t cmd_line country pid cwe.uid cve.uid user_agent enum items. #1035

• Platform Extensions

  n/a

Improved

• Categories

  n/a

• Event Classes

  1. Added auth_factors array to Authentication event class. #949
  2. Modified all classes such that primary attributes are at least recommended. #974
  3. Added src_endpoint, http_request attributes to all IAM category classes. #976
  4. Added autonomous_system to network_endpoint objects. #978
  5. Added List, Encrypt and Decrypt activities to datastore event class. #989
  6. Added file attribute to http, rdp, ssh, and ftp event classes. #985
  7. Added a Preauth activity_id to the Authentication class. #1018
  8. Added the Security Control profile to the Datastore Activity class. #1030
  9. Added risk_details to Detection Finding. #1032

• Profiles

  n/a

• Objects

  1. Expanded type_id enum in analytic object to account for more use-cases: #953
     • 5 - Fingerprinting
     • 6 - Tagging
     • 7 - Keyword Match
     • 8 - Regular Expressions
     • 9 - Exact Data Match
     • 10 - Partial Data Match
     • 11 - Indexed Data Match
  2. Added lat, long, geohash attributes to location object. #971.
  3. Added risk_score, risk_level_id, risk_level to user object. Issue #972.
  4. Added app_name, app_uid to actor object. Issue #966, PR #979.
  5. Added container, database, databucket to the evidences object. #984
  6. Added owner to endpoint object. #987
  7. Added is_applied Boolean attribute to policy object. #987
  8. Added agent_list as an array of agent objects. #987
  9. Added policies object as an array of policy objects. #987
  10. Added agent_list to endpoint object. #987
  11. Added labels to the Account object. #1028
  12. Added data_classification profile to database, databucket, email, file, metadata, product, resource_details and web_resource objects. #998

• Platform Extensions

  n/a

Bugfixes

1. Changed datatype of priority attribute, from integer_t to string_t #959
2. Extended email_t regexp to allow characters from RFC5322 before @.
3. Updated logon_type_id enum to include 0 as Unknown. Added enum item 1 as System. #1055

Deprecated

1. Deprecated coordinates attribute in favor of specific lat, long attributes. #971
2. Deprecated invoked_by attribute in the Actor object in favor of app_name. #979.

Breaking changes

n/a

Misc

1. New Extension registration for Sedara. #951
2. Corrected punctuation for the transmit_time attribute. #1001
3. New ways to define observables in the metaschema. #982 and #993
   • (Current) Dictionary types using observable property in dictionary types. This allows defining all occurrences of attributes of this type as an observable.
   • (Current) Objects using top-level observable property. This allows defining all occurrences attributes whose type is this object as an observable.
   • (New) Dictionary attributes using observable property in attribute. This allows defining all occurrences of this attribute as an observable.
   • (New) Object-specific attributes using observable property class's attributes. This allows defining object attributes as observables only within instances of this specific object.
   • (New) Event class-specific attributes using observable property class's attributes. This allows defining class attributes as observables only within instances of this specific class.
   • (New) Event class-specific attribute paths using top-level observables property. The observables property holds an object mapping from a dotted attribute path to an observable type_id. This allows defining an observable only within instances of this specific class, and only for the attributes at these paths, even for attributes that are within nested objects and arrays. This can also be used for top-level class attributes, which can be more convenient that defining a class attribute observable for classes that extend another, but don't otherwise change an attribute definition.
4. Metaschema improvements. #993
   • Detect unexpected top-level properties in object and event class definitions. This was added at this point to detect invalid observable definitions: invalid observable property in event classes, and invalid observables property in objects.
   • Remove hard-coded list of categories from metaschema/categories.schema.json, leaving this to the ocsf-validator. This change makes testing with alternate schemas that may add extra categories easier, as well as making it possible to validate private extensions that contain new categories.
5. Metaschema error reporting #1027
   • Updated the definition of object and event so that metaschema errors reported by the validator with nested properties correctly attribute the error to the property with the error, rather than the top-level class.

OCSF Schema Release v1.1.0

[v1.1.0] - January 25th, 2024

Added

• Categories

  n/a

• Event Classes

  1. Added User Inventory Info event class. #667
  2. Added Vulnerability Finding event class. #698
  3. Added NTP Activity event class #705
  4. Added OS Patch State event class. #746
  5. Added Datastore Activity event class 6005. #874
  6. Added Detection Finding event class. #877
  7. Added Incident Finding event class. #903
  8. Added Device Config Sate Change event class. #914
  9. Added Scan Activity event class. #915
  10. Added File Hosting Activity event class. #917

• Profiles

  1. Added Network Proxy Profile for the Network Activity and Application Activity classes. #705
  2. Added Load Balancer Profile for the Network Activity classes. #897

• Objects

  1. Added new cwe object to cve and vulnerability objects. #678
  2. Added Firewall Rule object. #685
  3. Added new kb_article object to house Knowledgebase Article info. #709 #862 #924
  4. Added new epss object to the cve object. #741

Improved

• Categories

  1. Improved Findings Category, with new and domain specific event classes (Vulnerability Finding, Compliance Finding, Detection Finding, Incident Finding), description updates across the board. #895 #907 #903 #698 #718

• Event Classes

  1. Added MFA Enable and Disable to activity_id to the Account Change event class. #724
  2. Added Service Ticket Renew to activity_id of the Authentication event class. #765
  3. Added url attribute to Network Activity event class. #857
  4. Added http_request, http_response, tls attributes, network_proxy profile to Web Resources Activity event class. #895
  5. Adjusted requirement of dst_endpoint from required to recommended in the DNS Activity event class. #901
  6. Added Create and Delete to activity_id of the Group Management event class. #929

• Profiles

  1. Improved security_control profile to include access control semantics, firewall properties. #851 #888 #889 #906

• Objects

  1. Added url_string attribute to the product and the web_resource objects. #675
  2. Added type and type_id attributes to the endpoint object. #690
  3. Added cwe, desc, references and title to cve object. #698
  4. Added affected_package object andaffected_packages attribute to vulnerability object. #698
  5. Added purl to package object. #698
  6. Added cpe_name attribute to the product and os objects. #713 #731
  7. Added container and data to response and request objects. #738
  8. Added group to the api object. #738
  9. Added namespace to the resource_details object. #738
  10. Added log_level to the metadata object. #738
  11. Added length to the http_request object. #768
  12. Added is_exploit_available to the vulnerability object. #777
  13. Added domain attribute to the group object. #871
  14. Adjusted attribute requirements in dns_query, dns_answer objects. #879
  15. Added firewall, router, switch, hub to endpoint type_id enum. #921
  16. Added is_vpn to the session object. #922
  17. Added state to network_connection_info object. #932

Bugfixes

n/a

Deprecated

1. Deprecated cwe_uid and cwe_url attributes and removed from cve object. #678
2. Deprecated http_status attribute from HTTP Activity event to be replaced by http_response.code. #767
3. Deprecated finding object in favor of finding_info object. #769
4. Deprecated proxy attribute from the dictionary, in favor of Network Proxy profile. #856
5. Deprecated group_name attribute. #873
6. Deprecated Security Finding class to be replaced by the new specific classes according to the use-case: Vulnerability Finding, Compliance Finding, Detection Finding, Incident Finding. #877
7. Deprecated Web Resources Access Activity event class. #890
8. Deprecated Network File Activity event class in favor of File Hosting Activity #917
9. Deprecated extension_list in TLS object in favor of tls_extension_list. #936

Breaking changes

n/a

Misc

1. New Extension registration for SentinelOne. #706
2. Added json-schema based metaschema validation to ensure correctness, consistency of the JSON definitions. #736 #830 #867 #892
3. Increased max_len for subnet_t type from 40 to 42. #745
4. Improved the regex for ip_t type. #745
5. Updated the datetime_t validation regex to enable validation of timestamps, and to ensure that timestamps not matching RFC-3339 are not considered valid. #753
6. Added version information to the native extensions. #881
7. Updated caption and description of Observable type - File Hash to read Hash. #900
8. New Extension registration for DataBee. #912
9. Changed data-type of type_uid to long_t from int_t. #928

OCSF Schema Release v1.0.0

The OCSF Schema Release v1.0.0!

Note: New release package was cut from the v1.0.0 branch. See Issue #793 for details

OCSF Schema Release Candidate 3 (v1.0.0-rc.3)

The OCSF Schema Release Candidate 3 (v1.0.0-rc.3) contain many updates and additions, and the release is not backwards compatible with the OCSF Schema Release Candidate 2 (v1.0.0-rc.2).

OCSF Schema Release Candidate 2

The same release as 0.99.2.rc2, no schema changes. Using a new version name and tag: v1.0.0-rc.2.

OCSG Schema Release Candidate 2

Add session to process object and authentication and authorization classes.
Some updates in descriptions.

OCSF Schema Release Candidate 1

Merge pull request #464 from splunk/main

Email and some final schema updates

The first alpha release

This is an alpha release v0.39.0.