4.17.01 - Notas de lançamento do Edge for Private Cloud

Você está lendo a documentação do Apigee Edge.
Acesse a documentação da Apigee X.
info

Na quarta-feira, 25 de janeiro de 2017, lançamos uma nova versão do Apigee Edge para nuvem privada.

Desde a versão anterior do Edge para nuvem privada, as seguintes versões ocorreram e estão incluídas nesta versão:

Consulte Sobre a numeração de versões para entender como descobrir se uma versão específica da nuvem está incluída na sua versão do Edge para nuvem privada.

Visão geral da versão

Esta versão inclui vários recursos importantes que ajudam a controlar e proteger melhor suas APIs.

Com os fluxos compartilhados e os hooks de fluxo, é possível criar um conjunto reutilizável de políticas e comportamentos em vários proxies de API.

Os mapas de chave-valor (KVMs), que já eram um recurso do Edge para persistência de longo prazo de pares de chave-valor, agora podem ser criptografados para aumentar a segurança dos dados.

Para um controle mais flexível sobre o acesso de desenvolvedores às suas APIs, a IU de gerenciamento do Edge oferece mais opções para criar e gerenciar chaves e secrets de API (credenciais), revogar apps de desenvolvedor e desativar desenvolvedores. Com essas melhorias, é mais fácil implementar estratégias como a rotação de chaves de API e desativar várias chaves de API revogando um app de desenvolvedor (todas as chaves dele são desativadas) ou desativando um desenvolvedor (todos os apps e chaves do desenvolvedor são desativados).

Em relação à descontinuação, o recurso de limites de monetização foi desativado.

O restante deste tópico contém detalhes sobre todos os novos recursos, atualizações e correções de bugs incluídos na versão.

Descontinuações e desativações

Os recursos a seguir foram descontinuados ou removidos nesta versão. Consulte a política de descontinuação da Edge para mais informações.

Desativado: limites de monetização (IU do Cloud 16.10.26)

O recurso de limites de monetização foi removido da interface de gerenciamento (Administrador > Limites). Consulte o aviso de descontinuação para mais detalhes, incluindo o que usar em vez disso: http://docs.apigee.com/monetization/content/limit-feature-deprecation-notice. (DEVRT-3259)

Suporte para RedHat/CentOS versão 6.5 removido

Se você estiver usando a versão 6.5 do RedHat/CentOS, atualize o sistema operacional para a versão 6.6 ou mais recente antes de atualizar para o Edge 4.17.01.

Novos recursos e atualizações

Confira a seguir os novos recursos e melhorias desta versão. Além das melhorias a seguir, esta versão também contém várias melhorias de usabilidade, desempenho, segurança e estabilidade.

Para mais detalhes e instruções, consulte a documentação do Edge para nuvem privada.

Nuvem privada

É possível exibir um banner de consentimento quando um usuário acessa a interface do Edge pela primeira vez. O banner de consentimento mostra um texto formatado em HTML e um botão que o usuário seleciona para acessar a tela de login. Consulte Ativar o banner de consentimento para mais informações.

A API BaaS é compatível com vários data centers

Agora é possível instalar a API BaaS em vários data centers. Consulte Instalação de vários data centers para API BaaS para mais informações.

Novos parâmetros de configuração de instalação do BaaS da API

Dois novos parâmetros de configuração foram adicionados ao arquivo de configuração da API BaaS:

  • BAAS_CASS_DC_LIST: especifica os nomes das regiões dos data centers do BaaS. Para um único data center, especifique o mesmo valor de BAAS_CASS_LOCALDC.
  • BAAS_CLUSTER_SEEDS: especifica os nós da pilha do BaaS usados para definir as sementes do cluster do BaaS.

Consulte Atualizar o Apigee Edge 4.16.09 para 4.17.01 para mais informações.

Não execute mais a opção "deploy" com o comando apigee-service para a API BaaS

A opção deploy para o comando apigee-service não é mais compatível com a pilha e o portal da API BaaS. Em vez disso, use as opções configure e restart. Consulte Instalação da API BaaS para saber mais.

Novo requisito de porta para o API BaaS

Todos os nós da pilha do BaaS agora precisam abrir a porta 2551 para acesso de todos os outros nós da pilha. Se você tiver vários data centers do BaaS, a porta precisará ser acessível em todos os nós da pilha em todos os data centers.

Consulte Instalação da API BaaS e Requisitos de instalação para mais informações.

O portal de serviços para desenvolvedores agora usa o Postgres como banco de dados e o Nginx como servidor da Web

Para todas as novas instalações, o portal usa o Postgres como banco de dados em vez do MySQL e do MariaDB. Os clientes que fizerem upgrade para a versão 4.17.01 de uma versão anterior vão continuar usando o MySQL ou o MariaDB.

As novas instalações da versão 4.17.01 também instalam o Nginx como servidor da Web. Os clientes que fizerem upgrade para a versão 4.17.01 de uma versão anterior continuarão usando o Apache.

O portal de serviços para desenvolvedores não ativa mais o SmartDocs por padrão

Ative o SmartDocs no portal. Para mais informações sobre o SmartDocs, consulte Como usar o SmartDocs para documentar APIs.

Portal de serviços para desenvolvedores agora instalado a partir de RPMs

A versão 4.17.01 do portal de serviços para desenvolvedores é instalada a partir de RPMs usando o mesmo repositório e as mesmas ferramentas do Edge e da API BaaS. Consulte Instalação do portal de serviços para desenvolvedores para mais informações.

A instalação baseada em RPM e o atualizador baseado em .tar usam componentes diferentes:

Instalação baseada em RPM

Instalação baseada em .tar

Servidor da Web

Nginx

Apache

Raiz da Web

/opt/apigee/apigee-drupal

/var/www/html

Porta

8079

80

Banco de dados

PostgreSQL

MySQL

PHP

php-fpm (FastCGI)

mod_php (em processo com o Apache)

O Qpid foi atualizado para a versão 1.35.

Esta versão inclui o Qpid versão 1.35.

Cassandra atualizado para a versão 2.1.16

Esta versão inclui o Cassandra versão 2.1.16.

O Play foi atualizado para a versão 2.4

Esta versão inclui o framework de interface do Play 2.4.

Adicionamos suporte para RedHat/CentOS versão 7.3

O Edge agora é compatível com o RedHat/CentOS versão 7.3.

Atualizações no painel de monitoramento Beta

A versão Beta do painel de monitoramento do Edge foi atualizada para:

  • Inclui novos painéis para Cassandra, Zookeeper, OpenLDAP, Postgres e Qpid.
  • A versão do Influx foi atualizada na 4.16.09 de 0.11 para 1.0.2.
  • Adição de várias correções de estabilidade.

Consulte Visão geral da versão Beta do painel de monitoramento da Apigee para mais informações.

Agora é possível definir a senha do Postgres no arquivo de configuração de instalação

Use a propriedade PG_PWD para definir a senha do Postgres no arquivo de configuração de instalação. Consulte a Referência do arquivo de configuração do Edge para mais informações.

Ativar o repositório EPEL

Ative os Pacotes extras para o Enterprise Linux (ou EPEL) para instalar ou atualizar o Edge. Consulte Requisitos de instalação para mais informações.

O comando usado depende da versão do RedHat/CentOS:

  • Para RedHat/CentOS 7.x:
    > wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm; rpm -ivh epel-release-latest-7.noarch.rpm
  • Para RedHat/CentOS 6.x:
    wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm; rpm -ivh epel-release-latest-6.noarch.rpm

Desativar a busca DNS no IPv6 ao usar o NSCD (Name Service Cache Daemon)

Se você tiver instalado e ativado o NSCD (Name Service Cache Daemon), os processadores de mensagens vão fazer duas buscas DNS: uma para IPv4 e outra para IPv6. É necessário desativar a busca DNS no IPv6 ao usar o NSCD. Consulte Requisitos de instalação para mais informações.

Para desativar a busca DNS no IPv6:

  1. Em cada nó do processador de mensagens, edite /etc/nscd.conf.
  2. Defina a seguinte propriedade:
    enable-cache hosts no

Serviços da API

Fluxos compartilhados e ganchos de fluxo para operacionalizar proxies de API (Cloud 16.09.21)

Um novo recurso de "fluxos compartilhados" permite operacionalizar a funcionalidade em proxies de API. Ao combinar políticas e recursos condicionados em um fluxo compartilhado, é possível referenciá-lo em qualquer proxy de API para executar uma lógica reutilizável de fonte única. Por exemplo, um fluxo compartilhado pode verificar a chave de API, proteger contra detenções de pico e registrar dados.

Defina os fluxos compartilhados na interface de gerenciamento (APIs > Fluxos compartilhados) e, em seguida, faça referência a eles de duas maneiras diferentes:

  • Com uma nova política de chamada de fluxo em um proxy de API
    ou
  • Em um novo artefato chamado "Ganchos de fluxo", que estão nos seguintes locais:

    Esses pontos de anexação permitem executar a lógica operacional antes ou depois dos pontos de fluxo principais do proxy individual. Atribua fluxos compartilhados a esses locais de hook de fluxo na interface de gerenciamento (APIs > Configuração do ambiente > Hooks de fluxo).

    • Solicitação: antes do PreFlow do ProxyEndpoint, depois do PostFlow do TargetEndpoint
    • Resposta: antes do PreFlow do TargetEndpoint, depois do PostFlow do ProxyEndpoint

Para mais informações, consulte Fluxos compartilhados reutilizáveis e Como anexar um fluxo compartilhado usando um gancho de fluxo.

Mapas de chave-valor criptografados (Cloud 16.09.21)

É possível criar mapas de chave-valor (KVMs) criptografados para armazenar informações sensíveis, como credenciais ou dados de PII/HIPAA. Esse recurso é diferente do armazenamento seguro do Edge (vault) e foi projetado para substituí-lo, já que os valores do vault só podem ser acessados com o Node.js (além da API Management). É possível acessar valores de KVM criptografados com o Node.js ou a política de operações de mapa de chave-valor.

Como criar KVMs criptografadas

  • Use as APIs de gerenciamento de KVM atuais. Quando você inclui “encrypted”: “true” na definição do payload ao criar uma KVM, o Edge gera uma chave de criptografia que tem o mesmo escopo da KVM e a criptografa usando essa chave.
  • Não é possível usar a política de operações de mapa de chave-valor para criar um KVM criptografado. É preciso criar um KVM criptografado usando as APIs de gerenciamento de KVM antes de usá-lo na política.
  • Não é possível criptografar um KVM não criptografado.

Como usar KVMs criptografadas

  • Use a política de operações de mapa de chave-valor para receber e atualizar valores de KVM criptografados.
  • Ao receber um valor de chave criptografado, use o prefixo "private." na variável que vai armazenar o valor. Por exemplo, <Get assignTo="private.secretVar">. Essa variável private.secretVar contém o valor descriptografado.
  • Ao atualizar um valor com a política, não é necessário fazer nada de especial. O valor será criptografado automaticamente em KVMs criptografados.
  • Também é possível acessar o valor descriptografado usando o módulo apigee-access no código Node.js. Use a função getKeyValueMap() para recuperar um KVM com base no nome e no escopo. Duas funções estão disponíveis no objeto retornado: getKeys(callback) para receber uma matriz de nomes de chaves e get(key, callback) para receber o valor de uma chave específica. Por exemplo, o código a seguir recebe um KVM com escopo de apiproxy chamado VerySecureKVM e recupera o valor criptografado de key1:
    var apigee = require('apigee-access');
      var encryptedKVM = apigee.getKeyValueMap('VerySecureKVM', 'apiproxy');
      encryptedKVM.get('key1', function(err, secretValue) {
      // use the secret value here
    });

Para mais informações, consulte Como trabalhar com mapas de chave-valor e Como acessar mapas de chave-valor no Node.js.

(APIRT-1197)

Criar mapas de chave-valor criptografados na IU (IU 16.10.26)

Ao criar um mapa de chave-valor (KVM) com escopo de ambiente na IU de gerenciamento (APIs > Configuração do ambiente > Mapas de chave-valor), uma nova caixa de seleção Criptografado permite criar um KVM criptografado. Depois de adicionar chaves ao KVM, os valores criptografados aparecem na IU de gerenciamento como asteriscos (*****). Adicione chaves/valores a um KVM criptografado exatamente como você faz para KVMs não criptografados. O suporte completo de back-end para KVMs criptografadas estava disponível na versão de nuvem 160921. (EDGEUI-764)

URLs de especificação da OpenAPI incluídos nos metadados do proxy de API (Cloud 16.09.21)

Quando você cria um proxy de API com base em uma especificação OpenAPI, o local da especificação OpenAPI é armazenado nos metadados do proxy de API. Por exemplo, se você usar a API Management para ver os detalhes de uma revisão de proxy, os metadados vão incluir o caminho para a especificação OpenAPI no seguinte formato:

"spec" : "https://raw.githubusercontent.com/apigee/api-platform-samples/master/default-proxies/helloworld/openapi/mocktarget.yaml"

Essa melhoria é compatível com a versão de última geração do Edge, que vincula as especificações da OpenAPI a proxies de API, produtos de API e documentos de referência da API no novo portal do desenvolvedor. (MGMT-2913)

Geração de especificações OpenAPI para proxies SOAP (IU do Cloud 16.10.05)

Quando você cria um proxy "REST para SOAP para REST" com base em um WSDL, o Edge gera automaticamente uma especificação OpenAPI hospedada com base nos recursos do proxy. Acesse a especificação em http(s)://[edge_domain]/[proxy_base_path]/openapi.json. No entanto, a conversão nem sempre é precisa, já que nem todas as regras de um esquema XML podem ser representadas em uma especificação OpenAPI. (EDGEUI-718)

WSDL hospedado no Edge para proxies SOAP de passagem (IU do Cloud 16.10.05)

Quando você cria um proxy "Pass-Through SOAP" com base em um WSDL, o Edge hospeda o WSDL e cria um fluxo no proxy para que você possa acessá-lo. É possível acessar o WSDL hospedado em http(s)://[edge_domain]/[proxy_base_path]?wsdl, que é o novo URL de endpoint de serviço para clientes que chamam o serviço SOAP pelo proxy. (EDGEUI-718)

Novo exemplo de cotação de ações WSDL no assistente de proxy de API (Cloud 16.08.24.01)

Ao criar uma API de serviço SOAP com o assistente de proxy de API, um WSDL de cotação de ações de substituição está disponível nos exemplos: https://ws.cdyne.com/delayedstockquote/delayedstockquote.asmx?WSDL. (EDGEUI-655)

Serviços do desenvolvedor

Gerenciamento de apps para desenvolvedores na IU (IU do Cloud 16.10.05)

O gerenciamento de apps para desenvolvedores na IU do Edge ficou mais eficiente com várias melhorias:

  • Você pode revogar e aprovar apps (no modo de edição) em um novo campo "Status do app". No modo de visualização, o campo também mostra o status atual do app. Se um app for revogado, nenhuma das chaves de API dele será válida para chamadas de API. As chaves não são revogadas e ficam disponíveis novamente para uso se o desenvolvedor for aprovado de novo. O rótulo "Aprovado" para chaves de API é exibido em texto tachado enquanto um app está em um estado revogado.
  • As datas de validade das chaves de API agora são mostradas na página "Detalhes do app do desenvolvedor", e as chaves são organizadas por datas de validade em uma seção "Credenciais". Por exemplo, uma chave sem validade é mostrada em um grupo com os produtos de API associados, e uma chave que expira em 90 dias é mostrada em outro grupo com os produtos associados. Não é possível alterar a validade de uma credencial atual.
  • Com um novo botão "Adicionar credencial" no modo de edição do app para desenvolvedores, é possível gerar chaves de API com datas ou horários de validade específicos (ou sem validade). Ao criar uma credencial (ou depois), é possível adicionar produtos de API a ela.
    Essa funcionalidade substitui o botão "Gerar chave novamente" na página de detalhes do app do desenvolvedor. Esse botão foi removido.

Essas melhorias adicionam recursos à interface que já estavam disponíveis na API Management. (EDGEUI-104)

Ativar/desativar o desenvolvedor de apps na interface (interface do Cloud 16.10.05)

É possível alterar o status de um desenvolvedor de apps entre ativo e inativo na IU do Edge (página "Detalhes do desenvolvedor", modo de edição, botão "Ativar/Desativar"). Quando um desenvolvedor está inativo, nenhuma das chaves de API do app do desenvolvedor ou dos tokens OAuth gerados com essas chaves é válida em chamadas para proxies de API. (EDGEUI-304)

Indicadores de desenvolvedor inativo na interface (interface 16.10.26)

Quando um desenvolvedor de apps é definido como "Inativo", os apps e as credenciais dele não são mais válidos, mesmo que permaneçam no estado "Aprovado". Agora, ao visualizar os apps e as credenciais de um desenvolvedor inativo na interface de gerenciamento, o rótulo de status "Aprovado" nos apps e nas credenciais é exibido em texto tachado, e uma dica de ferramenta ao passar o mouse sobre o rótulo indica que o desenvolvedor está inativo. Se o desenvolvedor for restaurado para "Ativo", os apps e as credenciais aprovados dele serão válidos novamente, e o texto tachado no rótulo "Aprovado" será removido. (EDGEUI-728)

Serviços de análise

Painel "Análise do código do erro" renomeado (IU 16.10.26)

O painel "Análise de erros" foi renomeado para "Análise de códigos de erro". O painel inclui chamadas de API com códigos de status HTTP 4xx e 5xx. (EDGEUI-738)

Dados de TPS em painéis de proxy (IU 16.10.26)

Os dados de transações médias por segundo ("TPS médio") foram adicionados ao painel principal de tráfego de proxy. Além disso, quando você passa o cursor sobre pontos de dados individuais nos gráficos de tráfego e desempenho do proxy, o TPS desse intervalo de tempo é exibido na dica. (EDGEUI-668)

Exibição de erro do Analytics (interface 16.10.26)

Quando um painel de análise recebia um erro 500, a IU de gerenciamento exibia "Tempo limite do relatório esgotado", independentemente do erro. Para oferecer melhores recursos de solução de problemas, a interface agora mostra o erro real. (EDGEUI-753)

Correções de bugs

Os bugs a seguir foram corrigidos nesta versão. Esta lista é principalmente para usuários que verificam se os tíquetes de suporte foram corrigidos. Ela não foi projetada para fornecer informações detalhadas a todos os usuários.

Edge para nuvem privada 4.17.01

ID do problema Descrição
APIBAAS-1990 A pilha da API BaaS não tenta mais autenticar no SMTP quando smtp.auth é falso
APIRT-3032

A execução do comando "apigee-service baas-usergrid restart" agora também executa "configure"

Não é mais necessário executar "apigee-service baas-usergrid configure" seguido por "apigee-service baas-usergrid restart" para a pilha do BaaS.

APIRT-3032

Não faça uma busca DNS se o nome do host for um endereço IP.

DOS-4070

"apigee-all -version" agora mostra a versão dos RPMs edge-mint-*

DOS-4359

Adicionamos a opção "pdb" para instalar apenas o banco de dados do Postgres.

Usado apenas ao instalar o portal de serviços para desenvolvedores. Consulte Instalação do portal do Developer Services.

Cloud 16.10.26 (interface)

ID do problema Descrição
EDGEUI-768 A criação do proxy com o WSDL StockQuote está falhando

Cloud 16.09.21_9

ID do problema Descrição
MGMT-3674 Não é possível criar KVMs ou Vaults criptografados para organizações com a HIPAA ativada
MGMT-3647 O acesso de Userrole para usuários com e-mail em letras maiúsculas gera o erro 403

Cloud 16.09.21

ID do problema Descrição
APIRT-3507 Erros intermitentes (como erros de SNI) em chamadas de serviço JavaScript
APIRT-3408 O módulo de análise de acesso da Apigee da versão 160817 do MP processa mensagens de maneira diferente
APIRT-3390

Mudança na resposta de falha retornada pela política de atualização do token de acesso

APIRT-3389
APIRT-3381 Latências altas em proxies de produção do cliente
APIRT-3366 As políticas de JavaScript estão falhando em todas as novas organizações de teste
APIRT-3363 A análise de URL inválida retorna um status 500 com ApplicationNotFound
APIRT-3356 Mensagem de token OAuth inválido
APIRT-3355 Erro 403 intermitente no proxy OAuth
APIRT-3285
APIRT-3261 As credenciais são validadas em relação a outro app de desenvolvimento em produção
APIRT-3234 O app Node.js retorna NPE
APIRT-3223 Problema de cache desatualizado da Apigee
APIRT-3193 O servidor de destino do Node.js está travando após a mudança para o ASG
APIRT-3152 A chamada de gerenciamento cachedlogs faz com que as mensagens de registro sejam divididas
APIRT-3117 O MP atingiu 100% de utilização da CPU e parou de exibir tráfego
APIRT-3064 Roteador: mensagem de erro 503 personalizada do roteador
APIRT-2620 Pool de linhas de execução separado para algumas etapas de bloqueio para melhorar o processamento de carregamento
CORESERV-774 O acesso usando uma chave válida com referência de apiproduct inválida causa um erro interno do servidor

Cloud 16.10.05 (IU)

ID do problema Descrição
EDGEUI-697 Botão de exportação da página de relatórios
O botão "Exportar" foi removido da página inicial de relatórios personalizados. A exportação de relatórios está disponível em cada página de relatórios personalizados.

Cloud 16.08.24.01

ID do problema Descrição
EDGEUI-663 O proxy gerado para a porta WeatherHttpGet de Weather.wsdl falha no ambiente de execução com o erro 500
Ao gerar um proxy de API para um serviço SOAP, as portas WSDL sem uma vinculação de protocolo SOAP não ficam mais visíveis no assistente de proxy de API. Isso é intencional, já que o assistente só gera solicitações SOAP.
EDGEUI-658 Problema com o nome da operação de passagem do WSDL SOAP
EDGEUI-653 Erro ao criar o proxy de API do Node.js quando a opção "Ativar CORS" está selecionada
EDGEUI-648 As chamadas da interface que levam entre 2 e 3 minutos expiram
EDGEUI-623 O botão "Alterar data" do histórico da organização não funciona no Firefox