Boletim Tcnico - Roteiro de Configurao - Web Service e Portal Protheus - 1

Boletim Tcnico
Roteiro de Configurao de Web Services e Portal Protheus
Verso : Protheus 8.11
Pas : Brasil
Data da Reviso : 05/11/04
Este boletim tem o objetivo de estabelecer um roteiro de configurao e utilizao do Portal Protheus em
uma rede corporativa (LAN).
Esse roteiro de configurao destina-se aos analistas e tcnicos de infra-estrutura.
Esse boletim no est vinculado a nenhuma atualizao do Protheus.
Funo do Portal Protheus via Web Services
O Portal Protheus disponibiliza servios na Web para agilizar e facilitar o compartilhamento de informaes
entre seus clientes, fornecedores, parceiros, usurios internos e externos; toda a comunicao entre os
servidores Web e os servidores Corporativos efetuada atravs de Web Services.
O Protheus disponibiliza um conjunto de portais via Web Services, como ferramentas:
Portal do Cliente
Neste portal, o seu cliente pode realizar diversas consultas s informaes financeiras e de vendas,
bem como realizar algumas operaes, como cotaes e pedidos de venda.
Portal do Fornecedor
Neste portal, o seu fornecedor pode realizar diversas consultas s informaes financeiras e de com-
pras, bem como responder as cotaes solicitadas pelo sua empresa.
Portal do Vendedor
Neste portal, o seu vendedor pode realizar diversas consultas s informaes financeiras e de vendas,
bem como a manuteno de oramentos, pedidos de venda, agenda e tarefas.
Portal do Tcnico (Field Service)
Neste portal, o seu tcnico pode realizar diversas consultas s informaes repair center, ordem de
servios, atendimento da OS, requisio da OS, atendimento, base instalada, produtos, pendncias e
agenda.
2 - Boletim Tcnico - Roteiro de Configurao - Web Service e Portal Protheus
O Web Services utilizado pelo Portal para realizar a interao entre servidores
O Portal Microsiga est disponvel a partir da verso Protheus 8, funcionando apenas em ambientes que
utilizam o TOPConnect.
Veja, no final desse documento, a infra-estrutura de rede necessria para utilizar o Portal Protheus
na Internet e um pequeno glossrio de termos tcnicos.
Boletim Tcnico - Roteiro de Configurao - Web Service e Portal Protheus - 3
Roteiro de Configurao dos Portais Protheus - Web Services
O primeiro passo: Habilitar o servio HTTP
A habilitao do servio de HTTP necessria para a instalao do mdulo Web. Durante a instalao de
um mdulo Web, caso o servio de HTTP no esteja habilitado, esta operao ser executada automatica-
mente.
Para habilitar o servio HTTP:
1. Inicie o Assistente de Configurao do Servidor (MP8Wizard) no menu Iniciar do Windows, pasta
Programas, opo Protheus 8+Ferramentas+Assistente de Configurao do Servidor.
2. Na janela principal do assistente de configuraes, selecione a opo Servidor Internet HTTP/FTP e
clique no cone +.
3. Selecione a opo HTTP e clique no boto Editar Configurao.
4 - Boletim Tcnico - Roteiro de Configurao - Web Service e Portal Protheus
Ser apresentada a janela Configurao da Seo.
4. Nesta janela, preencha os campos conforme a orientao do help do Assistente de Configurao (tecla
[F1]).
5. Aps configurar os campos necessrios, clique no boto Finalizar para confirmar as configuraes.
O Segundo passo: Habilitar os Web Services
O prximo passo a habilitar o uso dos Web Services utilizados pelos servios disponibilizados pelo Portal.
Para habilitar o Web Service:
1. Na janela principal do Assistente de Configuraes, selecione a pasta Mdulos Web e clique no boto
Novo Mdulo.
Boletim Tcnico - Roteiro de Configurao - Web Service e Portal Protheus - 5
Ser apresentada a janela Configuraes Bsicas do Mdulo.
2. Preencha os campos conforme a orientao do help do Assistente de Configurao (tecla [F1]).
Observe, porm, o preenchimento dos seguintes campos:
Mdulo Web: selecione a opo WS-Protheus 8 Web Service
Selecione a caixa Habilitar processos na inicializao do servidor, para que os processos sejam
inicializados no momento em que o servidor Protheus for carregado.
3. Clique no boto Avanar para prosseguir.
Ser apresentada a janela de Configurao de Host x Empresas Filiais. Nesta janela, necessrio
relacionar o nome do servidor Web/diretrio virtual e as empresas/filiais que iro acess-lo:
Exemplos: <www.nomedosite.com.br> (para um ambiente Internet) ou
<nomedoservidor> (para ambiente Intranet)
Pode-se, adicionalmente, informar um diretrio virtual aps o Host, separado por barra.
6 - Boletim Tcnico - Roteiro de Configurao - Web Service e Portal Protheus
4. Preencha os campos dessa janela conforme a orientao do help do Assistente de Configurao (tecla [F1]).
5. Clique no boto Avanar para prosseguir.
Ser apresentada a janela Configurao de Usurios para informao da expectativa de usurios que
iro acessar o site.
6. Preencha os campos dessa janela conforme a orientao do help do Assistente de Configurao (tecla
[F1]).
7. Clique no boto Finalizar, para confirmar a configurao.
Boletim Tcnico - Roteiro de Configurao - Web Service e Portal Protheus - 7
O Terceiro passo: Verificar as configuraes de HTTP e Web Service
Verifique, agora, se os Web Services foram devidamente instalados.
Para verificar os Web Services:
1. Inicie o Protheus Server.
2. Inicie o navegador de Internet e informe o endereo do servidor de Web Services:
http://<nome do servidor Web> ou <nmero do IP>/<diretrio virtual>
3. Aps a verificao, finalize o navegador.
O Quarto passo: Configurar o acesso ao Portal
Com o mdulo Web Service instalado, voc deve agora instalar o mdulo do portal.
Para instalar o portal:
1. Inicie o Assistente de Configurao do Servidor (MP8Wizard) no menu Iniciar do Windows,
pastaProgramas, opo Protheus 8 Ferramentas + Assistente de Configurao do Servidor.
2. Selecione a pasta Mdulos Web e clique no boto Novo Mdulo.
8 - Boletim Tcnico - Roteiro de Configurao - Web Service e Portal Protheus
Ser apresentada a janela de configurao bsica do mdulo.
3. Nesta janela, preencha os campos conforme a orientao do help do Assistente de Configurao (tecla
[F1]). Observe, porm, o preenchimento dos seguintes campos:
Mdulo Web: selecione a opo PP - Portal Protheus.
URL do Protheus Web Services: deve ser preenchido com a URL utilizada na instalao do mdulo
Web Services, precedido por HTTP://.
Exemplo: http://<nome do servidor Web> ou <nmero IP>/diretrio virtual (mesmo do Web Services)
Boletim Tcnico - Roteiro de Configurao - Web Service e Portal Protheus - 9
4. Clique no boto Avanar, para prosseguir.
Ser apresentada a janela Configurao de Hosts x Empresas/Filiais. Nesta janela, necessrio
relacionar o nome do servidor Web/diretrio virtual e as empresas/filiais que iro acess-lo:
Exemplos: <www.nomedosite.com.br> (para um ambiente Internet) ou
<nomedoservidor> (para ambiente Intranet)
Pode-se, adicionalmente, informar um diretrio virtual aps o Host, separado por barra.
5. Preencha os campos dessa janela conforme a orientao do help do Assistente de Configurao (tecla [F1]).
6. Clique no boto Avanar para prosseguir.
10 - Boletim Tcnico - Roteiro de Configurao - Web Service e Portal Protheus
Ser apresentada a janela Configurao de usurios para informao da expectativa de usurios que
iro acessar o site.
7. Preencha os campos dessa janela conforme a orientao do help do Assistente de Configurao (tecla [F1]).
8. Clique no boto Finalizar para concluir a configurao do Portal.
O Quinto passo: Reiniciar os servios do Protheus
Neste procedimento, ser possvel carregar todos os Web Services que esto no repositrio, configurar o
menu e as permisses do usurio.
1. Execute o Protheus Server.
2. Execute o Protheus Remote.
Boletim Tcnico - Roteiro de Configurao - Web Service e Portal Protheus - 11
3. Acesse o ambiente do Faturamento.
4. Selecione as opes Atualizaes+Portal+Web Services para carregar os Web Services.
Ser apresentada a janela de Web Services.
5. Selecione a opo Automtico para o sistema carregar todos os Web Services que esto no repositrio.
Esta operao pode ser executada vrias vezes, para verificar os Web Services que esto disponveis.
6. Finalizado o processo, selecione a opo Sair.
7. Selecione as opes Atualizaes+Portal+Menu dos Portais para verificar se os menus dos portais
foram criados.
12 - Boletim Tcnico - Roteiro de Configurao - Web Service e Portal Protheus
Ser apresentada a relao dos menus dos portais instalados.
8. Caso no tenha sido criado o menu, ser necessrio excluir o contedo das tabelas AI8 e AI9.
As tabelas do menu (AI8 e AI9) somente sero carregados quando estiverem vazias.
9. Se necessrio alterar as opes de acesso de algum menu, clique na opo Menu.
10. Clique na opo Sair para finalizar a rotina.
11. Selecione as opes Atualizaes+Portal+Usurios para incluir os usurios que podero utilizar o
portal e os respectivos direitos de acesso.
12. Selecione a opo Incluir.
Ser apresentada a janela Usurio do Portal.
Boletim Tcnico - Roteiro de Configurao - Web Service e Portal Protheus - 13
13. Preencha os campos para identificao do usurio do portal. Se o usurio for um vendedor, necess-
rio selecionar, no campo Usurio Int., o seu cdigo de identificao no sistema (Cadastro de Usurios
- SIGACFG).
14. Na pasta Clientes, selecione os clientes que podem ser tratados por este usurio.
15. Na pasta Fornecedores, selecione os fornecedores que podem ser tratados por este usurio.
16. Acesse a pasta Direitos e inclua os servios que podero ser utilizados por este usurio.
Para carregar todos os servios, clique no boto Carrega Direitos na barra de ferramentas.
17. Aps a configurao, confirme os dados e finalize a rotina.
ltimo passo: Acessar o Portal
1. Acesse o navegador de Internet e informe o endereo do portal.
Exemplo: http://nome do servidor do portal ou nmero do IP/instncia do portal
2. Efetue a identificao do usurio.
14 - Boletim Tcnico - Roteiro de Configurao - Web Service e Portal Protheus
A janela do Portal ser apresentada conforme as configuraes para o usurio.
3. Escolhido o portal para acesso, ser apresentado o menu do portal para utilizao conforme as opes
configuradas.
Boletim Tcnico - Roteiro de Configurao - Web Service e Portal Protheus - 15
Infra-estrutura necessria
Para acessar o Portal Protheus pela Internet, necessrio:
Adquirir um domnio;
Registrar o domnio;
Exemplo: www.registro.br
Possuir dois servidores de DNS, caso no possua, ser necessrio escolher um provedor de hospeda-
gem;
Os servidores de DNS permitem que as demais mquinas conectadas Internet consigam acesso ao
domnio.
Aguardar a confirmao do registro do domnio.
Aps confirmado, o domnio estar disponvel para a Internet.
As aplicaes com conectividade na Internet precisam de uma infra-estrutura apropriada e segura. A infra-
estrutura do Portal Protheus permite a utilizao de todos os recursos disponveis para segurana de
Internet em uso atualmente.
Vamos explicar os dois tipos de seguranas que podem ser adotadas para o Portal Protheus:
Segurana Simplificada
Segurana Avanada
16 - Boletim Tcnico - Roteiro de Configurao - Web Service e Portal Protheus
Segurana Simplificada - Requisitos
Domnio prprio apontando para o servidor Web;
IP fixo e real;
Servidor de Web deve ser separado do servidor Protheus corporativo;
Firewall implantando antes do servidor Web;
Possibilidade de implantao do Portal utilizando-se de pgina segura (HTTPS);
Ao utilizar o HTTPS, a empresa estar protegendo a:
1 - Garantia de autenticidade da entidade;
2 - Criptografia dos dados entre o cliente e o servidor.
Segurana Avanada - Requisitos
Criao da DMZ - Zona Desmilitarizada;
Domnio prprio apontando para o servidor Web;
IP Fixo e Real para acessar via Internet;
Firewall protegendo a entrada da internet para a DMZ;
Firewall protegendo a entrada da DMZ para a rede Corporativa;
Criptografia dos dados. Uso de HTTPS tanto para o servidor Web como para o servidor de Web
Services.
Boletim Tcnico - Roteiro de Configurao - Web Service e Portal Protheus - 17
Tipos de Segurana
Sistmica
Infra-estrutura
Rede
Criptografia de Dados
Pontos de Ateno
Sistmica
Controle de acesso aos portais atravs de usurios/senha e grupos de acesso;
Restrio dos servios e menus que podem ser utilizados;
Restrio de quais dados os usurios podem ter acesso (Ex.: Cliente ou Fornecedores).
Infra-estrutura
Servidor de Web sem acesso diretamente aos dados;
Todos os acessos so feitos atravs do servidor de Web Services que poder estar protegido por um
firewall adicional.
Rede
Suporte a Firewall (incluindo NAT), tanto entre os servidores Web e o usurio final, como entre os
servidores de Web e o servidor de Web Services;
Suporte a Proxy autenticados (Ex.: ISA Server, Squid entre outros).
Criptografia de Dados
Disponvel entre a comunicao do servidor Web e o servidor de Web Services;
Disponvel para ser utilizada entre o servidor Web e o usurio final;
Necessita de aquisio de Certificados de Segurana atravs de entidades certificadoras.
Pontos de Ateno
Definio do modelo de segurana a ser seguido de acordo com o tamanho e necessidade do cliente;
Ateno especial na definio das regras de acesso (usurio, senha, direitos, etc.).
18 - Boletim Tcnico - Roteiro de Configurao - Web Service e Portal Protheus
Licenciamento
Apenas a configurao do Web Services consome licena do tipo Protheus I (Licena exclusiva para o
mdulo Web);
Em mdia cada 10 usurios conectados no Portal, consumir uma licena no servidor de Web Services;
O consumo pode variar de acordo com os usurios e as personalizaes externas.
O consumo da banda para acesso est ligado com o design do site, que pode conter texto e imagens.
Boletim Tcnico - Roteiro de Configurao - Web Service e Portal Protheus - 19
Glossrio
DNS (Domain Name System) - converte nomes Internet em seus nmeros correspondentes e vice-versa.
Originalmente, os computadores da Internet eram identificados apenas por nmeros, como 200.252.269.1.
O DNS permitiu dar nomes aos computadores, como www.microsiga.com.br.
Domnio: um nome que serve para localizar e identificar conjuntos de computadores na Internet. O nome
do domnio foi concebido com o objetivo de facilitar a memorizao dos endereos de computadores na
Internet. O domnio sempre o nome que aparece direita do smbolo @ (arroba), num endereo eletrni-
co, e logo em seguida da expresso www.
Environment: Contm informaes dos diretrios de execuo do Protheus 8 Server, as informaes do
idioma, interface, diretrios e repositrios e, opcionalmente, as informaes para acesso ao TOPConnect.
Firewall - Parede de fogo ou parede corta-fogo - barreira de segurana (na Internet) que isola partes da
rede - designativo de sistemas de segurana (combinao de programas e equipamentos) criados para
proteo de mensagens e transaes, implementados atravs de filtragem da criptografia dos dados em
programa de servios pela rede Internet, incluindo variados tipos de controle por software ou hardware.
Mais especificamente, um dispositivo de hardware dotado de duas placas de rede (uma ligada rede
corporativa e outra Internet) rodando software especfico de anlise e roteamento de pacotes de dados;
como todo pacote enviado de uma rede para outra passa obrigatoriamente pelo sistema, o firewall tem a
oportunidade de analis-lo, determinando se ele representa algum risco e, em caso positivo, descartando-o
antes que alcance seu destino.
FTP (File Transfer Protocol): um servio Internet cuja finalidade permitir a transferncia de arquivos de
qualquer tipo entre dois computadores. Normalmente usado para transferir programas, textos, imagens,
etc. de um computador central (servidor) para um usurio remoto (cliente) ou vice-versa. Para acessar um
servidor FTP necessrio estar cadastrado como usurio deste, e ter, portanto, um nome de acesso e uma
senha (FTP real). Entretanto, h um tipo especial de servidor FTP que permite acesso pblico, sem senhas
especiais. o FTP annimo.
HTTP: (Hyper Text Transfer Protocol) - o protocolo pelo qual o browser e os sites na Internet se
comunicam. Protocolo que diz ao servidor para mandar pginas da World Wide Web para seu micro.
Sempre quando vamos visitar algum site, comeamos o endereo com http, esta sigla informa ao computa-
dor que este o protocolo que vai definir como os servidores devem transferir entre si comandos ou
informaes relativos ao www.
Host: Hospedeiro. Um computador servidor designado para hospedar e fornecer pginas HTML, arquivos de
execuo e de contedo, banco de dados, e outros fluxos de dados e servios de busca. Tambm pode
ser chamado de computador central. o servidor, tambm chamado de n.
20 - Boletim Tcnico - Roteiro de Configurao - Web Service e Portal Protheus
IP (Internet Protocol): o protocolo da Internet, esse protocolo que identifica, localiza e estabelece
conexo entre computadores ligados na rede corporativa na Internet.
Instncia: Nome utilizado para individualizar as configuraes das instalaes do mdulo Web, assim, se a
empresa necessita aplicar diferentes configuraes para um mesmo mdulo Web, possvel instal-lo sob
uma nova instncia.
Proxy - Um servidor proxy um programa que armazena localmente objetos Internet para posterior distribui-
o. Objetos Internet podem ser pginas web, imagens, arquivos de som, programas, etc.
Um browser web pode ser configurado para funcionar via servidor proxy. Quando configurado deste modo,
sempre que o usurio solicitar um objeto (clicando em um link), o browser ir verificar se este objeto existe
no servidor proxy. Se existir, o receber diretamente deste, sem a necessidade de solicit-lo na origem, que
pode ser uma conexo lenta. Se no existir, o prprio servidor proxy se encarregar de obt-lo na origem,
repassando-o ao usurio e simultaneamente gravando-o. Deste modo, quando um outro usurio solicitar
este mesmo objeto, este j estar disponvel no servidor proxy. A grande vantagem do uso de servidores
proxy que o browser tende a ficar muito mais rpido, pois muitos objetos (incluindo pginas e as imagens
das pginas) que originalmente so acessados por uma conexo internacional, ou congestionada, passam a
ser transmitidos por uma conexo local.
RootPath: Indica o diretrio raiz do Protheus 8, a partir do qual todos os diretrios utilizados pelo Protheus
sero criados.
URL (Uniform Resource Locator): Padro de endereamento da web. Permite que cada servio/arquivo na
Internet tenha um endereo prprio, que consiste de seu nome, diretrio, mquina onde est armazenado
e pelo protocolo qual deve ser transmitido. Por exemplo: http://www.exemplo.com.br
Web ou WWW: uma simplificao do termo World Wide Web (WWW) que significa Teia de Alcance
Mundial. o mais popular dos servios Internet, porque permite a obteno rpida e fcil de informaes
sobre os mais variados assuntos, com imagens e textos, usando um sistema de hipertextos de alcance
mundial. Os recursos disponveis no ambiente WWW so referenciados por um tipo especial de endereo,
chamado URL.
Web Service: Simplificando, um web service a maneira prtica e eficaz de aplicativos se comunicarem
via internet. Surgiu por um consrcio de empresas lideradas pela Microsoft e IBM, e hoje se tornou um
padro do W3C (WorldWide Web Consortium)
Para que servem os Web Services? - praticamente para quase tudo no que voc possa pensar em troca de
dados e informaes. Como ele baseado no protocolo SOAP (Simple Object Access Protocol), qualquer
plataforma que interprete rotinas HTTP e manipule XML pode utilizar os dados dos web services sem
qualquer problema. Como quase sempre os web services utilizam o protocolo HTTP, quase sempre no
haver surpresas com Firewall quando sua aplicao sair do servidor de aplicao para a verso final do
cliente.
Vantagens - Os dados so trafegados em formato XML. Assim, todos os dados possuem <tags> e isso faz
com que estes dados tenham consistncia, sem falhas, permitindo a troca de dados mais robustos como
Arrays, e por trafegar em XML, ele multi-plataforma.