# Google Workspace

## 1 - Setup

1. Select Google from our list under Integrations, then SSO.

<figure><img src="https://886837371-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqzQlqY7NPM9yObejMJmK%2Fuploads%2F58udxufwLtb89XXTZqux%2FScreenshot%202024-03-19%20at%208.01.41%E2%80%AFAM.png?alt=media&#x26;token=632601e7-279f-48b7-9805-fb8559b70b31" alt=""><figcaption></figcaption></figure>

2. From your Google Admin console, click "**Apps**" from the sidebar then click "**Web and mobile apps**" from the list.  If your application is already created, choose it from the list and move to step 3 in the process (step 5 in this documentation). If you've not created a SAML application, click "**Add custom SAML app**" from the menu.

<figure><img src="https://886837371-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqzQlqY7NPM9yObejMJmK%2Fuploads%2FT69QndLx5C3d8gRS4znu%2FScreenshot%202024-03-19%20at%208.06.13%E2%80%AFAM.png?alt=media&#x26;token=93d17a4a-2eb5-481a-8eb0-a09074a8d52a" alt=""><figcaption></figcaption></figure>

3. Give your application an "**App Name**" and click "**CONTINUE**"

<figure><img src="https://886837371-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqzQlqY7NPM9yObejMJmK%2Fuploads%2FwfqJpbnV4Kv8h4o5AFYT%2FScreenshot%202024-03-19%20at%208.06.40%E2%80%AFAM.png?alt=media&#x26;token=40f57d1e-a24a-48fb-af44-76be9c87646f" alt=""><figcaption></figcaption></figure>

4. From the next screen, click "**Download METADATA**" to download the metadata XML file, then click "**Continue**".

<figure><img src="https://886837371-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqzQlqY7NPM9yObejMJmK%2Fuploads%2FHIEb4wV8dBxqlaeerQoe%2FScreenshot%202024-03-19%20at%208.22.55%E2%80%AFAM.png?alt=media&#x26;token=af1e6fb1-87f1-4a7a-9da5-4fcc25f6e650" alt=""><figcaption></figcaption></figure>

5. &#x20;Enter the following values in the **"Service provider details"** section:&#x20;

   <figure><img src="https://886837371-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqzQlqY7NPM9yObejMJmK%2Fuploads%2FYiFl5UkjElnSlW3szEgQ%2FScreenshot%202024-03-19%20at%209.38.55%E2%80%AFAM.png?alt=media&#x26;token=cb918bb8-16f9-4c09-929b-d00d90d35f25" alt=""><figcaption></figcaption></figure>

   &#x20;Click "**Continue**" to save the configuration.

<figure><img src="https://886837371-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqzQlqY7NPM9yObejMJmK%2Fuploads%2FQCYRyAsy0bIOM9WIQ1PH%2FScreenshot%202024-03-19%20at%209.39.03%E2%80%AFAM.png?alt=media&#x26;token=b6025c5c-9d8d-47ff-b483-eb3d4685dfd0" alt=""><figcaption></figcaption></figure>

6. Under the "**Attributes"** section, you have to configure the following attributes:&#x20;

   <figure><img src="https://886837371-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqzQlqY7NPM9yObejMJmK%2Fuploads%2FMMEAYTbiudgmEzGxt2BC%2FScreenshot%202024-03-19%20at%209.44.10%E2%80%AFAM.png?alt=media&#x26;token=bd24277a-53d8-4822-9253-28925922a3ce" alt="" width="310"><figcaption></figcaption></figure>

   <figure><img src="https://886837371-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqzQlqY7NPM9yObejMJmK%2Fuploads%2FXVye54g4JqZ54tgVo6Rv%2FScreenshot%202024-03-19%20at%2010.09.16%E2%80%AFAM.png?alt=media&#x26;token=a5d086fa-a1f9-4f30-ae18-ed4218e52813" alt=""><figcaption></figcaption></figure>

   After you have configured the attributes, click **"Finish"** to save the configuration.
7. On the next screen, click **"User Access"** to configure the application to allow users to log in.&#x20;

   <figure><img src="https://886837371-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqzQlqY7NPM9yObejMJmK%2Fuploads%2FxxED14kiVJuHXywiyY9D%2FScreenshot%202024-03-19%20at%2010.26.42%E2%80%AFAM.png?alt=media&#x26;token=38598c51-8349-42d2-82cf-057bb83cbedc" alt=""><figcaption></figcaption></figure>
8. Check the **"ON for everyone"** checkbox and click **"Save"**.&#x20;

   <figure><img src="https://886837371-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqzQlqY7NPM9yObejMJmK%2Fuploads%2FuuwYu698XZjJcbCio27G%2FScreenshot%202024-03-19%20at%2010.26.58%E2%80%AFAM.png?alt=media&#x26;token=28e700ad-4985-479d-93d8-a00e14a4b224" alt=""><figcaption></figcaption></figure>
9. Upload your XML file to our system.&#x20;

   <figure><img src="https://886837371-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqzQlqY7NPM9yObejMJmK%2Fuploads%2FKy2WGQncXdDHQrDSEdDj%2FScreenshot%202024-03-19%20at%2010.46.28%E2%80%AFAM.png?alt=media&#x26;token=e714b366-acd3-4351-8be1-39f762da1c34" alt=""><figcaption></figcaption></figure>

## 2 - Syncing

1. Under "Integrations" select "SSO". Make sure you are [setup](#id-1-setup) before moving forward.

   <figure><img src="https://886837371-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqzQlqY7NPM9yObejMJmK%2Fuploads%2FPqBnw9wB6ZtnAGPLwV6u%2FScreenshot%202024-07-16%20at%201.12.01%E2%80%AFPM.png?alt=media&#x26;token=08f4f0e4-b101-4f3c-bc14-95c2de9b974e" alt="" width="563"><figcaption></figcaption></figure>

2. Click on "Directory Sync". Make sure you've toggled on the settings you would like to sync.&#x20;

   <figure><img src="https://886837371-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqzQlqY7NPM9yObejMJmK%2Fuploads%2FiCjcZo6KqEKjLhlaKy5a%2FScreenshot%202024-07-16%20at%201.14.11%E2%80%AFPM.png?alt=media&#x26;token=1d6959bd-96b7-4ab3-94bb-2fbfb608fc20" alt=""><figcaption></figcaption></figure>

3. Select "Sync", then select "Start" on the popup.&#x20;

   <figure><img src="https://886837371-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqzQlqY7NPM9yObejMJmK%2Fuploads%2FkRYamIhGqDya2HGFnsIP%2FScreenshot%202024-07-16%20at%201.15.42%E2%80%AFPM.png?alt=media&#x26;token=179a76b6-640e-4a9d-a3c3-b1009be0c6f5" alt=""><figcaption></figcaption></figure>

4. You will receive an email when the sync is complete.

## 2 - Including and Ignoring Groups

1. If you have select groups that you would like to include or ignore in your sync, toggle "Intention". **\*Either Organization or Groups must be toggled on in order for this feature to be toggled on.**&#x20;

   <figure><img src="https://886837371-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqzQlqY7NPM9yObejMJmK%2Fuploads%2FrqZf1UpTs1E6Ykb08t0C%2FScreenshot%202025-01-09%20at%209.37.50%E2%80%AFAM.png?alt=media&#x26;token=09cdbba7-884d-4985-b310-bdf2c4dc448e" alt=""><figcaption></figcaption></figure>
2. Start typing the group you want to include until you see it in the menu.&#x20;

   <figure><img src="https://886837371-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqzQlqY7NPM9yObejMJmK%2Fuploads%2FHki4MIM3A1m4b8eEm8Et%2FScreenshot%202025-01-09%20at%209.41.04%E2%80%AFAM.png?alt=media&#x26;token=0f3b1a87-ce2a-430b-beff-7474fe2f3d61" alt=""><figcaption></figcaption></figure>
3. Continue with this process until all of your groups are selected.
4. To "Ignore" changes to certain groups click on "Select Filter". You can choose the field and type of match. If you have multiple, you can choose the condition that suits your needs to add more.

   <figure><img src="https://886837371-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqzQlqY7NPM9yObejMJmK%2Fuploads%2F5DoELxPCoYbzCsbzkLwS%2FScreenshot%202025-01-09%20at%209.42.58%E2%80%AFAM.png?alt=media&#x26;token=be92f349-bd26-44f4-8e46-aa33815614c7" alt=""><figcaption></figcaption></figure>
5. At the bottom of the filter you will see the following message. Click submit to continue with these filters.&#x20;

   <figure><img src="https://886837371-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqzQlqY7NPM9yObejMJmK%2Fuploads%2FpYdaJZf1RSWgIiGP3NI3%2FScreenshot%202025-01-09%20at%209.43.12%E2%80%AFAM.png?alt=media&#x26;token=8c0ee6df-cc7d-4e8f-b745-3902e9543ed6" alt=""><figcaption></figcaption></figure>
6. Click save and sync immediately. You will receive an email when the sync is completed.


---

# Agent Instructions: 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:

```
GET https://docs.adminremix.com/integrations/sso-integration/google-workspace.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
