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 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 essa 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 dessa versão vai atualizar os componentes na lista de RPMs a seguir:
- 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 do Edge:
-
Em todos os nós do Edge:
- Limpe os repositórios do Yum:
sudo yum clean all
- Faça o download do arquivo
bootstrap_4.52.00.shmais 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
- Instale o utilitário
apigee-servicedo Edge 4.52.00 e as dependências: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 o insira.
- Use o comando
sourcepara executar o script apigee-service.sh:source /etc/profile.d/apigee-service.sh
- Limpe os repositórios do Yum:
- Em todos os nós do Edge, execute o script
update.shpara o processo do Edge:/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Execute o script
update.shpara SSO em todos os nós: - Em todos os nós da interface, execute o script
update.shpara a interface:/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
/opt/apigee/apigee-setup/bin/update.sh -c sso -f configFile
Problemas de segurança corrigidos
A seguir, confira 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 melhorada para torná-lo 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 no cabeçalho para fornecer uma camada extra de segurança para sites contra ataques do lado do cliente. |
Mudanças no software com suporte
Adicionamos 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 com suporte do Edge para nuvem privada para uma lista completa de softwares com suporte.
Descontinuações e desativações
Não há novas descontinuações ou desativaçõ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 essa versão, é possível limitar o número máximo de caracteres para os 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 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 vai usar um valor máximo de 1 ou 255, respectivamente.
Definir a expiração de tokens de acesso
Com essa versão, é possível definir a expiração de 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 ativá-lo, defina
conf_keymanagement_oauth_access_token_is_apply_limit como true
no processador de mensagens.
Esse recurso oferece aos administradores da Apigee mais controle sobre a expiração de tokens de acesso criados na Apigee.
Correções de bugs
Esta seção lista os bugs da nuvem privada que foram corrigidos nesta versão.
| ID do problema | Descrição |
|---|---|
| 290242749 |
Quando a variável |
| 260397807 |
Um problema nos modelos de e-mail impedia que caracteres multibyte fossem enviados 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 |
Adicionamos 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 do OAuth2, a entropia do parâmetro de estado foi melhorada para torná-lo imprevisível, a fim de evitar a vulnerabilidade de falsificação de solicitação entre sites (CSRF, na sigla em inglês). |
| 283310836 |
A mensagem de erro ao analisar XMLs grandes foi melhorada. |
| 245936798 |
Um problema com nomes de organizações e ambientes estava causando falhas nas consultas do Postgresql <code<create< code="" dir="ltr" translate="no"> .</code<create<> Isso foi corrigido com o tratamento aprimorado 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 Edge Gateway 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 |
Melhoramos a performance de algumas APIs de estatísticas. |
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 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. Para encontrar esses componentes, consulte as notas de lançamento do Edge para nuvem privada de todas as versões posteriores à sua e verifique a lista de RPMs dessas versões. Consulte
as Notas de lançamento da Apigee para links para todas as
notas de lançamento 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 de lançamento dessa 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 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 do 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 local do Edge para manter a versão do Edge.