与 Microsoft ADFS 相集成
在开始整合过程之前,您必须已经申请并核准了 Onshape Enterprise 帐户或试用版,并且拥有 Onshape Enterprise 域名。
Enterprise 域名的一个例子可能是:MyCompanyName.onshape.com。
请注意,您一次只能使用一个 SSO 提供程序。
This configuration process might fail without parameter values customized for your organization. Use your custom SSO identity provider (for example: Okta, PingOne, or ClassLink) dashboard to add Onshape as an application and record the values that are specific for your organization. You need those values for the following procedure.
Onshape 签署所有发出的 SAML 认证申请。您无需上传任何证书(例如,SAML 签名证书),ADFS 集成除外,因为 ADFS 会验证传入的 SAML 请求。请注意,Microsoft 还建议从最新版本的 ADFS 迁移到微软 Entra ID。有关更多信息,请参阅 ADFS 概述。
在 ADFS 管理应用程序中创建“信赖方信任”
- 在您的 ADFS 门户中,导航到“信赖方信任”,然后导航到“添加信赖方信任…”
- 选择“申请感知”。
- 选择“手动输入有关信赖方的数据”。
- 选择“启用 SAML 2.0 WebSSO 协议支持”。
- 将“信赖方 SAML 2.0 SSO 服务 URL”设置为 https://cad.onshape.com/identity/saml2/sso
- 将“信赖方信任标识符”设置为 com.onshape.saml2.sp
设置 SP 证书和哈希算法
- 双击使用上述指令创建的 RP 信任。
- 在“签名”选项卡上,添加合适的证书。
- 在“高级”选项卡上,将哈希算法设置为“SHA-1”。
配置申请
- 在 RP 信任上单击鼠标右键,然后选择“编辑申请发布政策”。
- 添加下面显示的三个规则(使用规则 3 中的企业的 DNS 前缀)
- 规则 1 模板:“将 LDAP 属性发送为申请”
- 规则 2 模板:“通过或筛选传入的申请”
- 规则 3 模板:“使用自定义规则发送申请”
Download the ADFS metadata file from: https://<server>/federationmetadata/2007-06/federationmetadata.xml
然后将其上传到 Onshape。
确保使用您的 ADFS 服务器的主机名替换 <server>。
确保使用您的公司名称值替换“Onshape DNS prefix here”,如上所示。例如,如果您的 Onshape 域为 acme.Onshape.com,请使用“acme”作为此输入框的值。
上传 Onshape 中的配置文件
下载配置/元数据文件后:
- 以管理员身份使用专门的域名登录您的 Onshape 企业帐户。
- 从“用户”菜单中选择公司/企业设置。
- 从左侧菜单中选择身份验证。
- 在单点登录 (SSO) 部分中:
- 单击上传配置文件。
- 选择您之前下载的元数据文件,然后单击打开。
- 在对话框中,输入 SSO 提供程序的名称并选中启用 SSO 提供程序复选框。
- Click OK.
You can disable the typical Onshape password sign in for your users and show just the SSO provider sign in prompt for the Onshape URL. However, do not perform this step at this time. Make sure you can sign in to Onshape yourself (as administrator) before disabling this additional sign in option. You can return here later, once sign in through your SSO provider has been verified to work correctly.
选择通过 SSO 强制登录到 Onshape 还会导致用户无法直接登录到非企业域,例如 cad.onshape.com。 - 退出登录 Onshape 帐户。
- 针对 Onshape 帐户页面执行硬刷新;请注意,该页面的底部有一个用于 SSO 提供程序的新登录链接。
要登录到 Onshape,管理员必须(在其单点登录帐户中)将其用户配置为使用 Onshape 应用程序。