透過單一登入設定 ThingWorx Navigate
在單一登入畫面,我們需要輸入 Windchill 伺服器的資訊以及連線至 PingFederate 的資訊。
事前準備
輸入 Windchill 伺服器資訊
首先,我們連線至 Windchill。我們建議針對 SSL 配置 Windchill。
1. 輸入您的「Windchill 伺服器 URL」:
◦ 欲連接至單一 Windchill 伺服器,請確保 URL 遵循格式 [http 或 https]://[windchill-host]:[windchill-port]/[windchill-web-app]
◦ 針對叢集 Windchill 環境,請輸入負載平衡路由器的 URL。例如,[https]://[LB-host]:[port]/[windchill-web-app]
2. 按一下 Next。
向 ThingWorx 提供您的 TrustStore 資訊
在此螢幕上提供資訊之前,請根據 Apache Tomcat 是否配置了 SSL 準備正確的信任庫檔案:
• 帶有 SSL 的 Apache Tomcat - 使用您在安裝時使用的相同 ThingWorx 信任庫檔案來配置帶有 SSL 的 Apache Tomcat。然後,使用 keytool 公用程式將 Windchill SSL 憑證匯入 ThingWorx 信任庫檔案。
• 不帶 SSL 的 Apache Tomcat - 透過 Java keytool 公用程式建立 ThingWorx 信任庫,然後將 Windchill SSL 憑證匯入信任庫檔案。
主題
使用 SSL 設定 ThingWorx Navigate 中有透過
keytool 產生信任庫檔案的指示。
現在,信任庫檔案已準備就緒,請提供「SSO: ThingWorx 的信任庫」螢幕上的資訊:
1. 按一下
TrustStore file 旁邊的
,然後瀏覽至您的信任庫檔案。請確定此檔案採用的是 JKS (
*.jks) 格式。
2. 按一下「開啟」。
3. 在「密碼」旁邊輸入信任庫檔案的密碼。
4. 按一下 Next。
存取權杖保存設定
在此畫面中,輸入您的資料庫存取權杖資訊。位置、埠、使用者名稱和資料庫名稱會依據您的安裝設定自動顯示。
• IP 地址或主機名稱
• 埠
• 資料庫名稱
• 使用者名稱
• 密碼
輸入 PingFederate 伺服器資訊
1. 輸入 PingFederate 的此類資訊:
◦ Hostname - 針對 PingFederate 伺服器輸入完全合格的主機名稱,例如 <hostname.domain.com>。
◦ Runtime port - 提供 PingFederate 執行時間埠。預設為 9031。
2. 按一下 Next。
提供識別提供者 (IdP) 與服務提供者 (SP) 的資訊
在此畫面中,從 PingFederate 提供資訊。請仔細檢查您的輸入。這些值未經驗證,如果資訊不正確,就會發生錯誤。
1. 提供 PingFederate 的 IdP 中繼資料資訊:
◦ 「IdP 中繼資料檔案」- 按一下
,然後瀏覽至
PingFederate 的 IdP 中繼資料檔案。例如,
sso-idp-metadata.xml。
◦ SAML 宣告使用者名稱屬性名稱 - 接受預設值,uid,或輸入新的屬性名稱。
2. 輸入 ThingWorx 服務提供者連接對的資訊:
◦ SP 連接對實體 ID - 輸入 metadataEntityId 的值。這是 ThingWorx 服務提供者連線 ID,需要您在 PingFederate 中配置服務提供者連線時提供。
3. 按一下 Next。
SSO 金鑰管理員設定
在此畫面上輸入資訊之前,請準備正確的金鑰倉庫檔案和金鑰對:
| 這是 ThingWorx 簽署憑證。這是應用程式階層憑證,並不一定與您的 ThingWorx 主機名稱相同。例如,ThingWorx。 |
2. 將 PingFederate 簽署憑證匯入至您在步驟 1 中建立的 SSO 金鑰庫檔案。
這些資源可能會很有幫助:
您已經有正確的檔案及憑證,您可以在「SSO 金鑰管理員設定」螢幕上輸入資訊:
1. 提供您 SSO 金鑰倉庫的資訊:
◦ KeyStore File - 按一下
,然後瀏覽至 JKS (
*.jks) 檔案。
◦ 「金鑰庫密碼」- 輸入建立金鑰倉庫檔案時依上述方法定義的密碼。
2. 輸入依上述方法定義的 ThingWorx 金鑰對資訊。
◦ 金鑰對別名
◦ 「金鑰對密碼」
3. 按一下 Next。
授權伺服器設定
PingFederate 作為授權伺服器。
1. 提供您的 PingFederate 伺服器的設定:
◦ 「授權伺服器 ID」- 您的 PingFederate 伺服器 ID。
◦ 「授權伺服器範圍」- 在 PingFederate 中註冊之範圍的名稱。例如,SCOPE NAME = WINDCHILL_READ
◦ 「ThingWorx OAuth 用戶端 ID」- 識別 PingFederate 之 ThingWorx 應用程式的 OAuth 用戶端 ID。
◦ 「ThingWorx OAuth 用戶端密碼」- PingFederate 中所述的用戶端密碼。
◦ 「用戶端驗證配置」- 預設為 form。
2. 接受預設「加密 OAuth 重新整理權杖」,在將權杖保留至資料庫之前對其進行保護。我們建議採用此設定。
3. 按一下 Next。
Summary: Configuration Settings
檢查組態設定。當您就緒時,請按一下「配置」。
成功!
ThingWorx Navigate 配置為使用單一登入。選取要開啟的程式:
• 「開啟 ThingWorx Navigate」
• 「開啟 ThingWorx Composer」
然後按一下「關閉」。您會被重新導向至識別提供者登入頁。使用您的 IdP 認證登入。
後續步驟
您的
ThingWorx Navigate 已安裝並獲得了授權,且基本組態已完成。下一個必要的步驟是向非管理使用者授與權限。請依照
修改 ThingWorx 權限:使用者和群組中的步驟執行。
您也可以繼續前往選用組態,例如下列組態:
• 連線至 SAP
• 配置為使用多個 Windchill 系統