> ## Documentation Index
> Fetch the complete documentation index at: https://manual.voiceping.net/llms.txt
> Use this file to discover all available pages before exploring further.

# SSO设置指南（HENNGE One）

> 使用HENNGE One配置单点登录的指南

export const ContactZh = () => <>
    <Tip>
      如有任何问题，请通过<a href="https://forms.gle/6AUho7oj3zBr79e96">此表单</a>与我们联系。
    </Tip>

    <h2>官方链接</h2>

    <CardGroup cols={2}>
      <Card title="官方网站" icon="globe" href="https://voiceping.net/en/">
        访问官方网站
      </Card>
      <Card title="X (Twitter)" icon="x-twitter" href="https://x.com/VoicePingMedia">
        在X上关注我们
      </Card>
      <Card title="Facebook" icon="facebook" href="https://www.facebook.com/voiceping.inc">
        在Facebook上点赞
      </Card>
      <Card title="LinkedIn" icon="linkedin" href="https://www.linkedin.com/company/28684130/">
        在LinkedIn上连接
      </Card>
    </CardGroup>
  </>;

## 关于单点登录（SSO）功能

企业版工作空间可以启用单点登录（SSO），允许**使用HENNGE One登录**。

配置SSO后，您可以使用在HENNGE One中注册的账户顺畅地登录VoicePing。

本指南将说明：

* 如何在工作空间中启用SSO
* 如何将HENNGE One配置为身份提供商（IdP）

***

## 常见问题

<AccordionGroup>
  <Accordion title="后续配置SSO时，希望现有用户只能通过SSO登录">
    可以实现。

    启用SSO后，现有用户将自动无法通过SSO以外的方式登录。如果已经登录，需要先注销。
  </Accordion>
</AccordionGroup>

***

## HENNGE One端配置

### 前提条件

<Check>已订阅VoicePing**企业版**</Check>
<Check>拥有具有**HENNGE One管理员权限**的账户</Check>

### 步骤

<Steps>
  <Step title="进入HENNGE One管理界面">
    点击"服务提供商设置"。

    <Frame>
      <img src="https://mintcdn.com/test-cf63e467/LU3oFsc_lcA5rDjy/ja/images/sso-hennge/01-hennge-admin.png?fit=max&auto=format&n=LU3oFsc_lcA5rDjy&q=85&s=891ca312df85f22ddd84e0e81eebba7c" alt="HENNGE One管理界面" width="1628" height="876" data-path="ja/images/sso-hennge/01-hennge-admin.png" />
    </Frame>
  </Step>

  <Step title="添加服务提供商">
    点击"添加服务提供商"。

    <Frame>
      <img src="https://mintcdn.com/test-cf63e467/LU3oFsc_lcA5rDjy/ja/images/sso-hennge/02-add-sp.png?fit=max&auto=format&n=LU3oFsc_lcA5rDjy&q=85&s=5631dacfd8e6d950963277c563087ade" alt="添加服务提供商" width="1637" height="777" data-path="ja/images/sso-hennge/02-add-sp.png" />
    </Frame>
  </Step>

  <Step title="添加SSO服务">
    选择"添加SSO服务"。

    <Frame>
      <img src="https://mintcdn.com/test-cf63e467/LU3oFsc_lcA5rDjy/ja/images/sso-hennge/03-sso-service.png?fit=max&auto=format&n=LU3oFsc_lcA5rDjy&q=85&s=9a0c7389377c04afca49c14208acd4ca" alt="添加SSO服务" width="1638" height="776" data-path="ja/images/sso-hennge/03-sso-service.png" />
    </Frame>
  </Step>

  <Step title="选择SAML手动配置">
    选择"SAML手动配置"。

    <Frame>
      <img src="https://mintcdn.com/test-cf63e467/LU3oFsc_lcA5rDjy/ja/images/sso-hennge/04-saml-manual.png?fit=max&auto=format&n=LU3oFsc_lcA5rDjy&q=85&s=7544561ea72aa4d325f0bff363489b63" alt="SAML手动配置" width="1688" height="789" data-path="ja/images/sso-hennge/04-saml-manual.png" />
    </Frame>
  </Step>

  <Step title="输入必要信息">
    输入以下信息并保存。

    | 项目                   | 值                                          |
    | -------------------- | ------------------------------------------ |
    | 服务名称                 | VoicePing（可自定义）                            |
    | ACS URL              | `https://api.voiceping.io/api/v1/user/acs` |
    | SP Issuer (Audience) | `voice-ping`                               |
    | 属性设置                 | 属性: email, 值: 选择Email                      |

    <Frame>
      <img src="https://mintcdn.com/test-cf63e467/LU3oFsc_lcA5rDjy/ja/images/sso-hennge/05-sp-config.png?fit=max&auto=format&n=LU3oFsc_lcA5rDjy&q=85&s=cf764bdbce7b082433ed10fc49528d76" alt="SP配置输入" width="1596" height="955" data-path="ja/images/sso-hennge/05-sp-config.png" />
    </Frame>

    输入完成后，点击"保存"。
  </Step>

  <Step title="下载IdP元数据">
    点击创建的提供商，然后点击"元数据"。

    <Frame>
      <img src="https://mintcdn.com/test-cf63e467/LU3oFsc_lcA5rDjy/ja/images/sso-hennge/06-metadata.png?fit=max&auto=format&n=LU3oFsc_lcA5rDjy&q=85&s=83bd539b3474b27e05ea160c4b6dc762" alt="元数据" width="1702" height="1016" data-path="ja/images/sso-hennge/06-metadata.png" />
    </Frame>

    点击**IdP元数据**的"下载"。

    <Warning>
      请注意不是SAML签名的那个。
    </Warning>

    将下载一个.xml扩展名的文件。稍后在VoicePing端配置时需要使用。
  </Step>

  <Step title="更新访问策略">
    更新目标用户的访问策略。

    <Frame>
      <img src="https://mintcdn.com/test-cf63e467/LU3oFsc_lcA5rDjy/ja/images/sso-hennge/07-access-policy.png?fit=max&auto=format&n=LU3oFsc_lcA5rDjy&q=85&s=673511de214a9a72c81447ff3ec60be9" alt="访问策略" width="1703" height="1004" data-path="ja/images/sso-hennge/07-access-policy.png" />
    </Frame>

    具体的授予方法请参阅[HENNGE One文档](https://www.desknets.com/neo/download/doc/saml/henngeone.html)。
  </Step>
</Steps>

***

## VoicePing端配置

### 前提条件

<Check>已订阅VoicePing**企业版**</Check>
<Check>拥有具有**工作空间所有者权限**的账户</Check>

### 步骤

<Steps>
  <Step title="打开管理员仪表板">
    <Frame>
      <img src="https://mintcdn.com/test-cf63e467/LU3oFsc_lcA5rDjy/ja/images/sso-hennge/08-vp-dashboard.png?fit=max&auto=format&n=LU3oFsc_lcA5rDjy&q=85&s=bfff924da3fe3a1839d057bc344d8155" alt="管理员仪表板" width="807" height="703" data-path="ja/images/sso-hennge/08-vp-dashboard.png" />
    </Frame>
  </Step>

  <Step title="点击成员管理标签页">
    <Frame>
      <img src="https://mintcdn.com/test-cf63e467/LU3oFsc_lcA5rDjy/ja/images/sso-hennge/09-member-management.png?fit=max&auto=format&n=LU3oFsc_lcA5rDjy&q=85&s=f9bbf4b0cd76c077a2efd911babbe170" alt="成员管理" width="1701" height="919" data-path="ja/images/sso-hennge/09-member-management.png" />
    </Frame>
  </Step>

  <Step title="点击SSO认证设置">
    <Frame>
      <img src="https://mintcdn.com/test-cf63e467/LU3oFsc_lcA5rDjy/ja/images/sso-hennge/10-sso-settings.png?fit=max&auto=format&n=LU3oFsc_lcA5rDjy&q=85&s=22370883becbfa2494365ededf5a3d56" alt="SSO认证设置" width="1700" height="825" data-path="ja/images/sso-hennge/10-sso-settings.png" />
    </Frame>
  </Step>

  <Step title="启用SSO">
    开启"为工作空间启用SSO"。

    <Frame>
      <img src="https://mintcdn.com/test-cf63e467/LU3oFsc_lcA5rDjy/ja/images/sso-hennge/11-enable-sso.png?fit=max&auto=format&n=LU3oFsc_lcA5rDjy&q=85&s=4cab5d4c1d915448d153306568e6307e" alt="启用SSO" width="1698" height="896" data-path="ja/images/sso-hennge/11-enable-sso.png" />
    </Frame>
  </Step>

  <Step title="确认组织ID">
    选择"Organization ID"，确认组织ID。

    <Info>
      组织ID稍后在登录时需要使用。
    </Info>

    <Frame>
      <img src="https://mintcdn.com/test-cf63e467/LU3oFsc_lcA5rDjy/ja/images/sso-hennge/12-org-id.png?fit=max&auto=format&n=LU3oFsc_lcA5rDjy&q=85&s=e45896a7559021cd504186d24b5c407e" alt="组织ID" width="1703" height="795" data-path="ja/images/sso-hennge/12-org-id.png" />
    </Frame>
  </Step>

  <Step title="选择HENNGE One">
    点击"Identity Provider"标签页，选择HENNGE One。

    <Frame>
      <img src="https://mintcdn.com/test-cf63e467/LU3oFsc_lcA5rDjy/ja/images/sso-hennge/13-select-hennge.png?fit=max&auto=format&n=LU3oFsc_lcA5rDjy&q=85&s=b3e86c8e1dd927dff84279f25ba4326b" alt="选择HENNGE One" width="1702" height="879" data-path="ja/images/sso-hennge/13-select-hennge.png" />
    </Frame>
  </Step>

  <Step title="上传元数据">
    上传在HENNGE One端配置中下载的文件（.xml扩展名），然后提交。

    <Frame>
      <img src="https://mintcdn.com/test-cf63e467/LU3oFsc_lcA5rDjy/ja/images/sso-hennge/14-upload-metadata.png?fit=max&auto=format&n=LU3oFsc_lcA5rDjy&q=85&s=8be12d7bcc42f660ecf15212f6a5a2df" alt="上传元数据" width="1696" height="805" data-path="ja/images/sso-hennge/14-upload-metadata.png" />
    </Frame>
  </Step>

  <Step title="添加用户">
    点击"用户管理"标签页，点击"添加成员"按钮。

    <Frame>
      <img src="https://mintcdn.com/test-cf63e467/LU3oFsc_lcA5rDjy/ja/images/sso-hennge/15-add-members.png?fit=max&auto=format&n=LU3oFsc_lcA5rDjy&q=85&s=d90ace6f3bef948059835ef612e2c885" alt="添加成员" width="1696" height="1008" data-path="ja/images/sso-hennge/15-add-members.png" />
    </Frame>

    点击"创建用户"，通过CSV文件或手动输入创建。

    <Frame>
      <img src="https://mintcdn.com/test-cf63e467/LU3oFsc_lcA5rDjy/ja/images/sso-hennge/16-create-users.png?fit=max&auto=format&n=LU3oFsc_lcA5rDjy&q=85&s=d4888d2b2b8dbb3192753c15ea0e9faa" alt="创建用户" width="1698" height="998" data-path="ja/images/sso-hennge/16-create-users.png" />
    </Frame>
  </Step>
</Steps>

***

## SSO登录

### 网页版

1. 访问VoicePing登录页面（[app.voiceping.io](https://app.voiceping.io/user/login)）
2. 点击"SSO登录"

<Frame>
  <img src="https://mintcdn.com/test-cf63e467/LU3oFsc_lcA5rDjy/ja/images/sso-hennge/17-login-web.png?fit=max&auto=format&n=LU3oFsc_lcA5rDjy&q=85&s=50da14d8eaa1f2a95b0cd38e47b467d3" alt="网页登录" width="673" height="852" data-path="ja/images/sso-hennge/17-login-web.png" />
</Frame>

3. 输入组织ID

<Frame>
  <img src="https://mintcdn.com/test-cf63e467/LU3oFsc_lcA5rDjy/ja/images/sso-hennge/18-org-id-input.png?fit=max&auto=format&n=LU3oFsc_lcA5rDjy&q=85&s=ca3f35ec8ffa5c182cb5ad0666064826" alt="组织ID输入" width="582" height="420" data-path="ja/images/sso-hennge/18-org-id-input.png" />
</Frame>

如果配置正确，将打开HENNGE登录页面。

<Frame>
  <img src="https://mintcdn.com/test-cf63e467/LU3oFsc_lcA5rDjy/ja/images/sso-hennge/20-hennge-login-screen.png?fit=max&auto=format&n=LU3oFsc_lcA5rDjy&q=85&s=55d30161253b4b701ac979bffb9f81b9" alt="HENNGE登录页面" width="1696" height="1008" data-path="ja/images/sso-hennge/20-hennge-login-screen.png" />
</Frame>

4. 输入HENNGE One认证信息登录

<Frame>
  <img src="https://mintcdn.com/test-cf63e467/LU3oFsc_lcA5rDjy/ja/images/sso-hennge/21-hennge-login-form.png?fit=max&auto=format&n=LU3oFsc_lcA5rDjy&q=85&s=45f4bc1d7a9b0fb47d8164d149b2c0a5" alt="HENNGE登录表单" width="1698" height="998" data-path="ja/images/sso-hennge/21-hennge-login-form.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/test-cf63e467/LU3oFsc_lcA5rDjy/ja/images/sso-hennge/22-hennge-authentication.png?fit=max&auto=format&n=LU3oFsc_lcA5rDjy&q=85&s=5f1337ed2f32d93212b789a4d243ee25" alt="HENNGE认证" width="1009" height="574" data-path="ja/images/sso-hennge/22-hennge-authentication.png" />
</Frame>

5. 认证完成后，将重定向到VoicePing

<Frame>
  <img src="https://mintcdn.com/test-cf63e467/LU3oFsc_lcA5rDjy/ja/images/sso-hennge/23-voiceping-redirect.png?fit=max&auto=format&n=LU3oFsc_lcA5rDjy&q=85&s=668dd1fb27e14727ef3ce1aa353d0882" alt="VoicePing重定向" width="673" height="852" data-path="ja/images/sso-hennge/23-voiceping-redirect.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/test-cf63e467/LU3oFsc_lcA5rDjy/ja/images/sso-hennge/24-successful-login.png?fit=max&auto=format&n=LU3oFsc_lcA5rDjy&q=85&s=0bb960e48852dafebd47773669001ae3" alt="登录成功" width="582" height="420" data-path="ja/images/sso-hennge/24-successful-login.png" />
</Frame>

登录成功后，将重定向到VoicePing应用程序。

### 移动端

桌面应用程序和移动应用程序也可以使用相同的步骤登录。

<Frame>
  <img src="https://mintcdn.com/test-cf63e467/LU3oFsc_lcA5rDjy/ja/images/sso-hennge/19-login-mobile.png?fit=max&auto=format&n=LU3oFsc_lcA5rDjy&q=85&s=934c2a785a2f5ba3d601cb1b76c632f4" alt="移动端登录" width="392" height="831" data-path="ja/images/sso-hennge/19-login-mobile.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/test-cf63e467/LU3oFsc_lcA5rDjy/ja/images/sso-hennge/25-mobile-login.png?fit=max&auto=format&n=LU3oFsc_lcA5rDjy&q=85&s=57398eef3cddce12a98ad0f22bdb9378" alt="移动端登录完成" width="392" height="831" data-path="ja/images/sso-hennge/25-mobile-login.png" />
</Frame>

***

<ContactZh />
