adaptador de SB-Messaging

El adaptador de Service Bus (SB-Messaging) se usa para recibir y enviar desde entidades de Service Bus, como colas, tópicos y retransmisiones. Puede usar el adaptador sb-messaging para conectar el servidor de BizTalk Server local a Azure.

A partir de BizTalk Server 2016 Feature Pack 2, se admite Service Bus Premium. Al configurar un puerto de envío mediante este adaptador, puede enviar mensajes a colas y temas con particiones.

Importante

El adaptador de SB-Messaging de BizTalk usa el protocolo SBMP que admite mensajes de hasta un tamaño máximo de 1 mb. El adaptador de BizTalk no admite el protocolo AMQP que puede controlar mensajes más grandes.

Autenticación con Service Bus

Service Bus proporciona dos métodos para autenticarse:

• Access Control Service (ACS)
• Firma de acceso compartido (SAS)

Se recomienda usar la firma de acceso compartido (SAS) para autenticarse con Service Bus. El valor de clave de acceso compartido se muestra en Azure Portal.

Al crear un espacio de nombres de Service Bus, el espacio de nombres de Access Control (ACS) no se crea automáticamente. Para usar Access Control, necesita los valores Nombre del emisor y Clave del emisor de este espacio de nombres. Estos valores están disponibles al crear un nuevo espacio de nombres de ACS mediante Windows PowerShell. Estos valores no aparecen en Azure Portal.

Para usar ACS para la autenticación y obtener los valores de Nombre del emisor y Clave del emisor, los pasos generales incluyen:

1. Instale los cmdlets de Azure PowerShell.

2. Agregue la cuenta de Azure: Add-AzureAccount

3. Devuelve el nombre de la suscripción: get-azuresubscription

4. Seleccione la suscripción: select-azuresubscription <name of your subscription>

5. Crea un nuevo espacio de nombres: new-azuresbnamespace <name for the service bus> "Location" -CreateACSNamespace $true -NamespaceType Messaging

   Ejemplo: new-azuresbnamespace biztalksbnamespace "South Central US" -CreateACSNamespace $true -NamespaceType Messaging

6. Cuando se crea el nuevo espacio de nombres de ACS (que puede tardar varios minutos), los valores IssuerName y IssuerKey se enumeran en la cadena de conexión:

   Precaución

   En este ejemplo o guía se hace referencia a información confidencial, como una cadena de conexión o un nombre de usuario y una contraseña. Nunca codifique de forma rígida estos valores en el código y asegúrese de proteger los datos confidenciales mediante la autenticación más segura disponible. Para más información, consulte la siguiente documentación:

   • Seguridad en BizTalk Server
   • Seguridad para enviar y recibir mensajes
   • Control de acceso y seguridad de datos

   Name                  : biztalksbnamespace
   Region                : South Central US
   DefaultKey            : abcdefghijklmnopqrstuvwxyz
   Status                : Active
   CreatedAt             : 10/18/2016 9:36:30 PM
   AcsManagementEndpoint : https://biztalksbnamespace-sb.accesscontrol.windows.net/
   ServiceBusEndpoint    : https://biztalksbnamespace.servicebus.windows.net/
   ConnectionString      : Endpoint=sb://biztalksbnamespace.servicebus.windows.net/;SharedSecretIssuer=owner;SharedSecretValue=abcdefghijklmnopqrstuvwxyz
   NamespaceType         : Messaging
   

Consulte New-AzureSBNamespace para obtener instrucciones.

Recepción de mensajes de Service Bus

1. En la consola de administración de BizTalk Server, expanda Grupo de BizTalk, expanda Aplicaciones y después expanda su aplicación.

2. Haga clic con el botón derecho en Puertos de recepción, seleccione Nuevo y seleccione One-Way puerto de recepción.

3. Asígnele un nombre y seleccione Ubicaciones de recepción.

4. Seleccione Nuevo, asígnele un nombre. En la sección Transporte , seleccione SB-Messaging en la lista desplegable Tipo y, a continuación, seleccione Configurar.

5. Configure las propiedades Generales :

   Usa esto	Para
   URL de cola o suscripción	Especifique la dirección URL donde se despliega la cola de Service Bus. Normalmente, la dirección URL tiene el formato siguiente: sb://<namespace>.servicebus.windows.net/<queue_name>
   Tiempo de espera de apertura	Especifica un valor de intervalo de tiempo que indica el tiempo para que se complete una operación de apertura de canal. Valor predeterminado: 1 minuto
   Tiempo de espera de cierre	Especifica un valor de intervalo de tiempo que indica el tiempo para que se complete una operación de cierre de canal. Valor predeterminado: 1 minuto
   Tiempo de espera de recepción	Especifica un valor de intervalo de tiempo que indica el tiempo para que se complete una operación de recepción. Valor predeterminado: 10 minutos
   Recuento de capturas previas	Especifica el número de mensajes que se reciben simultáneamente desde la cola de Service Bus o un tema. La captura previa permite al cliente de cola o suscripción cargar mensajes adicionales desde el servicio cuando realiza una operación de recepción. El cliente almacena estos mensajes en una memoria caché local. El tamaño de la memoria caché viene determinado por el valor de la propiedad Recuento de capturas previas que especifique aquí. Para obtener más información, consulte la sección “Captura previa” en https://azure.microsoft.com/documentation/articles/service-bus-performance-improvements/. Valor predeterminado: -1
   Usar sesión	Active esta casilla para usar una sesión de Service Bus para recibir mensajes de una cola o una suscripción.

6. Configure las propiedades de autenticación :

   Usa esto	Para
   Access Control Service	Seleccione esta opción para usar ACS para la autenticación y proporcione los valores siguientes: - Escriba el URI de STS del Servicio de Control de Acceso de Service Bus. Normalmente, el URI tiene el formato siguiente: https://<namespace>-sb.accesscontrol.windows.net/ : escriba el nombre del emisor para el espacio de nombres de Service Bus. - Ingrese la clave del emisor para el espacio de nombres de Service Bus.
   Firma de acceso compartido (nueva a partir de BizTalk Server 2013 R2)	Seleccione esta opción para usar la firma de acceso compartido (SAS) para la autenticación y proporcione el nombre de clave de SAS y el valor de clave.

7. En la pestaña Propiedades, en el Espacio de Nombres para Propiedades de Mensaje Intermedias, escriba el espacio de nombres que el adaptador usa para escribir las propiedades de mensaje intermedias como propiedades de contexto de mensaje en el mensaje recibido por BizTalk Server. Si quieres promover las propiedades de mensajes intermediados, activa la casilla Promover propiedades de mensajes intermediados.

8. Selecciona Aceptar.

9. Seleccione el controlador de recepción y la canalización de recepción. Seleccione Aceptar para guardar los cambios. Crear una ubicación de recepción proporciona algunas instrucciones.

Envío de mensajes a Service Bus

1. En la consola de administración de BizTalk Server, haga clic con el botón derecho en Puertos de envío, seleccione Nuevo y seleccione Puerto de envío unidireccional estático.

   Crear un puerto de envío proporciona algunas instrucciones.

2. Escriba un nombre. En Transporte, establezca El tipo en SB-Messaging y seleccione Configurar.

3. Configure las propiedades Generales :

   Usa esto	Para
   Dirección URL de destino	Escriba la dirección URL donde se implementa la cola del Bus de Servicios. Normalmente, la dirección URL tiene el formato siguiente: sb://<namespace>.servicebus.windows.net/<queue_name>
   Intervalo de vaciado por lotes	Especifica un valor de intervalo de tiempo que indica el intervalo cuando los lotes de mensajes que se envían a una cola o un tema se vacían. El valor predeterminado es 20 milisegundos. Para obtener más información sobre el procesamiento por lotes con respecto a las colas y temas de Service Bus, consulte la sección Procesamiento por lotes del lado cliente en https://azure.microsoft.com/documentation/articles/service-bus-performance-improvements.
   Tiempo de espera de apertura	Especifica un valor de intervalo de tiempo que indica el tiempo para que se complete una operación de apertura de canal. Valor predeterminado: 1 minuto
   Tiempo de espera de envío	Especifica un valor de intervalo de tiempo que indica el tiempo para que se complete una operación de envío. Valor predeterminado: 1 minuto
   Tiempo de espera de cierre	Especifica un valor de intervalo de tiempo que indica el tiempo para que se complete una operación de cierre de canal. Valor predeterminado: 1 minuto

4. Configure las propiedades de autenticación :

   Usa esto	Para
   Access Control Service	Seleccione esta opción para usar ACS para la autenticación y proporcione los valores siguientes: - Introduzca la URI del STS del servicio de control de acceso de Service Bus. Normalmente, el URI tiene el formato siguiente: https://<namespace>-sb.accesscontrol.windows.net/ - Escriba el nombre del emisor para el espacio de nombres de Service Bus. - Ingrese la clave del emisor para el espacio de nombres de Service Bus.
   Firma de acceso compartido (nueva a partir de BizTalk Server 2013 R2)	Seleccione esta opción para usar la firma de acceso compartido (SAS) para la autenticación y proporcione el nombre de clave de SAS y el valor de clave.

5. En la pestaña Propiedades, escriba el espacio de nombres para las Propiedades de Mensaje Intermediado definidas por el usuario que contiene las propiedades de contexto del mensaje de BizTalk que desea escribir en el mensaje saliente a Service Bus. Todas las propiedades del espacio de nombres se escriben en el mensaje como propiedades de mensaje intermediado definidas por el usuario. El adaptador omite el espacio de nombres mientras escribe las propiedades como propiedades de mensaje de corretaje. Usa el espacio de nombres solo para determinar qué propiedades se van a escribir.

   También puede introducir los valores de las propiedades de BrokeredMessage. Estas propiedades se describen en Propiedades BrokeredMessage, incluida la clave de partición.

6. Seleccione Aceptar para guardar los cambios.

Consulte también

Uso de adaptadores