Endereços de acesso ao sistema

O sistema pode ser instalado em um ou vários servidores de aplicação e de borda, e o acesso a eles pode ser realizado por mais de um endereço ou protocolo. É importante que o sistema tenha conhecimento de todos os possíveis endereços de acesso, pois eles precisam ser informados aos provedores de identidade externos para que eles possam ser utilizados na autenticação dos usuários do sistema.

Processo Endereços de acesso ao sistema

Caminho: Admin > Servidores > Endereços de acesso ao sistema.

Através desse cadastro é possível configurar:

  • A URL pública principal que os usuários utilizam para acessar o sistema. Preferencialmente ela deve utilizar o protocolo HTTPS e ela pode ser utilizada por processos e relatórios que enviam links por e-mails ou em documentos gerados pelo sistema, caso não haja uma configuração específica para definir a URL desses links.
  • A URL de autenticação dos usuários. Essa URL é utilizada exclusivamente para a autenticação de usuários junto aos provedores de identidade e por isso deve preferencialmente utilizar o protocolo HTTPS. O motivo de ser um campo separado é para permitir que eventual manutenção no DNS do endereço principal não interfira no login dos usuários. Se esse campo não for preenchido, será considerada a URL principal durante a autenticação.
  • Outras URLs dos servidores de aplicação e de borda utilizadas pelos usuários para acessar o sistema, como URLs com domínios alternativos ou que utilizem o protocolo HTTP, por exemplo.

As URLs configuradas podem ser consultadas por processos e relatórios, conforme exemplo abaixo:

const GeneralSettings = require('@nginstack/engine/lib/settings/GeneralSettings');

const settings = GeneralSettings.getInstance();
settings.get('ngin.urls.main'); // => 'https://example.com'
settings.get('ngin.urls.alternatives'); // => ['http://example.com', 'https://app-01.example.com']