15/05/27 - Notas da versão do Apigee Edge

Você está vendo a documentação do Apigee Edge.
Acesse a documentação da Apigee X.
informações

Na terça-feira, 2 de junho de 2015, lançamos uma nova versão do Apigee Edge para a nuvem.

Se você tiver dúvidas, acesse o suporte ao cliente da Apigee.

Para ver uma lista de todas as notas da versão do Apigee Edge, consulte as Notas de lançamento da Apigee.

Novos recursos e melhorias

Veja a seguir os novos recursos e melhorias desta versão.

Disponibilidade geral do SmartDocs

O SmartDocs está passando da versão Beta para a disponibilidade geral. As atualizações e os novos recursos incluem:

  • Suporte para Swagger 2.0, incluindo importação por arquivo ou URL, inclusive suporte a objetos de segurança com nomes personalizados.
  • Melhorias de design visual nos modelos que geram SmartDocs.
  • Melhorias de usabilidade e fluxo de trabalho no portal do desenvolvedor, disponíveis no menu Conteúdo > SmartDocs no Drupal.
  • O que era conhecido como autenticação por "token personalizado" agora é chamado de "chave de API".
  • Objetos de "segurança" de autenticação definidos no nível da revisão.
  • Configuração da autenticação do cliente no nível do modelo. As novas revisões não redefinem mais as credenciais pré-configuradas do cliente SmartDocs.

Para ver mais descrições de recursos, consulte esta postagem do blog (em inglês).

Para conferir a documentação do SmartDocs, consulte Como usar o SmartDocs para documentar APIs.

Novo Beta do editor de proxy de API

Uma nova versão Beta do editor de proxy de API está disponível. Para acessar, clique no link "Acessar a versão Beta" ao editar um proxy de API. É possível alternar entre os editores "clássicos" e "Beta".

Nova política do OAuthV2

Com a nova política DeleteOAuthV2Info, você pode excluir códigos de autorização e tokens de acesso. Para mais informações, consulte Excluir a política de informações do OAuthV2.

Novas entidades na política de entidade de acesso

A política de entidade de acesso fornece acesso às seguintes entidades novas: consumerkey-scopes, Authorizationcode, requesttoken e verificado.. Para mais informações, consulte a Política de entidade de acesso.

Mostrando certificados SSL que estão próximos do vencimento

A página "Certificados SSL" na IU de gerenciamento (Administrador > Certificados SSL) indica quando os certificados SSL expiram em 10, 15, 30 ou 90 dias, dependendo da sua seleção no novo campo suspenso de expiração.

Nome do app do desenvolvedor exibido na interface de gerenciamento

Os apps do desenvolvedor no Edge têm um nome interno que não muda e um nome de exibição que você pode mudar. Em uma página "App do desenvolvedor" na interface de gerenciamento (Publicar > Apps do desenvolvedor > nome do app), o "Nome" interno do app é exibido junto com o "Nome de exibição", facilitando a identificação visual dos apps pelos nomes internos para solução de problemas e gerenciamento de APIs.

A versão clássica dos relatórios personalizados será removida da interface de gerenciamento

A versão clássica opcional dos relatórios de análise personalizados não está mais disponível na interface de gerenciamento.


Processo de upgrade do SmartDocs

Se você já usa o SmartDocs durante o período Beta, os novos recursos na versão de disponibilidade geral exigem que você faça upgrade do SmartDocs no portal do desenvolvedor.

Todas as páginas SmartDocs que já tiverem sido publicadas no seu portal do desenvolvedor continuarão funcionando, mas você precisará seguir o processo de atualização antes de editar ou publicar qualquer alteração em páginas novas ou existentes.

É importante lembrar que, embora seja possível renderizar e publicar SmartDocs dentro do portal do desenvolvedor, os SmartDocs são gerados a partir do modelo de API que reside nos serviços de gerenciamento de APIs Edge da Apigee. Todas as alterações feitas em um modelo de API no Edge serão as mesmas em todos os ambientes do Pantheon (semelhante à forma como os desenvolvedores existem nos ambientes do Pantheon).

Fazer upgrade da versão Beta do SmartDocs para a disponibilidade geral

  1. Atualize e teste a versão 15.05.27 nos seus ambientes dev ou test do Pantheon.
  2. Crie um novo modelo para substituir qualquer modelo de API que você esteja usando.
    • Se você estiver importando documentos Swagger ou WADL, importe-os novamente para uma nova revisão.
    • Se você tem mantido seu modelo de API por meio do módulo SmartDocs, exporte como JSON SmartDocs e importe-o para o novo modelo usando o anexo de arquivo.
  3. Defina as propriedades de segurança da revisão do modelo. Na página Conteúdo > SmartDocs > modelo, selecione Configurações de segurança.
  4. Verifique as autenticaçãos pré-configuradas na página de configurações do modelo (Conteúdo > SmartDocs) clicando em Configurações na coluna "Operações".
  5. Atualize todos os modelos personalizados para usar a v6 dos recursos CSS e JS e faça alterações para refletir os novos nomes de objeto, como authSchemes e apiSchema. Para informações sobre como atualizar modelos do SmartDocs, consulte Como usar o SmartDocs para documentar APIs.
  6. Renderize novamente e publique a revisão do modelo.
  7. Depois de validar a nova documentação, atualize seu portal de produção para a versão 15.05.27.

Se você for um cliente Enterprise do Edge e tiver dúvidas sobre o processo de upgrade, envie um e-mail para marsh@apigee.com e cnovak@apigee.com. Caso contrário, use a Comunidade Apigee para receber a melhor resposta.

Bugs corrigidos

Os bugs abaixo foram corrigidos nesta versão.

Id do problema Descrição
TBD-72 Problema com a política de registro de mensagens
MGMT-2124 As permissões da função do cliente são redefinidas ao salvar as permissões na IU
MGMT-2048 Usuário com papel personalizado que limita as permissões de implantação a um ambiente pode implantar em outros
MGMT-2041 Remover o elemento FaultRules do modelo de anexo padrão
O elemento FaultRules, que não é usado em políticas ou etapas de proxy de API, não é mais adicionado automaticamente quando você cria proxies de API ou adiciona políticas.
MGMT-2034 A busca da WSDL retorna a falha: "Erro de busca do WSDL: erro de processamento da WSDL".
MGMT-1812 Adicionar validação do TargetEndpoint durante a importação
Semelhante ao ProxyEndpoint, o TargetEndpoint será validado para o esquema e as expressões adequados usados nas condições durante a importação do proxy da API.
MGMT-1345 A importação do WSDL com vários namespaces resulta em uma etapa incorreta de criação deSOAP
MGMT-800 Criar um recurso com o nome "padrão" resulta em interface corrompida
MGMT-602 Visualização de desenvolvimento do proxy de API: adicione uma política de cache de resposta quando o endpoint não tiver PreFlow/PostFlow causa erro
MGMT-460 A renomeação da política resulta em comportamento de falha, política duplicada que não pode ser removida
DEVRT-1565 Intervalos de 15 minutos para COBRANÇAS
AXAPP-1728 Ignorar variáveis de monetização no Analytics
AXAPP-1690 "Erro de API inválida" nos relatórios personalizados
AXAPP-1533 O mapa geográfico do Google Analytics gera um erro de chamada de API inválida
APIRT-52 Relatórios personalizados: o código de status da resposta para muitas APIs é nulo