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 nuvem privada.
O nome anterior do produto "Apigee Edge On-premises" ou "OPDK" agora é "Apigee Edge para nuvem privada".
Se tiver dúvidas, entre em contato com o suporte do Apigee Edge.
Para uma lista de todas as notas de lançamento do Apigee Edge, consulte Notas de lançamento da Apigee.
Novos recursos e melhorias
Confira abaixo 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 de upgrade.
Serviços da API
Confira abaixo os novos recursos e melhorias 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 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 externo para gerenciamento de API
O Edge é integrado 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 Edge para nuvem privada Configuração de autenticação externa.
Co-branding na interface de gerenciamento
É possível fazer o co-branding 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 "Como adicionar um logotipo personalizado ao menu da interface da Apigee" em 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 trace 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 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 do Edge expiravam automaticamente após 30 dias. Isso significava que um usuário ficava bloqueado, a menos que mudasse a senha antes da expiração. No entanto, isso também fazia com que a senha do administrador do sistema expirasse, de modo que o administrador do sistema ficasse bloqueado do Edge.
Ao fazer upgrade para a versão 4.15.04.00, a mudança padrão é que as senhas não expiram. Se
necessário, é possível configurar as senhas do Edge para expirar usando o
/opt/apigee4/bin/apigee-enable-pwlockout.sh script. Para mais informações, consulte o
Guia de operações do Apigee Edge para nuvem privada.
Como limitar o acesso do administrador do sistema a domínios de e-mail específicos
É possível restringir a participação nas funções de administrador do sistema ou somente leitura do administrador do sistema 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 reformulada 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 verdadeiro 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 Expired
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" na interface, o botão "Excluir" foi substituído por um botão "Remover". Isso ajuda a deixar claro que, ao remover um usuário de uma organização, a conta da Apigee desse usuário 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" na interface de gerenciamento, novas opções de filtragem estão disponíveis para pesquisa.
Ferramenta de trace off-line
A ferramenta de trace off-line permite visualizar e analisar sessões de trace que foram salvas anteriormente. Uma sessão de trace salva é basicamente uma "gravação" de uma sessão de trace 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 trace off-line é semelhante à ferramenta de trace "on-line".
Para mais informações, consulte Como usar a ferramenta de trace off-line.
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), as funções do usuário agora são mostradas.
Melhorias na interface de gerenciamento do Edge
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 abaixo os novos recursos e melhorias nos serviços de análise do Edge.
Dados de seis meses disponíveis
Ao gerar relatórios de análise com a interface de gerenciamento ou a API, 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 à análise do Edge, visíveis na fase AX da janela de trace do proxy de API
- apigee.edge.execution.is_target_error : permite identificar se os erros de API são erros do lado do destino (valor "1") ou erros não relacionados ao destino 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 êxito (valor "0"). O
valor é nulo para uma resposta HTTP bem-sucedida.
As variáveis relacionadas a seguir 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 de APIs, desenvolvedores, produtos e apps de desenvolvedores foram movidos. Eles eram mostrados na parte de baixo das páginas principais dessas entidades. Agora, acesse os gráficos selecionando a guia Análise na parte de cima de cada página.
- Esta versão inclui um trabalho importante nesses painéis atuais ou novos:
- Painel da 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 de "mais detalhes" que permite detalhar cada métrica. Consulte Painel da Apigee.
- Desempenho do proxy (novo): mostra padrões de tráfego do proxy de API e tempos de processamento. Substitui o painel de desempenho do proxy de API. Consulte Desempenho do proxy de API.
- Composição do tráfego (revisado): aparência, conteúdo e conteúdo do painel completamente revisados. Mede a contribuição relativa das principais APIs, aplicativos, desenvolvedores e produtos para seu programa geral de API. Consulte Composição do tráfego.
- Análise de erros (revisado): aparência, conteúdo e conteúdo completamente revisados. Mostra as taxas de erro para proxies e destinos de API. Consulte Painel de análise de código de erro.
-
Esses painéis atuais foram renomeados:
- Desempenho do endpoint foi renomeado como Desempenho do destino: mostra padrões de tráfego e métricas de desempenho para metas de back-end de proxy de API. Consulte Desempenho do destino.
- Engajamento de parceiros foi renomeado como Engajamento de desenvolvedores: mostra quais desenvolvedores de aplicativos 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 de desenvolvedores.
Serviços para desenvolvedores
Confira abaixo os novos recursos e melhorias nos serviços para desenvolvedores do Edge.
Suporte ao 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 versões anteriores do Swagger 1.2. O suporte a objetos de esquema de segurança e esquemas centralizados estará disponível em uma versão posterior.
Monetização
Confira abaixo os novos recursos e melhorias na monetização do Edge. Consulte também a seção "Problemas conhecidos" para mais informações sobre a monetização.
Tratamento separado de empresas e desenvolvedores
As empresas e os desenvolvedores agora são tratados separadamente, permitindo mais flexibilidade na adição de 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 permanecem como 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 foi atualizado |
| MGMT-1986 | Erro da interface ao adicionar um desenvolvedor |
| MGMT-1983 | A API "Receber um 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 O login na interface com determinados caracteres especiais, como o sinal de porcentagem, não falha mais. |
| MGMT-1894 | A página "Apps de desenvolvedores" nunca termina de carregar a 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 de .acn |
| MGMT-1362 | O e-mail "Esqueci minha 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 de 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 monetização instalação ou upgrade, não foram incluídos na versão. Para contornar esse problema, 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 | As chamadas de API com payloads grandes (centenas de KB) às vezes 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) |