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.

Configurar o TLS para a nova interface do Edge

Por padrão, você acessa a nova interface do Edge por HTTP usando o endereço IP ou o nome DNS do nó da nova interface do Edge e a porta 3001. Exemplo:

http://edge_UI_IP:3001

Como alternativa, é possível configurar o acesso TLS à nova interface do Edge para acessá-la no formato:

https://edge_UI_IP:3001

Requisitos de TLS

A nova interface do Edge oferece suporte ao TLS v1.2 e versões mais recentes. Se você ativar o TLS na nova interface do Edge, os usuários precisarão se conectar a ela usando um navegador compatível com o TLS v1.2 ou versões mais recentes.

Propriedades de configuração do TLS

Execute o comando a seguir para configurar o TLS para a nova interface do Edge:

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

Em que configFile é o arquivo de configuração usado para instalar ou configurar a nova interface do Edge.

Antes de executar esse comando, edite o arquivo de configuração para definir as propriedades necessárias que controlam o TLS. A tabela a seguir descreve as propriedades usadas para configurar o TLS para a nova interface do Edge:

Propriedade	Descrição	Obrigatório?
`MANAGEMENT_UI_SCHEME`	Define o protocolo, "http" ou "https", usado para acessar a nova interface do Edge. O valor padrão é "http". Defina como "https" para ativar o TLS: MANAGEMENT_UI_SCHEME=https	Sim
`MANAGEMENT_UI_TLS_OFFLOAD`	Se "n", especifica que as solicitações TLS para a nova interface do Edge são encerradas na nova interface do Edge. É necessário definir `MANAGEMENT_UI_TLS_KEY_FILE` e `MANAGEMENT_UI_TLS_CERT_FILE`. Se "y", especifica que as solicitações TLS para a nova interface do Edge são encerradas em um balanceador de carga e que o balanceador de carga encaminha a solicitação para a nova interface do Edge usando HTTP. Se você encerrar o TLS no balanceador de carga, a nova interface do Edge ainda precisará saber que a solicitação original chegou pelo TLS. Por exemplo, alguns cookies têm uma flag segura definida. É necessário definir `MANAGEMENT_UI_SCHEME` como "https" ou `MANAGEMENT_UI_TLS_OFFLOAD` será ignorado: MANAGEMENT_UI_SCHEME=https MANAGEMENT_UI_TLS_OFFLOAD=y	Sim
`MANAGEMENT_UI_TLS_KEY_FILE` `MANAGEMENT_UI_TLS_CERT_FILE`	Se `MANAGEMENT_UI_TLS_OFFLOAD=n`, especifica o caminho absoluto para os arquivos de chave e certificado TLS. Os arquivos precisam ser formatados como arquivos PEM com sem senha e precisam ser de propriedade do usuário "apigee". O local recomendado para esses arquivos é: /opt/apigee/customer/application/edge-management-ui Crie o diretório caso ele não exista. Se `MANAGEMENT_UI_TLS_OFFLOAD=y`, omita `MANAGEMENT_UI_TLS_KEY_FILE` e `MANAGEMENT_UI_TLS_CERT_FILE`. Eles são ignorados porque as solicitações para a nova interface do Edge chegam por HTTP.	Sim, se `MANAGEMENT_UI_TLS_OFFLOAD=n`
`MANAGEMENT_UI_PUBLIC_URIS`	Se `MANAGEMENT_UI_TLS_OFFLOAD=n`, especifica o URL da nova interface do Edge. Defina essa propriedade com base em outras propriedades no arquivo de configuração. Exemplo: MANAGEMENT_UI_PUBLIC_URIS=`$MANAGEMENT_UI_SCHEME://$MANAGEMENT_UI_IP:$MANAGEMENT_UI_PORT` Em que: `MANAGEMENT_UI_SCHEME` especifica o protocolo, "http" ou "https", conforme descrito acima. `MANAGEMENT_UI_IP` especifica o endereço IP ou o nome DNS da nova interface do Edge. `MANAGEMENT_UI_PORT` especifica a porta usada pela nova interface do Edge. Consulte Configurar a nova interface do Edge para mais informações sobre essas propriedades. Se `MANAGEMENT_UI_TLS_OFFLOAD=y`: `MANAGEMENT_UI_IP` especifica o endereço IP ou o nome DNS do balanceador de carga, não da nova interface do Edge. O balanceador de carga e a nova interface do Edge precisam usar o mesmo número de porta para solicitações, por exemplo, 3001. Use `MANAGEMENT_UI_PORT` para especificar o número da porta no balanceador de carga e na nova interface do Edge.	Sim
`MANAGEMENT_UI_TLS_ALLOWED_CIPHERS`	Define a lista de cifras TLS disponíveis como uma string separada por vírgulas ou espaços. String separada por vírgulas: MANAGEMENT_UI_TLS_ALLOWED_CIPHERS=TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384,TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 String separada por espaços entre aspas duplas: MANAGEMENT_UI_TLS_ALLOWED_CIPHERS="TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384 TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256"

Configurar a TLS

Para configurar o acesso TLS à nova interface do Edge:

Gere o certificado e a chave TLS como arquivos PEM sem senha. Exemplo:
```
mykey.pem
mycert.pem
```
Há muitas maneiras de gerar um certificado e uma chave TLS. Por exemplo, execute o comando a seguir para gerar um certificado e uma chave não assinados:
```
openssl req -x509 -newkey rsa:4096 -keyout mykey.pem -out mycert.pem -days 365 -nodes -subj '/CN=localhost'
```
Observação: normalmente, não é possível usar um certificado e uma chave não assinados em um ambiente de produção.
Copie os arquivos de chave e certificado para o diretório /opt/apigee/customer/application/edge-management-ui. Crie o diretório caso ele não exista.
Verifique se o certificado e a chave são de propriedade do usuário "apigee":
```
chown apigee:apigee /opt/apigee/customer/application/edge-management-ui/*.pem
```

Edite o arquivo de configuração usado para instalar a nova interface do Edge para definir as seguintes propriedades TLS:

# Set to https to enable TLS.
MANAGEMENT_UI_SCHEME=https 
# Do NOT terminate TLS on a load balancer.
MANAGEMENT_UI_TLS_OFFLOAD=n

# Specify the key and cert. 
MANAGEMENT_UI_TLS_KEY_FILE=/opt/apigee/customer/application/edge-management-ui/mykey.pem
MANAGEMENT_UI_TLS_CERT_FILE=/opt/apigee/customer/application/edge-management-ui/mycert.pem

# Leave these properties set to the same values as when you installed the New Edge UI:
MANAGEMENT_UI_PUBLIC_URIS=$MANAGEMENT_UI_SCHEME://$MANAGEMENT_UI_IP:$MANAGEMENT_UI_PORT

Execute o comando a seguir para configurar o TLS:
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui configure-ssl -f configFile
```
Em que configFile é o nome do arquivo de configuração.

O script reinicia a nova interface do Edge. Após a reinicialização, a nova interface do Edge oferece suporte ao acesso por HTTPS. Se não for possível fazer login na nova interface do Edge após ativar o TLS, limpe o processo de cache do navegador e tente fazer login novamente.

Configurar a nova interface do Edge quando o término de TLS ocorre no balanceador de carga

Se você tiver um balanceador de carga que encaminha solicitações para a nova interface do Edge, poderá encerrar a conexão TLS no balanceador de carga e, em seguida, fazer com que o balanceador de carga encaminhe solicitações para a nova interface do Edge por HTTP:

Diagrama de arquitetura mostrando o término de TLS em um balanceador de carga que encaminha solicitações HTTP para a New Edge UI (edge-management-ui) na porta 3001

Essa configuração é compatível, mas é necessário configurar o balanceador de carga e a nova interface do Edge de acordo.

Para configurar a nova interface do Edge quando o término de TLS ocorre no balanceador de carga:

Edite o arquivo de configuração usado para instalar a nova interface do Edge para definir as seguintes propriedades TLS:

# Set to https to enable TLS
MANAGEMENT_UI_SCHEME=https
# Terminate TLS on a load balancer
MANAGEMENT_UI_TLS_OFFLOAD=y
# Set to the IP address or DNS name of the load balancer.
MANAGEMENT_UI_IP=LB_IP_DNS
# Set to the port number for the load balancer and New Edge UI.
# The load balancer and the New Edge UI must use the same port number.
MANAGEMENT_UI_PORT=3001

# Leave these properties set to the same values as when you installed the New Edge UI:
MANAGEMENT_UI_PUBLIC_URIS=$MANAGEMENT_UI_SCHEME://$MANAGEMENT_UI_IP:$MANAGEMENT_UI_PORT

Se você definir MANAGEMENT_UI_TLS_OFFLOAD=y, omita MANAGEMENT_UI_TLS_KEY_FILE e MANAGEMENT_UI_TLS_CERT_FILE. Eles são ignorados porque as solicitações para a nova interface do Edge chegam por HTTP.

Execute o comando a seguir para configurar o TLS:
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui configure-ssl -f configFile
```
Em que configFile é o nome do arquivo de configuração.

O script reinicia a nova interface do Edge. Após a reinicialização, a nova interface do Edge oferece suporte ao acesso por HTTPS pelo balanceador de carga. Se não for possível fazer login na nova interface do Edge após ativar o TLS, limpe o processo de cache do navegador e tente fazer login novamente.

Desativar o TLS na nova interface do Edge

Para desativar o TLS na nova interface do Edge:

Edite o arquivo de configuração usado para instalar a nova interface do Edge para definir a seguinte propriedade TLS:

OBSERVAÇÃO:ao desativar o TLS, é necessário transmitir o arquivo de configuração completo usado para instalar a nova interface do Edge.
```
# Set to http to disable TLS.
MANAGEMENT_UI_SCHEME=http

# Only if you had terminated TLS on a load balancer,
# reset to the IP address or DNS name of the New Edge UI.
MANAGEMENT_UI_IP=edge_UI_IP_DNS
```
Execute o comando a seguir para desativar o TLS:
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-ui configure-ssl -f configFile
```
Em que configFile é o nome do arquivo de configuração.

O script reinicia a nova interface do Edge. Agora é possível acessar a nova interface do Edge por HTTP. Se não for possível fazer login na nova interface do Edge após desativar o TLS, limpe o processo de cache do navegador e tente fazer login novamente.