Você está visualizando a documentação do Apigee Edge.
Acesse a
documentação da
Apigee X. info
Na terça-feira, 2 de junho de 2015, lançamos uma nova versão na nuvem do Apigee Edge.
Se tiver dúvidas, acesse o suporte ao cliente da Apigee.
Para conferir uma lista de todas as notas da versão do Apigee Edge, consulte Notas da versão do Apigee.
Novos recursos e melhorias
Confira a seguir os novos recursos e as melhorias desta versão.
Disponibilidade geral do SmartDocs
O SmartDocs está saindo da versão Beta e vai ser disponibilizado para todos os usuários. As atualizações e os novos recursos incluem:
- Suporte ao Swagger 2.0, incluindo importação por arquivo ou URL, incluindo suporte a objetos de segurança com nomes personalizados.
- Melhorias no design visual dos modelos que geram SmartDocs.
- Melhorias na usabilidade e no fluxo de trabalho no portal do desenvolvedor, disponíveis no menu "Conteúdo" > "SmartDocs" no Drupal.
- O que era conhecido como autenticação de "Token personalizado" agora é chamado de "Chave de API".
- Objetos de "segurança" de autenticação definidos no nível de revisão.
- Configuração da autenticação do cliente no nível do modelo. As novas revisões não redefiniram mais nenhuma credencial de cliente pré-configurada do SmartDocs.
Para mais descrições de recursos, consulte esta postagem do blog.
Para conferir a documentação do SmartDocs, consulte Como usar o SmartDocs para documentar APIs.
Novo editor de proxy de API Beta
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 existente. É possível alternar entre os editores "clássico" e "Beta".
Nova política do OAuthV2
A nova política DeleteOAuthV2Info permite 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 acesso à entidade
A política de entidade de acesso fornece acesso às seguintes entidades: escopos de chave do consumidor, authorizationcode, requesttoken e verificador. Para mais informações, consulte a Política de acesso a entidades.
Mostrar certificados SSL que estão próximos da expiração
A página "Certificados SSL" na interface de gerenciamento (Administrador > Certificados SSL) indica quando os certificados SSL vão expirar em 10, 15, 30 ou 90 dias, dependendo da sua seleção no campo de lista suspensa "Nova expiração".
Nome do app do desenvolvedor exibido na interface de gerenciamento
Os apps para desenvolvedores no Edge têm um nome interno que não muda e um nome de exibição que pode ser alterado. Na página do 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 está sendo 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á estava usando o SmartDocs durante o período Beta, os novos recursos e recursos na versão de disponibilidade geral exigem que você faça upgrade do SmartDocs no portal do desenvolvedor.
As páginas do SmartDocs que já foram publicadas no seu portal de desenvolvedores vão continuar funcionando, mas você precisa seguir o processo de atualização antes de editar ou publicar as mudanças nas páginas atuais ou novas.
É possível renderizar e publicar SmartDocs no portal do desenvolvedor, mas eles são gerados com base no modelo de API que está nos serviços de gerenciamento de API do Edge da Apigee. Todas as mudanças feitas em um modelo de API no Edge serão as mesmas em todos os ambientes do Pantheon, semelhante à forma como os desenvolvedores existem em todos os ambientes do Pantheon.
Para fazer upgrade da versão Beta do SmartDocs para a versão de disponibilidade geral
- Atualize e teste a versão 15.05.27 nos ambientes de desenvolvimento ou teste no Pantheon.
- 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ê estiver mantendo seu modelo de API pelo módulo SmartDocs, exporte como JSON do SmartDocs e importe para o novo modelo usando o anexo de arquivo.
- Defina as propriedades de segurança da revisão do modelo. Na página Conteúdo >
SmartDocs > modelo, selecione Configurações de segurança.
- Verifique qualquer autenticação pré-configurada na página de configurações do modelo (Conteúdo >
SmartDocs) clicando em Configurações na coluna "Operações".
- Atualize os modelos personalizados para usar a v6 dos recursos de CSS e JS e faça mudanças para refletir novos nomes de objetos, como authSchemes e apiSchema. Para informações sobre como atualizar modelos do SmartDocs, consulte Como usar SmartDocs para documentar APIs.
- Renderize e publique a revisão do modelo.
- Depois de validar a nova documentação, atualize o portal de produção para a versão 15.05.27.
Se você é um cliente empresarial do Edge e tem 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 da 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 geração de registros de mensagens |
| MGMT-2124 | As permissões da função do cliente são redefinidas ao salvar as permissões na interface |
| MGMT-2048 | O usuário com função personalizada 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 do WSDL retorna uma falha: "Erro de busca do WSDL: erro ao processar WSDL". |
| MGMT-1812 | Adicionar a validação de 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 de API. |
| MGMT-1345 | A importação de WSDL com vários namespaces resulta em uma etapa SOAP incorreta |
| MGMT-800 | A criação de um recurso com o nome "default" resulta em uma interface incorreta |
| MGMT-602 | Visualização "Desenvolvimento" do proxy da API: a adição de uma política de cache de resposta quando o endpoint não tem PreFlow/PostFlow causa um erro |
| MGMT-460 | A renomeação da política resulta em comportamento com falhas, política duplicada que não pode ser removida |
| DEVRT-1565 | Intervalos de 15 minutos para CHARGES |
| AXAPP-1728 | Ignorar variáveis de monetização no Google Analytics |
| AXAPP-1690 | "Erro de API inválida" em relatórios personalizados |
| AXAPP-1533 | O Geomap do Google Analytics gera um erro de chamada de API inválida |
| APIRT-52 | Relatórios personalizados: o código de status da resposta de muitas APIs é nulo |