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 di 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 SmartDocs

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

  • Supporto per Swagger 2.0, inclusa l'importazione tramite file o URL, incluso il supporto per oggetti di sicurezza con nomi personalizzati.
  • Miglioramenti del design visivo nei modelli che generano SmartDocs.
  • Miglioramenti dell'usabilità e del flusso di lavoro nel portale per gli sviluppatori, disponibile tramite il menu Contenuti > SmartDocs in Drupal.
  • L'autenticazione "Token personalizzato" è ora denominata "Chiave API".
  • Oggetti di "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 accedervi, fai clic sul link "Accedi alla versione beta Version" quando modifichi un proxy API esistente. Puoi passare dall'editor "classico" a quello "beta" e viceversa.

Nuova policy OAuthV2

La nuova policy DeleteOAuthV2Info consente di eliminare i codici di autorizzazione e i token di accesso. Per ulteriori informazioni, consulta Policy Delete OAuthV2 Info.

Nuove entità nella policy Access Entity

La policy Access Entity fornisce l'accesso alle seguenti nuove entità: consumerkey-scopes, authorizationcode, requesttoken e verifier. Per ulteriori informazioni, consulta Policy Access Entity.

Visualizzazione dei certificati SSL in scadenza

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

Nome dell'app per sviluppatori 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 per sviluppatori dell'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 SmartDocs

Se hai già utilizzato SmartDocs durante il periodo beta, le nuove funzionalità e capacità della versione di disponibilità generale richiedono l'upgrade di SmartDocs nel portale per gli sviluppatori.

Le pagine SmartDocs già pubblicate nel 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 portale per sviluppatori, SmartDocs vengono generati 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 (analogamente a come gli sviluppatori esistono in tutti gli ambienti Pantheon).

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

  1. Aggiorna e testa la release 15.05.27 negli ambienti di sviluppo o di 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 > 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 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 release 15.05.27.

Se sei un cliente aziendale 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 ottenere la risposta migliore.

Bug corretti

In questa release sono stati corretti i seguenti bug.

ID problema Descrizione
TBD-72 Problema con la policy di logging dei messaggi
MGMT-2124 Le autorizzazioni del ruolo cliente vengono reimpostate quando le autorizzazioni vengono salvate 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 allegato predefinito
L'elemento FaultRules, che non viene utilizzato nelle policy o nei passaggi del proxy API, non viene più aggiunto automaticamente quando crei proxy API o aggiungi policy.
MGMT-2034 Recupera WSDL restituisce un errore: "Fetch WSDL Error: Error processing WSDL."
MGMT-1812 Aggiungi la convalida di TargetEndpoint durante l'importazione
Analogamente a ProxyEndpoint, TargetEndpoint verrà convalidato per lo schema e le espressioni corretti utilizzati nelle condizioni durante l'importazione del proxy API.
MGMT-1345 L'importazione di WSDL con più spazi dei nomi genera un passaggio di creazione SOAP errato Step
MGMT-800 La creazione di una risorsa con il nome "default" genera un'interfaccia utente danneggiata
MGMT-602 Visualizzazione Sviluppa proxy API: l'aggiunta di una policy di memorizzazione nella cache delle risposte quando l'endpoint non ha PreFlow/PostFlow causa un errore
MGMT-460 La ridenominazione della policy genera un comportamento anomalo, una policy duplicata che non può essere rimossa
DEVRT-1565 Intervalli di 15 minuti per le ADDEBITI
AXAPP-1728 Ignora le variabili di monetizzazione in Analytics
AXAPP-1690 "Invalid API Error" nei report personalizzati
AXAPP-1533 La mappa geografica di Analytics genera un errore di chiamata API non valida
APIRT-52 Report personalizzati: il codice di stato della risposta per molte API è null