> ## 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 - 如何设置 Google Workspace

#### 1. **添加自定义 SAML 应用**

* 转到您的 **Google 管理控制台**。
* 导航到：  
  `Apps > Web and mobile apps > Add app > Add custom SAML app`

#### 2. **输入应用详情**

* 提供应用名称（例如，`ggLeap SSO`）
* 可选：上传应用图标。
* 点击 **继续**。

#### 3. **设置 SAML 配置**

填写以下字段：

* **ACS URL:**  
  `[https://api.ggleap.com/production/saml/assert-login`](https://api.ggleap.com/production/saml/assert-login`)
* **Entity ID（完全如下所示，无尾部斜杠）:**  
  `[https://sp.ggleap.com`](https://sp.ggleap.com`)
* 保持其余部分为默认值，除非给出了具体要求。
* 点击 **继续**。

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

#### 4. **👥 属性映射**

添加以下 SAML 属性映射：

| Google 目录属性 | 应用属性 |
| ---- |
| 名 | `FirstName` |
| 姓 | `LastName` |
| 主要电子邮件 | `Email` |

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

做法如下：

* 为每个属性点击 **添加映射**。
* 选择相应的 Google 目录属性。
* 输入确切的应用属性名称（区分大小写）。

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

#### 5. **下载身份提供商元数据**

* 设置完成后，从 Google 下载 **元数据 XML** 文件。

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

#### 6. **托管元数据 XML**

* 将 XML 文件上传到可公开访问的托管服务（例如：您的网站、启用公开共享的 Google Drive、AWS S3 等）
* 复制托管元数据文件的公开链接。

#### 7. **完成集成**

* 在您应用的 SSO 设置中（例如：在 ggLeap 中），粘贴 **元数据 URL**。
* **测试连接**以验证 SSO 集成。
* 成功后点击 **保存**。

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