Skip to content

Commit

Permalink
[google_workspace] Enable agentless integration (#12921)
Browse files Browse the repository at this point in the history
Enable agentless integration for google_workspace, and make some required updates to ingest pipelines to work with the updated package spec.
  • Loading branch information
mjwolf authored Mar 4, 2025
1 parent ab3ec66 commit 2d14570
Show file tree
Hide file tree
Showing 19 changed files with 98 additions and 4 deletions.
6 changes: 6 additions & 0 deletions packages/google_workspace/_dev/build/docs/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -123,6 +123,12 @@ Once Service Account credentials are downloaded as a JSON file, then the integra
> NOTE: The default value of the "Page Size" is set to 1000. This option is available under 'Alert' Advance options. Set the parameter "Page Size" according to the requirement. For Alert Data Stream, The default value of "Alert Center API Host" is `https://alertcenter.googleapis.com`. The Alert Center API Host will be used for collecting alert logs only.
## Agentless Enabled Integration

Agentless integrations allow you to collect data without having to manage Elastic Agent in your cloud. They make manual agent deployment unnecessary, so you can focus on your data instead of the agent that collects it. For more information, refer to [Agentless integrations](https://www.elastic.co/guide/en/serverless/current/security-agentless-integrations.html) and the [Agentless integrations FAQ](https://www.elastic.co/guide/en/serverless/current/agentless-integration-troubleshooting.html).

Agentless deployments are only supported in Elastic Serverless and Elastic Cloud environments. This functionality is in beta and is subject to change. Beta features are not subject to the support SLA of official GA features.

## Logs

### Google Workspace Reports ECS fields
Expand Down
5 changes: 5 additions & 0 deletions packages/google_workspace/changelog.yml
Original file line number Diff line number Diff line change
@@ -1,4 +1,9 @@
# newer versions go on top
- version: "2.32.0"
changes:
- description: Enable Agentless deployment.
type: enhancement
link: https://github.com/elastic/integrations/pull/12921
- version: "2.31.0"
changes:
- description: Update Kibana constraint to support 9.0.0.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,11 @@ processors:
target_field: event.original
ignore_missing: true
if: ctx.event?.original == null
- remove:
field: message
ignore_missing: true
if: 'ctx.event?.original != null'
description: 'The `message` field is no longer required if the document has an `event.original` field.'
- json:
field: event.original
target_field: json
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,11 @@ processors:
target_field: event.original
ignore_missing: true
if: ctx.event?.original == null
- remove:
field: message
ignore_missing: true
if: 'ctx.event?.original != null'
description: 'The `message` field is no longer required if the document has an `event.original` field.'
- json:
field: event.original
target_field: json
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,11 @@ processors:
target_field: event.original
ignore_missing: true
if: ctx.event?.original == null
- remove:
field: message
ignore_missing: true
if: 'ctx.event?.original != null'
description: 'The `message` field is no longer required if the document has an `event.original` field.'
- json:
field: event.original
target_field: json
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,11 @@ processors:
target_field: event.original
ignore_missing: true
if: ctx.event?.original == null
- remove:
field: message
ignore_missing: true
if: 'ctx.event?.original != null'
description: 'The `message` field is no longer required if the document has an `event.original` field.'
- json:
field: event.original
target_field: json
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,11 @@ processors:
target_field: event.original
ignore_missing: true
if: ctx.event?.original == null
- remove:
field: message
ignore_missing: true
if: 'ctx.event?.original != null'
description: 'The `message` field is no longer required if the document has an `event.original` field.'
- json:
field: event.original
target_field: json
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,11 @@ processors:
target_field: event.original
ignore_missing: true
if: ctx.event?.original == null
- remove:
field: message
ignore_missing: true
if: 'ctx.event?.original != null'
description: 'The `message` field is no longer required if the document has an `event.original` field.'
- json:
field: event.original
target_field: json
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,11 @@ processors:
target_field: event.original
ignore_missing: true
if: ctx.event?.original == null
- remove:
field: message
ignore_missing: true
if: 'ctx.event?.original != null'
description: 'The `message` field is no longer required if the document has an `event.original` field.'
- json:
field: event.original
target_field: json
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,11 @@ processors:
target_field: event.original
ignore_missing: true
if: ctx.event?.original == null
- remove:
field: message
ignore_missing: true
if: 'ctx.event?.original != null'
description: 'The `message` field is no longer required if the document has an `event.original` field.'
- json:
field: event.original
target_field: json
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 +18,11 @@ processors:
target_field: event.original
ignore_missing: true
if: ctx.event?.original == null
- remove:
field: message
ignore_missing: true
if: 'ctx.event?.original != null'
description: 'The `message` field is no longer required if the document has an `event.original` field.'
- json:
field: event.original
target_field: json
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,11 @@ processors:
target_field: event.original
ignore_missing: true
if: ctx.event?.original == null
- remove:
field: message
ignore_missing: true
if: 'ctx.event?.original != null'
description: 'The `message` field is no longer required if the document has an `event.original` field.'
- json:
field: event.original
target_field: json
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,11 @@ processors:
target_field: event.original
ignore_missing: true
if: ctx.event?.original == null
- remove:
field: message
ignore_missing: true
if: 'ctx.event?.original != null'
description: 'The `message` field is no longer required if the document has an `event.original` field.'
- json:
field: event.original
target_field: json
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -21,6 +21,11 @@ processors:
target_field: event.original
ignore_missing: true
if: ctx.event?.original == null
- remove:
field: message
ignore_missing: true
if: 'ctx.event?.original != null'
description: 'The `message` field is no longer required if the document has an `event.original` field.'
- json:
field: event.original
target_field: json
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,11 @@ processors:
target_field: event.original
ignore_missing: true
if: ctx.event?.original == null
- remove:
field: message
ignore_missing: true
if: 'ctx.event?.original != null'
description: 'The `message` field is no longer required if the document has an `event.original` field.'
- json:
field: event.original
target_field: json
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -21,6 +21,11 @@ processors:
target_field: event.original
ignore_missing: true
if: ctx.event?.original == null
- remove:
field: message
ignore_missing: true
if: 'ctx.event?.original != null'
description: 'The `message` field is no longer required if the document has an `event.original` field.'
- json:
field: event.original
target_field: json
Expand Down
6 changes: 6 additions & 0 deletions packages/google_workspace/docs/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -123,6 +123,12 @@ Once Service Account credentials are downloaded as a JSON file, then the integra
> NOTE: The default value of the "Page Size" is set to 1000. This option is available under 'Alert' Advance options. Set the parameter "Page Size" according to the requirement. For Alert Data Stream, The default value of "Alert Center API Host" is `https://alertcenter.googleapis.com`. The Alert Center API Host will be used for collecting alert logs only.
## Agentless Enabled Integration

Agentless integrations allow you to collect data without having to manage Elastic Agent in your cloud. They make manual agent deployment unnecessary, so you can focus on your data instead of the agent that collects it. For more information, refer to [Agentless integrations](https://www.elastic.co/guide/en/serverless/current/security-agentless-integrations.html) and the [Agentless integrations FAQ](https://www.elastic.co/guide/en/serverless/current/agentless-integration-troubleshooting.html).

Agentless deployments are only supported in Elastic Serverless and Elastic Cloud environments. This functionality is in beta and is subject to change. Beta features are not subject to the support SLA of official GA features.

## Logs

### Google Workspace Reports ECS fields
Expand Down
14 changes: 11 additions & 3 deletions packages/google_workspace/manifest.yml
Original file line number Diff line number Diff line change
@@ -1,17 +1,17 @@
name: google_workspace
title: Google Workspace
version: "2.31.0"
version: "2.32.0"
source:
license: Elastic-2.0
description: Collect logs from Google Workspace with Elastic Agent.
type: integration
format_version: "3.0.3"
format_version: "3.2.3"
categories:
- security
- productivity_security
conditions:
kibana:
version: "^8.16.0 || ^9.0.0"
version: "^8.18.0 || ^9.0.0"
elastic:
subscription: basic
screenshots:
Expand Down Expand Up @@ -56,6 +56,14 @@ policy_templates:
- name: google_workspace
title: Google Workspace logs
description: Collect logs from Google Workspace APIs
deployment_modes:
default:
enabled: true
agentless:
enabled: true
organization: security
division: engineering
team: security-service-integrations
inputs:
- type: httpjson
vars:
Expand Down
1 change: 0 additions & 1 deletion packages/google_workspace/validation.yml
Original file line number Diff line number Diff line change
Expand Up @@ -3,4 +3,3 @@ errors:
- SVR00001 # Saved query, but no filter.
- SVR00002 # Mandatory filters in dashboards.
- SVR00004 # References in dashboards.
- SVR00005 # Kibana version for saved tags.

0 comments on commit 2d14570

Please sign in to comment.