4.17.01 - Note di rilascio di Edge per Private Cloud

Stai visualizzando la documentazione di Apigee Edge.
Consulta la documentazione di Apigee X.
info

Mercoledì 25 gennaio 2017 abbiamo rilasciato una nuova versione di Apigee Edge for Private Cloud.

Dalla precedente release delle funzionalità di Edge for Private Cloud, sono state pubblicate le seguenti release, che sono incluse in questa release delle funzionalità:

Consulta la sezione Informazioni sulla numerazione delle release per capire come determinare se una specifica release cloud è inclusa nella tua versione di Edge for Private Cloud.

Panoramica della release

Questa release include una serie di funzionalità importanti che ti aiutano a controllare e proteggere meglio le tue API.

I flussi condivisi e gli hook di flusso ti consentono di creare un insieme riutilizzabile di policy e comportamenti in più proxy API.

Le mappe di coppie chiave-valore (KVM), che erano già una funzionalità di Edge per la persistenza a lungo termine delle coppie chiave-valore, ora possono essere criptate per una maggiore sicurezza dei dati.

Per un controllo più flessibile sull'accesso degli sviluppatori alle tue API, la UI di gestione di Edge offre più opzioni per la creazione e la gestione di chiavi API e secret (credenziali), la revoca delle app per sviluppatori e la disattivazione degli sviluppatori. Questi miglioramenti ti consentono di implementare più facilmente strategie come la rotazione delle chiavi API e di disattivare più chiavi API revocando un'app per sviluppatori (tutte le relative chiavi vengono disattivate) o disattivando uno sviluppatore (tutte le app e le chiavi dello sviluppatore vengono disattivate).

Per quanto riguarda il ritiro, la funzionalità Limiti di monetizzazione è stata ritirata.

Il resto di questo argomento contiene i dettagli su tutte le nuove funzionalità, gli aggiornamenti e le correzioni di bug contenuti nella release.

Deprecazioni e ritiri

Le seguenti funzionalità sono state ritirate o rimosse in questa release. Per saperne di più, consulta le norme sul ritiro di Edge.

Ritirato: limiti di monetizzazione (UI di Cloud 16.10.26)

La funzionalità Limiti di monetizzazione è stata rimossa dalla UI di gestione (Amministrazione > Limiti). Per ulteriori dettagli, incluso cosa utilizzare in alternativa, consulta l'avviso di ritiro: http://docs.apigee.com/monetization/content/limit-feature-deprecation-notice. (DEVRT-3259)

Supporto per RedHat/CentOS versione 6.5 rimosso

Se al momento utilizzi RedHat/CentOS versione 6.5, devi aggiornare il sistema operativo alla versione 6.6 o successiva prima di eseguire l'aggiornamento a Edge 4.17.01.

Nuove funzionalità e aggiornamenti

Di seguito sono riportate le nuove funzionalità e i miglioramenti di questa release. Oltre ai seguenti miglioramenti, questa release contiene anche diversi miglioramenti relativi a usabilità, prestazioni, sicurezza e stabilità.

Per ulteriori dettagli e istruzioni, consulta la documentazione di Edge for Private Cloud.

Cloud privato

Puoi visualizzare un banner del consenso quando un utente accede per la prima volta alla UI di Edge. Il banner del consenso mostra un testo formattato in HTML e un pulsante che l'utente seleziona per procedere alla schermata di accesso. Per saperne di più, consulta Attivazione del banner del consenso.

API BaaS supporta più data center

Ora puoi installare API BaaS in più data center. Per saperne di più, consulta Installazione di più data center per API BaaS.

Nuovi parametri di configurazione dell'installazione di API BaaS

Al file di configurazione dell'API BaaS sono stati aggiunti due nuovi parametri di configurazione:

  • BAAS_CASS_DC_LIST: specifica i nomi delle regioni dei data center BaaS. Per un singolo data center, specifica lo stesso valore di BAAS_CASS_LOCALDC.
  • BAAS_CLUSTER_SEEDS: specifica i nodi dello stack BaaS utilizzati per definire i seed del cluster BaaS.

Per saperne di più, consulta Aggiorna Apigee Edge 4.16.09 alla versione 4.17.01.

Non eseguire più l'opzione "deploy" con il comando apigee-service per API BaaS

L'opzione deploy per il comando apigee-service non è più supportata per lo stack e il portale API BaaS. Utilizza invece le opzioni configure e restart. Per saperne di più, consulta Installazione di API BaaS.

Nuovo requisito per le porte per API BaaS

Tutti i nodi dello stack BaaS devono ora aprire la porta 2551 per l'accesso da tutti gli altri nodi dello stack. Se hai più data center BaaS, la porta deve essere accessibile da tutti i nodi Stack in tutti i data center.

Per saperne di più, consulta Installazione di API BaaS e Requisiti di installazione.

Il portale per i servizi per sviluppatori ora utilizza Postgres come database e Nginx come server web

Per tutte le nuove installazioni, il portale utilizza Postgres come database anziché MySQL e MariaDB. I clienti che eseguono l'upgrade alla versione 4.17.01 da una versione precedente continuano a utilizzare MySQL o MariaDB.

Le nuove installazioni per la versione 4.17.01 installano anche Nginx come server web. I clienti che eseguono l'upgrade alla versione 4.17.01 da una versione precedente continuano a utilizzare Apache.

Il portale dei servizi per gli sviluppatori non attiva più SmartDocs per impostazione predefinita

Devi attivare SmartDocs nel portale. Per saperne di più su SmartDocs, consulta Utilizzo di SmartDocs per documentare le API.

Il portale dei servizi per sviluppatori è ora installato dagli RPM

La versione 4.17.01 del portale Developer Services viene installata da RPM utilizzando lo stesso repository e gli stessi strumenti di Edge e API BaaS. Per saperne di più, consulta Installazione del portale Developer Services.

L'installazione basata su RPM e l'updater basato su .tar utilizzano componenti diversi:

Installazione basata su RPM

Installazione basata su .tar

Server web

Nginx

Apache

Web root

/opt/apigee/apigee-drupal

/var/www/html

Porta

8079

80

Database

PostgreSQL

MySQL

PHP

php-fpm (FastCGI)

mod_php (in-process con Apache)

Upgrade di Qpid alla versione 1.35

Questa release include Qpid versione 1.35.

Upgrade di Cassandra alla versione 2.1.16

Questa release include Cassandra versione 2.1.16.

Play è stato aggiornato alla versione 2.4

Questa release include il framework UI di Play 2.4.

Aggiunto il supporto per RedHat/CentOS versione 7.3

Edge ora supporta RedHat/CentOS versione 7.3.

Aggiornamenti alla dashboard di monitoraggio beta

La versione beta della dashboard di monitoraggio Edge è stata aggiornata a:

  • Includono nuove dashboard per Cassandra, Zookeeper, OpenLDAP, Postgres e Qpid.
  • Upgrade della versione di Influx nella versione 4.16.09 da 0.11 a 1.0.2.
  • Sono state aggiunte diverse correzioni per la stabilità.

Per saperne di più, consulta la panoramica della dashboard di monitoraggio di Apigee (beta).

Ora è possibile impostare la password di Postgres nel file di configurazione dell'installazione

Utilizza la proprietà PG_PWD per impostare la password di Postgres nel file di configurazione dell'installazione. Per saperne di più, consulta il riferimento al file di configurazione di Edge.

Abilita il repository EPEL

Per installare o aggiornare Edge, devi attivare Extra Packages for Enterprise Linux (o EPEL). Per saperne di più, consulta i requisiti di installazione.

Il comando da utilizzare dipende dalla versione di RedHat/CentOS:

  • Per 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
  • Per 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

Disattiva la ricerca DNS su IPv6 quando utilizzi NSCD (Name Service Cache Daemon)

Se hai installato e abilitato NSCD (Name Service Cache Daemon), i processori di messaggi eseguono due ricerche DNS: una per IPv4 e una per IPv6. Devi disattivare la ricerca DNS su IPv6 quando utilizzi NSCD. Per saperne di più, consulta i requisiti di installazione.

Per disattivare la ricerca DNS su IPv6:

  1. In ogni nodo del processore di messaggi, modifica /etc/nscd.conf.
  2. Imposta la seguente proprietà:
    enable-cache hosts no

Servizi API

Flussi condivisi e hook di flusso per rendere operativi i proxy API (Cloud 16.09.21)

Una nuova funzionalità "Flussi condivisi" consente di rendere operative le funzionalità nei proxy API. Combinando policy e risorse condizionali in un flusso condiviso, puoi farvi riferimento da qualsiasi proxy API per eseguire una logica riutilizzabile da un'unica origine. Ad esempio, un flusso condiviso potrebbe verificare la chiave API, proteggere dagli arresti dei picchi e registrare i dati.

Puoi definire i flussi condivisi nell'interfaccia utente di gestione (API > Flussi condivisi), quindi farvi riferimento in due modi diversi:

  • Con una nuova policy Flow Callout in un proxy API
    oppure
  • In un nuovo artefatto denominato Flow Hooks, che si trova nelle seguenti posizioni:

    Questi punti di collegamento consentono di eseguire la logica operativa prima o dopo i punti di flusso principali del singolo proxy. Puoi assegnare i flussi condivisi a queste posizioni degli hook dei flussi nell'UI di gestione (API > Configurazione ambiente > Hook dei flussi).

    • Richiesta: prima del PreFlow di ProxyEndpoint, dopo il PostFlow di TargetEndpoint
    • Risposta: prima del PreFlow di TargetEndpoint, dopo il PostFlow di ProxyEndpoint

Per saperne di più, consulta Flussi condivisi riutilizzabili e Collegamento di un flusso condiviso utilizzando un hook del flusso.

Mappe di coppie chiave-valore criptate (Cloud 21/09/16)

Puoi creare mappe chiave-valore (KVM) criptate per archiviare informazioni sensibili come credenziali o dati PII/HIPAA. Questa funzionalità è diversa dall'archivio protetto Edge esistente (vault) ed è progettata per sostituirlo, poiché ai valori del vault è possibile accedere solo con Node.js (oltre all'API di gestione). Puoi accedere ai valori KVM criptati con Node.js o con la policy Key Value Map Operations.

Creazione di KVM criptati

  • Utilizza le API di gestione KVM esistenti. Quando includi “encrypted”: “true” nella definizione del payload durante la creazione di un KVM, Edge genera una chiave di crittografia con lo stesso ambito del KVM e cripta il KVM utilizzando questa chiave.
  • Non puoi utilizzare la policy Key Value Map Operations per creare un KVM criptato. Prima di utilizzarlo nella policy, devi creare un KVM criptato utilizzando le API di gestione del KVM.
  • Non puoi criptare un KVM non criptato esistente.

Utilizzo di KVM criptati

  • Utilizza la policy Key Value Map Operations per ottenere e aggiornare i valori KVM criptati.
  • Quando ottieni un valore di chiave criptata, anteponi alla variabile che deve contenere il valore la parola chiave "private". Ad esempio: <Get assignTo="private.secretVar">. La variabile private.secretVar contiene il valore decriptato.
  • Quando aggiorni un valore con la policy, non devi fare nulla di speciale. Il valore verrà criptato automaticamente nei KVM criptati.
  • Puoi anche accedere al valore decriptato utilizzando il modulo apigee-access nel codice Node.js. Utilizza la funzione getKeyValueMap() per recuperare un KVM in base al nome e all'ambito. Nell'oggetto restituito sono disponibili due funzioni: getKeys(callback) per ottenere un array di nomi di chiavi e get(key, callback) per ottenere il valore di una determinata chiave. Ad esempio, il seguente comando recupera una KVM con ambito apiproxy denominata VerySecureKVM e recupera il valore criptato di key1:
    var apigee = require('apigee-access');
      var encryptedKVM = apigee.getKeyValueMap('VerySecureKVM', 'apiproxy');
      encryptedKVM.get('key1', function(err, secretValue) {
      // use the secret value here
    });

Per saperne di più, consulta Utilizzo delle mappe chiave-valore e Accesso alle mappe chiave-valore in Node.js.

(APIRT-1197)

Crea mappe di coppie chiave-valore criptate nell'interfaccia utente (UI 16.10.26)

Quando crei una mappa di coppie chiave-valore (KVM) con ambito ambiente nell'interfaccia utente di gestione (API > Configurazione ambiente > Mappe di coppie chiave-valore), una nuova casella di controllo Criptata ti consente di creare una KVM criptata. Dopo aver aggiunto le chiavi al KVM, i valori criptati vengono visualizzati nell'interfaccia utente di gestione come asterischi (*****). Puoi aggiungere chiavi/valori a un KVM criptato esattamente come faresti per i KVM non criptati. Il supporto completo del backend per i KVM criptati è disponibile nella release cloud 160921. (EDGEUI-764)

URL delle specifiche OpenAPI inclusi nei metadati del proxy API (Cloud 16.09.21)

Quando crei un proxy API basato su una specifica OpenAPI, la posizione della specifica OpenAPI viene archiviata nei metadati del proxy API. Ad esempio, se utilizzi l'API di gestione per ottenere i dettagli di una revisione del proxy, i metadati includono il percorso della specifica OpenAPI nel seguente formato:

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

Questo miglioramento supporta la versione di nuova generazione di Edge, che collega le specifiche OpenAPI ai proxy API, ai prodotti API e ai documenti di riferimento API nel nuovo portale per sviluppatori. (MGMT-2913)

Generazione di specifiche OpenAPI per i proxy SOAP (UI Cloud 16.10.05)

Quando crei un proxy "REST to SOAP to REST" basato su un WSDL, Edge genera automaticamente una specifica OpenAPI in hosting basata sulle risorse proxy. Puoi accedere alla specifica all'indirizzo http(s)://[edge_domain]/[proxy_base_path]/openapi.json. Tuttavia, la conversione non è sempre accurata, poiché non tutte le regole di uno schema XML possono essere rappresentate in una specifica OpenAPI. (EDGEUI-718)

WSDL ospitato su Edge per proxy SOAP passthrough (UI Cloud 16.10.05)

Quando crei un proxy "SOAP pass-through" basato su un WSDL, Edge ospita il WSDL e crea un flusso nel proxy per consentirti di accedervi. Puoi accedere al WSDL ospitato all'indirizzo http(s)://[edge_domain]/[proxy_base_path]?wsdl, che è l'URL del nuovo endpoint di servizio per i client che chiamano il servizio SOAP tramite il proxy. (EDGEUI-718)

Nuovo WSDL di esempio per le quotazioni azionarie nella procedura guidata del proxy API (Cloud 16.08.24.01)

Quando crei un'API di servizio SOAP con la procedura guidata del proxy API, negli esempi è disponibile un WSDL di quotazione azionaria sostitutivo: https://ws.cdyne.com/delayedstockquote/delayedstockquote.asmx?WSDL. (EDGEUI-655)

Servizi per gli sviluppatori

Gestione delle app per sviluppatori nell'interfaccia utente (UI Cloud 16.10.05)

La gestione delle app per sviluppatori nell'interfaccia utente di Edge è diventata più potente grazie a una serie di miglioramenti:

  • Puoi revocare e approvare le app (in modalità di modifica) in un nuovo campo "Stato app". In modalità di visualizzazione, il campo mostra anche lo stato attuale dell'app. Se un'app viene revocata, nessuna delle sue chiavi API è valida per le chiamate API. Le chiavi stesse non vengono revocate e sono nuovamente disponibili per l'utilizzo se lo sviluppatore viene approvato di nuovo. L'etichetta "Approvata" per le chiavi API viene visualizzata in testo barrato quando un'app è in stato di revoca.
  • Le date di scadenza delle chiavi API sono ora visualizzate nella pagina dei dettagli dell'app per sviluppatori e le chiavi sono organizzate in base alle date di scadenza in una sezione "Credenziali". Ad esempio, una chiave senza scadenza viene visualizzata in un gruppo con i prodotti API associati, mentre una chiave che scade tra 90 giorni viene visualizzata in un altro gruppo con i prodotti associati. Non puoi modificare la scadenza di una credenziale esistente.
  • Con un nuovo pulsante Aggiungi credenziale nella modalità di modifica dell'app per sviluppatori, puoi generare chiavi API con date o ore di scadenza specifiche (o senza scadenza). Durante (o dopo) la creazione di una credenziale, puoi aggiungere prodotti API.
    Questa funzionalità sostituisce il pulsante "Rigenera chiave" nella pagina dei dettagli dell'app per sviluppatori. Questo pulsante è stato rimosso.

Questi miglioramenti aggiungono funzionalità nell'interfaccia utente che erano già disponibili nell'API di gestione. (EDGEUI-104)

Attiva/disattiva lo sviluppatore di app nell'interfaccia utente (UI di Cloud 16.10.05)

Puoi modificare lo stato di uno sviluppatore di app tra attivo e non attivo nell'interfaccia utente di Edge (pagina dei dettagli dello sviluppatore, modalità di modifica, pulsante Attiva/Disattiva). Quando uno sviluppatore è inattivo, nessuna delle sue chiavi API dell'app per sviluppatori o dei token OAuth generati con queste chiavi è valida nelle chiamate ai proxy API. (EDGEUI-304)

Indicatori di sviluppatore non attivo nell'interfaccia utente (UI 16.10.26)

Quando uno sviluppatore di app è impostato su "Non attivo", le sue app e le sue credenziali non sono più valide, anche se rimangono nello stato "Approvato". Ora, quando visualizzi le app e le credenziali di uno sviluppatore non attivo nell'interfaccia utente di gestione, l'etichetta di stato "Approvato" sulle app e sulle credenziali viene visualizzata con testo barrato e un tooltip al passaggio del mouse sull'etichetta indica che lo sviluppatore non è attivo. Se lo sviluppatore viene ripristinato su "Attivo", le sue app e credenziali approvate sono di nuovo valide e il testo barrato sull'etichetta "Approvato" viene rimosso. (EDGEUI-728)

Servizi di analisi

Dashboard "Analisi dei codici di errore" rinominata (UI 16.10.26)

La dashboard "Analisi degli errori" è stata rinominata "Analisi dei codici di errore". La dashboard include chiamate API con codici di stato HTTP 4xx e 5xx. (EDGEUI-738)

Dati TPS sulle dashboard dei proxy (UI 16.10.26)

I dati relativi alle transazioni medie al secondo ("TPS media") sono stati aggiunti alla dashboard principale Traffico proxy. Inoltre, quando passi il mouse sopra i singoli punti dati nei grafici Traffico proxy e Prestazioni proxy, il valore TPS per quell'intervallo di tempo viene visualizzato nel tooltip. (EDGEUI-668)

Visualizzazione degli errori di Analytics (UI 16.10.26)

Quando una dashboard di analisi riceveva un errore 500, l'interfaccia utente di gestione visualizzava "Timeout del report" indipendentemente dall'errore. Per fornire migliori funzionalità di risoluzione dei problemi, la UI ora mostra l'errore effettivo. (EDGEUI-753)

Correzioni di bug

In questa release sono stati corretti i seguenti bug. Questo elenco è destinato principalmente agli utenti che vogliono verificare se i loro ticket di assistenza sono stati risolti. Non è progettato per fornire informazioni dettagliate per tutti gli utenti.

Edge for Private Cloud 4.17.01

ID problema Descrizione
APIBAAS-1990 Lo stack API BaaS non tenta più di autenticarsi su SMTP quando smtp.auth è false
APIRT-3032

L'esecuzione del comando "apigee-service baas-usergrid restart" ora esegue anche "configure"

Non è più necessario eseguire "apigee-service baas-usergrid configure" seguito da "apigee-service baas-usergrid restart" per lo stack BaaS.

APIRT-3032

Non eseguire la ricerca DNS se il nome host è un indirizzo IP.

DOS-4070

"apigee-all -version" ora mostra la versione degli RPM edge-mint-*

DOS-4359

Aggiunta l'opzione "pdb" per installare solo il database Postgres.

Utilizzato solo durante l'installazione del portale dei servizi per sviluppatori. Consulta Installazione del portale Developer Services.

Cloud 16.10.26 (UI)

ID problema Descrizione
EDGEUI-768 La creazione del proxy con StockQuote WSDL non va a buon fine

Cloud 16.09.21_9

ID problema Descrizione
MGMT-3674 Impossibile creare KVM o vault criptati per le organizzazioni abilitate per HIPAA
MGMT-3647 L'accesso al ruolo utente per gli utenti con indirizzo email con lettere maiuscole genera l'errore 403

Cloud 16.09.21

ID problema Descrizione
APIRT-3507 Errori intermittenti (ad esempio errori SNI) nei callout di servizio JavaScript
APIRT-3408 MP release 160817 apigee-access analytics module processing messages differently
APIRT-3390

Modifica della risposta di errore restituita dalla policy di aggiornamento del token di accesso

APIRT-3389
APIRT-3381 Latenze elevate sui proxy di produzione dei clienti
APIRT-3366 Le policy JavaScript non funzionano in tutte le nuove organizzazioni di prova
APIRT-3363 L'analisi di un URL non valido restituisce uno stato 500 con ApplicationNotFound
APIRT-3356 Messaggio di token OAuth non valido
APIRT-3355 Errore 403 intermittente sul proxy OAuth
APIRT-3285
APIRT-3261 Le credenziali vengono convalidate rispetto a un'altra app di sviluppo in produzione
APIRT-3234 L'app Node.js restituisce un errore NPE
APIRT-3223 Problema di cache inattiva di Apigee
APIRT-3193 Il server di destinazione Node.js si blocca dopo lo spostamento in ASG
APIRT-3152 cachedlogs management call causes log messages to be broken up
APIRT-3117 Il processore di messaggi ha raggiunto il 100% di utilizzo della CPU e ha smesso di gestire il traffico
APIRT-3064 Router - messaggio di errore 503 personalizzato dal router
APIRT-2620 Pool di thread separato per alcuni passaggi di blocco per migliorare la gestione del carico
CORESERV-774 Access using valid key with invalid apiproduct reference causes internal server error

Cloud 16.10.05 (UI)

ID problema Descrizione
EDGEUI-697 Pulsante di esportazione della pagina Report
Il pulsante Esporta è stato rimosso dalla home page dei report personalizzati. L'esportazione dei report è disponibile in ogni pagina dei report personalizzati.

Cloud 16.08.24.01

ID problema Descrizione
EDGEUI-663 Il proxy generato per la porta WeatherHttpGet di Weather.wsdl non funziona in fase di runtime con l'errore 500
Quando si genera un proxy API per un servizio SOAP, le porte WSDL senza un'associazione del protocollo SOAP non sono più visibili nella procedura guidata del proxy API. Questo è un comportamento previsto, in quanto la procedura guidata genera solo richieste SOAP.
EDGEUI-658 Problema relativo al nome dell'operazione di passthrough WSDL SOAP
EDGEUI-653 Errore durante la creazione del proxy API Node.js quando è selezionata l'opzione Abilita CORS
EDGEUI-648 Le chiamate dalla UI che richiedono tra 2 e 3 minuti vanno in timeout
EDGEUI-623 Il pulsante Modifica data della cronologia dell'organizzazione non funziona su Firefox