与 PingOne 相集成
在开始整合过程之前,您必须已经申请并核准了 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 单点登录帐户:
-
以管理员身份登录到 PingOne 门户网站。单击左侧导航窗格上的连接图标。
-
单击添加应用程序。
-
单击“Web 应用程序”框。然后单击 SAML 连接类型右侧的配置按钮。
-
在打开的创建应用程序配置文件选项卡中,输入应用程序名称和说明。然后单击窗格底部的下一步按钮。
-
在打开的配置 SAML 选项卡中,在“ACS URL” 输入框中输入 https://cad.onshape.com/identity/saml2/sso。
-
在同一选项卡中,向下滚动并在图元 ID 输入框中输入 com.onshape.saml2.sp,在断言验证时长(秒)输入框中输入 300。然后单击存并继续按钮。
-
在“映射属性”选项卡中,从 PingOne 用户属性下拉列表中选择电子邮件地址。
-
在同一选项卡中,创建以下三个 SAML 属性:
-
单击添加属性链接,然后从下拉列表中选择静态属性。这会创建第一个静态属性。在静态键输入框中,输入 firstName,然后在静态值输入框中输入名字。
-
再次单击“添加属性”链接,然后从下拉列表中选择静态属性。这会创建第二个静态属性。在静态键输入框中,输入 lastName,然后在静态值输入框中输入姓氏。
-
再次单击“添加属性”链接,然后从下拉列表中选择静态属性。这会创建第三个静态属性。在静态键输入框中,输入 companyName,然后在静态值输入框中输入域名前缀。例如,如果您的 Onshape Enterprise 名称为 Fishbowl.onshape.com,则在该输入框中输入 Fishbowl。
-
-
输入三个 SAML 属性后,它应如下图所示。单击保存并关闭按钮。
-
“应用程序”窗口将会打开。单击平均每日登录开关为应用程序启用单点登录。右上角会显示通知指明已成功保存应用程序。
-
单击配置子部分。然后单击下载按钮以下载元数据文件。在成功下载此文件后,右上角会显示相应消息。单击 X 关闭该消息。
上面的 ACS URL 必须为 “cad.onshape.com”,而不是您的 Onshape Enterprise 的 URL。
上传 Onshape 中的配置文件
- 以管理员身份使用专门的域名登录您的 Onshape 企业帐户。从帐户中选择 Enterprise 设置。
- 从左侧导航菜单中选择身份验证。
-
在单点登录 (SSO) 子部分中,单击配置 SSO 提供程序按钮。
-
“创建 SSO 提供程序”对话框将会打开。在名称输入框中,输入名称,例如 PingOne 身份。在“提供程序类型”下拉列表中,选择 PingOne。然后单击上传配置文件按钮。
-
找到并选择之前下载的元数据配置文件,然后单击打开。
-
单击确定。
-
将上传该文件。上传完成后,系统会显示通知。
- 退出登录 Onshape 和 PingOne 帐户。请确保针对两个帐户页面执行硬刷新。再次到达 Onshape 登录页面时,该页面的底部有一个用于单点登录提供程序的新登录链接。
您可以为用户禁用典型的 Onshape 密码登录并仅为 Onshape URL 显示 SSO 提供程序登录提示。但是,目前请勿执行此步骤。请先确保您可以自行登录到 Onshape(以管理员身份),然后再禁用此附加登录选项。已验证通过 SSO 提供程序的登录可正常工作后,您可以稍后返回此处。
选择通过 SSO 强制登录到 Onshape 还会导致用户无法直接登录到非企业域,例如 cad.onshape.com。