Configuración de los puertos HTTP y HTTPS

Por defecto, 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. Puede configurar los puertos utilizando el mandato setmqweb.

Antes de empezar

Si habilita el puerto HTTP y está utilizando la autenticación basada en señales, debe habilitar la misma señal LTPA que se va a utilizar para ambas conexiones, HTTP y HTTPS. Para más información, consulte Configuración del token LTPA.

Para completar esta tarea, debe ser un usuario con determinados privilegios para que pueda utilizar los mandatos dspmqweb y setmqweb:

• En z/OS®, debe tener autoridad para ejecutar los comandos dspmqweb y setmqweb , y acceso de escritura al archivo mqwebuser.xml .
• On all other operating systems, you must be a usuario privilegiado.
• Si el servidor mqweb forma parte de una instalación independiente de IBM MQ Web Server , debe tener acceso de escritura al archivo mqwebuser.xml en el directorio de datos IBM MQ Web Server .

Atención:

Antes de emitir elsetmqweb odspmqweb comandos enz/OS , debe establecer la variable de entorno WLP_USER_DIR para que apunte a la configuración de su servidor mqweb.

Para configurar la variable de entorno WLP_USER_DIR, emita el siguiente comando:

export WLP_USER_DIR=WLP_user_directory

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

export WLP_USER_DIR=/var/mqm/web/installation1

Para más información, ver Crear el servidor mqweb .

Atención:

Antes de emitir los mandatos setmqweb o dspmqweb en una instalación autónoma de IBM MQ Web Server , debe establecer la variable de entorno MQ_OVERRIDE_DATA_PATH en el directorio de datos IBM MQ Web Server .

Atención: De forma predeterminada, el servidor mqweb requiere que las señales LTPA estén protegidas para todas las solicitudes. Si el servidor mqweb está configurado para requerir que los tokens LTPA estén protegidos, no podrá completar las siguientes acciones cuando se conecte al puerto HTTP :

• Inicie la sesión en IBM MQ Console.
• Utilice la autenticación basada en señal con REST API.

Para permitir que las solicitudes HTTP utilicen tokens LTPA, establezca el valor de la propiedad secureLTPA en false. Para más información, consulte Configuración del token LTPA.

• Consulte 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.
• Habilite o configure el puerto HTTP: utilizando el mandato siguiente:
  • Habilite o establezca el puerto HTTP utilizando 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.

  • Restablezca el valor de puerto HTTP en el valor predeterminado de -1 utilizando el mandato siguiente:

    setmqweb properties -k httpPort -d

• Configure el puerto HTTPS:
  • Establezca el número de puerto HTTPS utilizando 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.

  • Restablezca el número de puerto HTTPS en el valor predeterminado de 9443 utilizando el mandato siguiente:

    setmqweb properties -k httpsPort -d