15.05.27 - Note di rilascio cloud Apigee Edge

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

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

In caso di domande, contatta l'assistenza Apigee Edge.

Per un elenco di tutte le note di rilascio di Apigee Edge, consulta 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 Smart Docs

Smart Docs passerà dalla versione beta alla disponibilità generale. Gli aggiornamenti e le nuove funzionalità includono:

  • Supporto di Swagger 2.0, inclusa l'importazione per file o URL, incluso il supporto per oggetti di sicurezza con nome personalizzato.
  • Miglioramenti della progettazione visiva nei modelli che generano Smart Documenti.
  • Miglioramenti dell'usabilità e del flusso di lavoro nel Developer Portal, disponibili tramite il menu Contenuti > SmartDocs in Drupal.
  • L'autenticazione nota come "token personalizzato" ora si chiama "chiave API".
  • Oggetti "sicurezza" di autenticazione definiti a livello di revisione.
  • Configurazione dell'autenticazione client a livello di modello. Le nuove revisioni non reimpostano più le credenziali client Smart Docs preconfigurate.

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

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

Nuova versione beta dell'editor proxy API

È disponibile una nuova versione beta dell'editor proxy API. Per accedere, fai clic sul link "Accedi alla versione beta" quando modifichi un proxy API esistente. Puoi passare da un editor all'altro tra la versione "classica" e quella "beta".

Nuova policy OAuthV2

Le nuove norme DeleteOAuthV2Info consentono di eliminare i codici di autorizzazione e i token di accesso. Per maggiori informazioni, consulta Elimina la policy OAuthV2 Info.

Nuove entità nella policy Access Entity

Il criterio Entità di accesso fornisce l'accesso alle seguenti nuove entità: consumerkey-scopes, authorizationcode, requesttoken e verifier. Per saperne di più, consulta Policy dell'entità di accesso.

Mostra i certificati SSL che stanno per scadere

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 nuovo campo a discesa Scadenza.

Nome dell'app sviluppatore visualizzato nella UI di gestione

Le app per sviluppatori in Edge hanno sia un nome interno che non cambia sia un nome visualizzato che puoi modificare. In una pagina dell'app sviluppatore nell'interfaccia utente di gestione (Pubblica > App sviluppatore > nome dell'app), il "Nome" interno dell'app viene visualizzato insieme al "Nome visualizzato", il che semplifica l'identificazione visiva delle app in base ai loro 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 Smart Docs

Se hai già utilizzato Smart Docs durante il periodo beta, le nuove funzionalità nella versione di disponibilità generale richiedono l'upgrade di Smart Docs nel tuo portale per sviluppatori.

Le pagine Smart Docs già pubblicate nel portale per sviluppatori continueranno a funzionare, ma devi seguire la procedura di aggiornamento prima di modificare o pubblicare qualsiasi modifica alle pagine esistenti o nuove.

Tieni presente che, sebbene tu possa eseguire il rendering e pubblicare Smart Docs all'interno del tuo portale per sviluppatori, Smart Docs vengono generate dal modello API che si trova all'interno dei servizi di gestione delle API Edge di Apigee. Le 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 Smart Docs alla disponibilità generale

  1. Aggiorna e testa la release 15.05.27 nei tuoi ambienti dev 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 hai gestito il modello API tramite il modulo Smart Docs, esportalo come Smart Docs JSON e importalo nel nuovo modello utilizzando l'allegato di file.
  3. Imposta le proprietà di sicurezza della revisione del modello. Nella pagina Contenuti > Smart Docs > modello, seleziona Impostazioni di sicurezza.
  4. Controlla l'eventuale autenticazione preconfigurata nella pagina delle impostazioni del modello (Contenuti > Smart Docs) facendo clic su Impostazioni nella colonna Operazioni.
  5. Aggiorna tutti i modelli personalizzati in modo che utilizzino la versione 6 degli asset CSS e JS e apporta modifiche per riflettere eventuali nuovi nomi di oggetti, come authSchemes e apiSchema. Per informazioni sull'aggiornamento dei modelli Smart Docs, consulta Utilizzare Smart Docs per documentare le API.
  6. Esegui di nuovo il rendering e pubblica la revisione del modello.
  7. Dopo aver convalidato la nuova documentazione, aggiorna il portale di produzione alla versione 15.05.27.

Se sei un cliente aziendale di Edge e hai domande o dubbi sulla procedura di upgrade, invia un'email a 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 cliente vengono reimpostate al salvataggio delle autorizzazioni nell'interfaccia utente
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 Rimuovi l'elemento FaultRules dal modello di collegamento predefinito
L'elemento FaultRules, che non viene utilizzato nei passaggi dei proxy API o delle norme, non viene più aggiunto automaticamente quando crei proxy API o aggiungi norme.
MGMT-2034 Il recupero del file WSDL restituisce un errore: "Errore di recupero del file WSDL: errore durante l'elaborazione del file WSDL".
MGMT-1812 Aggiungi la convalida di TargetEndpoint durante l'importazione
Analogamente a ProxyEndpoint, TargetEndpoint verrà convalidato per lo schema corretto e le espressioni utilizzate nelle condizioni durante l'importazione del proxy API.
MGMT-1345 L'importazione di WSDL con più spazi dei nomi genera un passaggio Build SOAP errato
MGMT-800 La creazione di una risorsa con il nome "default" comporta un'interfaccia utente danneggiata
MGMT-602 Visualizzazione Sviluppo proxy API: aggiungi un criterio di cache delle risposte quando l'endpoint non ha PreFlow/PostFlow causa un errore
MGMT-460 La ridenominazione della policy comporta un comportamento anomalo, una policy duplicata che non può essere rimossa
DEVRT-1565 Intervalli di 15 minuti per le CORSE
AXAPP-1728 Ignora le variabili di monetizzazione in Analytics
AXAPP-1690 "Errore API non valido" nei report personalizzati
AXAPP-1533 La mappa geografica di Analytics genera l'errore Chiamata API non valida
APIRT-52 Report personalizzati: il codice di stato della risposta per molte API è nullo