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, incluso l'importazione per file o URL, incluso il supporto per oggetti di sicurezza con nome personalizzato.
  • Miglioramenti al design visivo nei modelli che generano Smart Docs.
  • Miglioramenti dell'usabilità e del flusso di lavoro nel portale per sviluppatori, disponibili tramite il menu Contenuti > Smart Docs in Drupal.
  • L'autenticazione nota come "token personalizzato" è ora denominata "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 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 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".

Nuove norme OAuthV2

Le nuove norme DeleteOAuthV2Info consentono di eliminare i codici di autorizzazione e i token di accesso. Per maggiori informazioni, consulta le norme sull'eliminazione delle informazioni OAuthV2.

Nuove entità nel criterio 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 di accesso all'entità.

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 nuovo campo a discesa per la scadenza.

Nome dell'app dello 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. In una pagina dell'app per sviluppatori nell'interfaccia utente di gestione (Pubblica > App per sviluppatori > 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 SmartDocs durante il periodo beta, le nuove funzionalità nella versione di disponibilità generale richiedono l'upgrade di SmartDocs nel tuo portale per sviluppatori.

Tutte le pagine Smart Docs già pubblicate nel tuo portale per sviluppatori 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, sebbene tu possa eseguire il rendering e pubblicare SmartDocs all'interno del tuo portale per sviluppatori, SmartDocs 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 negli 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 SmartDocs, esportalo come SmartDocs 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 SmartDocs, consulta Utilizzare SmartDocs 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 di WSDL restituisce l'errore: "Errore di recupero di WSDL: errore durante l'elaborazione di 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 della risposta 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 Ignorare 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 è null