Você está lendo 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 Private Cloud.
O antigo nome do produto "Apigee Edge On-premises" ou "OPDK" agora é "Apigee Edge para nuvem privada".
Se você tiver dúvidas, entre em contato com o suporte do Apigee Edge.
Para uma lista de todas as notas da versão do Apigee Edge, consulte Notas da versão da Apigee.
Novos recursos e melhorias
Confira os novos recursos e melhorias desta versão.
OpenLDAP: instalação e upgrade
O OpenLDAP agora é o único servidor LDAP compatível com o Edge para instalações novas e de upgrade.
Serviços da API
Confira a seguir os novos recursos e melhorias nos serviços de API do Edge.
WebSockets
Para ativar comunicações da Web em tempo real entre um cliente e um servidor da Web, o Edge é compatível com o protocolo WebSocket. O Edge pode atuar como cliente ou servidor nas comunicações WebSocket. Para informações sobre como configurar e usar WebSockets no Edge, consulte o guia Apigee Edge para nuvem privada usando WebSockets.
Suporte a provedor de autenticação externa para gerenciamento de APIs
O Edge se integra ao Active Directory e a outros provedores de autenticação externos/sistemas LDAP que contêm seus 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 uma marca conjunta da interface de gerenciamento do Edge com seu próprio logotipo personalizado, que aparece ao lado do logotipo da Apigee. Para mais informações, consulte "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 de API do Node.js, é possível ativar o recurso de registro do Node.js na visualização de rastreamento do editor de proxy de 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
Depuração e solução de problemas
de proxies do Node.js.
Validade da senha
No Edge 4.15.01.x, as senhas expiravam automaticamente após 30 dias. Isso significa que um usuário ficaria bloqueado, a menos que mudasse a senha antes que ela expirasse. No entanto, isso também fez com que a senha do administrador do sistema expirasse, impedindo o acesso ao Edge.
Quando você faz upgrade para a versão 4.15.04.00, o padrão muda para que as senhas não expirem. Se
necessário, configure os senhas do Edge para expirar 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 de administradores de sistema a domínios de e-mail específicos
É possível restringir a associação às funções de sysadmin ou sysadmin 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 nuvem privada.
Mensagens de erro da interface de gerenciamento
A exibição de mensagens de erro na interface de gerenciamento foi redesenhada para usar o espaço da tela de maneira mais eficiente.
Novas variáveis de falha do OAuthV2
Essas novas variáveis relacionadas a falhas são definidas pela política OAuthV2:
- oauthV2.<policy-name>.failed: definido como "true" se a política falhou.
- 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 produto, agora é possível especificar o nome dele, 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 esclarecer 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 interface de gerenciamento
Nas páginas "Proxies de API", "Produtos", "Desenvolvedores" e "Apps" da interface de gerenciamento, novas opções de filtragem estão disponíveis para pesquisa.
Ferramenta Offline Trace
Com a ferramenta de rastreamento off-line, é possível ver e analisar 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 de rastreamento off-line é semelhante à ferramenta de rastreamento "ao vivo".
Para mais informações, consulte Como usar a ferramenta de rastreamento off-line.
Funções de usuário mostradas em "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 de gerenciamento de borda
Esta versão inclui várias pequenas melhorias de usabilidade e consistência na interface de gerenciamento do Edge.
Serviços de análise
Confira a seguir os novos recursos e melhorias nos serviços de análise de dados 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 a partir 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 do Apigee Edge.
Variáveis adicionadas à análise
As seguintes variáveis novas são transmitidas para a análise do Edge e ficam visíveis na etapa AX da janela de rastreamento do proxy de API.
- apigee.edge.execution.is_target_error: permite identificar se os erros de API são do lado do destino (valor "1") ou não para respostas HTTP sem êxito (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 sem sucesso (valor "0"). O valor é nulo para uma resposta HTTP bem-sucedida.
As seguintes variáveis relacionadas fornecem detalhes da 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 para APIs, desenvolvedores, produtos e apps de desenvolvedores mudaram de lugar. Elas eram mostradas na parte de baixo das páginas principais dessas entidades. Para acessar os gráficos, selecione a guia Analytics na parte de cima de cada página.
- Esta versão inclui um trabalho importante nestes painéis novos ou atuais:
- Painel do Apigee (revisado): inclui três gráficos de métricas: tráfego de proxy, engajamento de desenvolvedores e apps de desenvolvedores. 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 de desempenho do proxy de API. Consulte Desempenho do proxy de API.
- Composição de tráfego (revisado): aparência, experiência e conteúdo do painel 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, funcionalidade e conteúdo totalmente revisados. Mostra as taxas de erro para proxies e destinos de API. Consulte o Painel de análise do código de erro.
-
Os seguintes painéis foram renomeados:
- Desempenho do endpoint foi renomeado como Desempenho do destino: mostra padrões de tráfego e métricas de desempenho para destinos de back-end do proxy de API. Consulte Meta de performance.
- Engajamento do parceiro mudou para Engajamento do desenvolvedor: mostra quais dos seus desenvolvedores de apps registrados estão gerando mais tráfego de API. Para cada um dos seus desenvolvedores, você pode descobrir quem está gerando mais tráfego de API e mais erros. Consulte Engajamento do desenvolvedor.
Serviços para desenvolvedores
Confira a seguir os novos recursos e melhorias nos Serviços para desenvolvedores do Edge.
Suporte do Swagger 2.0 para SmartDocs
O SmartDocs permite importar documentos de especificação do Swagger 2.0 e mantém a compatibilidade com versões anteriores do 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.
Tratamento separado de empresas e desenvolvedores
Agora, empresas e desenvolvedores são tratados separadamente, o que permite 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, mas o rótulo mudou de "Desenvolvedores" para "Empresas".
Bugs corrigidos
Os bugs abaixo foram corrigidos nesta versão.
| ID do problema | Descrição |
|---|---|
| OPDK-954 | 4.15.01 O esquema do Cassandra não foi atualizado |
| MGMT-1986 | Erro de interface ao adicionar um desenvolvedor |
| MGMT-1983 | A API para receber um código de autorização do OAuth 2.0 retorna o status errado |
| MGMT-1962 | Erro ao fazer login na interface de gerenciamento com uma senha forte O login na interface com determinados caracteres especiais, como o sinal de porcentagem, não falha mais. |
| MGMT-1894 | A página "Apps do desenvolvedor" nunca termina de carregar na coluna "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 .acn |
| MGMT-1362 | O e-mail "Esqueceu a senha" não funciona se o endereço de e-mail contiver
'_' Corrige o problema de redefinição de senha na nuvem privada com endereços de e-mail que contêm um sublinhado. |
| CORERT-613 | Falhas no handshake de 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 no upgrade da monetização, não foram incluídos no lançamento. Para contornar isso, execute os comandos a seguir após a instalação ou upgrade do Cassandra para concluir a instalação/upgrade da monetização:
|
| CORERT-318 | Às vezes, as chamadas de API com payloads grandes (centenas de KB) podem ficar travadas. 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). |