Notas de lançamento do Edge para nuvem privada 4.51.00

Você está lendo 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 de lançamento 4.51.00 do Edge para nuvem privada.

Resumo da versão

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

Novos recursos

Esta versão inclui os novos recursos a seguir:

○ Uma nova janela pop-up avisa sobre as datas de fim da vida útil (EOL)
○ Opção de desconectar os usuários quando as senhas deles forem alteradas
○ Definir a versão do TLS para SMTP
○ Adição de um script pg-data-purge aprimorado para limpar opcionalmente dados de tabelas de fatos pai
○ 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 da Apigee (logon único).
  • Devido à correção do problema 132443137 (conforme descrito nas notas de lançamento da nuvem pública 19.03.01), os processadores de mensagens agora ignoram cabeçalhos que começam com X-Apigee-*. Como resultado, é necessário refatorar qualquer código que use cabeçalhos X-Apigee-* e substituí-los por outros compatíveis.
  • O nome dos arquivos de registro do Cassandra mudou. Agora é:

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

Desde o lançamento anterior do recurso 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 o lançamento da versão 4.51.00:

  • 4.19.06:: a versão 4.19.06 da 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 da interface do Edge, do Edge Management 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 para nuvem privada vão começar a ver mensagens de aviso seis meses antes da data de EOL da versão instalada. A mensagem de fim da vida útil será mostrada uma vez por sessão do navegador: se você fechar a guia ou o navegador, a sessão será perdida. Se você reabrir a Apigee em um navegador, a mensagem será exibida novamente.

Nova opção para desconectar usuários quando as senhas são alteradas

Uma nova flag foi adicionada ao apigee.feature.clearSessionOnPasswordUpdate, que permite configurar se os usuários serão desconectados depois que você mudar a senha deles. Por padrão, os usuários não são desconectados.

Nova flag para definir a versão do TLS para 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.

Adição de suporte a novas versões de software

A Apigee agora é compatível com as seguintes versões de software:

Configurar o proxy de encaminhamento.

As flags a seguir 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 ficam vazios.

Script pg-data-purge aprimorado para limpar tabelas de fatos pai do Analytics

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 vai excluir dados mais antigos que os dias de retenção da tabela de fatos pai.
  • skip-prompt. Padrão: No. Se No, o script vai solicitar confirmação antes de excluir dados do fato pai. Defina como "Yes" se o script de limpeza for automatizado.

Opção para alterar 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".

Software compatível

Esta versão inclui as seguintes mudanças no software compatível:

Suporte adicionado Indisponíveis

Esta versão é compatível com as seguintes versões de software:

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

As seguintes versões de software 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 uma lista completa de plataformas compatíveis, consulte Software e versões compatíveis.

Correções de bugs

Nesta seção, listamos os bugs da nuvem privada que foram corrigidos nesta versão. Além disso, esta versão inclui todas as correções de bugs nas versões da IU do Edge, 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 de KVM direcionadas 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 alterar os detalhes de conexão do Postgres para o servidor de gerenciamento do Mint. Consulte Como lidar com um failover de banco de dados PostgreSQL.
150844280

Sem uma conexão de Internet, o SSO da 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 fonte Noto Sans.
161351690

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

A política agora é exibida no seletor de políticas.
168149141

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

Alguns problemas em potencial devido a uma disputa durante a instalação do servidor de gerenciamento do Mint 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, é possível configurar o rótulo do usuário na página de login. O padrão é o rótulo atual, ou seja, Endereço de e-mail..
170791446

Na interface de 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 Management Server não aparecia 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

Adicionamos suporte para o AWS Linux 2.
175942835

As solicitações GET para dailysummaryreports estavam sendo permitidas sem proteção contra CSRF

Isso já foi corrigido.
178305317

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

Isso já 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 melhor 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.

Adicionamos uma configuração geral (conf_http_HTTPHeader.{ANY}) para controlar o comportamento padrão de valores múltiplos e duplicados 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 nem sempre se conectava 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 melhoradas. Isso simplifica a solução de problemas.

183147699

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

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

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

Esse recurso é desativado por padrão, então os e-mails de desenvolvedores continuam diferenciando maiúsculas de minúsculas (o comportamento atual).
189743303

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

Corrigimos 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 estava ativado

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

Ao criar um fluxo compartilhado na IU do Edge, a IU retornava 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 de JMX do Cassandra para que as configurações sigam outros padrões de configuração da Apigee e as alterações 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 formatados incorretamente no arquivo .properties de um componente estavam impedindo que ele fosse iniciado

Isso foi corrigido.
161934168

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

Isso foi corrigido.
185115206

Melhorias para otimizar o desempenho das consultas de análise no servidor de gerenciamento

193870176

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

197331224

A organização de recebimento retornará um erro 403-unauthorized em vez de 404-not found se a organização não estiver presente.

184573211

As Java Management Extensions (JMX) não são mais ativadas por padrão para o módulo de SSO da Apigee.

Problemas de segurança corrigidos

Veja 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 do 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 sites (XSS) no jQuery. Uma vulnerabilidade no jQuery que relatava scripting em vários sites (XSS) foi corrigida.

CVE-2016-5388

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

Problemas conhecidos

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

ID do problema Descrição
194249507

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

Como solução alternativa, instale o apigee-mirror em um servidor que execute uma versão anterior do RHEL ou outro sistema operacional compatível com a Apigee. Em seguida, use o espelho para adicionar pacotes, mesmo que tenha instalado a Apigee em servidores RHEL 8.0.

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

Próxima etapa

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

Novas instalações:

Visão geral da nova instalação

Instalações existentes

Atualize a Apigee Edge 4.19.06 ou 4.50.00 para 4.51.00.