> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://helpdesk.ggcircuit.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 🧑‍💼 SAML SSO -  How to Set Up Google Workspace

#### 1. **Add Custom SAML App**

* Go to your **Google Admin Console**.
* Navigate to:  
  `Apps > Web and mobile apps > Add app > Add custom SAML app`

#### 2. **Enter App Details**

* Provide an app name (e.g., `ggLeap SSO`)
* Optionally upload an app icon.
* Click **Continue**.

#### 3. **Set Up SAML Configuration**

Fill in the following fields:

* **ACS URL:**  
  https://api.ggleap.com/production/saml/assert-login
* **Entity ID (Exactly as shown, NO trailing slash):**  
  https://sp.ggleap.com
* Leave the rest as default unless specific requirements are given.
* Click **Continue**.

![](https://ggcircuit.atlassian.net/wiki/download/attachments/15860233/image-20250329-183640.png?version=1&modificationDate=1743273403495&cacheVersion=1&api=v2)

#### 4. **👥 Attribute Mapping**

Add the following SAML attribute mappings:

| Google Directory Attribute | App Attribute |
| ---- |
| First name | `FirstName` |
| Last name | `LastName` |
| Primary email | `Email` |

![](https://ggcircuit.atlassian.net/wiki/download/attachments/15860233/image-20250329-183654.png?version=1&modificationDate=1743273418752&cacheVersion=1&api=v2)

To do this:

* Click **Add Mapping** for each.
* Choose the corresponding Google directory attribute.
* Enter the exact app attribute name (case-sensitive).

  ![](https://ggcircuit.atlassian.net/wiki/download/attachments/15860233/image-20250329-183710.png?version=1&modificationDate=1743273433581&cacheVersion=1&api=v2)

#### 5. **Download the IdP Metadata**

* After setup, download the **Metadata XML** file from Google.

![](https://ggcircuit.atlassian.net/wiki/download/attachments/15860233/image-20250329-183728.png?version=1&modificationDate=1743273456727&cacheVersion=1&api=v2)

#### 6. **Host the Metadata XML**

* Upload the XML file to a publicly accessible hosting service (e.g., your website, Google Drive with public sharing, AWS S3, etc.)
* Copy the public link to the hosted metadata file.

#### 7. **Complete Integration**

* In your app’s SSO settings (e.g., within ggLeap), paste the **Metadata URL**.
* **Test the connection** to verify the SSO integration.
* Click **Save** once successful.

![](https://ggcircuit.atlassian.net/wiki/download/attachments/15860233/image-20250329-183742.png?version=1&modificationDate=1743273469913&cacheVersion=1&api=v2)