Abril 2025
Data de lançamento: 11/04/2025
1. Introdução
Neste documento, você encontrará um resumo das novas funcionalidades, melhorias significativas e correções de bugs implementados nesta versão, visando aprimorar a plataforma e a experiência do usuário. Além disso, destacamos quaisquer bugs conhecidos que podem impactar a utilização do sistema, fornecendo transparência e orientações.
2. Módulos e versões
Módulo | Versão |
---|---|
dhuo-iam | v1.3.0 |
manager-backend | v4.0.0 |
manager-frontend | v4.0.0 |
devportal-frontend | v2.0.0 |
platform-backend | v1.8.0 |
integra-build-manager | v3.6.0 |
build-service | v3.8.1 |
deploy-service | v3.1.1 |
pipeline | v3.35.1 |
subscription-backend | v1.3.0 |
3. Novas Funcionalidades
A versão mínima dos Gateways suportados pela plataforma foi atualizada. A atualização oferece melhorias de segurança e performance em relação à versão anterior.
Versões anteriores não são mais compatíveis, sendo necessária a atualização de versão dos API Gateways. Antes de atualizar, verifique a versão do API Gateway e entre em contato com nossa equipe para apoio no processo de atualização de versão.
Gateway | Versão |
---|---|
DHuO Gateway | 3.8-1.0.0 |
Kong | 3.8.x |
Upstreams e load balancing
Adicionamos suporte à configuração de Upstreams por meio da interface gráfica do API Manager do DHuO. Assim como Endpoints (Services no Kong Gateway) e Rotas, Upstreams são configurações para exposição de uma API nos Gateways. Com Upstreams é possível configurar múltiplos endpoints para que gateway realize o balanceamento de carga das requisições para as aplicações de backend. Isso possibilita um controle e flexibilidade ainda maiores no processo de atualização de aplicações, permitindo o uso de técnicas como deploys blue green.
Suporte a múltiplas credenciais
Adicionamos o suporte a múltiplas credenciais de um mesmo tipo para os consumidores de API. Essa opção dá mais flexibilidade caso seja necessário administrar mais de uma credencial para o mesmo consumidor de API. Esta opção é válida somente para consumidores de API criados pela interface gráfica do API Manager. Consumidores de API criados pelo Dev Portal permanecem com a relação de uma credencial por consumidor.
DHuO MTLS Plugin
Adicionamos suporte à configuração do plugin de autenticação DHuO MTLS por meio da interface gráfica do API Manager do DHuO. A configuração é feita em duas etapas:
- Cadastro do plugin
DHuO MTLS
nas configurações de políticas de Gateway da API - Cadastro de um consumidor de API e geração de uma credencial do tipo
DHuO MTLS
O plugin DHuO MTLS está disponível somente para o gateway DHuO.
4. Melhorias
- Gateway Endpoints: Adicionamos dois novos campos no cadastro de endpoints/services de API: name e certificados CA. Antes, o campo name era gerado automaticamente pela plataforma. Com isso, tornamos o cadastro mais flexível conforme o contexto de uso de cada cliente. O certificado de CA é utilizado caso a comunicação entre o gateway e a aplicação de backend utilizar certificado autoassinado.
- Gateway Routes: Adicionamos dois novos campos no cadastro de rotas de API: name e paths. Antes, esses campos eram gerados automaticamente pela plataforma. Com isso, tornamos o cadastro mais flexível conforme o contexto de uso de cada cliente. Uma das melhorias da nova versão dos gateways Kong e DHuO diz respeito a regras de roteamento. Agora, paths dinâmicos (que utilizam regex) têm configuração diferente de paths estáticos. Isso oferece mais performance no processamento do roteamento pelo gateway.
- Gateway Plugins: Adicionamos o suporte à configuação de plugins customizados pela interface gráfica do API Manager do DHuO.
- API Consumers: Adicionamos dois novos campos no cadastro de consumidores de API: username e custom_id. Antes, esses campos eram gerados automaticamente pela plataforma. Com isso, tornamos o cadastro mais flexível conforme o contexto de uso de cada cliente.
- API Credentials: Além da credencial API Key, agora realizamos o registro de histórico para as credenciais JWT, Basic Auth e DHuO MTLS.
- JWT Credential: Adicionamos suporte a novas opções de algoritmos de criptografia para credenciais do tipo JWT de gateways KONG e DHUO. Novos algoritmos suportados: RS512, ES512, PS256, PS384, PS512 e EdDSA.
5. Correções de bugs
- Certificate Management: Corrigimos um erro onde não era permitido cadastrar certificados com chave privada no formato PKCS #8. Agora, ambos formatos PKCS #1 e PKCS #8 são aceitos corretamente.
- API Deploy: Corrigmos um comportamento na implantação de APIs onde, em certas circunstâncias, era exibido na interface o indicativo de implantação bem sucedida, porém o processo apresentava falhas durante a configuração de plugins com dados inválidos. O indicativo foi corrigido e o status exibido agora é de erro.