Nota Técnica nº 340/2016

Grupo/Conjunto: Desenvolvimento Web/Tecnologia e Versão: 1.3

Pesquisa
Autor: Glauco David Laicht Criado em: 08/12/2016
Público Alvo: Usuários das soluções IPM
Assunto: Guia de Instalação e uso do IPM – Serviços Locais

Sumário
1. Configurações mínimas homologadas: ........................................................................................................ 2
2. Download ..................................................................................................................................................... 2
3. Instalação ..................................................................................................................................................... 3
3.1 Passo 1: ............................................................................................................................ 3
3.2 Passo 2: ............................................................................................................................ 3
3.3 Passo 3: ............................................................................................................................ 3
3.4 Passo 4: ............................................................................................................................ 3
3.5 Passo 5: ............................................................................................................................ 5
3.6 Instalação – Windows Vista ............................................................................................. 5
4. Execução ...................................................................................................................................................... 6
5. Atualização................................................................................................................................................... 8
6. Problemas e Soluções................................................................................................................................... 8
6.1 Instalação do certificado no Mozilla Firefox ................................................................... 9
6.2 Configuração de proxy para endereços locais ................................................................ 11
6.3 Dúvidas frequentes – Assinatura Digital........................................................................ 15
6.4 Instalação do certificado no Windows XP ..................................................................... 16
 Guia de Instalação e uso do IPM – Serviços Locais
O aplicativo IPM – Serviços Locais tem como o objetivo acessar diferentes dispositivos
conectados ou instalados localmente, como por exemplo, certificados digitais, impressoras,
leitores biométricos, scanners ou outros aplicativos.

Tal procedimento era feito até então através de um recurso denominado "applet" o qual
faz uso do Java para acessar estes dispositivos. Porém, por questões de segurança, os navegadores
descontinuaram o suporte ao Java1, o que consequentemente levou a necessidade de utilizar novas
tecnologias.

Com isso, a IPM desenvolveu uma única aplicação denominada “IPM Serviços Locais”,
que deverá ser executada localmente em seu computador e possibilitará a execução das referidas
atividades em diferentes navegadores.

Será necessário que até Fevereiro de 2017 todos estejam utilizando esta nova solução,
pois a partir desta data nenhum navegador dará suporte ao applet.

1. Configurações mínimas homologadas

• Windows Vista, Windows 7 ou superior, Mac OS X.

• Processador 2GHz.
• Memória RAM 1GB.
• Java Runtime Enviroment 7 ou superior.
• Navegadores:

Navegador Versão
Google Chrome 44
Mozilla Firefox* 38
Opera 37
iOS Safari 9.3
Microsoft Edge 13

* Para o navegador Mozilla Firefox, poderá ser necessário proceder com a instalação do
certificado, vide item 6.1.

2. Download

Windows:

Observação: realizar download da mesma versão do Java (32 ou 64 bits) instalado na sua máquina.

• IPM – Serviços Locais – 32 bits

• IPM – Serviços Locais – 64 bits
Mac OS X:

• IPM – Serviços Locais

Linux:

• IPM – Serviços Locais

3. Instalação

Para proceder com a instalação do “IPM - Serviços Locais” é necessário que o usuário
atual seja ou tenha privilégios de administrador.

Observação: caso esteja utilizando o Windows Vista e estiver com problemas na execução vide item 3.6.

3.1 Passo 1:

Feito o download da aplicação para o seu sistema operacional, deve ser executado o
arquivo que então será iniciado o processo de instalação. Este processo é padrão, bastando
informar o diretório de instalação da aplicação. É importante que as questões abaixo sejam
verificadas (as mesmas também poderão ser visualizadas durante a instalação).

3.2 Passo 2:

O IPM – Serviços Locais é uma aplicação que ficará instalada em seu computador e
precisará de privilégio de uso na porta 65433. Durante o processo de instalação será verificado se
a porta está em uso e caso esteja, irá cancelar a operação automaticamente. Caso a porta esteja
acessível, mas bloqueada, a instalação também não poderá avançar. Isso pode ocorrer em virtude
do uso de firewall do sistema operacional ou outro.

3.3 Passo 3:

A aplicação irá realizar procedimentos de atualização automática quando for necessário e

para isto precisará de acesso à Internet. Caso na infraestrutura de rede local seja utilizado algum
recurso de proxy, este deverá ser informado durante a instalação (se os dados já estiverem
configurados no sistema será carregado automaticamente). É necessário que os seguintes
domínios sejam liberados para permitir acesso (e para isso, o administrador de rede local deverá
ser contatado):

• *.ipm.com.br.
• *.atende.net.
• *.nfs-e.net.

3.4 Passo 4:

O computador precisará reconhecer a aplicação IPM – Serviços Locais como válida e

segura, para isto ele utiliza um certificado digital da IPM Sistemas Ltda que é fornecido junto ao
instalador. Ao final da instalação poderá ser solicitada a confirmação para inclusão deste
certificado, a qual deverá ser confirmada para funcionamento correto. Será apresentado a
confirmação conforme imagens abaixo.

Windows:

Mac OS X:

Windows XP:
3.5 Passo 5:

Ao finalizar o processo de instalação é necessário que os navegadores sejam reiniciados

para que possam identificar corretamente o IPM – Serviços Locais. Na última etapa do instalador
você terá a opção de fazer isso automaticamente.

3.6 Instalação – Windows Vista

Caso o seu sistema operacional seja Windows Vista o instalador do IPM – Serviços
Locais poderá não executar sem você realizar o desbloqueio primeiro. Para fazer isto pasta clicar
com o botão direito sobre o instalador e na janela aberta utilizar o botão desbloquear, tal como
ilustrado na figura abaixo.
4. Execução

Após a conclusão do procedimento de instalação pode-se iniciar o uso do IPM – Serviços

Locais e isto ocorrerá de forma automática. A identificação da execução poderá ser feita de duas
formas:

1 – Através do ícone na barra de tarefas:

Windows:
Mac OS X:

2 – Acessando o endereço https://localhost:65433 no navegador onde deverá ser apresentada a

mensagem abaixo.

“Caso você esteja utilizando o Mozilla Firefox, poderá ser apresentada uma mensagem de “conexão
insegura” e então será necessário proceder com a instalação do certificado”

Para mais detalhes no item 6.

O processo de instalação também irá questionar para criação de um atalho na área de

trabalho, o qual irá permitir a inicialização do IPM – Serviços Locais. A sua finalização poderá
ser feita através do ícone na barra de tarefas, utilizando o botão direito e selecionando a opção
"Fechar".

A aplicação sempre será iniciada junto com o sistema operacional.

5. Atualização

O IPM – Serviços Locais possui um mecanismo de atualização automática para seus

recursos. Desta forma, ao ser iniciado sempre serão feitas verificações de atualizações pendentes
e caso existam, serão instaladas.

Durante a utilização do recurso em uma das aplicações da IPM, caso algum recurso não
esteja presente, também será solicitada a atualização, a qual deverá ser feita para o
funcionamento. Isto ocorrerá, por exemplo, quando um recurso novo é distribuído e este fizer uso
de um componente de serviço local.

6. Problemas e Soluções

Abaixo são listados tópicos que podem resultar na solução para problemas encontrados na
execução do IPM – Serviços Locais. Caso nenhum destes solucionar o problema, pode-se entrar
em contato com a central de atendimento da IPM.

1. Caso você tenha finalizado a instalação recentemente, certifique-se que o navegador já foi
reiniciado.

2. Verifique se o IPM – Serviços Locais está em execução. A execução pode ser iniciada através
do seu atalho na área de trabalho ou menu de início, mais detalhes vide item 4.

3. O proxy deve estar configurado para que não seja utilizado em endereços locais, mais vide item
6.2.

4. Caso você esteja utilizando o navegador no Mozilla Firefox, pode ser necessário proceder com
a instalação manual do certificado digital, mais detalhes vide item 6.1.

5. Caso você utilize Windows Vista e esteja com problemas para executar o instalador vide item
3.6 para ter mais detalhes.

6. Se você está utilizando o IPM - Serviços Locais para realizar assinatura digital e está tendo
problemas vide item 6.3 para mais detalhes.

7. Caso você esteja utilizando o Windows XP, pode ser necessário proceder com a instalação
manual do certificado digital, mais detalhes vide item 6.4.

6.1 Instalação do certificado no Mozilla Firefox

Caso esteja ocorrendo problemas ao utilizar o IPM – Serviços Locais no Mozilla Firefox,
pode ser a ausência do certificado digital (irá apontar a aplicação como insegura ou não
instalada). Este navegador requer uma instalação própria do certificado, além da feita no sistema
operacional pelo próprio instalador. Para proceder com a instalação deve ser seguido o passo a
passo abaixo.

1 - Com o Mozilla Firefox iniciado você deve acessar o menu Configurações >> Opções.

2 – Acessar a opção Avançado >> Certificados >> Ver Certificados.

3 – Importar o certificado, aba "Autoridades" e botão "Importar". O certificado pode ser obtido no
diretório de instalação da aplicação.

4 – Selecionar o certificado baixado e na tela aberta, em sequência selecionar todas as opções e

então clique sobre o botão “Ok”.
5 – Para verificar se a importação solucionou o problema basta acessar o endereço
https://localhost:65433/ que deverá exibir uma imagem e a mensagem:

“A instalação foi bem sucedida e o aplicativo está em execução (O IPM – Serviços Locais deve estar em
execução para realização deste teste)”.

6.2 Configuração de proxy para endereços locais

Para configuração do proxy para endereços locais deve se seguir o passo a passo:

Windows:

1 – Digitar no menu iniciar a palavra “proxy” e clicar na opção “Configurar o servidor de proxy”.
2 – Na tela seguinte clicar no botão “Configurações de LAN”.

3 – Na tela seguinte marcar a opção “Não usar servidor proxy para endereços locais” e clicar no
botão “OK”.
Mac OS X:

1 – Na área de trabalho, no ícone de conexão, selecionar a opção “Abrir as Preferências

de Rede”.
2 – Na tela seguinte selecionar a rede utilizada e clicar no botão “Avançado”.

3 – Na configuração de rede, selecionar a opção “Proxies”, marcar os protocolos HTTP e HTTPS

e no campo “Ignorar configurações de proxy para estes Servidores e Domínios” adicionar:
localhost. Para finalizar, clique no botão “OK”.

6.3 Dúvidas frequentes – Assinatura Digital

Caso você esteja utilizando o IPM – Serviços Locais para realizar a assinatura digital de
documentos ou utilizar o seu certificado para logar no sistema e esteja com algum problema,
verifique se algum dos itens abaixo pode auxiliá-lo.

Motivo: Meu certificado não está sendo apresentado na lista para assinar.

Causa: Se você conectou ou instalou o token do seu certificado recentemente, tente removê-lo e
inseri-lo novamente. Após isto, se o problema persistir tente reiniciar o IPM – Serviços Locais
(Botão direito no botão apresentado na barra de tarefas e abri-lo novamente através do atalho).

Motivo: Utilizo MacOS e meu certificado não aparece na lista para assinar.

Causa: Será necessário configurar no Atende.Net para carregar os tokens automaticamente.

Para isto é necessário seguir os passos a seguir:

1 - Logar no respectivo sistema e acessar o Gerenciamento do Sistema.

2 - Acessar o menu Sistema >> Serviços Locais >> Assinatura Digital (Poderá ser necessário
solicitar privilégios para acesso a esta rotina).

3 – Na tela seguinte, marcar a opção “Carregar certificados de tokens conectados” e em seguida

clicar no botão “Salvar”.

Motivo: Ao realizar a assinatura está sendo apresentada uma mensagem de erro.

Causa: A cadeia de certificados digitais utilizados para emissão do seu certificado não está
instalada. Para verificar se a cadeia de seu certificado está instalada siga os passos abaixo:

Windows:

1 – Acessar o menu Iniciar e digitar certmgr.msc

2 – Na tela seguinte, selecionar as opções: Pessoal e Certificados.

3 – Clicar duas vezes sobre o certificado e na tela seguinte acessar a guia “Caminho de
certificação”.

Caso a cadeia não esteja instalada os certificados apareceram com um informativo em

vermelho e então será necessário instalá-la.

MacOS:

1 - Acessar o aplicativo “Acesso às chaves” em Aplicativos >> Utilitários.

2 - Buscar o seu certificado e clicar duas vezes sobre o mesmo.

Caso a cadeia não esteja instalada será apresentada a mensagem: “Este certificado foi
assinado por uma autoridade desconhecida”.

Para instalar a cadeia você deve entrar em contato com o fornecedor do seu certificado.

Observação: em alguns casos, a cadeia de certificados será incluída automaticamente através da

Internet pelo IPM – Serviços Locais. Neste caso, o erro poderá persistir e será necessário reiniciar o
mesmo após a primeira tentativa.

6.4 Instalação do certificado no Windows XP

Caso esteja ocorrendo algum problema ao utilizar o IPM – Serviços Locais no Windows
XP, o motivo pode ser a ausência do certificado digital (irá apontar a aplicação como insegura ou
não instalada).

Você poderá verificar se a instalação foi realizada corretamente acessando: Painel de

Controle >> Opções da Internet >> Conteúdo >> Certificados e na aba “Autoridades de
certificação raiz confiáveis” e então observar se o certificado da IPM Sistemas Ltda está
instalado. Outra maneira de verificar é acessar o endereço https://localhost:65433 que deverá
mostrar uma mensagem de que a instalação foi bem sucedida.

Caso não esteja instalado você deve seguir os passos abaixo para proceder com a
instalação:

1 – Realizar o download do certificado. O mesmo pode ser obtido no diretório de instalação do

IPM – Serviços Locais.

2 – Dar dois cliques sobre o certificado e em seguida clique no botão “Instalar Certificado”.

3 – No assistente que será aberto, basta clicar em avançar na primeira tela. Na segunda tela deverá
ser selecionada a opção “Colocar todos os certificados no armazenamento a seguir” e então clicar
no botão Procurar e selecionar “Autoridades de certificação raiz confiáveis”, tal como ilustra a
imagem a seguir. Após basta avançar e concluir o assistente.

4 – Será apresentada uma mensagem solicitando a confirmação da instalação, tal como ilustra a
imagem a seguir, basta clicar na opção “Sim”.
5 – Reiniciar o navegador.

Feito os passos da instalação passa verificar se a instalação foi feita corretamente

conforme orientações apresentadas no início deste tópico.
 Alterações/Revisões

Data Versão Autor Resumo

09/12/2016 1.1 Hauana A. N. de Brito Padronização do conteúdo.
30/12/2016 1.2 Glauco David Laicht Inclusão dos itens 3.6 e 6.3
04/01/2017 1.3 Glauco David Laicht Atualização dos itens 3.5 e 5 e
inclusão do item 6.4.

Quaisquer dúvidas ou sugestões deverão ser repassadas para o setor de Atendimento IPM
através da ferramenta de Atendimento Online ou pelo telefone (47) 3531-1500.