Impostare ThingWorx Navigate con l'autenticazione Windchill

Nelle schermate per l'autenticazione Windchill è necessario immettere le informazioni per il server Windchill e per i file keystore e truststore di ThingWorx.

Prima di impostare l'autenticazione Windchill, assicurarsi che il sistema soddisfi i prerequisiti riportati di seguito.

• Windchill è stato configurato con SSL.

• ThingWorx - Si consiglia di configurare ThingWorx con SSL.

• L'amministratore Windchill ha configurato la proprietà allowList per i reindirizzamenti URL. Se questa proprietà non è configurata, non sarà possibile accedere a ThingWorx Navigate.

1. Per impostare wt.idp.allowlisturls nel file wt.properties, eseguire il seguente comando dalla shell Windchill.

xconfmanager -s wt.idp.allowlisturls="url1 url2 url3" -t codebase/wt.properties -p

2. Includere i dettagli di host e port per ThingWorx Flow nell'URL. Ad esempio, https://FlowHost:Port/Thingworx.

Esempio di comando dove host e port sono i valori immessi nei campi di nome host NGINX e numero porta durante l'installazione di ThingWorx Navigate:

xconfmanager -s wt.idp.allowlisturls="https://hostxyz:443/Thingworx https://hostxyz:8449/Thingworx http://hostxyz:8080/Thingworx" -t codebase/wt.properties -p

Questo argomento in Windchill Help Center contiene informazioni dettagliate sulle proprietà di configurazione di Windchill.

• I file truststore e keystore sono stati creati. L'argomento Creare i file keystore e truststore per ThingWorx Navigate contiene istruzioni per la generazione dei file.

• Il certificato SSL di Windchill è stato importato nel file truststore di ThingWorx. Per ulteriori informazioni sulla configurazione SSL, vedere l'argomento Configurazione SSL per la comunicazione protetta.

• Il server HTTP Windchill è stato configurato in base alle istruzioni fornite in questo articolo del supporto tecnico. Poiché ThingWorx Navigate 9.1 e versioni successive supportano JDK 11 e Open JDK 11, questa configurazione è necessaria affinché la connessione a Windchill funzioni come previsto, soprattutto durante l'impostazione di ThingWorx Navigate con l'autenticazione Windchill.

◦ Per connettersi a un unico server Windchill, assicurarsi che l'URL segua il formato [http o https]://[windchill-host]:[windchill-port]/[windchill-web-app].

◦ Per gli ambienti cluster Windchill, immettere l'URL del router di bilanciamento del carico. Ad esempio, [https]://[LB-host]:[port]/[windchill-web-app].

Il formato dell'URL dipende dalla configurazione del sistema. Nell'argomento Configurare ThingWorx Navigate con un ambiente cluster Windchill, vedere le sezioni relative all'autenticazione Windchill.

◦ Per connettersi a più sistemi Windchill, eseguire per ora la connessione a un unico server. Dopo avere completato la configurazione iniziale, seguire la procedura manuale descritta in Configurare ThingWorx Navigate per la connessione a più sistemi Windchill.

Prima di fornire le informazioni in questa schermata, preparare i file keystore e truststore corretti per ThingWorx.

• File keystore - Creare un nuovo file keystore ThingWorx tramite l'utilità keytool Java. Assicurarsi di includere la coppia di chiavi ThingWorx. Si tratta di un certificato client utilizzato per accedere ai dati da Windchill utilizzando la configurazione SSL bidirezionale sui lati ThingWorx Navigate e Windchill.

Il file keystore di ThingWorx è diverso dal file keystore di Apache Tomcat che può essere stato creato durante l'installazione diThingWorx Navigate. Questi file keystore distinti hanno funzioni diverse ed è importante fornire il file corretto nella posizione corretta.

• File truststore - Creare un file truststore ThingWorx tramite l'utilità keytool Java, quindi importare il certificato SSL di Windchill nel file truststore.

Ora che si dispone dei file corretti, è possibile fornire le informazioni nella schermata Impostazioni autenticazione Windchill attenendosi alla procedura riportata di seguito.

1. Accanto a File keystore, fare clic su

, quindi passare al file keystore di ThingWorx creato in precedenza.

È importante tenere presente che il file keystore di ThingWorx è diverso dal file keystore di Apache Tomcat.

2. Nel campo Password, immettere la password definita durante la creazione del file keystore.

3. Accanto a File truststore, fare clic su

, quindi passare al file truststore di ThingWorx.

5. Accanto a Parametro di interrogazione utente sessione, accettare il valore di default.

Nella maggior parte dei casi, è necessario accettare il valore di default per questo parametro. Cambiare il valore solo se l'amministratore Windchill ha modificato questa impostazione di default in Windchill.

6. Fare clic su Avanti. Viene visualizzata la pagina Riepilogo - Impostazioni configurazione.

1. Rivedere le impostazioni, quindi fare clic su Configura. ThingWorx Navigate è configurato.

2. Selezionare le caselle di controllo riportate di seguito per aprire uno o entrambi i programmi.

ThingWorx Navigate è configurato con l'autenticazione Windchill. Selezionare i programmi da aprire:

• Apri ThingWorx Navigate

• Apri ThingWorx Composer

Se la configurazione ha esito negativo, selezionare la casella di controllo Apri il file di log ed esaminare il file di log per i dettagli dell'errore.

L'amministratore deve avere lo stesso nome utente in Windchill e in ThingWorx.

• Se non sono state apportate modifiche in Windchill, l'utente amministratore denominato "Amministratore" è stato creato durante l'installazione di Windchill. Se si utilizza un sistema ThingWorx configurato, è possibile eseguire l'autenticazione con le credenziali di quell'utente e disporre dei diritti di accesso completi come utente amministratore in ThingWorx.

• Se è stato cambiato il nome utente dell'amministratore, selezionare un nome utente che sia comune a Windchill e a ThingWorx, quindi aggiungere l'utente a ThingWorx e al gruppo di utenti amministratori.

Per verificare la configurazione dell'autenticazione Windchill, attenersi alla procedura descritta di seguito.

1. Aprire l'URL di ThingWorx. Si viene indirizzati a Windchill per l'autenticazione.

2. Specificare le credenziali di amministratore Windchill (o un altro utente configurato come amministratore ThingWorx). Il browser viene reindirizzato a ThingWorx e viene aperto ThingWorx Composer.

Operazione completata! ThingWorx è stato configurato correttamente con l'autenticazione Windchill.

Se si imposta l'autenticatore per la creazione automatica di utenti, provvedere a testarne la funzionalità.

1. Aprire il browser sull'URL di ThingWorx. Si viene indirizzati a Windchill per l'autenticazione.

2. Specificare le credenziali Windchill di un utente che non è presente in ThingWorx.

3. Il browser viene reindirizzato alla pagina del mashup di default di ThingWorx.

4. Verificare che ThingWorx sia eseguito dall'utente corretto. L'utente è stato creato automaticamente.

Se le opzioni di personalizzazione e i risultati della ricerca non funzionano come previsto, riavviare Apache Tomcat e ThingWorx Integration Runtime.

ThingWorx Navigate è ora installato e concesso in licenza e la configurazione di base è completa.

I task ThingWorx Navigate ora sono disponibili per l'uso. Per accedere, gli utenti dovrebbero usare nome utente e password di Windchill.