在开始整合过程之前,您必须已经申请并核准了 Onshape Enterprise 帐户或试用版,并且拥有 Onshape Enterprise 域名。

Enterprise 域名的一个例子可能是:MyCompanyName.onshape.com。

您一次只能使用一个 SSO(单点登录)提供程序。

如果没有为您的组织自定义的参数值,则此配置过程可能会失败。使用 PingOne 单点登录仪表板将 Onshape 添加为应用程序并记录特定于您的组织的值。您需要这些值来进行以下过程。

Onshape 签署所有发出的 SAML 认证申请。您无需上传任何证书(例如,SAML 签名证书),ADFS 集成除外,因为 ADFS 会验证传入的 SAML 请求。请注意,Microsoft 还建议从最新版本的 ADFS 迁移到微软 Entra ID。有关更多信息,请参阅 ADFS 概述

将 Onshape 添加到您的 PingOne 单点登录帐户

要为您的公司启用单点登录,必须先将 Onshape 应用程序添加到您的 PingOne 单点登录帐户:

  1. 以管理员身份登录到 PingOne 门户网站。单击左侧导航窗格上的连接图标。

  2. PingIdentity 页面,从左侧导航栏中单击“连接”

  3. 单击添加应用程序

    PingIdentity 应用程序页面,框起了“添加应用程序”按钮

  4. 单击“Web 应用程序”框。然后单击 SAML 连接类型右侧的配置按钮。

    单击“Web 应用程序”框,然后在“SAML 连接类型”对话框中单击“配置”按钮

  5. 在打开的创建应用程序配置文件选项卡中,输入应用程序名称和说明。然后单击窗格底部的下一步按钮。

    “创建应用程序配置文件”页面,框起了“应用程序名称”和“说明”

  6. 在打开的配置 SAML 选项卡中,在“ACS URL” 输入框中输入 https://cad.onshape.com/identity/saml2/sso

  7. 上面的 ACS URL 必须为 “cad.onshape.com”,而不是您的 Onshape Enterprise 的 URL。

    “配置 SAML 连接”页面,框起了“元数据文件”

  8. 在同一选项卡中,向下滚动并在图元 ID 输入框中输入 com.onshape.saml2.sp,在断言验证时长(秒)输入框中输入 300。然后单击存并继续按钮。

    PingIdentity Onshape 应用程序页面,框起了“实体 ID”和“断言有效性”。

  9. 在“映射属性”选项卡中,从 PingOne 用户属性下拉列表中选择电子邮件地址

    “属性映射”页面,框起了“SAML 属性”

  10. 在同一选项卡中,创建以下三个 SAML 属性:

    1. 单击添加属性链接,然后从下拉列表中选择静态属性。这会创建第一个静态属性。在静态键输入框中,输入 firstName,然后在静态值输入框中输入名字

    2. 再次单击“添加属性”链接,然后从下拉列表中选择静态属性。这会创建第二个静态属性。在静态键输入框中,输入 lastName,然后在静态值输入框中输入姓氏

    3. 再次单击“添加属性”链接,然后从下拉列表中选择静态属性。这会创建第三个静态属性。在静态键输入框中,输入 companyName,然后在静态值输入框中输入域名前缀。例如,如果您的 Onshape Enterprise 名称为 Fishbowl.onshape.com,则在该输入框中输入 Fishbowl

    4. 从“SAML 属性”页面中选择“静态属性”

  11. 输入三个 SAML 属性后,它应如下图所示。单击保存并关闭按钮。

    在“SAML 属性”页面上映射属性

  12. “应用程序”窗口将会打开。单击平均每日登录开关为应用程序启用单点登录。右上角会显示通知指明已成功保存应用程序。

    “应用程序”页面,显示了用于开启“平均每日登录”的切换开关

  13. 单击配置子部分。然后单击下载按钮以下载元数据文件。在成功下载此文件后,右上角会显示相应消息。单击 X 关闭该消息。

    “应用程序”页面,单击“配置”,然后下载元数据文件

上传 Onshape 中的配置文件

  1. 以管理员身份使用专门的域名登录您的 Onshape 企业帐户。从帐户中选择 Enterprise 设置

    进入“我的帐户”菜单,然后单击“企业设置”按钮

  2. 从左侧导航菜单中选择身份验证

    从左侧导航菜单中选择“身份验证”

  3. 在单点登录 (SSO) 子部分中,单击配置 SSO 提供程序按钮。

    在单点登录 (SSO) 设置下单击“配置 SSO 提供程序”

  4. “创建 SSO 提供程序”对话框将会打开。在名称输入框中,输入名称,例如 PingOne 身份。在“提供程序类型”下拉列表中,选择 PingOne。然后单击上传配置文件按钮。

    在“创建 SSO 提供程序”页面中输入一个名称,选择一种提供程序类型,然后单击“上传配置文件”按钮

  5. 找到并选择之前下载的元数据配置文件,然后单击打开

    打开之前下载的 XML 元数据文件

  6. 单击确定

    单击“确定”来完成 SSO 提供程序的创建

  7. 将上传该文件。上传完成后,系统会显示通知。

    显示已成功上传 SSO 配置文件的通知

  8. 您可以为用户禁用典型的 Onshape 密码登录并仅为 Onshape URL 显示 SSO 提供程序登录提示。但是,目前请勿执行此步骤。请先确保您可以自行登录到 Onshape(以管理员身份),然后再禁用此附加登录选项。已验证通过 SSO 提供程序的登录可正常工作后,您可以稍后返回此处。

    选择通过 SSO 强制登录到 Onshape 还会导致用户无法直接登录到非企业域,例如 cad.onshape.com。

  9. 退出登录 Onshape 和 PingOne 帐户。请确保针对两个帐户页面执行硬刷新。再次到达 Onshape 登录页面时,该页面的底部有一个用于单点登录提供程序的新登录链接。

    Onshape 登录页面,带有新的“通过 Ping 登录”(SSO) 按钮