Você está vendo a documentação do Apigee Edge.
Acesse a
documentação da Apigee X. informações
Na terça-feira, 19 de maio de 2015, lançamos uma versão trimestral do Apigee Edge para nuvem privada.
O antigo nome do produto "Apigee Edge On-Prem" ou "OPDK" agora é "Apigee Edge for Private Cloud".
Se você tiver dúvidas, acesse o suporte ao cliente da Apigee.
Para ver uma lista de todas as notas da versão do Apigee Edge, consulte as Notas de lançamento da Apigee.
Novos recursos e melhorias
Veja 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 da API Edge.
WebSockets
Para permitir 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 provedores de autenticação externos para gerenciamento de APIs
O Edge se integra ao Active Directory e a outros provedores de autenticação/sistemas LDAP externos 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 a nuvem privada.
Co-branding na interface de gerenciamento
É possível fazer o co-branding da IU 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" 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 "Trace" do editor de
proxy de API. Para ativar o recurso, defina
apigee.feature.disableNodeJSLogs="false" no arquivo apigee-base.conf ou
apigee-onprem.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 Node.js.
Validade da senha
No Edge 4.15.01.x, as senhas do Edge expiraram automaticamente após 30 dias. Isso significava que um usuário ficava bloqueado a menos que mudasse a senha antes que ela expirasse. No entanto, isso também fazia a senha do administrador do sistema expirar para que o administrador do sistema fosse bloqueado no 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 as 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 sysadmin a domínios de e-mail específicos
É possível restringir a associação nos papéis somente leitura sysadmin ou sysadmin 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 na tela com mais eficiência.
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 em caso de falha da política.
- 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.
IU 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 pelo botão "Remover". Isso ajuda a deixar claro que, ao remover um usuário de uma organização, a conta da 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 de proxies, produtos, desenvolvedores e apps da API na interface de gerenciamento, novas opções de filtragem estão disponíveis para pesquisa.
Ferramenta de rastreamento off-line
A ferramenta de rastreamento off-line permite visualizar e analisar 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 IU da ferramenta Trace off-line é semelhante à ferramenta Trace "ativa".
Para ver mais informações, consulte Como usar a ferramenta Rastreamento off-line.
Funções do usuário exibidas 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), as funções do usuário agora são exibidas.
Melhorias na interface do 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 interface de gerenciamento, dados anteriores a 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 do Edge, visíveis no estágio AX da janela de rastreamento do proxy de API.
- apigee.edge.execution.is_target_error: permite identificar se os erros da API são erros do lado do destino (valor "1") ou erros não relacionados ao destino de respostas HTTP malsucedidas (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 malsucedida (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 pré-fluxo, pós-fluxo 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 exibidos na parte inferior das páginas principais dessas entidades. Para acessar os gráficos, selecione a guia Analytics na parte superior de cada página.
- e inclui as principais alterações nestes painéis:
- Painel da Apigee (revisado): inclui três gráficos de métricas: tráfego de proxy, engajamento do desenvolvedor e apps de desenvolvedores. Cada gráfico apresenta uma visualização com "mais detalhes", que permite analisar cada métrica. Consulte o painel da Apigee.
- Desempenho de proxy (novo): mostra os padrões de tráfego do proxy da API e os tempos de processamento. Substitui o painel de desempenho do proxy de API. Consulte Desempenho do proxy da API.
- Composição do tráfego (revisada): aparência e conteúdo do painel totalmente revisados. Mede a contribuição relativa das suas principais APIs, apps, desenvolvedores e produtos para seu programa geral de API. Consulte Composição do tráfego.
- Análise de erros (revisado): aparência e conteúdo totalmente revisados. Mostra as taxas de erro para proxies e destinos da API. Consulte Painel de análise do código de erro.
-
Estes painéis existentes foram renomeados:
- Desempenho do endpoint foi renomeado como Desempenho desejado: mostra padrões de tráfego e métricas de desempenho para destinos de back-end do proxy de API. Consulte Desempenho desejado.
- O engajamento do parceiro foi renomeado como Engajamento do desenvolvedor: mostra quais dos desenvolvedores de apps registrados estão gerando mais tráfego da API. Para cada desenvolvedor, você pode descobrir quem está gerando mais tráfego de API e mais erros. Consulte Engajamento do desenvolvedor.
Serviços do desenvolvedor
Confira a seguir os novos recursos e melhorias nos Serviços para desenvolvedores de borda.
Suporte ao 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. O suporte para objetos de esquema de segurança e esquemas centralizados estará disponível em uma versão posterior.
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.
Gerenciamento separado de empresas e desenvolvedores
As empresas e 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 tem janelas separadas para "Empresas" e "Desenvolvedores", que podem ser acessadas 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 foi atualizado |
| MGMT-1986 | Erro na interface ao adicionar o 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 IU de gerenciamento com senha forte O login na IU com determinados caracteres especiais, como o sinal de porcentagem, não falha mais. |
| MGMT-1894 | A página "Apps do desenvolvedor" não 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 o usuário com um endereço de e-mail com o TLD .acn |
| MGMT-1362 | O e-mail esquecida a senha não funcionará 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 "un known_name" |
| APIRT-1346 | OAuth2.0: o valor de 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 problemas conhecidos a seguir.
| 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 esse problema, execute os seguintes comandos após a instalação do Cassandra ou faça upgrade para concluir a instalação/o upgrade da monetização:
|
| CORERT-318 | Chamadas de API com payloads grandes (centenas de KB) às vezes travam. 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) |