ThingWorx Navigate einrichten: Windchill Authentifizierung
Auf den Bildschirmen für die Windchill Authentifizierung müssen die Informationen für den Windchill Server und für ThingWorx KeyStore und TrustStore Dateien eingegeben werden.
Vorbereitung
Stellen Sie sicher, dass Ihr System die folgenden Voraussetzungen erfüllt, bevor Sie die Windchill Authentifizierung einrichten.
• Windchill wurde mit SSL konfiguriert.
• ThingWorx– Wir empfehlen die Konfiguration von ThingWorx mit SSL.
• Ihr Windchill Administrator hat die Eigenschaft allowList für URL-Umleitungen konfiguriert. Wenn diese Eigenschaft nicht konfiguriert ist, können Sie nicht auf ThingWorx Navigate zugreifen.
Führen Sie den folgenden Befehl in der Windchill Shell aus, um wt.idp.allowlisturls in der wt.properties-Datei festzulegen:
xconfmanager -s wt.idp.allowlisturls="url1 url2 url3" -t codebase/wt.properties -p
Der Name der webapp sollte in der URL enthalten sein. Beispiel: https://hostxyz:8443/Thingworx.
Beispiel für den Befehl:
xconfmanager -s wt.idp.allowlisturls="https://hostxyz:8443/Thingworx https://hostxyz:8449/Thingworx http://hostxyz:8080/Thingworx" -t codebase/wt.properties -p
Dieses Windchill Hilfethema enthält ausführliche Informationen zu Windchill Konfigurationseigenschaften.
• Sie haben TrustStore- und KeyStore-Dateien erstellt. Das Thema KeyStore- und TrustStore-Dateien für ThingWorx Navigate erstellen enthält Anweisungen zum Generieren dieser Dateien.
• Sie haben das Windchill SSL-Zertifikat in die ThingWorx TrustStore-Datei importiert. Weitere Informationen zum Konfigurieren von SSL finden Sie im Thema SSL für sichere Kommunikation verwenden.
Windchill Verbindung herstellen
Geben Sie auf dieser Seite die Informationen für Ihre Windchill Verbindung an.
1. Geben Sie die Windchill Server-URL ein:
◦ Für eine Verbindung mit einem einzelnen Windchill Server: Die URL muss das Format [http oder https]://[windchill-host]:[windchill-port]/[windchill-web-app] aufweisen.
◦ Für Windchill Cluster-Umgebungen: Geben Sie die URL des Lastenausgleichs-Routers ein. Beispiel: [https]://[LB-host]:[port]/[windchill-web-app].
Das URL-Format hängt von der Konfiguration Ihres Systems ab. Lesen Sie in ThingWorx Navigate mit einer Windchill Cluster-Umgebung konfigurieren die Abschnitte zur Windchill Authentifizierung.
◦ Für Verbindungen mit mehreren Windchill Systemen: Stellen Sie zunächst eine Verbindung mit einem einzelnen Server her. Nachdem Sie die Erstkonfiguration abgeschlossen haben, befolgen Sie die manuellen Schritte in ThingWorx Navigate für Verbindungen mit mehreren Windchill Systemen konfigurieren.
2. Klicken Sie auf Weiter oder Vorwärts.
Windchill Authentifizierungseinstellungen
Bevor Sie die Informationen auf diesem Bildschirm eingeben, bereiten Sie die richtigen KeyStore- und TrustStore-Dateien für ThingWorx vor:
• KeyStore-Datei – Erstellen Sie eine neue ThingWorx KeyStore-Datei mit dem Java-Dienstprogramm keytool. Denken Sie daran, das ThingWorx Schlüsselpaar einzuschließen. Dies ist ein Client-Zertifikat für den Zugriff auf Daten aus Windchill unter Verwendung der 2-Wege-SSL-Konfiguration auf ThingWorx Navigate und Windchill.
 | Diese ThingWorx KeyStore-Datei unterscheidet sich von der Apache Tomcat KeyStore-Datei, die Sie möglicherweise während der Installation von ThingWorx Navigate erstellt haben. Diese separaten KeyStore-Dateien haben unterschiedliche Aufgaben. Es ist daher wichtig, die richtige Datei am richtigen Ort bereitzustellen. |
• TrustStore-Datei – Erstellen Sie eine ThingWorx TrustStore-Datei mit dem Java-Dienstprogramm keytool, und importieren Sie anschließend das Windchill SSL-Zertifikat in die TrustStore-Datei.
Weitere Informationen finden Sie in den Themen KeyStore- und TrustStore-Dateien für ThingWorx Navigate erstellen und SSL für sichere Verbindung verwenden.
Nachdem Sie die richtigen Dateien vorbereitet haben, können Sie die Informationen auf dem Bildschirm Einstellungen für die Windchill Authentifizierung eingeben:
1. Klicken Sie neben KeyStore-Datei auf 
, und navigieren Sie dann zu der ThingWorx Keystore-Datei, die Sie oben erstellt haben.
, und navigieren Sie dann zu der ThingWorx Keystore-Datei, die Sie oben erstellt haben.| | Denken Sie daran, dass sich die ThingWorx KeyStore-Datei von der Apache Tomcat KeyStore-Datei unterscheidet. |
2. Geben Sie das Passwort ein, das Sie beim Erstellen der KeyStore-Datei festgelegt haben.
3. Klicken Sie neben TrustStore-Datei auf , und navigieren Sie anschließend zu Ihrer ThingWorx TrustStore-Datei.
, und navigieren Sie anschließend zu Ihrer ThingWorx TrustStore-Datei.4. Geben Sie das Passwort ein.
5. Akzeptieren Sie den Standardwert für Abfrageparameter für Sitzungsbenutzer.
| | In den meisten Fällen sollten Sie den Standardwert für diesen Parameter akzeptieren. Ändern Sie den Wert nur dann, wenn der Windchill Administrator diese Standardeinstellung in Windchill geändert hat. |
6. Klicken Sie auf Weiter oder Vorwärts. Die Seite Zusammenfassung: Konfigurationseinstellungen wird geöffnet.
Zusammenfassung: Konfigurationseinstellungen
1. Überprüfen Sie die Einstellungen und klicken Sie auf Konfigurieren. ThingWorx Navigate ist konfiguriert.
2. Aktivieren Sie die Kontrollkästchen, um eines oder beide Programme zu öffnen:
◦ ThingWorx Navigate öffnen
◦ ThingWorx Composer öffnen
Klicken Sie anschließend auf Schließen.
Erfolg!
ThingWorx Navigate ist mit Windchill Authentifizierung konfiguriert. Wählen Sie die Programme aus, die geöffnet werden sollen:
• ThingWorx Navigate öffnen
• ThingWorx Composer öffnen
Klicken Sie anschließend auf Schließen.
| | Wenn die Konfiguration fehlschlägt, aktivieren Sie das Kontrollkästchen Öffnen Sie die Protokolldatei, und überprüfen Sie die Protokolldatei auf Fehlerangaben. |
Konfiguration prüfen
Der Administrator muss in Windchill und ThingWorx den gleichen Benutzernamen verwenden.
• Wenn Sie keine Änderungen in Windchill vorgenommen haben, wurde bei der Installation von Windchill ein Administratorbenutzer namens "Administrator" erstellt. Wird ein konfiguriertes ThingWorx System verwendet, können Sie sich als dieser Benutzer authentifizieren und haben volle Zugriffsrechte als Administrator in ThingWorx.
• Wenn Sie den Benutzernamen für den Administrator geändert haben, wählen Sie einen Benutzernamen aus, der in Windchill und ThingWorx gleich ist, und fügen Sie diesen Benutzer anschließend zu ThingWorx sowie zur Benutzergruppe "Administratoren" hinzu.
So überprüfen Sie die Windchill Authentifizierungs-Konfiguration:
1. Öffnen Sie die ThingWorx URL. Sie werden zur Authentifizierung zu Windchill weitergeleitet.
2. Geben Sie die Windchill Anmeldeinformationen für den Administrator an (oder für einen anderen Benutzer, der als ThingWorx Administrator konfiguriert ist). Der Browser wird zurückgeleitet zu ThingWorx und ThingWorx Composer wird geöffnet.
3. Überprüfen Sie, dass Sie ThingWorx als Administrator ausführen.
Erfolg! ThingWorx ist ordnungsgemäß mit Windchill Authentifizierung konfiguriert.
Wenn der Authentifikator für die automatische Erstellung von Benutzern konfiguriert ist, prüfen Sie als dies als nächstes:
1. Öffnen Sie die ThingWorx URL im Browser. Sie werden zur Authentifizierung zu Windchill weitergeleitet.
2. Geben Sie die Windchill Anmeldeinformationen eines Benutzers an, der nicht in ThingWorx vorhanden ist.
3. Ihr Browser wird zurück zur ThingWorx Start-Mashup-Seite geleitet.
4. Überprüfen Sie, ob Sie ThingWorx nun als richtiger Benutzer ausführen. Der Benutzer wurde automatisch erstellt.
| | Wenn die Anpassungsoptionen und die Suchergebnisse nicht wie erwartet funktionieren, starten Sie Apache Tomcat und ThingWorx Integration Runtime neu. |
Nächste Schritte
ThingWorx Navigate ist jetzt installiert und lizenziert, und die grundlegende Konfiguration ist abgeschlossen. Die ThingWorx Navigate Aufgaben können jetzt verwendet werden. Für die Anmeldung sollten Benutzer Ihren Benutzernamen und Ihr Passwort für Windchill verwenden.
Im nächsten Schritt müssen nicht als Administratoren eingerichteten Benutzern Berechtigungen gewährt werden. Führen Sie die Schritte in ThingWorx Berechtigungen ändern: Benutzer und Gruppen aus.
Sie können auch mit optionalen Konfigurationen wie den folgenden weitermachen: