Páginas filhas
  • Como expor os Web Services do RM através do IIS

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

Índice


Aviso
titleAVISO SOBRE TÉRMINO DO SUPORTE

A partir da versão 12.1.2302, o RM não dará mais suporte às integrações que utilizam o TBC (TOTVS Business Connect) via IIS, conforme instruções descritas neste documento.

O QUE DEVE SER FEITO
As integrações existentes deverão ser substituídas pelo TBC via Host.

Mais informações aqui, Como Expor os Web Services do RM através do Host (recomendado) ou Redirecionamento de Requisições IIS para o Host



Produto

:

Conector                       Versão: 12.0                                                                   

Processo

:

Instalação do TBC no IIS

Subprocesso

:


Data da publicação

:

13/01/2015

...

Para instalar o TBC para o IIS são necessários alguns pré-requisitos, que são:Pré

1. Pré-requisitos:

Possuir o Internet Information Service (IIS) instalado e devidamente configurado. Alguns sub-componentes do IIS que serão descritos abaixo devem estar configurados/instalados, que são:

Windows XP ou superiores: (Acesse PAINEL DE CONTROLE > ADICIONAR OU REMOVER PROGRAMAS (PROGRAMAS E RECURSOS) > ATIVAR OU DESATIVAR RECURSOS DO WINDOWS)

  Image Modified Image Modified
 


Windows Server: (Acessar GERENCIADOR DE SERVIDORES (SERVER MANAGER) > ADICIONAR FUNÇÃO > SERVIDOR DE WEB (WEB SERVER) ):

Image ModifiedImage Modified
 
Image Modified

...


As restrições CGI e ISAPI devem estar liberadas para o Asp Net 4.0, conforme prints abaixo:

Image Modified
Image Modified
 

...

2.

...

Instalação – WS do TBC

O pacote de instalação "TOTVS Business Connect – [versão].msi" instala os WebServices do TBC e hospeda estes no IIS. A sua instalação é muito simples e intuitiva, através de um assistente. Veja passo a passo:


Poderá ser apresentado o seguinte aviso, caso o Sistema Operacional do Computador não seja o recomendado:

Image Modified
Image Modified


Passo 1 – Ler aviso e clicar em Avançar

Image Modified


Passo 2 – Ler o contrato e se estiver de acordo clicar em Avançar 

Image Modified


Passo 3 - Confirmar a instalação, clicando em Instalar

Image Modified


Passo 4 – Instalação concluída
A instalação padrão incluirá um aplicativo no IIS: 

Image Modified
 
Verifique nas configurações básicas do aplicativo se o "Caminho Físico" está apontando para o caminho onde o TBC foi instalado, e qual o Pool de Aplicativos está selecionado:

Image Modified
 
Nas configurações dos Pools, verifique se o Pool de Aplicativos utilizado está como:
Status = Iniciado
Versão FrameWork = v4.0
Modo de Pipeline = Clássico
Identidade = "ApplicationPoolIdentity"
 
 
Image Modified
 
Caso não esteja, altere em Configurações avançadas.
Image Modified
Image Modified
 
 
No arquivo Web.config existente no <diretório de instalação>\WS_TBC deve ser alterada as seguintes tags:

...

Bloco de código
titleWeb.config
<add key="Host" value="localhost"/> : Informar o hostname ou ip da máquina que contém o serviço do Host do RM;

...


<add key="Port" value="8050"/> : Informar a porta em que o serviço do Host do RM está sendo executado;

...


<add key="DBAlias" value="CORPORERM"/> : Informar o Alias, do arquivo Alias.dat, que contém a informação de qual base será utilizada na integração;

...


 

...


Alterar a linha abaixo (Para as integrações "SigaLoja x FrontLoja x BackOfficeRM" e "Protheus SigaMNT x Linha RM" Manter como "<deny users= " ? " /> ")

...

<authorization>

...



De:
<authorization>
      <deny users= " ? " />  

...


</authorization>

...




Para:

...


<authorization>      

...


      <allow users= " * " />  

...


</authorization>


 
Observação:
Nos arquivos "<diretório de instalação do RM>\WS_TBC\Web.Config"  e ""<diretório de instalação do RM>\RM.Net\RM.Host.Service.exe.config", verificar se as linhas relacionadas à informação abaixo, estão idênticas para ambos os arquivos;

...

Bloco de código
titleWeb.config
<add key="JobServer3Camadas" value="false" />

...


<add key="EnableCompression" value="false" />



Os WS serão instalados na porta 80 (como é a porta padrão pode ser omitida na url). Mas o administrador do sistema poderá alterar esta e demais configurações, se desejado, editando o arquivo Web.config que se encontra no diretório de instalação RM na pasta WS_TBC: (verificar as configuração JOSERVER3CAMADAS, DABALIAS, HOST e PORTA de acordo com as configurações do RM.Host.Service.exe.config ou RM.Host.exe.config).

Image Modified
 


A partir deste ponto os WebServices do TBC já podem ser acessados, por exemplo através do navegador Internet Explorer:

Image Added


3. Autenticação

Informações importantes sobre o comportamento do mecanismo de autenticação de usuários quando o TBC é instalado no IIS.

Para o WebMethod: AutenticaAcesso

Autentica o acesso do usuário no ambiente RM. O usuário e senha terá que ser passado via SOAP, criando um token para isto.

Especificamente quando o TBC estiver no IIS, o mecanismo de autenticação utilizará o protocolo de autenticação WSS, mais informações.

Significa que na requisição do serviço, o usuário e senha devem ser informados no modelo do protocolo WSS, que é diferente do Basic Authentication. (Que é o utilizado quando o TBS é acessado direto do RM.Host)

O usuário e senha devem ser informado no Header da requisição Soap, conforme o exemplo abaixo:

Usuário em texto limpo e a senha em base64:

Informações
titleSoap Request Example

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:br="http://www.totvs.com.br/br/">
   <soap:Header>
     <wsse:Security soap:mustUnderstand="1" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">
         <wsse:UsernameToken>
           <wsse:Username>User</wsse:Username>
           <wsse:Password>cGFzc3dvcmQ=</wsse:Password>
         </wsse:UsernameToken>
       </wsse:Security>
     </soap:Header>
   <soap:Body>
      <br:AutenticaAcesso/>
   </soap:Body>
</soap:Envelope>


4. Cache do IIS

Muito importante compreender que o IIS possui seu próprio gerenciamento de Cache e que ele pode interferir nas requisições, respondendo resultados armazenados em seu cache, sem antes requisitar o RM.Host.

Deve ser analisado com um técnico as configurações mais adequadas do IIS, de forma que não afete de forma negativa os serviços TBC.Image Removed



 
Para maiores informações:
Icon
Consulte o WikiHelp TOTVS
 
[ |https://www.byyou.com/static/resources/hotsite/index.html]COMUNIDADE  @TBC e Microsoft Dynamics CRM
 Canais de Atendimento:
Chamado: Através do Portal Totvs www.suporte.totvs.com.br
Telefônico: 4003-0015 Escolhendo as opções 2 – (Software), 2 – (Suporte Técnico), 3 – (RM), 9 – (Demais Áreas), 2 – (CRM), 3 - (Vendas e CRM) e 3 –  (Microsoft CRM).