> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.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://storage.crisp.chat/users/helpdesk/website/-/a/f/d/6/afd6941e8bc7d800/image-20250329-183640_kptp4b.png)

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

Add the following SAML attribute mappings:

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

![](https://storage.crisp.chat/users/helpdesk/website/-/a/f/d/6/afd6941e8bc7d800/image-20250329-183654_vurdha.png)

To do this:

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

  ![](https://storage.crisp.chat/users/helpdesk/website/-/a/f/d/6/afd6941e8bc7d800/image-20250329-183710_opawqr.png)

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

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

![](https://storage.crisp.chat/users/helpdesk/website/-/a/f/d/6/afd6941e8bc7d800/image-20250329-183728_7kqfi0.png)

#### 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://storage.crisp.chat/users/helpdesk/website/-/a/f/d/6/afd6941e8bc7d800/image-20250329-183742_bz0obh.png)