> For the complete documentation index, see [llms.txt](https://help.nightfall.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.nightfall.ai/nightfall_settings/directory_sync/google_workspace.md).
# Google Workspace Directory Service
Learn how to sync your Google Workspace data to Nightfall.
This document explains the process of adding your Google Workspace tenant to Nightfall to enable Directory Sync. Once you add Google Workspace to Nightfall, you can sync users and user groups data from Google Workspace to Nightfall. To get an overview of the Directory Sync feature in Nightfall, you can read [this article](/nightfall_settings/directory_sync.md) and then proceed with this document.
{% hint style="info" %}
You need a Google Workspace **Super Admin** account. Directory Sync uses its own service account and domain-wide delegation entry, separate from Google Drive. Its access is read only. For the scopes shown in step 5 and why each is needed, see [SaaS App Permissions Reference](/nightfall_integrations/saas-app-permissions-reference.md).
{% endhint %}
To install Google Directory:
1. Click the **Settings** button in Nightfall.
2. Click the **Directory Sync** tab.
3. Click **Add directory**.
4. Select **Google Workspace** as the identity provider.
5. Copy the **Client ID** and **OAuth Scope ID**. Store these values in a secure place. You require them in the further steps.
6. Login to your Google Workspace with a Super Admin account.
7. Click the menu icon.
8. Select **Admin**.
9. In the Admin console left pane, expand **Security** and then expand **Access and data control**.
10. Click **API controls**.
11. Click **MANAGE DOMAIN WIDE DELEGATION** under **Domain wide delegation**.
12. Click **Add New**.
13. Paste the **Client ID** copied from the Nightfall app, in the **Client ID** field.
14. Paste the **Scopes ID** copied from the Nightfall app, under **OAuth Scope** field**.** Use comma to add multiple scope IDs.
15. Click **AUTHORIZE.**
16. Return to the Nightfall app and click **Continue**.
17. Click **Connect**.
Once the setup is completed, Nightfall displays the list of active and inactive users in your Google Workspace. Nightfall syncs with your Identity and Access Provider every four hours. Also, you can manually sync once every hour. To sync data manually, click the ellipsis menu and select **Refresh.**
Currently, once registered you cannot unregister an Identity and Access Provider from Nightfall. If you wish to unregister your Identity and Access Provider, please contact Nightfall support.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://help.nightfall.ai/nightfall_settings/directory_sync/google_workspace.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
