Part Two: Setup Threat Detection With Elastic
As a continuation of this series about Google Workspace’s (GW) attack surface, we diverge from surveying the land and focus on setting up a threat detection lab with Elastic. In part one, we explored the important resources and capabilities of GW, while tracking intrusion techniques that adversaries may leverage. In part two, we will give you the foundation needed to begin researching threats targeting GW, and provide resources for detecting those threats using Elastic technologies. The information used during the steps provided should be adjusted for your own lab and testing environment. If you do not feel the need to set up your own lab, that’s fine as this includes examples showing you how we detect threats to GW.
Following this will be part three of this series, in which we cover common intrusion techniques by emulating the GW environment and simulating threat activity. In doing so, we’ll build detection logic to further detect several common techniques.
Elastic resources will be freely available but a registered domain for GW is necessary and will be covered in the upcoming steps, strictly for maximum authenticity. Approximate lab setup time is 20-30 minutes.
Let’s Get You Up to Speed
For those who may not be familiar with Elastic’s current stack: take a few minutes to review the current solutions it offers. In short, the stack is an all-encompassing product that can be deployed anywhere from a single interface! If you would like to explore more information about the Elastic security solution, the documentation is a great starting point.
In this article, we will focus specifically on the security solution which includes a robust detection engine and 600+ pre-built threat detection rules, an endpoint agent that can be deployed to Windows, Linux, or macOS endpoints and collect data from various on-premise and cloud environments, as well as detect and prevent threats in real-time. Not to mention, this endpoint behavior logic is also all public in our protections artifacts repository.
Our endpoint agent orchestrator, Fleet, is manageable from the Kibana interface in the Elastic Stack. Fleet allows us to set up and deploy security policies to our endpoint agents. These policies are extremely customizable, thanks to an extensive list of supported Integrations.
Think of an Integration as a module for the Elastic Agent that provides processors to collect specific data. When added to our security policy, an Integration allows the Elastic Agent to ingest logs, apply our Elastic Common Schema (ECS), and store them in the Elastic Stack for searching or to trigger alerts. If you're curious about a specific integration Elastic has, you can search for it here!
With this information you could almost assume the Elastic Stack allows you to manage all of this with just one information technology (IT) guy.
Either way, our goal is to create a threat detection lab for Google Workspace as depicted in this diagram:
The process of setting this up is pretty straightforward. Note that your environment does not have to be cloud-focused; if you prefer to do everything locally, you are more than welcome to. The Elastic Container Project is a great resource for a local Docker build of the stack.
Sign-Up for Google Workspace
In order for you to use GW, you must have a registered Google account email address and organization. If you already have a GW setup for an organization, login to the admin console and continue to Create a Project in Google Cloud. This process will not go into detail about creating a Google account.
Once created, do the following:
- Visit https://workspace.google.com > Get Started
- Fill out the information requested in subsequent steps
- Business name: DeJesus’ Archeology
- Number of employees: 2-9
- Region: United States
For this lab, we will use DeJesus’ Archeology as a business name because it's memorable (also who didn't want to be an archeologist growing up?). We'll be digging up more recent evidence in these logs than we would from the earth, of course.
Eventually you will be asked, “Does your business have a domain?”. GW requires you to have your own domain name to use its services, especially the admin console for an organization. For today, we will select “No, I need one” and will use dejesusarcheology.com, but please select or use your own. From here, you will need to enter additional business information to register your domain and organization.
You will need a username to sign into your GW account and create your business email address. We'll use email@example.com as the administrative email. When finished, continue to login to your GW admin console with your new email where you should be greeted by a similar interface below.
Setup Google Cloud Platform (GCP)
For the Elastic agent to ingest GW logs, it relies solely on making requests to the Reports API and therefore, we need to leverage GCP for a managed service account. This service account’s credentials will be used by our Elastic agent to then leverage the admin SDK API for pulling logs from GW’s Reports API into the Elastic Stack. Domain-wide delegation and OAuth2 are important for authentication and resource access but will be enabled through steps later on.
Create a Project
GCP is hierarchical, so we must first create a project. If you already have a GCP environment setup, we recommend creating a new project that links to your GW via the registered domain by following similar steps below.
Complete the following steps:
- Log into Google Cloud with the same Google account used to setup GW
- Select the following: Select a project > New Project
- Enter the following information described in subsequent steps
- Project name: dejesus-archeology
- Organization: dejesusarcheology.com
- Location: dejesusarcheology.com
When done, you should have a new organization and project in GCP. By default, only the creator of the project has rights to manage the project.
Enable Admin SDK API
Our Elastic agent will eventually use our GCP service account, which uses the Workspace Admin SDK to interact with the GW admin console REST API, therefore it needs to be enabled in GCP. To keep your mind at ease, we will only be enabling read access to the Reports API for this admin SDK.
Complete the following steps:
- Select the Google Cloud navigation menu > APIs & Services > Enabled APIs & Services
- Search and enable “Admin SDK API” from the API library page
When finished, you will have enabled the Admin SDK API within your project, where your service account will have access to pull data from GW.
Configure OAuth Consent Screen
We next need to set up the OAuth consent screen for our service account and application when they create API requests to GW, as it will include the necessary authorization token.
Complete the following steps:
- Select the Google Cloud navigation menu > APIs & Services > Enabled APIs & Services > OAuth Consent Screen
- User Type > Internal > Create
- Fill out the following information in subsequent steps
- App name: elastic-agent
- User support email: firstname.lastname@example.org
- Authorized domains: dejesusarcheology.com
- Developer contact information: email@example.com
- Save and Continue
- Save and Continue
- Back to Dashboard
When finished, we will now have a registered application using OAuth 2.0 for authorization and the consent screen information set. Please note, the default token request limit for this app daily is 10,000 but can be increased. We recommend setting your Elastic agent’s pull rate to every 10 minutes which should not come close to this reaching this threshold. Setting the agent’s pull rate will be done at a later step.
Create a Service Account
For the Elastic agent to ingest data from GW, we will need to create a service account for the agent to use. This account is meant for non-human applications, allowing it to access resources in GW via the Admin SDK API we enabled earlier.
To create a service account, do the following:
- Select the navigation menu in Google Cloud > APIs & Services > Credentials > Create Credentials > Service Account
- Enter the following information:
- Service account name: elastic-agent
- Service account ID: elastic-agent
- Leave the rest blank and continue
- Select your new Service Account > Keys > Add Key > Create New Key > JSON
By default, the Owner role will be applied to this service account based on inheritance from the project, feel free to scope permissions tighter as best seen fit. When finished, you should have a service account named elastic-agent, credentials for this service account in a JSON file saved to your host. We will enter this information during our Fleet policy integration setup.
Enable Domain-Wide Delegation
Our service account will need domain-wide delegation of permissions to access APIs that reach outside of GCP and into GW. The important data necessary for this has already been established in earlier steps where we need an API key, service account and OAuth client ID.
To enable domain-wide delegation for your service account, do the following:
- In your GW Admin Console select > Navigation Menu > Security > Access and data control > API controls
- Select Manage Domain Wide Delegation > Add New
- Client ID: OAuth ID from Service Account in GCP
- Google Cloud Console > IAM & Admin > Service Accounts > OAuth 2 Client ID (copy to clipboard)
- OAuth Scopes: https://www.googleapis.com/auth/admin.reports.audit.readonly
Our service account in GCP only needs access to admin.reports.audit.readonly to access GW Audit Reports where these are converted into ECS documents for our Elastic Stack.
If you made it this far, CONGRATULATIONS you are doing outstanding! Your GW and GCP environments are now set up and finished. At this point you are almost done, we just need to set up the Elastic Stack.
Setting Up Your Free Cloud Stack
For this lab, we will use a free trial of cloud elastic with your preference of a Google or Microsoft email account. You also have the option to create the stack in Amazon Web Services (AWS), GCP or Microsoft Azure if you’d like to stand up your stack in an existing Cloud Service Provider (CSP). The free trial will deploy the stack to GCP.
Once registered for the free trial, we can focus on configuring the Elastic Stack deployment. For this lab, we will call our deployment gw-threat-detection and deploy it in GCP. It is fine to leave the default settings for your deployment and we recommend the latest version for all the latest features. For the purposes of this demo, we use the following:
- Name: gw-threat-detection
- Cloud provider: Google Cloud
- Region: Iowa (us-central1)
- Hardware profile: Storage optimized
- Version: 8.4.1 (latest)
Once set, select “Create deployment” and the Elastic Stack will automatically be deployed in GCP where your deployment credentials will be displayed. You can download these credentials as a CSV file or save them wherever you best see fit, but they are crucial to logging into your deployed stack. The deployment takes approximately ~5 minutes to complete and once finished you can select “continue” to login. Congratulations, you have successfully deployed the Elastic Stack within minutes!
Setup Fleet from the Security Solution
As a reminder, Fleet enables the creation of a security policy, which can incorporate the GW integration on an elastic-agent, in order to access and ingest GW logs into our stack.
Create a Google Workspace Policy
In order for our Elastic Agent to know which integration it is using, what data to gather and where to stream that data within our stack, we must first set up a custom Fleet policy, named Google Workspace.
To setup a fleet policy within your Elastic Stack, do the following in your Elastic Stack:
- Navigation menu > Management > Fleet > Agent Policies > Create agent policy
- Enter “Google Workspace” as a name > Create Agent Policy
Install the Elastic agent on an Endpoint
As previously mentioned, we have to install at least one agent on an endpoint to access data in GW, and will be subject to the deployed GW policy. We recommend a lightweight Linux host, either as a VM locally or in a CSP such as GCP to keep everything in the same environment. I will be using a VM instance of Ubuntu 20.04 LTS VM in Google’s Compute Engine (GCE) of the same GCP project we have been working on. Your endpoint can be lightweight, such as GCP N1 or E2 series, as its sole purpose is to run the Elastic agent.
After your endpoint is setup, do the following in your Elastic Stack to deploy your the agent:
- Navigation menu > Management > Fleet > Agents > Add Agent
- Ensure the GW policy is selected
- Select the appropriate OS
- Select the clipboard icon to copy the commands
- Run the commands on your endpoint to install the agent
- Once finished, Fleet should show a checkmark and state 1 agent has been enrolled and Incoming data confirmed
Assign Google Workspace Integration to Fleet Policy
We must add the GW integration to our GW policy in order for it to collect data from GW and stream it to our Elastic Stack. We will configure the GW integration settings to have information created when we set up our GW environment to avoid having unsecured credentials on our Ubuntu host.
⚠️ The GW integration has a default interval of 2 hours, meaning the Elastic agent will retrieve data every 2 hours due to potential data retention and lag times. This should be adjusted in the integration itself and is accounted for in the following steps within your Elastic Stack:
- Navigation menu > Fleet > Agent Policies > Google Workspace > Add Integration
- Search for “Google Workspace” > Select Google Workspace
- Select “Add Google Workspace”
- Enter the following information for this integration:
- Integration name: google workspace
- Jwt File: Copy contents of JSON file from service account creation steps
- Delegated Account: firstname.lastname@example.org (Use your own)
- Interval: 10m
- Agent policy: Google Workspace
- Select “Save and Continue”
- Select “Save and deploy changes”
Once completed, your GW integration should be assigned to your GW policy with one agent assigned this policy.
To recap on our Elastic Stack setup so far we have completed the following:
- Deployed an Elastic Stack
- Created a Fleet policy
- Setup a lightweight Linux endpoint
- Deployed an Elastic agent to the Linux endpoint
- Enabled the Google Workspace integration inside our Fleet policy
Assign Google Workspace Integration to Fleet Policy
Rather than rely on the detection engineering (DE) higher powers, let’s take a second to actually confirm GW data is being ingested into our stack as expected at this point. We can rely on the Discovery feature of the Elastic Stack which allows us to search specific criteria across existing ECS documents. For this, we will use the filter criteria
data_stream.dataset : "google_workspace.*" to look for any ECS documents that originate from a Google Workspace datastream.
If you do not have any results, generate some activity within your GW such as creating new users, enabling email routes, creating new Organizational Units (OU) and so forth, then refresh this query after the 10 minute window has surpassed.
If results are found, congratulations are in order because you now have a fully functional threat detection lab for Google Workspace with the Elastic Security for SIEM!
Enable Google Workspace Detection Rules
As stated earlier, Elastic has 600+ pre-built detection rules not only for Windows, Linux and MacOS endpoints, as well as several integrations including GW. You can view our current existing GW rules and MITRE ATT&CK coverage.
To enable GW rules, complete the following in the Elastic Stack:
- Navigation menu > Security > Manage > Rules
- Select “Load Elastic prebuilt rules and timeline templates”
- Once all rules are loaded:
- Select “Tags” dropdown
- Search “Google Workspace”
- Select all rules > Build actions dropdown > Enable
While we won’t go in-depth about exploring all rule information, we recommend doing so. Elastic has some additional information such as related integrations, investigation guides and more! Also, you can contribute back to the community by creating your own detection rule with the “Create new rule” button, and contribute to our detection rules repository.
Let’s Trigger a Pre-Built Rule
For this example, we will provoke the Google Workspace Custom Admin Role Created detection rule. In our GW admin console, visit Account > Admin roles and create a new role with the following information:
- Name: Curator
- Description: Your Choice
- Admin console privileges:
- Alert Center: Full Access
Now, we aren’t entirely sure why the Curator role would have access to our Alert Center, but the role seems either improperly scoped or someone wants to have the ability to potentially silence some alerts before our security team can investigate them. While the creation of administrative accounts (T1136.003) is not unusual, they should always be investigated if unexpected to ensure cloud roles (T1098.003) are properly scoped.
To view our detection alert, in your Elastic Stack, visit Navigation Menu > Security > Alerts and the following should show your alerts. From this, we can see that our rule triggered as well as Google Workspace API Access Granted via Domain-Wide Delegation of Authority.
If we select “View details” from the actions column, we receive a pop-out panel showing the alert overview, tabled data fields and values from our ECS document, as well as the raw JSON.
Most detection rules for GW can be developed with a few consistent fields such as those we describe in our documentation, making new rules easier to create. If you would like to view all data fields for GW that the ECS schema contains, you can find that information here.
Let’s Trigger a Custom Rule
While pre-built detection rules are great for having threat coverage during onboarding, maybe you would like to search your data and create a new custom rule tailored to your environment.
Since the Elastic Stack is bundled with additional searching capabilities, we can rely on the Analytics Discover feature to start searching through our raw data for GW related documents by visiting Navigation Menu > Analytics > Discover.
From here, we can change our data view to logs-* and then do an open-ended KQL query for
event.dataset: google_workspace* which will return all documents where the source is from GW. You can then either start tabling the data based on available fields or view details about each document.
This is important to understand because it influences rule development. Rules are often prototyped as a data reduction exercise, beginning very broad and being refined over time into an effective rule. If you are having difficulty after this exercise with creating detection logic, our philosophy on doing so may be of assistance.
First, we will add a user, Ray Arnold, to our organization who has administrative access. With our Ray Arnold account, we will generate some suspicious events in GW, such as creating a custom email route for Gmail that forwards email destined to our primary administrator (Terrance), to Ray Arnold. In this scenario we are focused on potential collection of sensitive information via email collection via an email forwarding rule (T1114.003)
Complete the following steps:
- Add Ray Arnold as a user:
- Navigate to the users settings in GW
- Select “add new user”
- First name: Ray
- Last name: Arnold
- Select “ADD NEW USER”
- Add Engineers group and make Ray Arnold the owner:
- Navigate to groups settings in GW
You can configure the following settings like these examples:
- Group name: Engineers
- Group email: email@example.com
- Group Description: Engineering group at dinosaur park who are responsible for technology and feeding velociraptors.
- Group owners: firstname.lastname@example.org
- Labels: Mailing and Security
- Who can join the group: Only invited users
- Select “Create Group”
Now we assign admin roles and privileges to Ray Arnold:
- Navigate to Ray Arnold’s user account
- Select “Admin roles and privileges” > Assign Roles
- Super Admin -> Assigned
- Groups Admin -> Assigned
- Services Admin -> Assigned
- Select “Save”
If done correctly, Ray Arnold should be a new user in GW for the DeJesus’ Archeology organization. He is also the owner of the Engineers group and has Super Admin, Groups Admin and Services Admin roles assigned to his account. Following this, we need to login to the GW admin console with Ray Arnold’s account and add a custom email route.
This provides our organization with an insider threat scenario. Ray Arnold was hired as an employee with authorization and authentication to GW admin console settings. Our organization trusts that Ray Arnold will receive compensation for the requirements agreed to during the hiring process. Risk-mitigation is then up to the administrator when scoping the proper permissions and roles applied to Ray Arnold.
Complete the following:
- Login to the admin console with Ray Arnold’s account
- Select Navigation Menu > Apps > Google Workspace > Gmail > Routing
- Select Configure for “Routing”
- Enter the following information
- Description: Default administrator spam filtering
- Email messages to affect: Inbound, Outbound, Internal - Sending, Internal - Receiving
- Also deliver to: email@example.com
- Account types to affect: Users
- Envelope filter: Only affect specific envelope recipients (Email address: firstname.lastname@example.org)
Now we can test our custom email route by sending email@example.com an email from a separate email (We created a random email account with Proton), that is private and discusses private details about new Paleo-DNA. Once you send an email, you can view Ray Arnold’s Gmail and see that this private email was additionally routed to firstname.lastname@example.org, where we now have an existing insider threat potentially selling private information about our Paleo-DNA tests to competitors. This we cannot allow!
Identify a Potential Detection Rule for Custom Gmail Routes
Luckily, we have the Elastic Stack on our side to help us thwart this potential insider threat by detecting custom Gmail route creations! Within your Elastic Stack, visit Navigation Menu > Analytics > Discover and let’s start creating our KQL query. Below are the query filters we should be looking for and the final query.
event.dataset: google_workspace.admin and event.action: "CREATE_GMAIL_SETTING" and not related.user: terrance and google_workspace.admin.setting.name: (MESSAGE_SECURITY_RULE or EMAIL_ROUTE)
Let’s break this down further to explain what we are looking for:
event.dataset: google_workspace.admin - Documents in ECS where the data sourced from GW, specifically admin reporting. Since a user needs to be an administrator, we should expect data to source from admin reporting, which may also indicate a compromised admin account or abuse of an admin not setup with principle of least-privilege (PoLP).
event.action: "CREATE_GMAIL_SETTING" - The creation of a Gmail setting which is typically done by administrators.
not related.user: terrance - So far, any creation of a Gmail setting by an administrator whose username is not “terrance” who is the only administrator that is expected to be touching such settings.
google_workspace.admin.setting.name: (MESSAGE_SECURITY_RULE or EMAIL_ROUTE) - This setting name is specific to Gmail routing rules.
Plugging this query into Discover, we have matching documents for this activity being reported in GW!
Create a Custom Rule in the Security Feature
Let’s wrap this up by adding our custom detection rule for this!
To add your custom rule, complete the following:
- In your Elastic Stack, select Navigation menu > Security > Manage > Rules
- Select “Create new rule”
- Enter the following information:
- Define rule: Source, Index Patterns: logs-google_workspace*
- Custom query: Our custom query
And we define rule metadata:
- Name: Google Workspace Custom Forwarding Email Route Created
- Description: Your choice
- Default severity: High
- Tags: Google Workspace
What is fantastic about this custom rule is we can send a notification via our platform of choice so we are notified immediately when this alert is triggered.
Then select “Create & enable rule” at the bottom to create your custom rule. If we replay the steps above to create a custom Gmail forwarding rule, we will now see an alert and receive a notification about the alert trigger!
At this point, we are now aware that Ray Arnold has created a custom Gmail route rule in GW with no authorization. From our alert in the Elastic Stack and notification to the CEO, we can now take action to mitigate further risk.
As demonstrated, Elastic’s security solution and the Elastic Stack allow us to ingest GW reporting logs and scan this data with pre-built detection rules or custom rules. Combine this with other features of the stack such as Enterprise Search, Observability, and a very simple cloud stack deployment process and we can start detecting threats in our GW environment in no time.
It’s been quite a journey and you have accomplished an incredible amount of work. In part three of this series: Detecting Common Threats, we will emulate some common Google Workspace abuse by threat actors and create more advanced detection logic for these. Hold on tight, because it's about to get WILD.
Also, there is still so much more to explore within the Elastic Stack, as you have probably already found during this lab, so feel free to explore! Elastic continues to take action on security transparency as recently discussed.
Hopefully this provides you with a better understanding of the powerful capabilities within the Elastic Stack and how to use it to detect potential threats in GW. Thanks for reading/following along and may we all be in the capable hands of detection engineers in part three.
See all top stories
We aim to out-innovate adversaries and maintain protections against the cutting edge of attacker tradecraft. With Elastic Security 8.8, we added new kernel call stack based detections which provide us with improved efficacy against in-memory threats.