INTRODUÇÃO
Um hotfix está disponível que permite que o Adaptador BizTalk para EMS TIBCO suporte a entrega de mensagens ordenadas e conexões SSL (Secure Sockets Layer) no Microsoft BizTalk Server 2006 R2 Service Pack 1 (SP1) e BizTalk Server 2009.
Informações adicionais
Anotações importantes
-
Certifique-se de que o servidor Tibco está instalado e configurado adequadamente.
-
Certifique-se de adicionar o EMS TIBCO C# API (Tibco.ems.dll) ao GaC (Cache de Assembly Global). Para fazer isso, use o Gacutil.bat aplicativo. Para obter mais informações, consulte a seção "Reference".
-
O SSL é suportado no Tibco que começa com a versão 4.4.
Habilitar o suporte à entrega de mensagens ordenadas
Depois de aplicar o hotfix, duas novas opções estarão disponíveis na caixa de diálogo Adaptador BizTalk para propriedades de transporte emS TIBCO que permitem que você habilita o suporte à entrega de mensagem ordenada. As duas opções são Entrega Ordenada e StopPollingOnFailure. Por padrão, a opção Entrega Ordenada é definida como False e a opção StopPollingOnFailure é definida como True.
Opção de Entrega Ordenada
Quando você definir a opção Entrega Ordenada como True, espera-se que as mensagens sejam sondadas do servidor Tibco e sejam enviadas para BizTalk Server. A ordem na qual o servidor BizTalk recebe mensagens é a mesma na qual as mensagens são enviadas para o servidor Tibco.
Observação As mensagens que têm prioridade mais alta na fila Tibco são as mensagens que devem ser sondadas e enviadas ao BizTalk antes das mensagens com prioridade mais baixa. Você pode alterar a prioridade de uma mensagem usando a propriedade de configuração do emissor da opção Prioridade da Mensagem.Opção StopPollingOnFailure
Essa opção só será aplicável se a opção Entrega Ordenada estiver definida como True. Essa opção é usada para decidir se a sondagem deve continuar ou parar quando o envio de uma mensagem para BizTalk falhar. Se a opção StopPollingOnFailure estiver definida como True e uma mensagem não for enviada para BizTalk, a porta de recebimento que usa o Adaptador BizTalk para EMS TIBCO interrompe a sondagem adicional das mensagens do servidor Tibco e, em seguida, a porta será desabilitada. Se a opção StopPollingOnFailure estiver definida como False, a sondagem não será interrompida mesmo que o envio de uma mensagem para BizTalk falhe. Nesse caso, as mensagens com falha são movidas para uma fila suspensa.
Observação Quando a opção StopPollingOnFailure é definida como False, as mensagens que não podem ser enviadas para BizTalk são movidas para a fila suspensa. Esse comportamento causa uma perda de ordem. Portanto, é recomendável definir essa opção como True.Habilitar o suporte à conexão SSL
Depois de aplicar o hotfix, três novas opções estarão disponíveis na caixa de diálogo Adaptador BizTalk para propriedades de transporte emS TIBCO que permitem habilitar o suporte à conexão SSL. As três opções são as seguinte:
-
UseSSL
-
SSLTargetHostName
-
SSLClientSubjectDN
Observação Por padrão, a opção UseSSL é definida como False, e a opção SSLTargetHostName e a opção SSLClientSubjectDN estão vazias.
Importante Para dar suporte a conexões SSL, você deve configurar algumas configurações necessárias no servidor Tibco e no servidor BizTalk. Para obter mais informações, consulte a seção "Configurações necessárias para dar suporte à conexão SSL".Opção UseSSL
Se a opção UseSSL estiver definida como False, o adaptador se conectará ao Servidor Tibco na Porta TCP. Se a opção UseSSL estiver definida como True, o adaptador se conectará ao Servidor Tibco na porta SSL.
Observação O Servidor Tibco é configurado no campo "Nome do Servidor" na seção definição de conexão do servidor. Tanto a Porta TCP quanto a Porta SSL são configuradas no campo Número da porta na seção definição de conexão do servidor. Opção SSLTargetHostName Certifique-se de que o certificado raiz confiável do servidor Tibco está instalado no armazenamento autoridades de certificação raiz confiáveis do usuário cuja conta está configurada para a instância de host BizTalk. Opção SSL ClientSubjectDN Essa opção é obrigatória se o SSL de duas vias for necessário. Por exemplo, o servidor Tibco exige que o cliente apresente o certificado. O certificado pode ser habilitado ou desabilitado na propriedade ssl_require_client_cert do arquivo Tibemsd.conf. Esse valor corresponde ao nome diferenciado do assunto do certificado do cliente. Certifique-se de que o certificado raiz confiável do servidor Tibco está instalado no armazenamento autoridades de certificação raiz confiáveis do usuário cuja conta está configurada para a instância de host BizTalk. Veja a seguir um valor de exemplo para esta opção:E=client@testcompany.com, CN=client, UNIDADE OU=cliente, O=Test Company, L=us-english, S=California, C=US
Configurações necessárias para dar suporte à conexão SSL
SSL é um protocolo que fornece autenticação segura e transmite dados criptografados pela Internet ou uma intranet. Um handshake SSL entre o cliente (Adaptador) e o servidor Tibco pode ocorrer das duas seguintes maneiras:
-
SSL de ida: o cliente não precisa apresentar o certificado ao servidor.
-
SSL de duas vias: o cliente deve apresentar o certificado da AC ao servidor.
Configurando SSL único
No servidor Tibco, altere o arquivo Tibemsd.conf. Para fazer isso, siga estas etapas:
-
Desabilite a ssl_require_client_cert propriedade. Para fazer isso, altere essa configuração para que ela apareça da seguinte forma:
ssl_require_client_cert = desabilitar -
Defina a propriedade ssl_server_identity para apontar para o certificado do servidor, defina a propriedade ssl_server_key para usar a chave SSL correta e defina a propriedade ssl_password para usar a senha SSL correta. Para fazer isso, altere essas configurações para que elas apareçam da seguinte forma:
ssl_server_identity = server.cert.pem ssl_server_key = server.key.pem ssl_password =<senha>Observação Certifique-se de que os arquivos .pem estão disponíveis no caminho definido. -
Salve o arquivo Tibemsd.conf e inicie o servidor EMS Tibco.
No servidor BizTalk, instale o certificado raiz confiável do servidor Tibco no armazenamento autoridades de certificação raiz confiáveis do usuário cuja conta está configurada para a instância de host BizTalk. Em seguida, tente se conectar ao servidor Tibco usando o adaptador Tibco.
Configurando SSL de duas vias
No servidor Tibco, altere o arquivo Tibemsd.conf. Para fazer isso, siga estas etapas:
-
Habilitar ssl_require_client_cert propriedade. Para fazer isso, altere essa configuração para que ela apareça da seguinte forma:
ssl_require_client_cert = habilitar -
Defina a propriedade ssl_server_identity para apontar para o certificado do servidor, defina a propriedade ssl_server_key para usar a chave SSL correta e defina a propriedade ssl_password para usar a senha SSL correta. Para fazer isso, altere essas configurações para que elas apareçam da seguinte forma:
ssl_server_identity = server.cert.pem ssl_server_key = server.key.pem ssl_password =<password>Observação Certifique-se de que os arquivos .pem estão disponíveis no caminho definido. -
De definir a ssl_server_trusted para apontar para o certificado raiz para a CA do certificado do cliente. Para fazer isso, altere essa configuração para que ela apareça da seguinte forma:
ssl_server_trusted = client.root.cert.pem Observação Certifique-se de que os arquivos .pem estão disponíveis no caminho definido. -
Salve o arquivo Tibemsd.conf e inicie o servidor EMS Tibco
No servidor BizTalk, instale o certificado raiz confiável do servidor Tibco no armazenamento autoridades de certificação raiz confiáveis do usuário cuja conta está configurada para a instância de host BizTalk. Instale o certificado ca do certificado do cliente no armazenamento autoridades de certificação raiz confiáveis do usuário atual. Instale o certificado do cliente no armazenamento pessoal do usuário atual. Em seguida, tente se conectar ao servidor usando o adaptador Tibco.
Informações sobre o hotfix
Para BizTalk Server 2006 R2 SP1
O hotfix está incluído no pacote de atualização cumulativa 3 para BizTalk Server 2006 R2 SP1. 2286501Pacote de atualização cumulativa 3 para BizTalk Server 2006 R2 Service Pack 1 Para obter mais informações sobre hotfixes BizTalk Server 2006 R2 SP1, clique no seguinte número de artigo para exibir o artigo na Base de Dados de Conhecimento da Microsoft: 974563Lista de correções quentes do Microsoft BizTalk Server que estão incluídas no BizTalk Server 2006 R2 Service Pack 1
Para obter mais informações sobre como obter o pacote de atualização cumulativa, clique no seguinte número de artigo para exibir o artigo na Base de Dados de Conhecimento da Microsoft:Para BizTalk Server 2009
O hotfix que resolve esse problema está incluído no pacote de atualização cumulativa 2 para BizTalk Server 2009. 2497794 Pacote de atualização cumulativa 2 para BizTalk Server 2009 Um hotfix suportado agora está disponível da Microsoft. No entanto, destina-se a corrigir apenas o problema descrito neste artigo. Aplique-o somente a sistemas que estão enfrentando esse problema específico. Esse hotfix pode receber testes adicionais. Portanto, se você não for afetado gravemente por esse problema, recomendamos aguardar a próxima atualização de software que contenha esse hotfix. Para resolver esse problema imediatamente, entre em contato com os Serviços de Suporte ao Cliente da Microsoft para obter o hotfix. Para obter uma lista completa de números de telefone do Microsoft Customer Support Services e informações sobre os custos de suporte, visite o seguinte site da Microsoft:
Para obter mais informações sobre como obter o pacote de atualização cumulativa, clique no seguinte número de artigo para exibir o artigo na Base de Dados de Conhecimento da Microsoft:http://support.microsoft.com/contactus/?ws=supportObservação Em casos especiais, as cobranças normalmente incorridas para chamadas de suporte podem ser canceladas se um Profissional de Suporte da Microsoft determinar que uma atualização específica resolverá seu problema. Os custos de suporte em geral aplicam-se a questões e problemas de suporte adicionais que não se enquadrem na atualização específica em questão.
Pré-requisitos
Você deve ter o Microsoft BizTalk Server 2009 e o Adaptador Do Microsoft BizTalk para Aplicativos Empresariais (também conhecido como Adaptador LOB BizTalk) instalado para aplicar esse hotfix.
Necessidade de reinicialização
Você não precisa reiniciar o computador depois de aplicar o hotfix.
Informações de substituição do hotfix
Esse hotfix não substitui nenhum outro.
Informações do arquivo
A versão em inglês deste hotfix possui os atributos de arquivo (ou atributos de arquivo posteriores) listados na tabela a seguir. As datas e horas desses arquivos estão listadas em UTC (Tempo Universal Coordenado). Quando você exibe as informações sobre os arquivos, elas são convertidas no horário local. Para saber a diferença entre a hora UTC e a hora local, use a guia Fuso Horário no item Data e Hora do Painel de Controle.
Nome do arquivo |
Versão do arquivo |
Tamanho do arquivo |
Data |
Hora |
Plataforma |
---|---|---|---|---|---|
Btcore.dll |
1.0.5020.12 |
2,129,744 |
26-Apr-2010 |
12:16 |
x86 |
Microsoft.biztalk.adapters.bizutil.dll |
1.0.5020.12 |
163,720 |
26-Apr-2010 |
12:16 |
x86 |
Microsoft.biztalk.adapters.corereceiver.dll |
1.0.5020.12 |
33,680 |
26-Apr-2010 |
12:16 |
x86 |
Microsoft.biztalk.adapters.coretransmitter.dll |
1.0.5020.12 |
39,320 |
26-Apr-2010 |
12:16 |
x86 |
Microsoft.biztalk.adapters.tibcoems.dll |
1.0.5020.12 |
88,968 |
26-Apr-2010 |
12:16 |
x86 |
Status
A Microsoft confirmou que este é um problema nos produtos Microsoft listados na seção "Aplicável a".
Referências
Para obter mais informações sobre o Serviço de Mensagens Empresariais do TIBCO, visite o seguinte site do Microsoft Developer Network (MSDN) :
Requisitos e limitações do serviço de mensagem empresarial TIBCOPara obter mais informações sobre a Entrega Ordenada de Mensagens, visite o seguinte site do MSDN:
Entrega ordenada de mensagensPara obter mais informações sobre BizTalk Server, clique no seguinte número de artigo para exibir o artigo na Base de Dados de Conhecimento da Microsoft:
2003907 Informações sobre BizTalk Server hotfixes