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 a seguir os novos recursos e melhorias desta versão.
OpenLDAP: instalação e upgrade
Agora, o OpenLDAP é 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 em 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 provedores de autenticação externos para gerenciamento de API
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 co-branding da UI 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 do Apigee" no Guia de operações do Apigee Edge para nuvem privada.
Registros do Node.js no Trace
Ao depurar proxies de API 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 ficava 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 que ele acessasse o 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 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 de administradores de sistema a domínios de e-mail específicos
É possível restringir a associação às funções de administrador do sistema ou 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 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 forma 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
A ferramenta Trace off-line permite que você visualize e analise sessões de rastreamento que foram 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 mostradas 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 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 novas variáveis a seguir são transmitidas para a análise do Edge e ficam visíveis na fase AX da janela de rastreamento do proxy de API.
- apigee.edge.execution.is_target_error: permite identificar se os erros da API são do lado do destino (valor "1") ou não relacionados ao destino para respostas HTTP sem sucesso (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 performance para APIs, desenvolvedores, produtos e apps de desenvolvedores foram movidos. 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 atuais ou novos:
- Painel do 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 de desempenho do proxy da API. Consulte Desempenho do proxy de API.
- Composição de tráfego (revisado): aparência, sensação 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 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 mudou para 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 de parceiros mudou para Engajamento de desenvolvedores: 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 melhorias nos Serviços para desenvolvedores do Edge.
Suporte do Swagger 2.0 para SmartDocs
O SmartDocs é compatível com a importação de documentos de especificação do Swagger 2.0 e mantém a compatibilidade com versões anteriores do Swagger 1.2. A compatibilidade com 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 | Receber um código de autorização do OAuth 2.0. A API 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 baixar 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 "Esqueci a senha" não funciona se o endereço de e-mail contiver
'_' Corrige o problema de redefinição de senha no Cloud privado 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 hash é retornado na resposta do token de acesso quando hash.oauth.tokens.enabled é "true" |
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 na versão. 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, 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). |