To install the Nightfall DLP for Google Drive integration, you must have the following:
A Google Workspace account, preferably a service account.
An admin user account of your organization's Google Workspace account (or any other Google Workspace account) on which you wish to install the integration.
Learn how to get started with Nightfall DLP for Google Drive.
Please follow the link to below, to our main Nightfall website page, which includes access to the Walkthrough Demo Video for Google Drive: https://nightfall.ai/nightfall-demo-google-drive-dlp Note: The video is gated by a company email input prompt.
Learn how to set up alerts on Nightfall for Github
Nightfall sends alerts in real-time to the channels or platforms you configure. You can configure the following alerts:
Slack Alerts
Microsoft Teams
Webhook
Jira Tickets
The Nightfall for Google Drive integration allows you to configure alerts at the policy level and also at the integration level.
When you configure alert settings at the integration level, the alert settings apply to all the policies, created for the Nightfall for Google Drive integration. However, when you configure alert settings specifically for a policy, which is created in the Google Drive integration, the alert settings are applicable only for that specific policy.
This document explains how to configure alerts at the integration level. To learn about how to configure alerts at the policy level, read this document.
To use Slack as an alert platform, you must first perform the required Slack configurations. You can refer to this document to learn more about how to configure Slack as an Alert platform.
To use Microsoft Teams as an alert platform, you must have the Nightfall for Microsoft 365 integration enabled.
To use Webhook as an alert platform, you must first perform the required Webhook configurations. You can refer to this document to learn more about how to configure Webhook as an Alert platform.
To use JIRA as an alert platform, you must have the DLP for the JIRA app installed from the Atlassian Marketplace. You can read more about the DLP for JIRA integration here.
You can configure alerts at the integration level once you have installed the Nightfall for Google Drive integration.
To configure alerts at the integration level:
Navigate to the Nightfall for Google Drive integration.
Scroll down to the Alerting section.
Nightfall provides you with the following alert methods.
Slack: Enter the name of the Slack channel to which the violation notifications from this integration must be directed and click Save.
Teams: Select the Team and the Channel(s) within that team to which the violation notifications must be sent.
Email: Enter the Email ID of the recipient to whom the violation notification must be sent and click Save.
Webhook: Click + Webhook to add Webhook URL. Click Test to test the connection to the Webhook URL. HTTP headers. Click Save.
When you configure alerts to a Webhook, Nightfall AI sends occasional posts to:
To validate that the Webhook is properly configured before the policy is saved.
Periodically thereafter to ensure that the Webhook is still valid.
The response to the test Webhooks is 200 status code if successful.
An example of Webhook request is as follows.
This is part of alert event consumption and can be ignored.
JIRA: Select the JIRA project, issue type, enter comments, and click Save changes.
When a Violation occurs, Nightfall sends a notification to the end-user whose actions triggered the violation. While notifying the end-user, Nightfall also sends a text message. You can draft the text message to be sent to the end-user. This message applies to all the policies. Click Save changes once done.
This document explains the steps to install the Nightfall DLP for Google Drive. Nightfall recommends that you read the Requirements document for Google drive installation and then proceed with this document.
To install Nightfall for Google Drive:
Log in to Nightfall.
Click Google Drive under the MY INTEGRATIONS section (click Show more if you are unable to view Google Drive)
Click Begin Setup.
The access permission page is displayed as follows. Copy the client ID and Scopes ID generated.
Login to your Google Workspace with an admin account.
Click the menu icon.
Select Admin.
In the Admin console left pane, expand Security and then expand Access and data control.
Click API controls.
Click MANAGE DOMAIN WIDE DELEGATION under Domain wide delegation.
Click Add New.
Paste the Client ID copied from the Nightfall app, in the Client ID field.
Paste the Scopes ID copied from the Nightfall app, under OAuth Scope field. Use comma to add multiple scope IDs.
Click AUTHORIZE.
Return to the Nightfall app and click Next Step.
Click Connect.
Once the installation is completed, you can view the details of your Google Drive in the Nightfall app.
Once the installation is completed, Nightfall connects to your Google Workspace account and fetches all the domains. In the above image, you can see that 3 domains are fetched. These three domains were already present in your Google Workspace and are considered to be internal. You can add additional domains by clicking the ellipsis menu at the right end and selecting Manage Domains.
