Esta página foi traduzida pela API Cloud Translation.

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

Você está vendo a documentação do Apigee Edge.
Acesse a 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:esta versão vai estar disponível até 25 de outubro de 2024.

Procedimento de atualização

Nesta seção, descrevemos como instalar esta versão se você estiver atualizando da versão anterior 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 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

Observação:sosreport, uma ferramenta de coleta de dados e diagnóstico no nível do sistema, agora está instalada por padrão. Os representantes de suporte ao cliente da Apigee podem usar o sosreport para ajudar a resolver problemas. A ferramenta não coleta dados, a menos que seja executada.

É possível verificar as versões de RPM instaladas atualmente para confirmar se elas precisam ser atualizadas. Para isso, digite:

apigee-all version

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

Em todos os nós de borda:
1. Limpe o repositório do Yum:
```
sudo yum clean all
```
2. Faça o download do 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á necessário inserir esse valor.
4. Use o comando source para executar o script apigee-service.sh:
```
source /etc/profile.d/apigee-service.sh
```
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
```
Execute o script update.sh para SSO em todos os nós:

/opt/apigee/apigee-setup/bin/update.sh -c sso -f configFile

Em todos os nós da IU, execute o script update.sh para a IU:
```
/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
```
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 aprimorada para torná-la imprevisível, a fim de evitar a vulnerabilidade de falsificação de solicitação entre sites (CSRF, na sigla em inglês).",
279065586	Adicionamos políticas de segurança de conteúdo ao cabeçalho para oferecer uma camada extra de segurança a sites contra ataques do lado do cliente.

Mudanças no software com suporte

Foi adicionado suporte para as seguintes versões de software:

Red Hat Enterprise Linux (Intel de 64 bits): versão 8.8
Oracle Linux (Intel de 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 conferir uma lista completa de softwares compatíveis.

Descontinuações e desativações

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

Novos recursos

Esta versão apresenta os seguintes novos recursos:

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

Com esta versão, é possível limitar o número máximo de caracteres dos nomes da organização e do ambiente ao criar uma nova organização ou ambiente. O valor padrão para o número máximo de caracteres é 255. Para definir um 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, definindo a propriedade conf_keymanagement_oauth_access_token_expiry_time_in_millis com o prazo de validade desejado em milissegundos. Esse recurso fica desativado por padrão. Para ativá-lo, defina conf_keymanagement_oauth_access_token_is_apply_limit como true no processador de mensagens.

Esse recurso oferece aos administradores da Apigee um controle melhor sobre a expiração dos 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` era usada no DataMasking, as políticas não ficaram visíveis no trace. Isso foi corrigido.
260397807	Um problema nos modelos de e-mail impedia o envio de caracteres de vários bytes no e-mail. Isso foi corrigido.
234544436	Ocorreu 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 Google 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 de estado foi aprimorada para torná-la imprevisível, a fim de 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 falhas nas consultas <code<create< code="" dir="ltr" translate="no"> do Postgresql.</code<create<> Isso foi corrigido pelo gerenciamento aprimorado de conflitos de nomes de índice postgres para nomes longos de organizações e ambientes.
293733533	A biblioteca de terceiros do Spring nos componentes do Edge Gateway foi atualizada 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 fossem exibidas 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

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

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

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 mais recente que a versão instalada atualmente. É possível encontrar esses componentes nas notas da versão do Edge para nuvem privada de todas as versões posteriores à atual e na lista de RPMs dessas versões. Consulte as Notas de lançamento da Apigee para ver links de todas as notas de lançamento do Edge para nuvem privada.

Observação:você só precisa atualizar cada componente uma vez. Basta instalar a RPM para a 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:o upgrade de um componente instala automaticamente a versão mais recente do patch dele. Se você quiser fazer upgrade para uma versão de patch que não seja a mais recente, será necessário manter sua própria cópia tarball do repositório da Apigee usando o espelho da Apigee e usar esse espelho para instalações da Apigee. Para mais informações, consulte Como usar um repositório do Edge local para manter sua versão do Edge.