4.52.00.03 - Notas da versão do Edge para nuvem privada

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

Em 25 de outubro de 2023, lançamos uma nova versão do Apigee Edge para Private Cloud.

Observação:essa versão vai ter suporte até 25 de outubro de 2024.

Procedimento de atualização

Esta seção descreve como instalar esta versão se você estiver atualizando da versão anterior do Edge para nuvem privada. Se você precisar atualizar de uma versão anterior, consulte Como aplicar várias versões de patch.

A atualização desta versão vai atualizar os componentes na seguinte lista de RPMs:

  • edge-gateway-4.52.00-0.0.60200.noarch.rpm
  • edge-management-server-4.52.00-0.0.60200.noarch.rpm
  • edge-message-processor-4.52.00-0.0.60200.noarch.rpm
  • edge-postgres-server-4.52.00-0.0.60200.noarch.rpm
  • edge-qpid-server-4.52.00-0.0.60200.noarch.rpm
  • edge-router-4.52.00-0.0.60200.noarch.rpm
  • apigee-sso-4.52.00-0.0.21316.noarch.rpm
  • edge-analytics-4.52.00-0.0.40100.noarch.rpm
  • edge-management-ui-4.52.00-0.0.20029.noarch.rpm
  • edge-ui-4.52.00-0.0.20233.noarch.rpm
  • apigee-service-4.52.00-0.0.1500.noarch.rpm
  • apigee-mirror-4.52.00-0.0.1032.noarch.rpm
  • apigee-tomcat-9.0.82-0.0.939.noarch.rpm
  • apigee-configutil-4.52.00-0.0.624.noarch.rpm

Para verificar se as versões do RPM instaladas precisam ser atualizadas, insira:

apigee-all version

Para atualizar a instalação, siga este procedimento nos nós de borda:

  1. Em todos os nós de borda:

    1. Limpe os repositórios do Yum:
      sudo yum clean all
    2. Faça o download do arquivo bootstrap_4.52.00.sh mais recente do Edge 4.52.00 para /tmp/bootstrap_4.52.00.sh:
      curl https://software.apigee.com/bootstrap_4.52.00.sh -o /tmp/bootstrap_4.52.00.sh
    3. Instale o utilitário apigee-service e as dependências do Edge 4.52.00:
      sudo bash /tmp/bootstrap_4.52.00.sh apigeeuser=uName apigeepassword=pWord

      em que uName e pWord são o nome de usuário e a senha que você recebeu da Apigee. Se você omitir pWord, será solicitado que você o insira.

    4. Use o comando source para executar o script apigee-service.sh:
      source /etc/profile.d/apigee-service.sh
  2. Em todos os nós de borda, execute o script update.sh para o processo de borda:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  3. Execute o script update.sh para SSO em todos os nós:
  4. /opt/apigee/apigee-setup/bin/update.sh -c sso -f configFile
  5. Em todos os nós da interface, execute o script update.sh para a interface:
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  6. Se você estiver usando a nova experiência do Edge, execute o seguinte comando:
    /opt/apigee/apigee-setup/bin/update.sh -c ue -f configFile

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 do Edge para nuvem privada.
ID do problema Descrição
279065506 No URL de redirecionamento do OAuth2, a entropia do parâmetro de estado foi aprimorada para torná-lo imprevisível e evitar a vulnerabilidade de falsificação de solicitações entre sites (CSRF).",
279065586 Adicionamos políticas de segurança de conteúdo no cabeçalho para oferecer uma camada extra de segurança para sites contra ataques do lado do cliente.

Mudanças no software compatível

Adicionamos suporte para as seguintes versões de software:

  • Red Hat Enterprise Linux (Intel 64 bits): versão 8.8
  • Oracle Linux (Intel 64 bits): versões 7.9, 8.7 e 8.8
  • Rocky Linux 8
  • Tomcat 9.0.82

Consulte Software compatível com o Edge para nuvem privada para uma lista completa de softwares compatíveis.

Descontinuações e desativações

Não há novas descontinuações ou desativações nesta versão.

Novos recursos

Esta versão inclui os seguintes recursos novos:

Definir o número máximo de caracteres para nomes de organizações e ambientes

Com esse lançamento, é possível limitar o número máximo de caracteres para os nomes da organização e do ambiente ao criar uma organização ou um ambiente. O valor padrão para o número máximo de caracteres é 255. Para definir um máximo menor, defina as seguintes propriedades no arquivo de propriedades respectivo:

  • No arquivo de propriedades da organização, defina org.name.max.length.
  • No arquivo de propriedades da organização, defina env.name.max.length.

Se uma dessas propriedades for definida como um valor menor que 0 ou maior que 255, o sistema usará um valor máximo de 1 ou 255, respectivamente.

Definir a validade dos tokens de acesso

Com essa versão, é possível definir a expiração dos tokens de acesso definindo a propriedade conf_keymanagement_oauth_access_token_expiry_time_in_millis como o tempo de expiração desejado em milissegundos. Esse recurso fica desativado por padrão. Para ativar, defina conf_keymanagement_oauth_access_token_is_apply_limit como true no processador de mensagens.

Com esse recurso, os administradores da Apigee têm mais controle sobre a expiração dos tokens de acesso criados na Apigee.

Correções de bugs

Esta seção lista os bugs da nuvem privada corrigidos nesta versão.

ID do problema Descrição
290242749

Quando a variável ServiceCallout.response era usada em DataMasking, as políticas não ficavam visíveis no rastreamento.

Isso foi corrigido.
260397807

Um problema nos modelos de e-mail impedia o envio de caracteres multibyte por e-mail.

Isso foi corrigido.
234544436

Havia um problema em que o menu à esquerda desaparecia ao mudar de organização na nova interface do Edge.

Isso foi corrigido.
293268203

As dependências do Analytics não eram atualizadas automaticamente nos nós do servidor de gerenciamento.

Isso foi corrigido.
261616264

Adicionada verificação de bootstrap para garantir que o PostgreSQL não seja removido/excluído durante o processo de upgrade.

279065586

No URL de redirecionamento do OAuth2, a entropia do parâmetro de estado foi melhorada para torná-lo imprevisível e evitar a vulnerabilidade de falsificação de solicitações entre sites (CSRF).

283310836

A mensagem de erro ao analisar XMLs grandes foi aprimorada.

245936798

Um problema com os nomes da organização e do ambiente estava causando falhas nas consultas do Postgresql <code<create< code="" dir="ltr" translate="no"> .</code<create<>

Isso foi corrigido com o melhor tratamento de conflitos de nomes de índice do postgres para nomes longos de organizações e ambientes.
293733533

A biblioteca de terceiros do Spring nos componentes do gateway do Edge foi atualizada da versão 5.3.20 para a 5.3.27.

294363158

Uma regressão estava fazendo com que algumas dimensões extras aparecessem nos menus suspensos das páginas de análise e monitoramento da interface do Edge.

Isso foi corrigido.
297889765

Os artefatos gerados pelo apigee-mirror agora têm a propriedade correta.

294989027

Melhoria na performance de algumas APIs do Google Analytics.

Problemas conhecidos

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

Aplicar várias versões de patch

Esta seção descreve como aplicar várias versões de patch, caso você esteja atualizando de uma versão do Edge para nuvem privada anterior à versão de lançamento patch anterior.

Cada versão de patch contém atualizações para componentes específicos do Edge para nuvem privada, como edge-management-server. Para aplicar várias versões de patch, é necessário atualizar cada componente do Edge incluído em uma versão de patch posterior à versão instalada no momento. Para encontrar esses componentes, consulte as notas da versão do Edge para nuvem privada de todas as versões posteriores à sua versão atual e verifique a lista de RPMs dessas versões. Consulte as Notas da versão da Apigee para links de todas as notas da versão do Edge para nuvem privada.

Observação:só é necessário atualizar cada componente uma vez, instalando o RPM da versão mais recente do componente incluído nas versões de patch. Siga as instruções nas notas da versão para atualizar o componente.

Observação:ao fazer upgrade de um componente, a versão mais recente do patch de um componente é instalada automaticamente. Se você quiser fazer upgrade para uma versão de patch que não seja a mais recente, mantenha sua própria cópia tarball do repositório da Apigee usando o espelho da Apigee e use esse espelho para instalações da Apigee. Para mais informações, consulte Usar um repositório local do Edge para manter sua versão do Edge.