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:
-
Em todos os nós do Edge:
- Limpe o repositório do Yum:
sudo yum clean all
- 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
- 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.
- Use o comando
source
para executar o script apigee-service.sh:source /etc/profile.d/apigee-service.sh
- Limpe o repositório do Yum:
- 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
- Execute o script
update.sh
para SSO em todos os nós: - 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
- 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
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 |
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="" dir="ltr" translate="no"> 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