# Google Workspace

## Requirements


:::info
Official Filebeat documentation:  
<https://www.elastic.co/docs/reference/beats/filebeat/filebeat-module-google_workspace>

:::

On your Google Workspace:


1. Set up a `ServiceAccount` using the administrator account.
2. Set up access to the Admin SDK API for the `ServiceAccount`.
3. Enable Domain-Wide Delegation for your `ServiceAccount`.
4. Allow use of the following oauth2 scope: `https://www.googleapis.com/auth/admin.reports.audit.readonly`
5. Downloaded your service account credentials as a JSON file

   *Note the “**Delegated user**”. Usually this is the email address of the admin who performed the above steps in Google Cloud Console.*



---


:::success
Available on [Data Gallery](/doc/6ecc8c58-3d81-4f32-80e0-984c8092653e) - No NiFi configuration required.

:::

## NiFi Provisioning

| Processor | Version |
|-----------|---------|
| `GetRedisList` | N/A     |
| `PutElasticCS` | v1.0 > v1.x |
| `CybersiftParser` | N/A     |

### Pipeline Structure

```mermaidjs
graph TD
    GetRedisList -->|All| CybersiftParser
    CybersiftParser -->|ALERTS| 1.PutElasticCS 
    CybersiftParser -->|Success| 2.PutElasticCS
```

### Configuring `GetRedisList` processor

| Property | Value |
|----------|-------|
| **List Name** | `google-workspace` |

### Configuring `CybersiftParser` processor

*Set the dropped and failed relationships to terminate*

| Property | Value |
|----------|-------|
| **[New Property +] - Google Index** | `Google Workspace Logs` |

### Configuring `PutElasticCS` processor

*This applies to both Alerts and Success Connectors.*

*Set all the relationships to terminate*

| Property | Value (Success) | Value (Alerts) |
|----------|-----------------|----------------|
| Elasticsearch ID attribute | `es_id`         | `es_id`        |
| **Elasticsearch Default Index** | `${now():format('yyyy.MM.dd'):prepend('google-workspace-')}` | `${now():format('yyyy.MM.dd'):prepend('alerts-')}` |

## Configure the module

*Please follow the below documentation to configure the filebeat module.* 

[https://www.elastic.co/docs/reference/beats/filebeat/filebeat-module-google%5Fworkspace](https://www.elastic.co/docs/reference/beats/filebeat/filebeat-module-google%5Fworkspace)




:::success
You successfully configured the log source, please make sure to define the [Index Patterns](/doc/c6b29c57-cd4c-4c74-b241-73f0aebc0203)

:::


---


:::info
tags:

* Google Workspace Logs Setup
* NiFi Google Workspace Setup

:::

---

**Documents**

- [Logs and Architecture](https://outline.cybersift.io/s/sentio-siem/doc/logs-and-architecture-acvUiDgvI5)
- [Sentio](https://outline.cybersift.io/s/sentio-siem/doc/sentio-KuYAbF5grr)
- [ISO27001:2022](https://outline.cybersift.io/s/sentio-siem/doc/iso270012022-7S5IzvF6a0)
- [FAQ](https://outline.cybersift.io/s/sentio-siem/doc/faq-vVyRNyNb60)