Configuración de ThingWorx Navigate con autenticación de Windchill
En las pantallas para la autenticación de Windchill, se especificará la información del servidor Windchill y de los ficheros KeyStore y TrustStore de ThingWorx.
Antes de comenzar
Asegúrese de que el sistema cumpla los requisitos previos siguientes antes de configurar la autenticación de Windchill.
• Se ha configurado Windchill con SSL.
• ThingWorx: se recomienda configurar ThingWorx con SSL.
• El administrador de Windchill ha configurado la propiedad allowList para las redirecciones de URL. Si esta propiedad no está configurada, no se podrá acceder a ThingWorx Navigate.
Para definir wt.idp.allowlisturls en el fichero wt.properties, ejecute el siguiente comando desde el shell Windchill:
xconfmanager -s wt.idp.allowlisturls="url1 url2 url3" -t codebase/wt.properties -p
El nombre de webapp debe incluirse en el URL. Por ejemplo, https://hostxyz:8443/Thingworx.
Ejemplo de comando:
xconfmanager -s wt.idp.allowlisturls="https://hostxyz:8443/Thingworx https://hostxyz:8449/Thingworx http://hostxyz:8080/Thingworx" -t codebase/wt.properties -p
Este tema de ayuda de Windchill proporciona información detallada sobre las propiedades de configuración de Windchill.
• Se han creado los ficheros TrustStore y KeyStore. El tema Creación de ficheros KeyStore y TrustStore para ThingWorx Navigate contiene instrucciones para la generación de estos ficheros.
• Se ha importado el certificado SSL de Windchill al fichero TrustStore de ThingWorx. Para obtener más información sobre cómo configurar SSL, consulte el tema Utilización de SSL para la comunicación segura.
• Ha activado TLS 1.2 según las instrucciones que se proporcionan en la sección "Enabling TLS 1.2" del tema TLS 1.3 Support for Windchill del Centro de ayuda de Windchill. Esta configuración es necesaria para que la conexión de Windchill funcione según lo previsto, especialmente al configurar ThingWorx Navigate con la autenticación de Windchill.
Establecimiento de la conexión a Windchill
En esta página, proporcione los detalles de la conexión a Windchill.
1. Introduzca un valor en URL del servidor Windchill:
◦ Para conectarse a un solo servidor Windchill, asegúrese de que el URL siga el formato [http o https]://[windchill-host]:[windchill-port]/[windchill-web-app].
◦ Para entornos de clúster de Windchill: introduzca el URL del direccionador de equilibrio de la carga. Por ejemplo, [https]://[LB-host]:[port]/[windchill-web-app].
El formato del URL depende de la configuración del sistema. En Configuración de ThingWorx Navigate con un entorno de clúster de Windchill, consulte las secciones sobre la autenticación de Windchill.
◦ Para conectarse a varios sistemas Windchill: por ahora, conéctese a un solo servidor. A continuación, después de completar la configuración inicial, siga los pasos manuales que se indican en Configuración de ThingWorx Navigate para conectarse a varios sistemas Windchill.
2. Pulse en Siguiente o en Adelante.
Configuración de autenticación de Windchill
Antes de proporcionar la información en esta pantalla, se deben preparar los ficheros de KeyStore y TrustStore correctos para ThingWorx:
• Fichero KeyStore: permite crear un nuevo fichero de KeyStore de ThingWorx con la utilidad keytool de Java. Asegúrese de que se incluya el par de claves de ThingWorx. Se trata de un certificado de cliente que se utiliza para acceder a datos de Windchill mediante la configuración de SSL bidireccional en ThingWorx Navigate y Windchill.
 | Este fichero KeyStore de ThingWorx es distinto del fichero KeyStore de Apache Tomcat que quizás se haya creado durante la instalación de ThingWorx Navigate. Estos ficheros KeyStore independientes tienen distintos fines, por lo que es importante proporcionar el fichero correcto en la ubicación adecuada. |
• Fichero TrustStore: permite crear un fichero de TrustStore de ThingWorx con la utilidad keytool de Java y, a continuación, importar el certificado SSL de Windchill en el fichero de TrustStore.
Para obtener más información, consulte los temas Creación de ficheros KeyStore y TrustStore para ThingWorx Navigate y Utilización de SSL para una conexión segura.
Ahora que se cuenta con los ficheros correctos, se puede proporcionar la información en la pantalla Configuración de autenticación de Windchill:
1. Junto a Fichero KeyStore, pulse en 
y, a continuación, desplácese hasta el fichero KeyStore de ThingWorx que se ha creado antes.
y, a continuación, desplácese hasta el fichero KeyStore de ThingWorx que se ha creado antes.| | Recuerde que el fichero KeyStore de ThingWorx es distinto al fichero KeyStore de Apache Tomcat. |
2. Introduzca el valor de Contraseña que se ha definido al crear el fichero KeyStore.
3. Junto a Fichero TrustStore, pulse en y, a continuación, desplácese hasta el fichero TrustStore de ThingWorx.
y, a continuación, desplácese hasta el fichero TrustStore de ThingWorx.4. Introduzca un valor de Contraseña.
5. Junto a Parámetro de consulta de usuario de la sesión, acepte el valor por defecto.
| | En la mayoría de los casos, se debe aceptar el valor por defecto para este parámetro. Cambie el valor solo si el administrador de Windchill ha cambiado esta configuración por defecto en Windchill. |
6. Pulse en Siguiente o en Adelante. Se abre la página Resumen: opciones de configuración.
Resumen: opciones de configuración
1. Revise la configuración y, a continuación, pulse en Configurar. ThingWorx Navigate está configurado.
2. Seleccione las casillas para abrir uno o ambos programas:
◦ Abrir ThingWorx Navigate
◦ Abrir ThingWorx Composer
A continuación, pulse en Cerrar.
La operación se ha finalizado correctamente.
ThingWorx Navigate se configura con la autenticación de Windchill. Seleccione los programas para abrir:
• Abrir ThingWorx Navigate
• Abrir ThingWorx Composer
A continuación, pulse en Cerrar.
| | Si la configuración falla, seleccione la casilla Abrir el fichero de registro y revise el fichero de registro para obtener información detallada sobre el problema. |
Verificación de la configuración
El administrador debe tener el mismo nombre de usuario en Windchill y ThingWorx.
• Si no se han realizado cambios en Windchill, el usuario administrador "Administrador" se habrá creado instalar Windchill. Con un sistema de ThingWorx configurado, es posible autenticarse como ese usuario y tener derechos de acceso completos como usuario administrador en ThingWorx.
• Si se ha cambiado el nombre de usuario del administrador, se debe seleccionar un nombre de usuario común para Windchill y ThingWorx, y luego añadir dicho usuario a ThingWorx y al grupo de usuarios administradores.
Para verificar la configuración de autenticación de Windchill:
1. Abra el URL de ThingWorx. Se redirigirá a Windchill para autenticación.
2. Proporcione las credenciales de administrador de Windchill (u otro usuario configurado para ser el administrador de ThingWorx). El explorador vuelve a ThingWorx y se abre ThingWorx Composer.
3. Verifique que ThingWorx ahora se ejecuta como administrador.
La operación se ha finalizado correctamente. ThingWorx está configurado correctamente con la autenticación de Windchill.
Si se define el autenticador para crear usuarios automáticamente, pruebe esto a continuación:
1. Abra el explorador en el URL de ThingWorx. Se redirigirá a Windchill para autenticación.
2. Proporcione las credenciales de Windchill de un usuario que no exista en ThingWorx.
3. El explorador vuelve a la página de mashup de inicio de ThingWorx.
4. Verifique que ThingWorx ahora se ejecuta como el usuario correcto. El usuario se ha creado automáticamente.
| | Si las opciones de personalización y los resultados de la búsqueda no funcionan según lo previsto, reinicie Apache Tomcat y ThingWorx Integration Runtime. |
Pasos siguientes
La instancia de ThingWorx Navigate está instalada, tiene licencia y se ha completado la configuración básica.
Las tareas de ThingWorx Navigate están listas para utilizarse. Para iniciar sesión, los usuarios deben utilizar su nombre de usuario y contraseña de Windchill.