15.05.27 - Note di rilascio cloud Apigee Edge

Stai visualizzando la documentazione di Apigee Edge.
Vai alla documentazione di Apigee X.
info

Martedì 2 giugno 2015 abbiamo rilasciato una nuova versione cloud di Apigee Edge.

Per qualsiasi domanda, contatta l'assistenza clienti Apigee.

Per un elenco di tutte le note di rilascio di Apigee Edge, consulta le note di rilascio di Apigee.

Nuove funzionalità e miglioramenti

Di seguito sono riportate le nuove funzionalità e i miglioramenti di questa release.

Disponibilità generale di SmartDocs

SmartDocs passa dalla versione beta alla disponibilità generale. Gli aggiornamenti e le nuove funzionalità includono:

  • Supporto di Swagger 2.0, inclusa l'importazione tramite file o URL, nonché il supporto per gli oggetti di sicurezza con nomi personalizzati.
  • Miglioramenti al design visivo nei modelli che generano SmartDocs.
  • Miglioramenti all'usabilità e al flusso di lavoro nel portale per sviluppatori, disponibili tramite il menu Contenuti > SmartDocs in Drupal.
  • L'autenticazione "Token personalizzato" ora si chiama "Chiave API".
  • Oggetti "sicurezza" di autenticazione definiti a livello di revisione.
  • Configurazione dell'autenticazione del client a livello di modello. Le nuove revisioni non reimpostano più le credenziali del client SmartDocs preconfigurate.

Per ulteriori descrizioni delle funzionalità, consulta questo post del blog.

Per la documentazione di SmartDocs, consulta Utilizzare SmartDocs per documentare le API.

Nuova versione beta dell'editor proxy API

È disponibile una nuova versione beta dell'editor del proxy API. Per accedere, fai clic sul link "Accedi alla versione beta" quando modifichi un proxy API esistente. Puoi passare dall'editor "classico" a quello "beta" e viceversa.

Nuovo criterio OAuthV2

Il nuovo criterio DeleteOAuthV2Info ti consente di eliminare i codici di autorizzazione e i token di accesso. Per maggiori informazioni, consulta le Norme relative all'eliminazione delle informazioni di OAuth V2.

Nuove entità nel criterio di accesso alle entità

Il criterio Access Entity fornisce l'accesso alle seguenti nuove entità: consumerkey-scopes, authorizationcode, requesttoken e verifier. Per ulteriori informazioni, consulta Criteri relativi alle entità di accesso.

Visualizzazione dei certificati SSL in scadenza

La pagina Certificati SSL nell'interfaccia utente di gestione (Amministrazione > Certificati SSL) indica quando i certificati SSL scadono entro 10, 15, 30 o 90 giorni, a seconda della selezione nel campo del menu a discesa della nuova scadenza.

Nome dell'app sviluppatore visualizzato nell'interfaccia utente di gestione

Le app per sviluppatori in Edge hanno sia un nome interno che non cambia sia un nome visualizzato che puoi modificare. Nella pagina App sviluppatore dell'interfaccia utente di gestione (Pubblica > App sviluppatore > nome dell'app), viene visualizzato il "Nome" interno dell'app insieme al "Nome visualizzato", il che semplifica l'identificazione visiva delle app in base ai relativi nomi interni per la risoluzione dei problemi e la gestione delle API.

Rimozione della versione classica dei report personalizzati dall'interfaccia utente di gestione

La versione classica facoltativa dei report di analisi personalizzati non è più disponibile nell'interfaccia utente di gestione.


Procedura di upgrade di SmartDocs

Se utilizzi già SmartDocs durante il periodo beta, le nuove funzionalità e funzionalità nella versione di disponibilità generale richiedono l'upgrade di SmartDocs nel tuo portale sviluppatori.

Tutte le pagine SmartDocs già pubblicate nel tuo Developer Portal continueranno a funzionare, ma devi seguire la procedura di aggiornamento prima di modificare o pubblicare eventuali modifiche alle pagine esistenti o nuove.

Tieni presente che, anche se puoi visualizzare e pubblicare SmartDocs all'interno del tuo portale per sviluppatori, gli SmartDocs vengono generati dal modello API che si trova all'interno di Apigee's Edge API Management Services. Eventuali modifiche apportate a un modello API in Edge saranno le stesse in tutti gli ambienti Pantheon (in modo simile a come gli sviluppatori esistono negli ambienti Pantheon).

Per eseguire l'upgrade dalla versione beta di SmartDocs alla disponibilità generale

  1. Aggiorna e testa la release del 27/05/15 nei tuoi ambienti di sviluppo o test su Pantheon.
  2. Crea un nuovo modello per sostituire qualsiasi modello API esistente che hai utilizzato.
    • Se hai importato documenti Swagger o WADL, importali di nuovo in una nuova revisione.
    • Se gestisci il modello API tramite il modulo SmartDocs, esportalo come JSON di SmartDocs e importalo nel nuovo modello utilizzando l'allegato del file.
  3. Imposta le proprietà di sicurezza della revisione del modello. Nella pagina Contenuti > SmartDocs > modello, seleziona Impostazioni di sicurezza.
  4. Controlla l'autenticazione preconfigurata nella pagina delle impostazioni del modello (Contenuti > SmartDocs) facendo clic su Impostazioni nella colonna Operazioni.
  5. Aggiorna i modelli personalizzati in modo da utilizzare la versione 6 degli asset CSS e JS e apporta le modifiche necessarie per riflettere eventuali nuovi nomi di oggetti, come authSchemes e apiSchema. Per informazioni sull'aggiornamento dei modelli di SmartDocs, consulta Utilizzare SmartDocs per documentare le API.
  6. Esegui nuovamente il rendering e pubblica la revisione del modello.
  7. Dopo aver convalidato la nuova documentazione, aggiorna il portale di produzione alla release del 27/05/15.

Se sei un cliente Edge Enterprise e hai domande o dubbi sulla procedura di upgrade, invia un'email all'indirizzo marsh@apigee.com e cnovak@apigee.com. In caso contrario, utilizza la community Apigee per ricevere la risposta migliore.

Bug corretti

In questa release sono stati corretti i seguenti bug.

ID problema Descrizione
TBD-72 Problema relativo alle norme di registrazione dei messaggi
MGMT-2124 Le autorizzazioni del ruolo del cliente vengono reimpostate al salvataggio delle autorizzazioni nell'UI
MGMT-2048 L'utente con un ruolo personalizzato che limita le autorizzazioni di deployment a un'ambiente può eseguire il deployment in altri
MGMT-2041 Rimozione dell'elemento FaultRules dal modello di allegato predefinito
L'elemento FaultRules, che non viene utilizzato nei criteri o nei passaggi del proxy API, non viene più aggiunto automaticamente quando crei proxy API o aggiungi criteri.
MGMT-2034 Il recupero del WSDL restituisce un errore: "Errore di recupero del WSDL: errore di elaborazione del WSDL".
MGMT-1812 Aggiungi la convalida di TargetEndpoint durante l'importazione
Come per ProxyEndpoint, TargetEndpoint verrà convalidato per lo schema e le espressioni appropriati utilizzati nelle condizioni durante l'importazione del proxy API.
MGMT-1345 L'importazione di WSDL con più spazi dei nomi comporta un passaggio di compilazione SOAP scorretto
MGMT-800 La creazione di una risorsa con il nome "default" comporta un'interfaccia utente non funzionante
MGMT-602 Visualizzazione Sviluppo proxy API: aggiungi un criterio di cache della risposta quando l'endpoint non ha PreFlow/PostFlow e causa errori
MGMT-460 La ridenominazione del criterio comporta un comportamento instabile, nonché la creazione di un criterio duplicato che non può essere rimosso
DEVRT-1565 Intervalli di 15 minuti per le ACCUISE
AXAPP-1728 Ignorare le variabili di monetizzazione in Analytics
AXAPP-1690 "Errore API non valido" nei report personalizzati
AXAPP-1533 Geomap di Analytics genera un errore di chiamata API non valida
APIRT-52 Report personalizzati: il codice di stato della risposta per molte API è nullo