Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

2.2.8 release #438

Merged
merged 49 commits into from
Dec 19, 2024
Merged

2.2.8 release #438

merged 49 commits into from
Dec 19, 2024

Conversation

bk-cs
Copy link
Collaborator

@bk-cs bk-cs commented Dec 19, 2024

Removed Commands

ioa

  • Get-FalconCloudIoaEvent
  • Get-FalconCloudIoaUser

New Commands

billing-dashboards-usage

  • Get-FalconHostAverage

device-content

  • Get-FalconContentState

identity-protection

  • Get-FalconIdentityRule
  • New-FalconIdentityRule
  • Remove-FalconIdentityRule

policy-content-update

  • Edit-FalconContentPolicy
  • Get-FalconContentPolicy
  • Get-FalconContentPolicyMember
  • Invoke-FalconContentPolicyAction
  • New-FalconContentPolicy
  • Remove-FalconContentPolicy
  • Set-FalconContentPrecedence

quickscanpro

  • Remove-FalconQuickScan
  • Remove-FalconQuickScanFile
  • Send-FalconQuickScanFile

snapshots

  • Get-FalconSnapshotCredential
  • New-FalconSnapshotAwsAccount

Issues Resolved

General Changes

  • Fixed some error message output for Request-FalconToken and Test-FalconToken.

Command Changes

ConvertTo-FalconFirewallRule

  • Added protocol as a required field for the Map table and rule creation.

Edit-FalconReconRule

  • Added MatchOnTsqResultType.

Export-FalconConfig

  • Added ContentPolicy as a value for Select parameter.

Get-FalconChannelControl

  • Renamed to Get-FalconContentControl. Get-FalconChannelControl has been kept as an alias.

Get-FalconHost

  • Added content_state as an Include value.

Get-FalconIoaExclusion

  • Added ClRegex and IfnRegex.

Get-FalconQuickScan

  • Updated to use new QuickScan Pro API.

Get-FalconVulnerability

  • Updated to set Limit to 400 when using All without Detailed to prevent
    5000 is an invalid page size, must be between 1 and 400 error.

Import-FalconConfig

  • Added support for Content Update policies.
  • Added ContentPolicy as a value for ModifyExisting and ModifyDefault parameters.

Invoke-FalconAdminCommand

  • Added tar as a valid Command value.

Invoke-FalconResponderCommand

  • Added tar as a valid Command value.
  • Added update query as a valid Command which was mistakenly removed in a previous release.

New-FalconCompleteCase

  • Added MalwareSubmissionId and ReconRuleType.

New-FalconQuickScan

  • Updated to use new QuickScan Pro API, which is replacing the regular QuickScan API.

New-FalconReconRule

  • Added MatchOnTsqResultType.

Receive-FalconCloudAwsScript

  • Added DspmEnabled, DspmRegion, and DspmRole.

Receive-FalconScheduledReport

  • Updated to use a combination of the last_execution.id and report_params.format fields to define a
    filename if Path is left undefined and is being passed a report via pipeline. This will ensure that
    "scheduled reports" (i.e. vulnerability reports) are successfully downloaded without providing a Path.

Set-FalconChannelControl

  • Renamed to Set-FalconContentControl. Set-FalconChannelControl has been kept as an alias.

bk-cs added 30 commits September 5, 2024 15:08
Updated internal function to evaluate FalconSensorTags and re-wrote scripts for FalconSensorTag manipulation through Real-time Response to fix the inability to add/remove FalconSensorTags on Linux. This also fixed the same issue that was impacting MacOS hosts.
Removed comment
Fixed some error message output for `Request-FalconToken` and `Test-FalconToken`.
Updated `Get-FalconVulnerability` to set `Limit` to `400` when using `All` without `Detailed` to prevent `5000 is an invalid page size, must be between 1 and 400` error.
Added `DspmEnabled`, `DspmRegion`, and `DspmRole` to `Receive-FalconCloudAwsScript`

Updated `Receive-FalconCloudAwsScript` to ensure that `OrganizationId` used updated parameter name during API submission
Updated `Uninstall-FalconSensor` to properly select bash uninstall script when targeting Linux hosts.
Added `tar` to valid `Command` list for `Invoke-FalconAdminCommand` and `Invoke-FalconResponderCommand`

Corrected `Invoke-FalconAdminCommand` to properly include the `Command` value `update query`
Increased `[System.Net.Http.HttpClient]` default timeout to 5 minutes from 1 minute to allow for the `put` command step to complete during `Invoke-FalconDeploy`.

Updated `Invoke-FalconAdminCommand`, `Invoke-FalconCommand`, and `Invoke-FalconResponderCommand` to only attempt to append `batch_id` to results that have a `session_id`. This should suppress `You cannot call a method on a null-valued expression` errors when trying to append `batch_id` (`Set-Property $_ batch_id $BatchId`).

Decreased default `Timeout` when using `runscript` for single host sessions by 5 seconds to help provide enough time for results to return.

Added some minor formatting changes for performance (using `Where()` instead of `Where-Object`).
Added an additional 30 seconds to the default request wait time to allow for a gap between the maximum RTR session length (5 minutes) and result collection
Removed deprecated version of `Get-FalconContainerVulnerability` which has been replaced by an endpoint in the `container-security` collection
Updated `Get-FalconQuickScan` and `New-FalconQuickScan` to use QuickScan Pro APIs. Added additional QuickScan related commands for submitting samples: `Remove-FalconQuickScan`, `Remove-FalconQuickScanFile`, `Send-FalconQuickScanFile`.

Removed `Get-FalconCloudIoaEvent` and `Get-FalconCloudIoaUser` because the APIs are no longer available.

Added `Get-FalconIdentityRule`.

Removed endpoint formatting data from `format\format.json` for commands that have their own defined format detail.
Updated sample to filter to completed scheduled reports
Updated `Receive-FalconScheduledReport` to use a combination of the `last_execution.id` and `report_params.format` fields to define an output filename if `Path` is left undefined and is being passed a report execution via pipeline
Added `BypassExecPolicy` switch and code to `runscript` step to bypass execution policy on Windows hosts when performing `runscript` step.
### `Edit-FalconFirewallGroup`

* `null` values for `rule_ids` and `rule_versions` will now be converted into empty arrays.
* Single values for `rule_ids` and `rule_versions` will now be forced into arrays.
* Slightly modified some error messages.
* Rearranged some of the code before submission.
Modified `diff_operations` evaluation to ensure proper modification into `[PSCustomObject]`.

Updated `rule_versions` evaluation to ensure all values are submitted as `[int32]` unless the value is `'null'`.
Added `if` condition to `Edit-FalconFirewallGroup` to prevent attempted submission when the only provided `diff_operations` object is invalid
Removed code that had been commented out
Added additional `cid` evaluation in `Import-FalconConfig` to help ensure proper policies are being picked for creation/modification (because an inherited policy and a local policy can have the same name) and also filter out inherited policies when attempting to make changes (because inherited policies can't be modified--but groups can still be assigned).

Made some minor changes to use `.Where({})` filtering where possible.
Added `Get-FalconChannelState`

Added `channel_state` to accepted `Include` values for `Get-FalconHost`
Updated `uninstall_sensor.sh` script to incorporate the use of `systemd` to uninstall `falcon-sensor` on Linux hosts utilizing some additional code from an existing uninstaller script. Thanks @carlosmmatos and @cs-APreston-ghAccount!
Corrected typo from testing
Test change for UTF-8 encoding to fix GitHub desktop comparison issue
bk-cs added 19 commits December 9, 2024 11:22
Changed from UTF-16 LE to UTF-8 encoding to resolve GitHub Desktop comparison issue
Added `Get-FalconCorrelationRule` and `Remove-FalconCorrelationRule`
Added `protocol` as a required field for `ConvertTo-FalconFirewallRule`
Renamed `Get-FalconChannelControl` to `Get-FalconContentControl`

Renamed `Set-FalconChannelControl` to `Set-FalconContentControl`

Renamed `Get-FalconChannelState` to `Get-FalconContentState`

Renamed `Get-FalconHost -Include` value from `channel_state` to `content_state` and updated command name
Added `Edit-FalconContentPolicy`, `Get-FalconContentPolicy`, `Get-FalconContentPolicyMember`, `Invoke-FalconContentPolicyAction`, `New-FalconContentPolicy`, `Remove-FalconContentPolicy`, and `Set-FalconContentPrecedence`
Added `ContentPolicy` to `Export-FalconConfig`
Added `ContentPolicy` to `Import-FalconConfig`

Updated `Compare-Setting` function to properly evaluate `ring_assignment_settings` for `ContentPolicy`

Modified `Add-Result` to omit `all` as a `platform` in host output stream messages
Added `ClRegex` and `IfnRegex` to `Get-FalconIoaExclusion`

Added `MatchOnTsqResultType` to `Edit-FalconReconRule` and `New-FalconReconRule`
Corrected alias for `Receive-FalconCloudAwsScript` parameter `OrganizationId`
Added `Remove-FalconIdentityRule`
Added `New-FalconIdentityRule`
Added `MalwareSubmissionId` and `ReconRuleType` to `New-FalconCompleteCase`
Added `Get-FalconSnapshotCredential` and `New-FalconSnapshotAwsAccount`
Updated version to 2.2.8 in preparation for release
Readded formatting for `Start-FalconMigration`, `Stop-FalconMigration`, `Rename-FalconMigration` and `Remove-FalconMigration`
@bk-cs bk-cs self-assigned this Dec 19, 2024
@bk-cs bk-cs merged commit f0b3a68 into master Dec 19, 2024
@bk-cs bk-cs deleted the dev branch December 19, 2024 20:40
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant