Manual Técnico - OpenWebStart

1. Introdução

Este manual orienta os usuários no download, instalação e configuração do software OpenWebStart, necessário para a assinatura digital.

2. Download do Software

Acesse: https://openwebstart.com/download/
Baixe a versão correspondente ao seu sistema operacional (Windows, macOS ou Linux).

Importante:

WINDOWS

3. Instalação

Seleção de Idioma: Escolha o idioma (inglês ou alemão) e clique em "OK".
Início da Instalação: Clique em "Next".
Aceite dos Termos: Marque "I accept the agreement" e clique em "Next".
Modo de Instalação: Selecione "For the current user only" se não for administrador da máquina.
Se estiver utilizando um computador compartilhado em uma organização, considere solicitar ao administrador que realize a instalação.
Diretório de Instalação: Escolha o local de instalação e clique em "Next".
Associação de Arquivos: Mantenha “*.jnlpx” selecionado e clique em "Next".
Finalização: Clique em "Finish".

4. Configuração Inicial

Aprovação de segurança: Marque "Always trust content from this publisher" e clique em "Run".
No painel de controle Java:

Acesse a aba "Segurança".
Desabilite a opção "Ativar Conteúdo Java para aplicativos de browser e Web Start"
Clique em "Aplicar" e depois em "OK".

SOMENTE para usuários de macOS:

Abra o "OpenWebStart Settings".
Acesse "JVM Manager".
Clique em "Settings..."
Na opção "Vendor:" selecione Azul Systems, Inc.
Clique em "Ok" e depois em "Apply".

5. Possíveis Erros e Soluções Comuns

Erro: OpenWebStart não inicia ao carregar aplicação JNLPX.

Causa: Conflito entre versões de Java instaladas.

Solução: No painel de controle Java, desative “Ativar Conteúdo Java para aplicativos de browser e Web Start”.

Erro: Could not find a suitable JVM in the system.

Causa: Não foi possível localizar uma JVM válida.

Solução: Instale e configure o Java 11 no "JVM Manager" do OpenWebStart.

Abra o "OpenWebStart Settings".
Acesse "JVM Manager".
Remova JVMs não compatíveis (ex.: Java 21).
Clique em "Add Local..." e selecione a pasta do Java 11.
Clique em "Apply".

Erro: Falha ao carregar aplicação JNLPX.

Causa: URL inválida ou conexão com a internet ausente.

Solução: Verifique se o download foi efetuado e se há conexão com a internet. Tente fazer o download novamente clicando no botão “Assinar com Nova Tecnologia (Recomendada)” clique em “Assinar com Nova Tecnologia (Recomendada)”.

Erro: Solicitação para baixar Java 11 mesmo com versão instalada.

Causa: Versão local do Java desatualizada em relação a versão do repositório do OpenWebStart.

Solução: Aceite a instalação sugerida ou ignore a mensagem (ela continuará sendo exibida). Você poderá configurar a estratégia de exibição posteriormente.

Abra o "OpenWebStart Settings".
Acesse "JVM Manager".
Clique em "Settings..."
Na opção "Update strategy:", estão disponíveis quatro alternativas:

Do not download any version - selecione esta opção se não quiser que o JDK seja atualizado automaticamente.
Use local if available - selecione esta opção para utilizar uma versão do JDK já instalada na sua máquina.
Ask if newer version should be downloaded - selecione esta opção se quiser ser avisado sempre que uma nova versão do JDK estiver disponível.
Always download newer version - selecione esta opção para que o JDK seja sempre atualizado automaticamente para a versão mais recente disponível no repositório do OpenWebStart.

Clique em "Ok" e depois em "Apply".

7. Considerações Finais

Seguindo este manual, o OpenWebStart estará pronto para uso com o sistema de assinatura digital, assegurando uma instalação e configuração estáveis e seguras.