Você está visualizando a documentação do Apigee Edge.
Acesse a
documentação da
Apigee X. info
Na terça-feira, 19 de maio de 2015, lançamos uma versão trimestral do Apigee Edge para nuvem particular.
O nome do produto "Apigee Edge local" ou "OPDK" agora é "Apigee Edge para nuvem privada".
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.
OpenLDAP: instalação e upgrade
O OpenLDAP agora é o único servidor LDAP com suporte do Edge para instalações novas e upgrades.
Serviços da API
Confira a seguir os novos recursos e aprimoramentos nos serviços de API do Edge.
WebSockets
Para ativar as comunicações da Web em tempo real entre um cliente e um servidor da Web, o Edge oferece suporte ao protocolo WebSocket. O Edge pode desempenhar o papel de cliente ou servidor nas comunicações do WebSocket. Para informações sobre como configurar e usar WebSockets no Edge, consulte o guia Apigee Edge para nuvem privada usando WebSockets.
Suporte a provedores de autenticação externa para gerenciamento de API
O Edge se integra ao Active Directory e a outros provedores de autenticação externa/sistemas LDAP que contêm os usuários administrativos da API. Para mais informações, consulte o guia Configuração de autenticação externa do Edge para nuvem privada.
Co-branding na interface de gerenciamento
É possível fazer co-branding na interface de gerenciamento do Edge com seu próprio logotipo personalizado, que aparece ao lado do logotipo do Apigee. Para mais informações, consulte "Como adicionar um logotipo personalizado ao menu da interface da Apigee" no Guia de operações do Apigee Edge para nuvem privada.
Registros do Node.js no Trace
Ao depurar proxies da API Node.js, é possível ativar o recurso de registro do Node.js na visualização de rastreamento do editor de proxy da API. Para ativar o recurso, defina
apigee.feature.disableNodeJSLogs="false" no arquivo apigee-base.conf ou
apigee-onpremise.conf na sua instalação. Para mais informações sobre o registro do Node.js, consulte
Como depurar e resolver problemas
de proxies do Node.js.
Validade da senha
No Edge 4.15.01.x, as senhas do Edge expiravam automaticamente após 30 dias. Isso significava que um usuário ficava bloqueado até mudar a senha antes do vencimento. No entanto, isso também fez com que a senha do administrador do sistema expirasse, bloqueando o acesso do administrador do sistema ao Edge.
Quando você faz upgrade para a versão 4.15.04.00, as mudanças padrão são feitas para que as senhas não expirem. Se
necessário, é possível configurar a expiração das senhas do Edge usando o
script /opt/apigee4/bin/apigee-enable-pwlockout.sh. Para mais informações, consulte o
Guia de operações do Apigee Edge para nuvem privada.
Limitar o acesso do administrador do sistema a domínios de e-mail específicos
É possível restringir a associação às funções de administrador do sistema ou de administrador do sistema somente leitura a usuários em domínios de e-mail específicos. Para ativar esse recurso, adicione os domínios permitidos ao arquivo apigee4/conf/apigee/management-server/security.properties, conforme descrito no Guia de operações do Apigee Edge para Private Cloud.
Mensagens de erro da IU de gerenciamento
A exibição de mensagens de erro na interface de gerenciamento foi reformulada para usar o espaço na tela de forma mais eficiente.
Novas variáveis de falha do OAuthV2
Estas novas variáveis relacionadas a falhas são definidas pela política OAuthV2:
- oauthV2.<policy-name>.failed: definido como verdadeiro se a política tiver falhado.
- oauthv2.<policy_name>.<fault_name>: o nome da falha. Por exemplo, invalid_request
- oauthv2.<policy_name>.<fault_cause>: o motivo da falha. Por exemplo: "Token expirado"
Consulte http://apigee.com/docs/api-services/content/oauthv2-policy.
Criação de produtos
Ao criar um novo produto, agora é possível especificar o nome do produto, além do nome de exibição.
Consulte http://apigee.com/docs/developer-services/content/creating-api-products.
Interface para remover usuários de uma organização
Na página "Usuários da organização" da interface, o botão "Excluir" foi substituído por "Remover". Isso ajuda a deixar claro que, quando você remove um usuário de uma organização, a conta do Apigee dele permanece ativa.
Consulte http://apigee.com/docs/api-services/content/managing-organization-users.
Opções de filtragem na IU de gerenciamento
Nas páginas "Proxies de API", "Produtos", "Desenvolvedores" e "Apps" na interface de gerenciamento, novas opções de filtragem estão disponíveis para pesquisa.
Ferramenta Trace off-line
A ferramenta Trace off-line permite que você visualize e analise sessões de rastreamento salvas anteriormente. Uma sessão de rastreamento salva é basicamente uma "gravação" de uma sessão de rastreamento e pode ser útil para casos em que a solução de problemas e análises adicionais são necessárias. A interface da ferramenta Trace off-line é semelhante à ferramenta Trace "on-line".
Para mais informações, consulte Como usar a ferramenta Offline Trace.
Funções do usuário exibidas nas configurações do usuário
Na página "Configurações do usuário" da interface de gerenciamento (nome de usuário > Configurações do usuário), os papéis do usuário agora são exibidos.
Melhorias na interface do gerenciamento de bordas
Esta versão inclui várias pequenas melhorias na usabilidade e na consistência da interface de gerenciamento do Edge.
Serviços de análise
Confira a seguir os novos recursos e aprimoramentos dos Serviços de análise de borda.
Seis meses de dados disponíveis
Ao gerar relatórios de análise com a API ou a interface de gerenciamento, os dados com mais de seis meses da data atual não podem ser acessados por padrão. Se você quiser acessar dados com mais de seis meses, entre em contato com o suporte da Apigee.
Variáveis adicionadas à análise
As novas variáveis a seguir são transmitidas para a Análise Edge, que fica visível na fase AX da janela de rastreamento de proxy da API.
- apigee.edge.execution.is_target_error: permite identificar se os erros da API são do lado do alvo (valor "1") ou não (valor "0"). O valor é nulo para uma resposta HTTP bem-sucedida.
-
apigee.edge.execution.is_policy_error: permite identificar se uma política falhou (valor "1") ou se nenhuma política falhou em uma resposta HTTP com falha (valor "0"). O
valor é nulo para uma resposta HTTP bem-sucedida.
As variáveis relacionadas a seguir fornecem detalhes sobre a política que falhou primeiro. Os valores serão nulos se nenhuma política falhar.- apigee.edge.execution.fault_policy_name: o nome da política que falhou.
- apigee.edge.execution.fault_flow_name: o nome do fluxo na política que falhou (como PreFlow, PostFlow ou um fluxo definido pelo usuário).
- apigee.edge.execution.fault_flow_state: o local em que a política foi anexada no fluxo. Valores possíveis: PROXY_REQ_FLOW, TARGET_REQ_FLOW, TARGET_RESP_FLOW, PROXY_RESP_FLOW.
Painéis
- Os gráficos de desempenho de APIs, desenvolvedores, produtos e apps de desenvolvedor foram movidos. Elas costumavam aparecer na parte de baixo das páginas principais dessas entidades. Agora, você acessa os gráficos selecionando a guia Analytics na parte de cima de cada página.
- Esta versão inclui trabalhos importantes sobre estes painéis novos ou atuais:
- Painel da Apigee (revisado): inclui três gráficos de métricas: tráfego de proxy, engajamento do desenvolvedor e apps do desenvolvedor. Cada gráfico oferece uma visualização "mais detalhes" que permite detalhar cada métrica. Consulte o painel da Apigee.
- Desempenho do proxy (novo): mostra padrões de tráfego e tempos de processamento do proxy de API. Substitui o painel "Desempenho do proxy da API". Consulte Desempenho do proxy da API.
- Composição de tráfego (revisada): aparência, sensação e conteúdo do painel foram completamente revisados. Mede a contribuição relativa das principais APIs, apps, desenvolvedores e produtos para seu programa geral de API. Consulte Composição do tráfego.
- Análise de erros (revisada): aparência e conteúdo completamente revisados. Mostra as taxas de erro para proxies e destinos de API. Consulte Painel de análise do código de erro.
-
Os seguintes painéis foram renomeados:
- Desempenho do endpoint foi renomeado para Desempenho do destino: mostra padrões de tráfego e métricas de desempenho para destinos de back-end do proxy da API. Consulte Meta de performance.
- Engajamento do parceiro foi renomeado para Engajamento do desenvolvedor: mostra quais desenvolvedores de apps registrados estão gerando mais tráfego de API. Para cada um dos desenvolvedores, é possível descobrir quem está gerando mais tráfego de API e a maioria dos erros. Consulte Engajamento do desenvolvedor.
Serviços para desenvolvedores
Confira a seguir os novos recursos e aprimoramentos dos Serviços para Desenvolvedores do Edge.
Suporte a Swagger 2.0 para SmartDocs
O SmartDocs oferece suporte à importação de documentos de especificação do Swagger 2.0 e mantém a compatibilidade com o Swagger 1.2. O suporte a objetos de esquema de segurança e esquemas centralizados vai estar disponível em uma versão futura.
Monetização
Confira a seguir os novos recursos e melhorias na monetização do Edge. Consulte também a seção "Problemas conhecidos" para mais informações sobre monetização.
Processamento separado de empresas e desenvolvedores
Empresas e desenvolvedores agora são tratados separadamente, permitindo mais flexibilidade ao adicionar várias empresas a desenvolvedores e vários desenvolvedores a empresas. A interface de gerenciamento agora oferece janelas separadas para "Empresas" e "Desenvolvedores" (acessíveis no menu "Publicar").
Consulte Gerenciar empresas e desenvolvedores.
Nos relatórios de monetização, as empresas continuam sendo um filtro principal, embora o rótulo do filtro tenha mudado de "Desenvolvedores" para "Empresas".
Bugs corrigidos
Os bugs abaixo foram corrigidos nesta versão.
| ID do problema | Descrição |
|---|---|
| OPDK-954 | O esquema do Cassandra 4.15.01 não é atualizado |
| MGMT-1986 | Erro de interface ao adicionar um desenvolvedor |
| MGMT-1983 | A API de código de autorização OAuth 2.0 retorna o status errado |
| MGMT-1962 | Erro ao fazer login na interface de gerenciamento com uma senha forte Fazer login na interface com determinados caracteres especiais, como o símbolo de porcentagem, não falha mais. |
| MGMT-1894 | A página "Apps do desenvolvedor" nunca termina de carregar para a coluna do desenvolvedor |
| MGMT-1872 | Não é possível fazer o download de relatórios personalizados |
| MGMT-1777 | Não é possível adicionar um usuário com um endereço de e-mail que tenha um TLD de .acn |
| MGMT-1362 | O e-mail "Esqueci minha senha" não funciona se o endereço de e-mail tiver
'_' Corrige o problema de redefinição de senha na nuvem particular com endereços de e-mail que contêm um sublinhado. |
| CORERT-613 | Falhas de handshake SSL devido a "unrecognized_name" |
| APIRT-1346 | OAuth2.0: o valor com hash é retornado na resposta do token de acesso quando hash.oauth.tokens.enabled é verdadeiro |
Esta versão também contém correções de bugs das seguintes versões:
| Cloud Edge | Edge para nuvem privada |
|---|---|
Problemas conhecidos
Esta versão tem os seguintes problemas conhecidos.
| ID do problema | Descrição |
|---|---|
| N/A |
Dois scripts do Cassandra, que o instalador usa na instalação ou atualização da monetização, não foram incluídos na versão. Para contornar esse problema, execute os seguintes comandos após a instalação ou o upgrade do Cassandra para concluir a instalação/upgrade da monetização:
|
| CORERT-318 | Às vezes, as chamadas de API com payloads grandes (100 KB) podem travar. Para contornar esse
problema, defina o seguinte valor de propriedade no arquivo router.properties:HTTPServer.streaming.buffer.limit=0 (a configuração padrão é 10) |