Edge for Private Cloud v. 4.17.05
Por padrão, você acessa a interface de gerenciamento do Edge por HTTP usando o endereço IP do e a porta 9000 do servidor de gerenciamento. Exemplo:
http://ms_IP:9000
Como alternativa, você pode configurar o acesso TLS à interface de gerenciamento para acessá-la em o formulário:
https://ms_IP:9443
Neste exemplo, você configura o acesso TLS para usar a porta 9443. No entanto, esse número de porta não é necessário para o Edge. Você pode configurar o servidor de gerenciamento para usar outros valores de porta. O único o firewall permite o tráfego pela porta especificada.
Verifique se a porta TLS está aberta
O procedimento desta seção configura o TLS para usar a porta 9443 no servidor de gerenciamento. Independentemente da porta usada, você deve assegurar que ela esteja aberta no console do Servidor. Por exemplo, use o comando a seguir para abrir:
$ iptables -A INPUT -m state --state NEW -m tcp -p tcp --dport 9443 -j ACCEPT --verbose
Configurar a TLS
Use o procedimento a seguir para configurar o acesso TLS à interface de gerenciamento:
- Gere o arquivo JKS do keystore que contém a certificação TLS e a chave privada e copie-o para o nó do servidor de gerenciamento. Para mais informações, consulte Como configurar o TLS/SSL para o Edge local.
- Execute o seguinte comando para configurar o TLS:
US$ /opt/apigee/apigee-service/bin/apigee-service Edge-ui configure-ssl - Insira o número da porta HTTPS, por exemplo, 9443.
- Especifique se você quer desativar o acesso HTTP à interface de gerenciamento. Por padrão, a interface de gerenciamento é acessível por HTTP na porta 9000.
- Insira o algoritmo do keystore. O padrão é JKS.
- Insira o caminho absoluto para o arquivo JKS do keystore.
O script copia o arquivo para o diretório /opt/apigee/customer/conf na Management Server, e altera a propriedade do arquivo para apigee. - Digite a senha do keystore em texto não criptografado.
- Em seguida, o script reinicia a interface de gerenciamento do Edge. Após a reinicialização, a interface de gerenciamento
oferece suporte ao acesso por TLS.
Essas configurações estão em /opt/apigee/etc/edge-ui.d/SSL.sh.
Também é possível transmitir um arquivo de configuração para o comando em vez de responder a solicitações. O arquivo de configuração tem as seguintes propriedades:
HTTPSPORT=9443 DISABLE_HTTP=y KEY_ALGO=JKS KEY_FILE_PATH=/opt/apigee/customer/application/mykeystore.jks KEY_PASS=clearTextKeystorePWord
Em seguida, use o comando a seguir para configurar o TLS da interface do Edge:
/opt/apigee/apigee-service/bin/apigee-service edge-ui configure-ssl -f configFile
Configurar a interface do Edge quando o TLS for encerrado no balanceador de carga
Se você tiver um balanceador de carga que encaminha solicitações para a interface do Edge, poderá encerrar a conexão TLS no balanceador de carga e encaminhar as solicitações para a interface do Edge por HTTP. Essa configuração é compatível, mas você precisa configurar o balanceador de carga e a interface do Edge adequadamente.
A configuração extra é necessária quando a interface do Edge envia e-mails aos usuários para definir a senha quando o usuário é criado ou quando o usuário solicita a redefinição de uma senha perdida. Este e-mail contém um URL que o usuário seleciona para definir ou redefinir uma senha. Por padrão, se a interface do Edge não estiver configurada para usar TLS, o URL no e-mail gerado vai usar o protocolo HTTP, e não o HTTPS. É necessário configurar o balanceador de carga e a interface do Edge para gerar um endereço de e-mail que use HTTPS.
Para configurar o balanceador de carga, verifique se ele define o seguinte cabeçalho nas solicitações encaminhadas na interface do Edge:
X-Forwarded-Proto: https
Para configurar a interface do Edge:
- Abra o arquivo /opt/apigee/customer/application/ui.properties
em um editor. Se o arquivo não existir, crie-o:
> vi /opt/apigee/customer/application/ui.properties - Defina a seguinte propriedade em ui.properties:
conf/application.conf+trustxforwarded=true - Salve as mudanças em ui.properties.
- Reinicie a interface do Edge:
> /opt/apigee/apigee-service/bin/apigee-service Edge-ui reinicialização