Notas de lançamento do Edge para nuvem privada 4.51.00

Você está visualizando a documentação do Apigee Edge.
Acesse a documentação da Apigee X.
info

Em 29 de julho de 2021, lançamos a versão 4.51.00 do lançamento de recursos do Edge para nuvem privada.

Resumo da versão

A tabela a seguir resume as mudanças desta versão:

Novos recursos

Esta versão inclui os novos recursos a seguir:

○ Uma nova janela pop-up avisa sobre as datas de fim de vida (EOL)
○ Opção para sair dos usuários quando as senhas são alteradas
○ Definir a versão TLS para SMTP
○ Adição de um script pg-data-purge aprimorado para limpar dados de tabelas de fatos pai, opcionalmente
○ Adição do sosreport, uma nova ferramenta de diagnóstico e coleta de dados no nível do sistema.

Para mais informações sobre cada um desses novos recursos, consulte Novos recursos.

Compatibilidade com versões anteriores

Os seguintes problemas que afetam a compatibilidade com versões anteriores foram introduzidos nesta versão do Apigee Edge para nuvem privada:

  • As extensões de gerenciamento do Java (JMX) não são mais ativadas por padrão para o módulo de SSO do Apigee (logon único).
  • Devido à correção do problema 132443137 (conforme descrito nas notas da versão da Nuvem Pública 19.03.01), os processadores de mensagens agora ignoram cabeçalhos que começam com X-Apigee-*. Como resultado, você precisa refatorar qualquer código que use cabeçalhos X-Apigee-* e substituí-los por cabeçalhos com suporte.
  • O nome dos arquivos de registro do Cassandra foi alterado. Agora é:

    /opt/apigee/var/log/apigee-cassandra/system.log
Versões incluídas

Desde a versão anterior do recurso do Edge para nuvem privada, as seguintes versões foram lançadas e estão incluídas nesta versão:

○ Edge:
   20.08.03 (roteador)
   20.09.18 (servidor de gerenciamento)
   21.03.08 (roteador, servidor de gerenciamento, processador de mensagens)
Desativações Nenhum
Suspensões de uso

Com a versão 4.51.00:

  • 4.19.06::a versão 4.19.06 do Apigee Edge para nuvem privada foi descontinuada.

Para informações mais detalhadas sobre as descontinuações, incluindo cronogramas de remoção, consulte Descontinuações e desativações da Apigee.

Problemas conhecidos

Esta versão inclui os seguintes problemas conhecidos:

Para mais informações sobre cada um desses problemas conhecidos, incluindo soluções alternativas, consulte Problemas conhecidos.

Caminhos de upgrade

Para instruções sobre como fazer upgrade para o Edge para nuvem privada 4.51.00, consulte Atualizar o Apigee Edge 4.19.06 ou 4.50.00 para 4.51.00.

Novos recursos

Esta seção lista os novos recursos desta versão. Além disso, esta versão inclui todos os recursos das versões da interface do Edge, do gerenciamento do Edge e do Portal listados em Versões incluídas.

Além das melhorias a seguir, esta versão também contém várias melhorias de usabilidade, desempenho, segurança e estabilidade.

Uma nova janela pop-up avisa sobre as datas de fim de vida útil (EOL) do Edge para nuvem privada

Os clientes do Edge for Private Cloud vão começar a receber mensagens de aviso seis meses antes da data de EOL da versão instalada. A mensagem de EOL vai aparecer uma vez por sessão do navegador: se você fechar a guia ou o navegador, a sessão será perdida. Se você reabrir o Apigee em um navegador, a mensagem vai aparecer novamente.

Nova opção para fazer logout dos usuários quando as senhas são alteradas

Uma nova flag foi adicionada a apigee.feature.clearSessionOnPasswordUpdate, que permite configurar se os usuários serão desconectados após a alteração da senha. O padrão é que os usuários não sejam desconectados.

Nova flag para definir a versão TLS do SMTP

Uma nova flag foi adicionada a mail.smtp.ssl.protocols, que especifica o protocolo SSL ativado para conexões SMTP. Esse recurso permite configurar protocolos SSL com base nos seus requisitos de segurança.

Para definir essa flag, adicione a seguinte entrada ao arquivo de propriedades, /opt/apigee/customer/application/ui.properties:

conf_apigee.mail.smtp.ssl.protocols=ssl-protocol

Os valores possíveis para ssl-protocol são SSLv2Hello, SSLv3, TLSv1, TLSv1.1 e TLSv1.2.

Nova ferramenta de diagnóstico, sosreport

Adicionamos o Sosreport, uma nova ferramenta de diagnóstico e coleta de dados no nível do sistema.

Foi adicionado suporte a novas versões de software

A Apigee adicionou suporte às seguintes versões de software:

Configure o proxy de encaminhamento.

As seguintes flags foram adicionadas para permitir a configuração de um proxy de encaminhamento:

  • http.proxyHost
  • http.proxyPort
  • http.proxyUser
  • http.proxyPassword

Por padrão, os valores das flags estão vazios.

O script pg-data-purge foi aprimorado para limpar tabelas de fatos principais da análise

Para executar o script, digite o seguinte comando:

/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql pg-data-purge org_name env_name number_of_days_to_retain [Delete-from-parent-fact - N/Y] [Confirm-delete-from-parent-fact - N/Y]

O script tem as seguintes opções:

  • Delete-from-parent-fact Padrão : não. Também exclui dados com mais de dias de retenção da tabela de fatos pai.
  • skip-prompt. Padrão: não. Se não, o script vai solicitar confirmação antes de excluir dados do fato pai. Defina como "Sim" se o script de limpeza for automatizado.

Opção para mudar o rótulo do usuário na página de login

Uma nova flag, apigee.feature.customLoginUserLabel, permite configurar o rótulo do usuário na página de login com base na preferência dele. O padrão é "Endereço de e-mail".

Softwares compatíveis

Esta versão inclui as seguintes alterações no software compatível:

Suporte adicionado Não é mais compatível

Esta versão oferece suporte às seguintes versões de software:

  • Red Hat Enterprise Linux (RHEL) 7.5, 7.6, 7.7, 7.8, 7.9 e 8.0
  • Amazon Linux AMI 2
  • Postgres 10.17
  • Nginx 1.20.1

As versões de software a seguir não são mais compatíveis com esta versão:

  • Red Hat Enterprise Linux (RHEL) 6.X
  • Amazon Linux AMI 1
  • Node.js 0.10.32

Para conferir uma lista completa de plataformas compatíveis, consulte Software e versões compatíveis.

Correções de bugs

Esta seção lista os bugs da nuvem particular corrigidos nesta versão. Além disso, esta versão inclui todas as correções de bugs na interface do Edge, nas versões do Edge Management e do Portal mostradas em Versões incluídas.

ID do problema Descrição
120421482

A criação de KVM agora inclui verificações adicionais para validar a existência do ambiente especificado.

As solicitações POST e GET do KVM com destino a ambientes inexistentes vão retornar um erro 404.
112262604

O servidor de gerenciamento do Mint precisa ser atualizado quando o failover do Postgres é realizado

Um script aprimorado foi criado para mudar os detalhes de conexão do Postgres para o servidor de gerenciamento do Mint. Consulte Como lidar com failover de um banco de dados PostgreSQL.
150844280

Sem uma conexão de Internet, o SSO do Apigee tentou fazer o download de uma biblioteca de fontes externa durante o login.

A fonte Google Sans para cabeçalhos, que não tem uma licença de código aberto, foi substituída pela Noto Sans.
161351690

A política HMAC não apareceu no seletor de políticas.

A política agora aparece no seletor de políticas.
168149141

A instalação da monetização estava falhando no segundo servidor de gerenciamento.

Alguns possíveis problemas devido a uma condição de disputa durante a instalação do Mint Management Server foram corrigidos.
170089960

Não é possível mudar o rótulo do usuário na página de login

Uma nova flag foi adicionada a apigee.feature.customLoginUserLabel. Com essa flag, você pode configurar o rótulo do usuário na página de login. O padrão é o rótulo existente, ou seja, Endereço de e-mail.
170791446

Na interface para desenvolvedores, um caractere proibido no endereço de e-mail do desenvolvedor impedia a edição dos detalhes do desenvolvedor.

Isso foi corrigido.
173657467

O servidor de gerenciamento não estava sendo iniciado se os nós do Cassandra em outros data centers estivessem inativos.

O script de ativação da autenticação do Cassandra foi aprimorado para evitar esse problema.
175638733

O AWS Linux 1 está sendo descontinuado

Foi adicionado suporte ao AWS Linux 2.
175942835

As solicitações GET para relatórios de resumo diários eram permitidas sem proteção CSRF

Isso foi corrigido
178305317

O cliente do Consul connect não estava usando todos os servidores do Consul disponíveis para failover automático

Isso foi corrigido
180207712

Os clientes não conseguiram adicionar novos nós do Cassandra devido à propriedade CASS_HOSTS incorreta.

A configuração do Cassandra agora retorna uma mensagem de erro melhorada se uma propriedade CASS_HOSTS incorreta for fornecida.
186503861

A política ServiceCallout estava dividindo incorretamente os valores do cabeçalho quando o elemento era usado.

Foi adicionada uma configuração geral (conf_http_HTTPHeader.{ANY}) para controlar o comportamento padrão de valores duplicados e de vários valores de todos os cabeçalhos. Essa configuração só será aplicada se a configuração de cabeçalho específica não estiver presente.
182456858

O servidor de gerenciamento não se conectava sempre ao servidor Postgres da região local.

O algoritmo de seleção do Postgres do servidor de gerenciamento foi otimizado para se conectar a um nó do Postgres na região local
182857918

As mensagens de registro quando o processador de mensagens atinge o limite de conexão foram aprimoradas. Isso simplifica a solução de problemas.

183147699

A expansão do cliente dc-4 falhou devido ao nome da região personalizada.

Uma nova propriedade, REGION_MAPPING, permite atribuir nomes de regiões personalizadas a nomes de regiões padrão (dc-1, dc2 etc.). Consulte a Referência do arquivo de configuração do Edge.
185285557

Adicionamos um recurso opcional para que os e-mails dos desenvolvedores não diferenciem maiúsculas de minúsculas.

Esse recurso fica desativado por padrão. Por isso, os e-mails dos desenvolvedores continuam sendo sensíveis a maiúsculas e minúsculas (o comportamento atual).
189743303

A API Google Analytics com filtro para excluir proxies de API estava retornando um erro.

Foi corrigido um problema com a análise de filtros durante a execução de relatórios personalizados.
171240470

A atualização de gerenciamento falhava quando a autenticação JMX do Cassandra ou o SSL estavam ativados

Recurso adicionado para fornecer autenticação JMX do Cassandra e configurações SSL ao executar a configuração ou atualização no servidor de gerenciamento.
168560804

Ao criar um fluxo compartilhado na interface do Edge, a interface estava retornando um erro 403 por permissões insuficientes.

Correção de um valor indefinido que estava sendo transmitido para a API.
171985727

Melhorias nas configurações JMX do Cassandra para que elas sigam outros padrões de configuração do Apigee e as mudanças não sejam substituídas durante o upgrade do Cassandra.

188526117

Um comando IP não foi prefixado com o caminho absoluto.

O caminho absoluto agora está incluído no comando.
123015330

Números com formato incorreto no arquivo .properties de um componente estavam causando falha na inicialização do componente

Isso foi corrigido.
161934168

Vulnerabilidade de design do protocolo PassTheHash do PostgreSQL para o Postgres v10.17

Isso foi corrigido.
185115206

Melhorias para melhorar a performance das consultas de análise no servidor de gerenciamento

193870176

Foi adicionada uma configuração no nível do roteador para desativar as opções de escuta de host virtual nas portas padrão 80 e 443.

197331224

A API Get org retornaria um erro 403 não autorizado em vez de 404 não encontrado se a organização não estivesse presente.

184573211

As extensões de gerenciamento Java (JMX) não são mais ativadas por padrão para o módulo de SSO do Apigee.

Problemas de segurança corrigidos

Confira a seguir uma lista de problemas de segurança conhecidos que foram corrigidos nesta versão. Para evitar esses problemas, instale a versão mais recente da Edge Private Cloud.

ID do problema Descrição
CVE-2018-16131

Vulnerabilidade: [Negação de serviço (DoS)] encontrada no projeto: unified-experience/navbar (SNYK-JAVA-COMTYPESAFEAKKA-32493). Isso foi corrigido.

CVE-2020-7676

Vulnerabilidade de scripting em vários locais (XSS) no jQuery. Uma vulnerabilidade no jQuery que informava sobre scripting em vários locais (XSS) foi corrigida.

CVE-2016-5388

Vulnerabilidade no servlet do Tomcat. O servlet do Tomcat 8.0.53 tinha uma vulnerabilidade de segurança. O upgrade do servlet Tomcat para 8.5.34 corrigiu essa vulnerabilidade.

Problemas conhecidos

A tabela a seguir lista os problemas conhecidos desta versão:

ID do problema Descrição
194249507

apigee-mirror não funciona no Red Hat Enterprise Linux (RHEL) 8.0.

Como solução alternativa, instale o apigee-mirror em um servidor com uma versão anterior do RHEL ou outro sistema operacional com suporte para a Apigee. Você pode usar o espelho para adicionar pacotes mesmo que tenha instalado o Apigee em servidores RHEL 8.0.

Consulte Problemas conhecidos com o Edge para nuvem privada para conferir uma lista completa de problemas conhecidos.

Próxima etapa

Para começar a usar o Edge para nuvem privada 4.51.00, use estes links:

Novas instalações:

Visão geral da nova instalação

Instalações atuais

Atualize o Apigee Edge 4.19.06 ou 4.50.00 para 4.51.00.