Portal Roteiro Config Web Services Portal Protheus

Boletim Técnico - Roteiro de Configuração - Web Service e Portal Protheus - 1

Boletim Técnico

Roteiro de Configuração de Web Services e Portal Protheus

Versão : Protheus 8.11País : BrasilData da Revisão : 05/11/04

Este boletim tem o objetivo de estabelecer um roteiro de configuração e utilização do Portal Protheus emuma rede corporativa (LAN).

Esse roteiro de configuração destina-se aos analistas e técnicos de infra-estrutura.

Esse boletim não está vinculado a nenhuma atualização do Protheus.

Função do Portal Protheus via Web Services

O Portal Protheus disponibiliza serviços na Web para agilizar e facilitar o compartilhamento de informaçõesentre seus clientes, fornecedores, parceiros, usuários internos e externos; toda a comunicação entre osservidores Web e os servidores Corporativos é efetuada através 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 informações financeiras e de vendas,bem como realizar algumas operações, como cotações e pedidos de venda.

� Portal do Fornecedor

Neste portal, o seu fornecedor pode realizar diversas consultas às informações financeiras e de com-pras, bem como responder as cotações solicitadas pelo sua empresa.

� Portal do Vendedor

Neste portal, o seu vendedor pode realizar diversas consultas às informações financeiras e de vendas,bem como a manutenção de orçamentos, pedidos de venda, agenda e tarefas.

� Portal do Técnico (Field Service)

Neste portal, o seu técnico pode realizar diversas consultas às informações repair center, ordem deserviços, atendimento da OS, requisição da OS, atendimento, base instalada, produtos, pendências eagenda.

2 - Boletim Técnico - Roteiro de Configuração - Web Service e Portal Protheus

O Web Services é utilizado pelo Portal para realizar a interação entre servidores

O Portal Microsiga está disponível a partir da versão Protheus 8, funcionando apenas em ambientes queutilizam o TOPConnect.

Veja, no final desse documento, a infra-estrutura de rede necessária para utilizar o Portal Protheusna Internet e um pequeno glossário de termos técnicos.


Roteiro de Configuração dos Portais Protheus - Web Services

O primeiro passo: Habilitar o serviço HTTP

A habilitação do serviço de HTTP é necessária para a instalação do módulo Web. Durante a instalação deum módulo Web, caso o serviço de HTTP não esteja habilitado, esta operação será executada automatica-mente.

Para habilitar o serviço HTTP:

1. Inicie o Assistente de Configuração do Servidor (MP8Wizard) no menu �Iniciar� do Windows, pasta�Programas�, opção �Protheus 8+Ferramentas+Assistente de Configuração do Servidor�.

2. Na janela principal do assistente de configurações, selecione a opção �Servidor Internet HTTP/FTP� eclique no ícone �+�.

3. Selecione a opção �HTTP� e clique no botão �Editar Configuração�.


Será apresentada a janela �Configuração da Seção�.

4. Nesta janela, preencha os campos conforme a orientação do help do Assistente de Configuração (tecla[F1]).

5. Após configurar os campos necessários, clique no botão �Finalizar� para confirmar as configurações.

O Segundo passo: Habilitar os Web Services

O próximo passo é a habilitar o uso dos Web Services utilizados pelos serviços disponibilizados pelo Portal.

Para habilitar o Web Service:

1. Na janela principal do Assistente de Configurações, selecione a pasta �Módulos Web� e clique no botão�Novo Módulo�.


Será apresentada a janela �Configurações Básicas do Módulo�.

2. Preencha os campos conforme a orientação do help do Assistente de Configuração (tecla [F1]).Observe, porém, o preenchimento dos seguintes campos:

� Módulo Web: selecione a opção �WS-Protheus 8 Web Service�

� Selecione a caixa �Habilitar processos na inicialização do servidor�, para que os processos sejaminicializados no momento em que o servidor Protheus for carregado.

3. Clique no botão �Avançar� para prosseguir.

Será apresentada a janela de Configuração de Host x Empresas Filiais. Nesta janela, é necessáriorelacionar o nome do servidor Web/diretório virtual e as empresas/filiais que irão acessá-lo:

Exemplos: <www.nomedosite.com.br> (para um ambiente Internet) ou

<nomedoservidor> (para ambiente Intranet)

Pode-se, adicionalmente, informar um diretório virtual após o Host, separado por barra.


4. Preencha os campos dessa janela conforme a orientação do help do Assistente de Configuração (tecla [F1]).


Será apresentada a janela �Configuração de Usuários� para informação da expectativa de usuários queirão acessar o site.

6. Preencha os campos dessa janela conforme a orientação do help do Assistente de Configuração (tecla[F1]).

7. Clique no botão �Finalizar�, para confirmar a configuração.


O Terceiro passo: Verificar as configurações 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 endereço do servidor de Web Services:

http://<nome do servidor Web> ou <número do IP>/<diretório virtual>

3. Após a verificação, finalize o navegador.

O Quarto passo: Configurar o acesso ao Portal

Com o módulo Web Service instalado, você deve agora instalar o módulo do portal.

Para instalar o portal:

1. Inicie o Assistente de Configuração do Servidor (MP8Wizard) no menu �Iniciar� do Windows,pasta�Programas�, opção �Protheus 8 �Ferramentas� + �Assistente de Configuração do Servidor�.

2. Selecione a pasta �Módulos Web� e clique no botão �Novo Módulo�.


Será apresentada a janela de configuração básica do módulo.

3. Nesta janela, preencha os campos conforme a orientação do help do Assistente de Configuração (tecla[F1]). Observe, porém, o preenchimento dos seguintes campos:

� Módulo Web: selecione a opção �PP - Portal Protheus�.

� URL do Protheus Web Services: deve ser preenchido com a URL utilizada na instalação do móduloWeb Services, precedido por �HTTP://�.

Exemplo: http://<nome do servidor Web> ou <número IP>/diretório virtual (mesmo do Web Services)


4. Clique no botão �Avançar�, para prosseguir.

Será apresentada a janela �Configuração de Hosts x Empresas/Filiais�. Nesta janela, é necessáriorelacionar o nome do servidor Web/diretório virtual e as empresas/filiais que irão acessá-lo:

Exemplos: <www.nomedosite.com.br> (para um ambiente Internet) ou

<nomedoservidor> (para ambiente Intranet)

Pode-se, adicionalmente, informar um diretório virtual após o Host, separado por barra.




Será apresentada a janela �Configuração de usuários� para informação da expectativa de usuários queirão acessar o site.


8. Clique no botão �Finalizar� para concluir a configuração do Portal.

O Quinto passo: Reiniciar os serviços do Protheus

Neste procedimento, será possível carregar todos os Web Services que estão no repositório, configurar omenu e as permissões do usuário.

1. Execute o Protheus Server.

2. Execute o Protheus Remote.


3. Acesse o ambiente do Faturamento.

4. Selecione as opções �Atualizações+Portal+Web Services� para carregar os Web Services.

Será apresentada a janela de Web Services.

5. Selecione a opção �Automático� para o sistema carregar todos os Web Services que estão no repositório.

Esta operação pode ser executada várias vezes, para verificar os Web Services que estão disponíveis.

6. Finalizado o processo, selecione a opção �Sair�.

7. Selecione as opções �Atualizações+Portal+Menu dos Portais� para verificar se os menus dos portaisforam criados.


Será apresentada a relação dos menus dos portais instalados.

8. Caso não tenha sido criado o menu, será necessário excluir o conteúdo das tabelas AI8 e AI9.

As tabelas do menu (AI8 e AI9) somente serão carregados quando estiverem vazias.

9. Se necessário alterar as opções de acesso de algum menu, clique na opção �Menu�.

10. Clique na opção �Sair� para finalizar a rotina.

11. Selecione as opções �Atualizações+Portal+Usuários� para incluir os usuários que poderão utilizar oportal e os respectivos direitos de acesso.

12. Selecione a opção �Incluir�.

Será apresentada a janela Usuário do Portal.


13. Preencha os campos para identificação do usuário do portal. Se o usuário for um vendedor, é necessá-rio selecionar, no campo �Usuário Int.�, o seu código de identificação no sistema (Cadastro de Usuários- SIGACFG).

14. Na pasta �Clientes�, selecione os clientes que podem ser tratados por este usuário.

15. Na pasta �Fornecedores�, selecione os fornecedores que podem ser tratados por este usuário.

16. Acesse a pasta �Direitos� e inclua os serviços que poderão ser utilizados por este usuário.

Para carregar todos os serviços, clique no botão �Carrega Direitos� na barra de ferramentas.

17. Após a configuração, confirme os dados e finalize a rotina.

Último passo: Acessar o Portal

1. Acesse o navegador de Internet e informe o endereço do portal.

Exemplo: http://nome do servidor do portal ou número do IP/instância do portal

2. Efetue a identificação do usuário.


A janela do Portal será apresentada conforme as configurações para o usuário.

3. Escolhido o portal para acesso, será apresentado o menu do portal para utilização conforme as opçõesconfiguradas.


Infra-estrutura necessária

Para acessar o Portal Protheus pela Internet, é necessário:

� Adquirir um domínio;

� Registrar o domínio;

Exemplo: www.registro.br

� Possuir dois servidores de DNS, caso não possua, será necessário escolher um provedor de hospeda-gem;

Os servidores de DNS permitem que as demais máquinas conectadas à Internet consigam acesso aodomínio.

� Aguardar a confirmação do registro do domínio.

Após confirmado, o domínio estará disponível para a Internet.

As aplicações com conectividade na Internet precisam de uma infra-estrutura apropriada e segura. A infra-estrutura do Portal Protheus permite a utilização de todos os recursos disponíveis para segurança deInternet em uso atualmente.

Vamos explicar os dois tipos de seguranças que podem ser adotadas para o Portal Protheus:

� Segurança Simplificada

� Segurança Avançada


Segurança Simplificada - Requisitos

� Domínio próprio 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 implantação do Portal utilizando-se de página 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.

Segurança Avançada - Requisitos

� Criação da DMZ - Zona Desmilitarizada;

� Domínio próprio 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 WebServices.


Tipos de Segurança

� Sistêmica

� Infra-estrutura

� Rede

� Criptografia de Dados

� Pontos de Atenção

Sistêmica

� Controle de acesso aos portais através de usuários/senha e grupos de acesso;

� Restrição dos serviços e menus que podem ser utilizados;

� Restrição de quais dados os usuários podem ter acesso (Ex.: Cliente ou Fornecedores).

Infra-estrutura

� Servidor de Web sem acesso diretamente aos dados;

� Todos os acessos são feitos através do servidor de Web Services que poderá estar protegido por umfirewall adicional.

Rede

� Suporte a Firewall (incluindo NAT), tanto entre os servidores Web e o usuário final, como entre osservidores de Web e o servidor de Web Services;

� Suporte a Proxy autenticados (Ex.: ISA Server, Squid entre outros).

Criptografia de Dados

� Disponível entre a comunicação do servidor Web e o servidor de Web Services;

� Disponível para ser utilizada entre o servidor Web e o usuário final;

� Necessita de aquisição de Certificados de Segurança através de entidades certificadoras.

Pontos de Atenção

� Definição do modelo de segurança a ser seguido de acordo com o tamanho e necessidade do cliente;

� Atenção especial na definição das regras de acesso (usuário, senha, direitos, etc.).


Licenciamento

� Apenas a configuração do Web Services consome licença do tipo Protheus I (Licença exclusiva para omódulo Web);

� Em média cada 10 usuários conectados no Portal, consumirá uma licença no servidor de Web Services;

� O consumo pode variar de acordo com os usuários e as personalizações externas.

� O consumo da banda para acesso está ligado com o design do site, que pode conter texto e imagens.


Glossário

DNS (Domain Name System) - converte nomes Internet em seus números correspondentes e vice-versa.Originalmente, os computadores da Internet eram identificados apenas por números, como 200.252.269.1.O DNS permitiu dar nomes aos computadores, como www.microsiga.com.br.

Domínio: É um nome que serve para localizar e identificar conjuntos de computadores na Internet. O nomedo domínio foi concebido com o objetivo de facilitar a memorização dos endereços de computadores naInternet. O domínio é sempre o nome que aparece à direita do símbolo @ (arroba), num endereço eletrôni-co, e logo em seguida da expressão www.

Environment: Contém informações dos diretórios de execução do Protheus 8 Server, as informações doidioma, interface, diretórios e repositórios e, opcionalmente, as informações para acesso ao TOPConnect.

Firewall - �Parede de fogo� ou �parede corta-fogo� - barreira de segurança (na Internet) que isola partes darede - designativo de sistemas de segurança (combinação de programas e equipamentos) criados paraproteção de mensagens e transações, implementados através de filtragem da criptografia dos dados emprograma de serviços 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 à redecorporativa e outra à Internet) rodando software específico de análise e roteamento de pacotes de dados;como todo pacote enviado de uma rede para outra passa obrigatoriamente pelo sistema, o firewall tem aoportunidade de analisá-lo, determinando se ele representa algum risco e, em caso positivo, descartando-oantes que alcance seu destino.

FTP (File Transfer Protocol): é um serviço Internet cuja finalidade é permitir a transferência de arquivos dequalquer tipo entre dois computadores. Normalmente é usado para transferir programas, textos, imagens,etc. de um computador central (servidor) para um usuário remoto (cliente) ou vice-versa. Para acessar umservidor FTP é necessário estar cadastrado como usuário deste, e ter, portanto, um nome de acesso e umasenha (FTP real). Entretanto, há um tipo especial de servidor FTP que permite acesso público, sem senhasespeciais. É o FTP anônimo.

HTTP: (Hyper Text Transfer Protocol) - É o protocolo pelo qual o browser e os sites na Internet secomunicam. Protocolo que diz ao servidor para mandar páginas da World Wide Web para seu micro.

Sempre quando vamos visitar algum site, começamos o endereço com http, esta sigla informa ao computa-dor que este é o protocolo que vai definir como os servidores devem transferir entre si comandos ouinformações relativos ao www.

Host: Hospedeiro. Um computador servidor designado para hospedar e fornecer páginas HTML, arquivos deexecução e de conteúdo, banco de dados, e outros fluxos de dados e serviços de busca. Também podeser chamado de computador central. É o servidor, também chamado de nó.


IP (Internet Protocol): É o protocolo da Internet, é esse protocolo que identifica, localiza e estabelececonexão entre computadores ligados na rede corporativa na Internet.

Instância: Nome utilizado para individualizar as configurações das instalações do módulo Web, assim, se aempresa necessita aplicar diferentes configurações para um mesmo módulo Web, é possível instalá-lo sobuma nova instância.

Proxy - Um servidor proxy é um programa que armazena localmente objetos Internet para posterior distribui-ção. Objetos Internet podem ser páginas 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 usuário solicitar um objeto (clicando em um link), o browser irá verificar se este objeto existeno servidor proxy. Se existir, o receberá diretamente deste, sem a necessidade de solicitá-lo na origem, quepode ser uma conexão lenta. Se não existir, o próprio servidor proxy se encarregará de obtê-lo na origem,repassando-o ao usuário e simultaneamente gravando-o. Deste modo, quando um outro usuário solicitareste mesmo objeto, este já estará disponível no servidor proxy. A grande vantagem do uso de servidoresproxy é que o browser tende a ficar muito mais rápido, pois muitos objetos (incluindo páginas e as imagensdas páginas) que originalmente são acessados por uma conexão internacional, ou congestionada, passam aser transmitidos por uma conexão local.

RootPath: Indica o diretório raiz do Protheus 8, a partir do qual todos os diretórios utilizados pelo Protheusserão criados.

URL (Uniform Resource Locator): Padrão de endereçamento da web. Permite que cada serviço/arquivo naInternet tenha um endereço próprio, que consiste de seu nome, diretório, máquina onde está armazenadoe pelo protocolo qual deve ser transmitido. Por exemplo: http://www.exemplo.com.br

Web ou WWW: é uma simplificação do termo World Wide Web (WWW) que significa Teia de AlcanceMundial. É o mais popular dos serviços Internet, porque permite a obtenção rápida e fácil de informaçõessobre os mais variados assuntos, com imagens e textos, usando um sistema de hipertextos de alcancemundial. Os recursos disponíveis no ambiente WWW são referenciados por um tipo especial de endereço,chamado URL.

Web Service: Simplificando, um web service é a maneira prática e eficaz de aplicativos se comunicaremvia internet. Surgiu por um consórcio de empresas lideradas pela Microsoft e IBM, e hoje se tornou umpadrão do W3C (WorldWide Web Consortium)

Para que servem os Web Services? - praticamente para quase tudo no que você possa pensar em troca dedados e informações. Como ele é baseado no protocolo SOAP (Simple Object Access Protocol), qualquerplataforma que interprete rotinas HTTP e manipule XML pode utilizar os dados dos web services semqualquer problema. Como quase sempre os web services utilizam o protocolo HTTP, quase sempre nãohaverá surpresas com Firewall quando sua aplicação sair do servidor de aplicação para a versão final docliente.

Vantagens - Os dados são trafegados em formato XML. Assim, todos os dados possuem <tags> e isso fazcom que estes dados tenham consistência, sem falhas, permitindo a troca de dados mais robustos como�Arrays�, e por trafegar em XML, ele é multi-plataforma.

Portal Roteiro Config Web Services Portal Protheus

Documents

Transcript of Portal Roteiro Config Web Services Portal Protheus