> 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
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.
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 an 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 dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
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 optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.