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

Esta é a documentação do Apigee Edge.
Acesse Documentação da Apigee X.
informações

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

Observação:essa versão 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 a partir da anterior e a nova versão do Edge para nuvem privada. Se precisar atualizar de uma versão anterior, consulte Como aplicar várias versões de patch.

Atualizar esta versão vai atualizar os componentes da 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
.

Você pode verificar as versões de RPM instaladas atualmente precisam ser atualizados, inserindo:

apigee-all version

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

  1. Em todos os nós do Edge:

    1. Limpe o repositório do Yum:
      sudo yum clean all
    2. Baixe o arquivo bootstrap_4.52.00.sh do Edge 4.52.00 mais recente 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 a 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 do Edge, execute o script update.sh para o processo do Edge:
    /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

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 para nuvem privada.
ID do problema Descrição
279065506 No URL de redirecionamento para OAuth2, a entropia do parâmetro de estado foi melhorada para ser imprevisível e evitar a vulnerabilidade de falsificação de solicitações entre sites (CSRF, na sigla em inglês).",
279065586 Políticas de segurança de conteúdo adicionadas ao cabeçalho para fornecer uma camada adicional de segurança contra ataques do lado do cliente.

Mudanças no software com suporte

Agora as seguintes versões do software são compatíveis:

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

Consulte Edge para software com suporte a nuvem privada (em inglês) para conferir a lista completa desses softwares.

Descontinuações e descontinuações

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

Novos recursos

Esta versão introduz os seguintes novos recursos:

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

Com esta versão, você pode limitar o número máximo de caracteres para o organização e nomes de ambiente ao criar uma nova organização ou ambiente. A o valor padrão para o número máximo de caracteres é 255. Para definir um valor máximo mais baixo, defina as seguintes propriedades no respectivo arquivo de propriedades:

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

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

Definir a expiração dos tokens de acesso

Com essa versão, é possível definir a expiração dos tokens de acesso configurando a propriedade conf_keymanagement_oauth_access_token_expiry_time_in_millis até o valor desejado o prazo de validade em milissegundos. Esse recurso fica desativado por padrão. Para ativá-lo, defina De conf_keymanagement_oauth_access_token_is_apply_limit a true no processador de mensagens.

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

Correções de bugs

Nesta seção, listamos os bugs da nuvem privada que foram corrigidos nesta versão.

ID do problema Descrição
290242749

Quando a variável ServiceCallout.response foi usada no DataMasking, políticas não estavam visíveis no trace.

Isso foi corrigido.
260397807

Um problema nos modelos de e-mail impediu o envio de caracteres de vários bytes na mensagem.

Isso foi corrigido.
234544436

Ocorria 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 estavam sendo atualizadas automaticamente nos nós do servidor de gerenciamento.

Isso foi corrigido.
261616264

Inclusão de uma verificação de inicialização para garantir que o postgresql não seja removido/excluído durante o processo de upgrade.

279065586

No URL de redirecionamento para OAuth2, a entropia do parâmetro state foi melhorada imprevisível e evitar a vulnerabilidade de falsificação de solicitações entre sites (CSRF, na sigla em inglês).

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 o erro <code<create< do Postgresql code=&quot;&quot; dir=&quot;ltr&quot; translate=&quot;no&quot;&gt; que as consultas falhem.</code<create<>

Isso foi corrigido com melhorias no tratamento dos conflitos de nomes de índice postgres para organizações longas. e nomes de ambientes.
293733533

A biblioteca de terceiros Spring no Edge Os componentes de gateway foram atualizados da versão 5.3.20 para a versão 5.3.27.

294363158

Uma regressão estava fazendo com que algumas dimensões extras aparecessem nos menus suspensos do as 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

Problemas conhecidos

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

Como 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 patch anterior;

Cada versão de patch contém atualizações de componentes específicos do Edge para nuvem privada, como: edge-management-server: Para aplicar várias versões de patch, é preciso atualizar cada componente do Edge incluído uma versão de patch mais recente que a instalada atualmente. Você pode encontrar esses componentes consulte as notas da versão da nuvem privada no Edge para todas as versões posteriores à sua e verificando a lista de RPMs dessas versões. Consulte Notas de lançamento da Apigee para links para todos Notas de lançamento do Edge para nuvem privada.

Observação: você só precisa atualizar cada componente uma vez, instalando a RPM para a versão mais recente do componente incluído nas versões de patch. Siga as instruções na notas da versão para atualizar o componente.

Observação: o upgrade de um componente instala automaticamente a versão de patch mais recente de um componente. Se quiser fazer upgrade para uma versão de patch que não é a mais recente, você precisa manter a sua tarball do repositório da Apigee usando o espelho da Apigee e usá-lo para instalações da Apigee. Para mais informações, consulte Usar um repositório local do Edge para manter a versão do Edge