Saltar al contenido

Conexión de Microsoft Azure Service Bus

Introducción

Una conexión de Microsoft Azure Service Bus, creada utilizando el conector de Microsoft Azure Service Bus, establece acceso a Microsoft Azure Service Bus. Una vez que se configura una conexión, puedes crear instancias de actividades de Microsoft Azure Service Bus asociadas con esa conexión para ser utilizadas como fuentes (para proporcionar datos en una operación) o como destinos (para consumir datos en una operación).

Crear o editar una conexión de Microsoft Azure Service Bus

Una nueva conexión de Microsoft Azure Service Bus se crea utilizando el conector de Microsoft Azure Service Bus desde una de estas ubicaciones:

Una conexión existente de Microsoft Azure Service Bus se puede editar desde estas ubicaciones:

Configurar una conexión de Microsoft Azure Service Bus

Cada elemento de la interfaz de usuario de la pantalla de configuración de conexión de Microsoft Azure Service Bus se describe a continuación.

La interfaz utilizada durante la configuración de la conexión depende del tipo de autenticación seleccionado:

Microsoft Entra ID

Nota

Para obtener información sobre cómo obtener estas credenciales, consulta Microsoft Entra ID en Requisitos previos.

Si se selecciona Microsoft Entra ID para el tipo de autenticación, se presenta la interfaz descrita a continuación.

Consejo

Los campos con un ícono de variable admiten el uso de variables globales, variables de proyecto y variables de Jitterbit. Comienza escribiendo un corchete cuadrado abierto [ en el campo o haciendo clic en el ícono de variable para mostrar un menú con las variables existentes de las que elegir.

  • Nombre de conexión: Ingresa un nombre para identificar la conexión. El nombre debe ser único para cada conexión de Microsoft Azure Service Bus y no debe contener barras inclinadas / ni dos puntos :. Este nombre también se utiliza para identificar el punto final de Microsoft Azure Service Bus, que se refiere tanto a una conexión específica como a sus actividades.

  • Tipo de autenticación: Usa el menú para seleccionar Microsoft Entra ID para autorizar solicitudes a las entidades de Service Bus utilizando la aplicación de Microsoft Entra ID. Para más información sobre esta opción, consulta la documentación de Microsoft Autenticar desde una aplicación.

    Nota

    La aplicación de Microsoft Entra ID debe tener asignado el rol de Propietario de Datos de Azure Service Bus para el Espacio de Nombres de Service Bus, como se describe en Requisitos previos.

  • Espacio de nombres / Nombre de host: Ingresa el espacio de nombres de Service Bus o la dirección del espacio de nombres utilizando el nombre del espacio de nombres como un nombre de host. Por ejemplo, tanto spsbusns1028 como spsbusns1028.servicebus.windows.net son válidos y apuntan al mismo espacio de nombres de Service Bus.

  • ID de inquilino: Ingresa el ID de directorio (inquilino) para el registro de la aplicación.

  • ID de cliente: Ingresa el ID de aplicación (cliente) para el registro de la aplicación.

  • Secreto de cliente: Ingresa el Valor del secreto del cliente para el registro de la aplicación.

  • Probar: Haz clic para verificar la conexión utilizando la configuración proporcionada. Cuando se prueba la conexión, la última versión del conector es descargada por el(los) agente(s) en el grupo de agentes asociado con el entorno actual. Este conector admite suspender la descarga de la última versión del conector utilizando la política de organización Deshabilitar actualización automática del conector.

  • Guardar cambios: Haga clic para guardar y cerrar la configuración de la conexión.

  • Descartar cambios: Después de realizar cambios en una configuración nueva o existente, haga clic para cerrar la configuración sin guardar. Un mensaje le pide que confirme que desea descartar los cambios.

  • Eliminar: Después de abrir una configuración de conexión existente, haga clic para eliminar permanentemente la conexión del proyecto y cerrar la configuración (consulte Dependencias de componentes, eliminación y remoción). Un mensaje le pide que confirme que desea eliminar la conexión.

Firmas de Acceso Compartido

Nota

Para obtener información sobre cómo obtener estas credenciales, consulte Firma de Acceso Compartido en Requisitos previos.

Si se selecciona Firmas de Acceso Compartido para Tipo de autenticación, se presenta la interfaz descrita a continuación.

Consejo

Los campos con un ícono de variable admiten el uso de variables globales, variables de proyecto y variables de Jitterbit. Comience escribiendo un corchete cuadrado abierto [ en el campo o haciendo clic en el ícono de variable para mostrar un menú con las variables existentes de las que elegir.

  • Nombre de la conexión: Ingrese un nombre para identificar la conexión. El nombre debe ser único para cada conexión de Microsoft Azure Service Bus y no debe contener barras diagonales / ni dos puntos :. Este nombre también se utiliza para identificar el punto final de Microsoft Azure Service Bus, que se refiere tanto a una conexión específica como a sus actividades.

  • Tipo de autenticación: Use el menú para seleccionar Firmas de Acceso Compartido para autorizar solicitudes a entidades de Service Bus utilizando una clave principal asignada a una regla de política de autorización.

  • Namespace / Hostname: Ingresa el namespace o la dirección del namespace del Service Bus utilizando el nombre del namespace como un hostname. Por ejemplo, tanto spsbusns1028 como spsbusns1028.servicebus.windows.net son válidos y apuntan al mismo namespace de Service Bus.

  • Nombre de la política: Ingresa el nombre de la regla de política de autorización de acceso compartido del namespace. Por defecto, los namespaces de Service Bus tienen una política de administrador llamada RootManageSharedAccessKey. Se recomienda crear otra política para uso de integración.

    Importante

    • Para usar la actividad Send Message, la regla de política de autorización debe incluir derechos de envío.
    • Para usar las actividades Consume Queue y Consume Topic, la regla de política de autorización debe incluir derechos de escucha.

  • Clave primaria: Ingresa la Clave Primaria que corresponde con el Nombre de la Política. Cada regla de política de autorización tiene su propia Clave Primaria asignada.

  • Probar: Haz clic para verificar la conexión utilizando la configuración proporcionada. Cuando se prueba la conexión, la última versión del conector es descargada por el(los) agente(s) en el grupo de agentes asociado con el entorno actual. Este conector admite suspender la descarga de la última versión del conector utilizando la política de organización Disable Auto Connector Update.

  • Guardar cambios: Haz clic para guardar y cerrar la configuración de la conexión.

  • Descartar cambios: Después de realizar cambios en una configuración nueva o existente, haz clic para cerrar la configuración sin guardar. Un mensaje te pide que confirmes que deseas descartar los cambios.

  • Eliminar: Después de abrir una configuración de conexión existente, haga clic para eliminar permanentemente la conexión del proyecto y cerrar la configuración (consulte Dependencias de componentes, eliminación y remoción). Un mensaje le pide que confirme que desea eliminar la conexión.

Próximos pasos

Después de que se ha creado una conexión de Microsoft Azure Service Bus, se coloca un tipo de actividad en el lienzo de diseño para crear instancias de actividad que se utilizarán como fuentes (para proporcionar datos en una operación) o como destinos (para consumir datos en una operación).

Las acciones del menú para una conexión y sus tipos de actividad son accesibles desde el panel del proyecto y la paleta de componentes de diseño. Para más detalles, consulte Menús de acciones en Conceptos básicos de conectores.

Estos tipos de actividad están disponibles:

  • Obtener mensaje de cola: Recupera todos los mensajes en una cola de Microsoft Azure Service Bus y está destinado a ser utilizado como fuente en una operación.

  • Desbloquear mensaje de tema: Desbloquea mensajes en un tema de Microsoft Azure Service Bus y está destinado a ser utilizado como destino en una operación.

  • Eliminar mensaje de cola: Elimina mensajes de una cola de Microsoft Azure Service Bus y está destinado a ser utilizado como destino en una operación.

  • Consumir Tema: Consume mensajes de un tema de Microsoft Azure Service Bus y está destinado a ser utilizado como fuente en una operación.

  • Renovar Bloqueo de Mensaje del Tema: Renueva los bloqueos de mensajes en un tema de Microsoft Azure Service Bus y está destinado a ser utilizado como objetivo en una operación.

  • Eliminar Mensaje del Tema: Elimina mensajes de un tema de Microsoft Azure Service Bus y está destinado a ser utilizado como objetivo en una operación.

  • Enviar Mensaje: Envía mensajes a una cola o tema de Microsoft Azure Service Bus y está destinado a ser utilizado como objetivo en una operación.

  • Consumir Cola: Consume mensajes de una cola de Microsoft Azure Service Bus y está destinado a ser utilizado como fuente en una operación.

  • Renovar Bloqueo de Mensaje de la Cola: Renueva los bloqueos de mensajes en una cola de Microsoft Azure Service Bus y está destinado a ser utilizado como objetivo en una operación.

  • Obtener mensaje de tema: Recupera mensajes de un tema de Microsoft Azure Service Bus y está destinado a ser utilizado como fuente en una operación.

  • Desbloquear mensaje de cola: Desbloquea mensajes de una cola de Microsoft Azure Service Bus y está destinado a ser utilizado como destino en una operación.