Notas de lançamento do Edge para nuvem privada 4.51.00

Você está vendo a documentação do Apigee Edge.
Acesse a documentação da Apigee X.
informações

Em 29 de julho de 2021, lançamos a versão 4.51.00 do recurso 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 útil (EOL)
○ Opção para desconectar usuários quando as senhas deles forem alteradas
○ Definir a versão do TLS para SMTP
○ Foi adicionado um script pg-data-purge aprimorado para, opcionalmente, limpar dados de tabelas de fatos pai.
○ Adição do sosreport, uma nova ferramenta de diagnóstico e coleta de dados no 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 Java (JMX, na sigla em inglês) não são mais ativadas por padrão para o módulo SSO da Apigee (Logon único).
  • Devido à correção do problema 132443137 (conforme descrito nas notas da versão 19.03.01 do Public Cloud), os processadores de mensagens agora ignoram os 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 cabeçalhos compatíveis.
  • O nome dos arquivos de registro do Cassandra foi alterado. Agora ele é:

    /opt/apigee/var/log/apigee-cassandra/system.log
Lançamentos incluídos

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

○ Edge:
   20.08.03 (roteador)
   20.09.18 (servidor de gerenciamento)
   21.03.08 (roteador, servidor de gerenciamento, processador de mensagens)
Aposentadoria Nenhum
Descontinuações

Com o lançamento da versão 4.51.00:

  • 4.19.06: a versão 4.19.06 do Apigee Edge para nuvem privada agora está obsoleta.

Para informações mais detalhadas sobre as descontinuações, incluindo os cronogramas de remoção, consulte Suspensões e descontinuaçõ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 a nuvem privada 4.51.00, consulte Atualizar o Apigee Edge 4.19.06 ou 4.50.00 para a versão 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 nas versões do Edge UI, Edge Management e 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 começarão a ver mensagens de aviso exibidas seis meses antes da data de EOL da versão instalada. A mensagem de EOL 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á mostrada novamente.

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

Uma nova sinalização foi adicionada a apigee.feature.clearSessionOnPasswordUpdate, o que permite configurar se os usuários serão desconectados depois que você alterar a senha. O padrão é que os usuários não sejam desconectados.

Nova sinalização para definir a versão do TLS para o SMTP

Uma nova sinalização 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.

É possível definir essa flag adicionando 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

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

Adição de compatibilidade com novas versões de software

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

Configurar proxy de encaminhamento.

As flags a seguir foram adicionadas, permitindo que você configure um proxy de encaminhamento:

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

Por padrão, os valores das sinalizações estão vazios.

Aprimoramento do script pg-data-purge para limpar as tabelas de fatos pais 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 vai excluir dados anteriores a dias de retenção da tabela de fatos mãe.
  • skip-prompt. Padrão: não. Se não, o script solicitará uma confirmação antes de excluir dados do fato pai. Defina como "Sim" se o script de limpeza for automatizado.

Opção para mudar o identificador do usuário na página de login

Uma nova sinalização, apigee.feature.customLoginUserLabel, permite que você configure 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 em softwares com suporte:

Suporte adicionado Não há mais suporte

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

  • Red Hat Enterprise Linux (Firebase) 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 seguintes versões de software não são mais compatíveis com esta versão:

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

Para ver uma lista completa das 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 do Edge UI, Edge Management e Portal mostradas em Versões incluídas.

Id do problema Descrição
112262604

O Mint Management Server precisa ser atualizado quando o failover do Postgres for realizado

Um script aprimorado foi criado para alterar os detalhes da conexão do Postgres para o Mint Management Server. Consulte Como gerenciar um failover de banco de dados do 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 de HMAC não apareceu no seletor de políticas.

Agora a política é exibida no seletor de políticas.
168149141

Falha na instalação da monetização no segundo servidor de gerenciamento.

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

Não foi possível alterar o marcador do usuário na página de login

Uma nova flag foi adicionada a apigee.feature.customLoginUserLabel. Com essa sinalização, é possível configurar o rótulo do usuário na página de login. O padrão é o identificador atual, ou seja, Endereço de e-mail...
170791446

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

Isso foi corrigido.
173657467

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

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

O AWS Linux 1 está sendo descontinuado

Foi adicionado suporte para o AWS Linux 2.
175942835

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

Isso foi corrigido
178305317

O cliente de conexão do Consul não estava usando todos os servidores do Consul disponíveis para o 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 retornará uma mensagem de erro aprimorada se uma propriedade CASS_HOSTS incorreta for fornecida.
186503861

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

Adição de 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 uma configuração de cabeçalho específica não estiver presente.
182456858

O servidor de gerenciamento nem sempre se conectava ao servidor Postgress 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

Melhoria das mensagens de registro quando o Message Processor atinge o limite de conexões. Isso simplifica a solução de problemas.

183147699

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

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

Um recurso opcional foi adicionado para que os e-mails dos desenvolvedores não diferenciam maiúsculas de minúsculas.

Esse recurso é desativado por padrão, então os e-mails dos 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 ou o SSL do Cassandra JMX foi ativado

Adicionado recurso para fornecer a autenticação Cassandra JMX e as 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 retornava um erro 403 por permissões insuficientes.

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

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

188526117

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

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

Números incorretos no arquivo .properties de um componente causavam falha na inicialização do componente

Isso foi corrigido.
161934168

Vulnerabilidade de design do protocolo PostgreSQL PassTheHash, do PostgreSQL para o Postgres v10.17 (link em inglês)

Isso foi corrigido.
185115206

Fizemos melhorias para melhorar o desempenho das consultas de análise no servidor de gerenciamento

193870176

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

197331224

Get org retornaria o erro 403-não autorizado em vez de 404-not found se a organização não estivesse presente.

184573211

O Java Management Extensions (JMX) não está mais ativado por padrão no módulo 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 da nuvem privada do Edge.

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. Corrigimos uma vulnerabilidade no jQuery que informava scripting em vários locais (XSS).

CVE-2016-5388

Vulnerabilidade no stub do Tomcat. O webinar 8.0.53 do Tomcat tinha uma vulnerabilidade de segurança. A atualização do stub do Tomcat para a versão 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 (Ela) 8.0.

Como solução alternativa, instale apigee-mirror em um servidor executando uma versão anterior do AOSP ou outro sistema operacional compatível com a Apigee. Em seguida, é possível usar o espelho para adicionar pacotes mesmo que você tenha instalado a Apigee nos servidores do RM 8.0.

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

Próxima etapa

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

Novas instalações:

Nova visão geral da instalação

Instalações atuais

Atualize o Apigee Edge 4.19.06 ou 4.50.00 para 4.51.00.