Skip to content

Commit d1d951c

Browse files
Fix links and add more info
1 parent 7efb454 commit d1d951c

File tree

1 file changed

+18
-16
lines changed
  • src/content/docs/cloudflare-one/email-security/setup/post-delivery-deployment/bcc-journaling/bcc-setup/gmail-bcc-setup

1 file changed

+18
-16
lines changed

src/content/docs/cloudflare-one/email-security/setup/post-delivery-deployment/bcc-journaling/bcc-setup/gmail-bcc-setup/enable-gmail-integration.mdx

Lines changed: 18 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -8,17 +8,16 @@ sidebar:
88
To enable Gmail BCC integration:
99

1010
1. Log in to [Zero Trust](https://one.dash.cloudflare.com/).
11-
2. Select **Zero Trust**.
12-
3. Select **Email Security**.
13-
4. Select **Monitoring**: If you have not purchased Email Security, select **Contact Sales**. Otherwise, select **Set up**.
14-
5. Select **BCC/Journaling**.
15-
6. Select **Integrate with Google** > **Authorize**.
11+
2. Select **Zero Trust** > **Settings**.
12+
3. Select **SaaS Integrations**.
13+
4. Select **Add integration** > **Google Workspace**.
14+
5. Select **Select Integration**.
1615

1716
## Create an integration
1817

1918
1. Name your integration, then select **Next**.
2019
2. Create a Service Account in your GCP Project:
21-
1. On the [Google Cloud Console](https://console.cloud.google.com/welcome/new), select **Credentials**.
20+
1. On the [Google Cloud Console](https://console.cloud.google.com/welcome/new), go to the sidebar, select **APIs & Services**, then select **Credentials**.
2221
2. Select **CREATE CREDENTIALS** > **Service account**.
2322
3. Fill in the details to create a service account:
2423
- **Service account name**: Enter `Message Retraction Service Account`.
@@ -27,7 +26,7 @@ To enable Gmail BCC integration:
2726
- Select **CREATE AND CONTINUE**.
2827
4. In **Grant this service account access to project**, select **Select a role** > Choose **Owner**. Select **CONTINUE**, then select **DONE**.
2928
5. Go back to **Credentials** on the sidebar, and select your service account under **Service Accounts**. In **Details**, take note of the **Unique ID**.
30-
6. Select **Advanced settings** > **VIEW GOOGLE WORKSPACE ADMIN CONSOLE**, then enter your password.
29+
6. Select **Advanced settings** > **VIEW GOOGLE WORKSPACE ADMIN CONSOLE**, then enter your password. This will redirect you to the Google admin portal.
3130
7. On the sidebar, select **Security** > **Access and data control** > **API controls** > Select **MANAGE DOMAIN WIDE DELEGATION**.
3231
8. Select **Add new** > Add a new client ID:
3332
- **Client ID**: Enter the **Unique ID** you took note of in step 5.
@@ -37,27 +36,30 @@ To enable Gmail BCC integration:
3736
https://www.googleapis.com/auth/admin.directory.user.readonly, https://www.googleapis.com/auth/admin.directory.group.readonly, https://www.googleapis.com/auth/admin.directory.user.alias.readonly, https://www.googleapis.com/auth/gmail.labels, https://mail.google.com/
3837
```
3938
- Select **AUTHORIZE**.
40-
3. **Create a JSON Key for your Service Account**:
41-
- On the sidebar, select **Service Accounts**.
39+
3. **Create a JSON Key for your Service Account**:
40+
- On the [Google Cloud Console](https://console.cloud.google.com/welcome/new), select **Service Accounts** on the sidebar:
4241
- Select the three dots, then:
4342
- Select **Manage keys**.
4443
- Select **ADD KEY** > **Create new key**.
4544
- Select **JSON** > Select **CREATE**. This downloads a `.json` file which you will use at a later stage.
46-
4. **Upload JSON Key**: Upload the `.json` file downloaded from step 3.
47-
5. **Enable Necessary Google Workspace APIs in GCP**: Select the links below to enable each API:
45+
4. **Upload JSON Key**: On the [Zero Trust dashboard](https://one.dash.cloudflare.com/), upload the `.json` file downloaded on step 3.
46+
5. **Enable Necessary Google Workspace APIs in GCP**: Enable the following APIs on the Google Cloud Console:
4847
- [Enable Google Calendar API](https://console.cloud.google.com/apis/library/calendar-json.googleapis.com?project=winter-surf-439414-h1)
4948
- [Enable Google Drive API](https://console.cloud.google.com/apis/library/drive.googleapis.com?project=winter-surf-439414-h1)
5049
- [Enable Google Admin SDK API](https://console.cloud.google.com/apis/library/admin.googleapis.com?project=winter-surf-439414-h1)
5150
- [Enable Gmail API](https://console.cloud.google.com/apis/library/gmail.googleapis.com?project=winter-surf-439414-h1)
52-
- [Enable Google Service Usage API]([https://console.cloud.google.com/apis/library/serviceusage.googleapis.com?project=winter-surf-439414-h1](https://console.cloud.google.com/apis/library/serviceusage.googleapis.com?project=winter-surf-439414-h1))
53-
6. **Log in to Google Workspace Admin Console**: Here, you will be given the service account Domain Wide Delegation from the admin console.
54-
7. **Create a Domain-Wide Delegation API Client**: Use the Client ID and copy the scopes to create a new API client. Refer to [Delegate domain-wide authority to your service account]([https://cloud.google.com/chronicle/docs/soar/marketplace-integrations/google-alert-center?_gl=1*skktsb*_ga*MTMxODg5NDExMy4xNzI5NjA1MzYy*_ga_WH2QY8WWF5*MTcyOTc3MDg2Ny40LjEuMTcyOTc3MDg5OC4yOS4wLjA.#delegate_domain-wide_authority_to_your_service_account](https://cloud.google.com/chronicle/docs/soar/marketplace-integrations/google-alert-center?_gl=1*skktsb*_ga*MTMxODg5NDExMy4xNzI5NjA1MzYy*_ga_WH2QY8WWF5*MTcyOTc3MDg2Ny40LjEuMTcyOTc3MDg5OC4yOS4wLjA.#delegate_domain-wide_authority_to_your_service_account)). Then, select **Next**.
51+
- [Enable Google Service Usage API](https://console.cloud.google.com/apis/library/serviceusage.googleapis.com?project=winter-surf-439414-h1)
52+
6. **Log in to Google Workspace Admin Console**: Enter your password and log in to the Google Workspace Admin Console.
53+
7. **Create a Domain-Wide Delegation API Client**:
54+
- Copy the **Client ID** and **Scopes** displayed on the Zero Trust dashboard.
55+
- On Google Admin, go to **Security** > **Access and data control** > **API controls**.
56+
- Select **MANAGE DOMAIN WIDE DELEGATION** > **Add new**.
57+
- Use the Client ID and copy the scopes to create a new API client. Refer to [Delegate domain-wide authority to your service account](https://cloud.google.com/chronicle/docs/soar/marketplace-integrations/google-alert-center?_gl=1*skktsb*_ga*MTMxODg5NDExMy4xNzI5NjA1MzYy*_ga_WH2QY8WWF5*MTcyOTc3MDg2Ny40LjEuMTcyOTc3MDg5OC4yOS4wLjA.#delegate_domain-wide_authority_to_your_service_account). Then, select **Next**.
5558
8. **Confirm Workspace Administrator Email**: Enter the email associated with the Google Workspace Administrator account. Your email must match the email associated with your Google Workspace account, or else your integration will not work.
5659
9. Select **Create integration**.
5760
10. Once you created your integration, you will be redirected to the **Review details** page, where you will be able to review **Integration details**.
5861
11. Review your details, then select **Complete Email Security set up** > **Continue to Email Security**.
5962

60-
6163
## Next steps
6264

63-
Now that you have created an integration, you will need to [connect your domains](/cloudflare-one/email-security/setup/post-delivery-deployment/bcc-journaling/bcc-setup/gmail-bcc-setup/connect-domains/) for Email Security to start scanning your inbox.
65+
Now that you have created an integration, you will need to [connect your domains](/cloudflare-one/email-security/setup/post-delivery-deployment/bcc-journaling/bcc-setup/gmail-bcc-setup/connect-domains/) for Email Security to start scanning your inbox.

0 commit comments

Comments
 (0)