Centro de suporte da Workiva

Os GroundRunners permitem que os comandos em cadeia interajam com sistemas locais ou fontes de dados remotas não acessíveis de outra forma pela Internet. 

Para usar um certificado personalizado, um profissional de TI ou alguém familiarizado com as configurações de rede da sua organização deve importar o certificado para o armazenamento de certificados do sistema e desativar as bibliotecas compartilhadas padrão da Workiva.

Requisitos

• Recomenda-se que você tenha um profissional de TI ao usar um certificado personalizado. O suporte da Workiva não poderá ajudar você com essa instalação.
• É necessário um sistema operacional compatível.
• Se você estiver usando o GroundRunner, o JRE não será instalado com o GroundRunner durante a instalação inicial do GroundRunner. Depois que a configuração for concluída e o GroundRunner estiver sendo executado, ele baixará automaticamente um JRE, conforme necessário, para executar comandos que dependem do Java. Não é necessária nenhuma instalação ou intervenção do administrador, e o JRE recuperado não afetará as instalações de JRE existentes, se elas existirem no host. Saiba mais sobre os requisitos do GroundRunner.
• Alguns conectores não são compatíveis com as bibliotecas compartilhadas do Workiva e você deve usar a instalação Java do sistema do GroundRunner. Consulte a lista de exclusão.

Importar o certificado personalizado

Quando você usa um certificado autoassinado ou um certificado não emitido pela autoridade de certificação, o GroundRunners deve usar o armazenamento de certificados do sistema.

Para importar um certificado:

1. Entre em contato com o administrador de TI para obter uma cópia do certificado usado para proteger o site ou exportá-lo do navegador.
2. Importe o certificado para o repositório de chaves de certificado do sistema. Os locais válidos estão listados abaixo.

Locais válidos

Nas versões anteriores do GroundRunner, os certificados personalizados eram lidos no arquivo cacerts no diretório de instalação do JRE/JDK. Essa funcionalidade foi alterada para que os certificados personalizados só possam ser lidos nos seguintes locais.

Desativar as bibliotecas compartilhadas da Workiva

Nas cadeias, uma "biblioteca compartilhada" é qualquer biblioteca ou dependência externa necessária para o funcionamento adequado de um conector. Essas bibliotecas compartilhadas são mantidas, atualizadas e distribuídas diretamente pela Workiva (com algumas exceções). No momento, o Java 21 é a nossa única biblioteca compartilhada, mas dependências adicionais podem ser adicionadas conforme necessário.

Para desativar as bibliotecas compartilhadas e substituí-las pela biblioteca que você mesmo instalou, adicione uma nova opção de configuração ao arquivo GroundRunner.config:

SHARED_LIBRARY_OVERRIDES=java-21=/path/to/java21/home,java-24=/path/to/java24/home

O caminho fornecido nessa substituição deve ser válido e deve conter uma pasta chamada bin que contenha os executáveis relevantes. No entanto, o caminho em si não deve incluir o diretório bin.

Exemplo

Considere a estrutura de pastas de um exemplo de instalação do Java: ~/.asdf/installs/java/corretto-21.0.6.10.1 ❯ tree -L 1

. ├── ADDITIONAL_LICENSE_INFO ├── ASSEMBLY_EXCEPTION ├── LICENSE ├── README.md ├── bin ├── commitId.txt ├── conf ├── include ├── jmods ├── legal ├── lib ├── man ├── release └── version.txt

Você notará a pasta bin em nossa estrutura de arquivos. É importante ressaltar que esse subdiretório não está incluído em nosso caminho fornecido.

Em vez disso, a substituição em nosso arquivo GroundRunner.config tem a seguinte aparência:

 SHARED_LIBRARY_OVERRIDES=java-21=/Usuários/nome de usuário/.asdf/installs/java/corretto-21.0.6.10.1

Em um computador com Windows, você terá a seguinte aparência:

SHARED_LIBRARY_OVERRIDES=java-21=C:\Program Files\Java\jre-21

Nota: Certifique-se de que você instale o Windows usando barras invertidas no caminho fornecido.

Solução de problemas

O GroundRunner não será iniciado se:

• Qualquer um dos caminhos fornecidos em seu arquivo de configuração não existir
• Os caminhos não contêm um subdiretório bin

Conectores excluídos

Esses conectores não são compatíveis com as bibliotecas compartilhadas da Workiva e devem usar a instalação Java do sistema do GroundRunner:

• Oracle Essbase
• Oracle Hyperion Financial Management (HFM)

Esses conectores ainda usam certificados personalizados lidos no arquivo cacerts.

Observação: Quando os conectores "suportados" são executados no mesmo GroundRunner que um conector excluído, os conectores suportados ainda usarão as bibliotecas compartilhadas da Workiva por padrão. Você pode substituir isso configurando a opção SHARED_LIBRARY_OVERRIDES detalhada neste artigo.