Configuración de los puertos HTTP y HTTPS

De forma predeterminada, el servidor mqweb que aloja IBM® MQ Console y REST API utiliza el puerto HTTPS 9443. El puerto que está asociado con conexiones HTTP está inhabilitado. Puede habilitar el puerto HTTP, configurar un puerto HTTPS distinto o inhabilitar el puerto HTTP o HTTPS. Desde IBM MQ 9.0.4, puede configurar los puertos utilizando el mandato setmqweb . En IBM MQ 9.0.3y anteriores, puede configurar los puertos editando el archivo mqwebuser.xml .

Antes de empezar

Debe ser un usuario privilegiado para completar este procedimiento.

Si habilita los puertos HTTP y HTTPS, una señal LTPA que se emite para una solicitud HTTPS puede reutilizarse para una solicitud HTTP desde un navegador. Para configurar el servidor mqweb para evitar este comportamiento y aumentar la seguridad del entorno, añada la siguiente línea al archivo mqwebuser.xml:

<webAppSecurity ssoRequiresSSL="true"/>

Desde IBM MQ 9.0.4, puede ver la configuración actual de los puertos HTTP y HTTPS utilizando el mandato siguiente:

dspmqweb properties -a

El campo httpPort muestra el puerto HTTP y el campo httpsPort muestra el puerto HTTPS. Para obtener más información, consulte dspmqweb.

Atención:

Antes de emitir los mandatos setmqweb o dspmqweb en z/OS®, debe establecer la variable de entorno WLP_USER_DIR, para que la variable apunte a la configuración del servidor mqweb.

Para ello, emita el mandato siguiente:

export WLP_USER_DIR=WLP_user_directory

donde WLP_user_directory es el nombre del directorio que se pasa a crtmqweb.sh. Por ejemplo:

export WLP_USER_DIR=/var/mqm/web/installation1

Para obtener más información, consulte Crear la definición de servidor de Liberty.

Utilice uno de los métodos siguientes para configurar los puertos:

• A partir de IBM MQ 9.0.4, utilice el mandato setmqweb properties :
  • Para habilitar o configurar el puerto HTTP, utilice el mandato siguiente:

    setmqweb properties -k httpPort -v portNumber

    donde númeroPuerto especifica el puerto que desea utilizar para las conexiones HTTP. Puede inhabilitar el puerto utilizando un valor de -1.

  • Para configurar el puerto HTTPS, use el mandato siguiente:

    setmqweb properties -k httpsPort -v portNumber

    donde númeroPuerto especifica el puerto que desea utilizar para las conexiones HTTPS. Puede inhabilitar el puerto utilizando un valor de -1.

• Para IBM MQ 9.0.3 y anteriores, edite el archivo mqwebuser.xml :
  1. Abra el archivo mqwebuser.xml.
     El archivo mqwebuser.xml puede encontrarse en uno de los directorios siguientes:

     • En UNIX, Linux®, and Windows: MQ_DATA_DIRECTORY/web/installations/installationName/servers/mqweb
     • En z/OS: WLP_user_directory/servers/mqweb

       donde directorio_usuario_WLP es el directorio que se especificó cuando se ejecutó el script crtmqweb.sh para crear la definición del servidor mqweb.

  2. Configure los puertos:
     • Para habilitar o configurar el puerto HTTP, añada o edite la línea siguiente en el archivo mqwebuser.xml, dentro de las etiquetas <server>:

       <variable name="httpPort" value="portNumber" />

       donde númeroPuerto especifica el puerto que desea utilizar para las conexiones HTTP. Puede inhabilitar el puerto utilizando un valor de -1.

     • Para configurar el puerto HTTPS, añada o edite la línea siguiente en el archivo mqwebuser.xml, dentro de las etiquetas <server>:

       <variable name="httpsPort" value="portNumber" />

       donde númeroPuerto especifica el puerto que desea utilizar para las conexiones HTTPS. Puede inhabilitar el puerto utilizando un valor de -1.