Skip To Content

Utilizar portas não padrão para o ArcGIS Web Adaptor do portal

Para a grande maioria de usuários do ArcGIS Enterprise , é apropriado executar o ArcGIS Web Adaptor nas portas padrão 80 e 443. Em alguns casos raros, no entanto, uma instância do Web Adaptor não pode utilizar estas portas padrão no servidor da web que as hospeda. Por exemplo, o servidor da web de host pode já ter um aplicativo em execução nestas portas ou o acesso à porta pode ser restrito em uma organização protegida.

Nestas situações onde as portas 80 e 443 não podem ser utilizadas, uma solução alternativa está disponível no ArcGIS Enterprise 10.6.1 para permitir que o Web Adaptor do portal seja executado em portas não padrão. Um servidor proxy reverso ou balanceador de carga deve então ser configurado para que os usuários acessem o portal através das portas padrão. O uso de HTTPS ainda deve ser mantido para decodificar a comunicação entre ArcGIS Web Adaptor e Portal for ArcGIS.

Na versão 10.6.1, o arquivo de configuração do ArcGIS Web Adaptor tem uma nova propriedade, EnableDefaultPortValidation, que, por padrão, obriga o uso das portas padrão 80 e 443 ao configurar ArcGIS Web Adaptor com um portal. Alterar o valor desta propriedade para falso ignora esta validação, permitindo ao ArcGIS Web Adaptor executar em portas não padrão.

Configurar o ArcGIS Web Adaptor do portal em portas não padrão

Se o servidor da web pretendia hospedar o ArcGIS Web Adaptor do seu portal, para executar o software em portas diferentes de 80 e 443, você precisará seguir algumas etapas adicionais ao configurar o Web Adaptor através dos assistentes de instalação e configuração.

  1. Habilite HTTPS no servidor da web que hospedará o web adaptor. Observe a porta sendo utilizada para comunicação de HTTPS, pois ela será utilizada para acessar o ArcGIS Web Adaptor durante a configuração inicial com o portal.
  2. Instale o ArcGIS Web Adaptor no servidor da web, utilizando o assistente de instalação Setup.exe como um usuário com privilégios administrativos.
  3. Na máquina hospedando o ArcGIS Web Adaptor, navegue e abra o arquivo webadaptor.config em um editor de texto. Por padrão, está localizado na pasta /root.webadaptor/<web adaptor name> .
  4. No arquivo webadaptor.config , localize a propriedade EnableDefaultPortValidation, que tem um valor padrão de verdadeiro. Altere o valor para falso: <EnableDefaultPortValidation>false</EnableDefaultPortValidation>.
  5. Reinicie o servidor da web.
  6. Abra a página de configuração do ArcGIS Web Adaptor em um navegador da Internet na porta HTTPS que está sendo utilizada pelo servidor da web no formato de URL https://webadaptorhost.domain.com:<https_port>/webadaptorname/webadaptor/portal. Se um Nome Alternativo de DNS for utilizado com o portal, o Web Adaptor deverá ser configurado pelo nome alternativo, utilizando uma URL como https://dnsalias.domain.com:<https_port>/<webadaptorname>/webadaptor/portal
  7. Para a propriedade URL do Portal , digite a URL da máquina que hospeda o software Portal for ArcGIS utilizando o nome de domínio totalmente qualificado da máquina na URL, como https://portal.domain.com:7443.
  8. Forneça um nome de usuário e senha para uma conta que tenha privilégios administrativos no Portal for ArcGIS. Normalmente, você utilizará o login da conta inicial de administrador que definiu na primeira vez que configurou seu portal. Se você desativou ou excluiu a conta inicial de administrador, você precisará especificar uma conta diferente com acesso administrativo para o site da web do portal.
  9. Clique em Configurar.
  10. Configure o portal com o servidor proxy reverso ou balanceador de carga da sua organização, para que os usuários acessem o portal por meio das portas padrão. Para fazer isto, você precisa fornecer algumas informações ao portal sobre o proxy reverso ou balanceador de carga. Para instruções completas, consulte Utilizar um servidor proxy reverso com Portal for ArcGIS.
  11. Após configurar o proxy reverso ou balanceador de carga com o portal, atualize a página de configuração do ArcGIS Web Adaptor para atualizá-lo.

Quando este fluxo de trabalho estiver concluído, o ArcGIS Web Adaptor estará configurado para utilizar com o seu portal do ArcGIS Enterprise . Os usuários somente acessarão o portal e o ArcGIS Portal Administrator Directory através do servidor proxy reverso, com o formato de URL https://reverseproxy.domain.com/webadaptorname/home, ao invés da porta 7443.

Dica:

Se você configurou seu portal para utilizar HTTPS para toda comunicação, atualize o site da web do portal instalado e URLs do atalho de ajuda para utilizar https ao invés de http.

Configurar silenciosamente ArcGIS Web Adaptor (Java Platform) do portal em portas não padrão

A instalação e configuração do seu ArcGIS Web Adaptor (Java Platform) também pode ser feita a partir da linha de comando, com etapas adicionais para executar em portas não padrão.

Anotação:

Para executar o utilitário da linha de comando, o Java Runtime Environment (JRE) deve estar presente na máquina hospedando o ArcGIS Web Adaptor. Se o JRE não estiver presente na sua máquina, ocorrerá um erro ao executar o utilitário. Consulte o site Java SE Downloads para instruções sobre como baixar e instalar o JRE na sua máquina.

  1. Habilite HTTPS no servidor da web que hospedará o web adaptor. Observe a porta sendo utilizada para comunicação de HTTPS, pois ela será utilizada para acessar o ArcGIS Web Adaptor durante a configuração inicial com o portal.
  2. Instale o ArcGIS Web Adaptor no servidor da web, utilizando o utilitário da linha de comando da instalação como um usuário com privilégios administrativos.
  3. Na máquina hospedando o ArcGIS Web Adaptor, navegue e abra o arquivo webadaptor.config em um editor de texto.
  4. No arquivo webadaptor.config , localize a propriedade EnableDefaultPortValidation, que tem um valor padrão de verdadeiro. Altere o valor para falso: <EnableDefaultPortValidation>false</EnableDefaultPortValidation>.
  5. Reinicie o servidor da web.
  6. Configure ArcGIS Web Adaptor através do utilitário da linha de comando configurewebadaptor.sh, que está localizado na pasta <ArcGIS Web Adaptor installation directory>/webadaptor<version>/java/tools . Você utilizará a sintaxe ConfigureWebAdaptor.sh -m <Mode> -w <WebAdaptorURL> -g <URL> -u <Username> -p <Password>. Os parâmetros a fornecer são os seguintes:

    • <Mode>—O modo de produto no qual o ArcGIS Web Adaptor será configurado. Configure este parâmetro para portal para utilizar com Portal for ArcGIS.
    • <WebAdaptorURL>—A URL do ArcGIS Web Adaptor que você deseja configurar a partir da linha de comando. Esta é a mesma URL que seria utilizada se você estivesse acessando a página de configuração em um navegador da web. Você é exigido para especificar a URL de HTTPS do ArcGIS Web Adaptor—por exemplo, https://webadaptorhost.domain.com:<https_port>/webadaptorname/webadaptor. Se um Nome Alternativo de DNS for utilizado com o portal, o Web Adaptor deverá ser configurado pelo Nome Alternativo de DNS, utilizando uma URL como https://<dnsalias.domain.com>:<https_port>/<webadaptorname>/webadaptor.
    • <URL>—A URL da máquina hospedando o Portal for ArcGIS. Inclua o nome de domínio qualificado completo da máquina na URL—por exemplo, https://portal.domain.com:7443.
    • <Username>—O nome de usuário de uma conta que tem privilégios administrativos no Portal for ArcGIS. Normalmente, você utilizará a conta inicial de administrador que definiu na primeira vez que configurou seu portal.
    • <Password>—A senha de uma conta que tem privilégios administrativos no Portal for ArcGIS. Normalmente, você utilizará a conta inicial de administrador que definiu na primeira vez que configurou seu portal.

    Exemplo de comando

    configurewebadaptor.sh -m portal -w https://webadaptorhost.domain.com:https_port/webadaptorname/webadaptor -g https://portal.domain.com:7443 -u initialadmin -p secret123
  7. Configure o portal com o servidor proxy reverso ou balanceador de carga da sua organização, para que os usuários acessem o portal por meio das portas padrão. Para fazer isto, você precisa fornecer algumas informações ao portal sobre o proxy reverso ou balanceador de carga. Para instruções completas, consulte Utilizar um servidor proxy reverso com Portal for ArcGIS.

Quando este fluxo de trabalho estiver concluído, o ArcGIS Web Adaptor estará configurado para utilizar com o seu portal do ArcGIS Enterprise . Os usuários somente acessarão o portal e o ArcGIS Portal Administrator Directory através do servidor proxy reverso, com o formato de URL https://reverseproxy.domain.com/webadaptorname/home, ao invés da porta 7443.

Dica:

Se você configurou seu portal para utilizar HTTPS para toda comunicação, atualize o site da web do portal instalado e URLs do atalho de ajuda para utilizar https ao invés de http.