O Google usa tecnologia de IA na tradução de conteúdos para seu idioma de preferência. As traduções com IA podem ter erros.

Como configurar o TLS para a IU de gerenciamento

Edge para nuvem privada v4.18.05

Por padrão, você acessa a IU de gerenciamento do Edge por HTTP usando o endereço IP do nó do servidor de gerenciamento e a porta 9000. Exemplo:

http://ms_IP:9000

Como alternativa, é possível configurar o acesso TLS à IU de gerenciamento para que você possa acessá-la no 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 é exigido pelo Edge. É possível configurar o Management Server para usar outros valores de porta. O único requisito é que o firewall permita o tráfego pela porta especificada.

Verifique se a porta TLS está aberta

O procedimento nesta seção configura o TLS para usar a porta 9443 no servidor de gerenciamento. Independentemente da porta usada, é preciso garantir que ela esteja aberta no servidor de gerenciamento. Por exemplo, use o seguinte comando para abri-lo:

iptables -A INPUT -m state --state NEW -m tcp -p tcp --dport 9443 -j ACCEPT --verbose

Observação:este exemplo usa a porta 9443 para a porta TLS, e não a porta 443, que é mais comum. Isso ocorre porque as portas abaixo de 1024 normalmente são protegidas pelo sistema operacional e exigem que o processo que as acessa tenha acesso raiz. A IU do Edge é executada como o usuário "apigee" e, portanto, normalmente não tem acesso a portas abaixo de 1024.

Uma alternativa é usar um balanceador de carga com a IU do Edge e encerrar o TLS no balanceador de carga na porta 443. Em seguida, use HTTP ou HTTPS entre o balanceador de carga e a interface do Edge.

Outra alternativa é usar iptables para encaminhar solicitações para a porta 443 para a porta 9443. Exemplo:

iptables -A PREROUTING -t nat -i eth0 -p tcp --dport 443 -j REDIRECT --to-port 9443

Configurar a TLS

Use o procedimento a seguir para configurar o acesso TLS à IU 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 TLS/SSL para o Edge para nuvem privada.

Execute o seguinte comando para configurar o TLS:

/opt/apigee/apigee-service/bin/apigee-service edge-ui configure-ssl

Digite 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 pode ser acessada 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 no nó do Management Server e altera a propriedade do arquivo para "apigee".
Digite a senha do keystore em texto simples.
Em seguida, o script reinicia a IU de gerenciamento do Edge. Após a reinicialização, a IU de gerenciamento oferece suporte ao acesso por TLS.
Você pode ver essas configurações 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 às 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 seguinte comando para configurar o TLS da IU do Edge:

/opt/apigee/apigee-service/bin/apigee-service edge-ui configure-ssl -f configFile

Configurar a IU do Edge quando o TLS termina no balanceador de carga

Se você tiver um balanceador de carga que encaminha solicitações para a IU do Edge, encerre a conexão TLS no balanceador de carga e faça com que ele encaminhe as solicitações para a IU do Edge por HTTP. Essa configuração é compatível, mas você precisa configurar o balanceador de carga e a IU do Edge de acordo.

A configuração adicional é necessária quando a IU 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. Esse e-mail contém um URL que o usuário seleciona para definir ou redefinir uma senha. Por padrão, se a IU do Edge não estiver configurada para usar TLS, o URL no e-mail gerado usará o protocolo HTTP, e não HTTPS. É preciso configurar o balanceador de carga e a IU 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 para a IU do Edge:

X-Forwarded-Proto: https

Para configurar a IU 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 alterações em ui.properties.

Reinicie a IU do Edge:

/opt/apigee/apigee-service/bin/apigee-service edge-ui restart

Desativar o TLS na interface do Edge

Para desativar o TLS na IU do Edge, use o seguinte comando:

/opt/apigee/apigee-service/bin/apigee-service edge-ui disable-ssl