Stai visualizzando la documentazione di Apigee Edge.
Consulta la
documentazione di Apigee X. info
Martedì 19 maggio 2015 abbiamo rilasciato una versione trimestrale di Apigee Edge for Private Cloud.
Il precedente nome del prodotto "Apigee Edge On-premises" o "OPDK" è ora "Apigee Edge for Private Cloud".
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.
OpenLDAP - installazione e upgrade
OpenLDAP è ora l'unico server LDAP supportato da Edge per le installazioni nuove e di upgrade.
Servizi API
Di seguito sono riportate le nuove funzionalità e i miglioramenti dei servizi API Edge.
WebSockets
Per abilitare le comunicazioni web in tempo reale tra un client web e un server, Edge supporta il protocollo WebSocket. Edge può svolgere il ruolo di client o server nelle comunicazioni WebSocket. Per informazioni sulla configurazione e sull'utilizzo di WebSocket in Edge, consulta la guida Apigee Edge for Private Cloud con WebSocket.
Supporto del provider di autenticazione esterno per la gestione delle API
Edge si integra con Active Directory e altri provider di autenticazione esterni/sistemi LDAP che contengono gli utenti amministrativi API. Per ulteriori informazioni, consulta la guida Configurazione dell'autenticazione esterna di Edge per Private Cloud.
Co-branding nell'interfaccia utente di gestione
Puoi personalizzare l'interfaccia utente di gestione Edge con il tuo logo personalizzato, che viene visualizzato accanto al logo di Apigee. Per ulteriori informazioni, consulta "Aggiunta di un logo personalizzato al menu dell'interfaccia utente Apigee" nella guida operativa di Apigee Edge per Private Cloud.
Log Node.js in Trace
Quando esegui il debug dei proxy API Node.js, puoi abilitare la funzionalità Log Node.js nella visualizzazione Trace dell'editor del proxy API. Per attivare la funzionalità, imposta
apigee.feature.disableNodeJSLogs="false" nel file apigee-base.conf o
apigee-onpremise.conf nell'installazione. Per saperne di più sul log Node.js, consulta
Debug e risoluzione dei problemi
dei proxy Node.js.
Scadenza password
In Edge 4.15.01.x, le password di Edge scadevano automaticamente dopo 30 giorni. Ciò significava che un utente non poteva accedere a meno che non avesse cambiato la password prima della scadenza. Tuttavia, ha anche causato la scadenza della password dell'amministratore di sistema, che non ha più potuto accedere a Edge.
Quando esegui l'upgrade alla versione 4.15.04.00, l'impostazione predefinita cambia in modo che le password non scadano. Se
necessario, puoi configurare la scadenza delle password di Edge utilizzando lo script
/opt/apigee4/bin/apigee-enable-pwlockout.sh. Per ulteriori informazioni, consulta la
guida operativa di Apigee Edge for Private Cloud.
Limitare l'accesso dell'amministratore di sistema a domini email specifici
Puoi limitare l'appartenenza ai ruoli sysadmin o sysadmin di sola lettura agli utenti di domini email specifici. Per attivare questa funzionalità, aggiungi i domini consentiti al file apigee4/conf/apigee/management-server/security.properties, come descritto nella guida operativa di Apigee Edge per Private Cloud.
Messaggi di errore dell'interfaccia utente di gestione
La visualizzazione dei messaggi di errore nell'interfaccia utente di gestione è stata riprogettata per utilizzare lo spazio sullo schermo in modo più efficiente.
Nuove variabili di errore OAuthV2
Queste nuove variabili correlate a errori sono impostate dal criterio OAuthV2:
- oauthV2.<policy-name>.failed: imposta il valore su true se il criterio non è riuscito.
- oauthv2.<policy_name>.<fault_name>: il nome dell'errore. Ad esempio, invalid_request
- oauthv2.<policy_name>.<fault_cause>: il motivo dell'errore. Ad esempio: Token scaduto
Consulta http://apigee.com/docs/api-services/content/oauthv2-policy.
Creazione del prodotto
Quando crei un nuovo prodotto, ora puoi specificare il nome del prodotto oltre al nome visualizzato.
Consulta http://apigee.com/docs/developer-services/content/creating-api-products.
Interfaccia utente per la rimozione di utenti da un'organizzazione
Nella pagina Utenti dell'organizzazione dell'UI, il pulsante Elimina è stato sostituito con un pulsante Rimuovi. In questo modo, è più chiaro che quando rimuovi un utente da un'organizzazione, il suo account Apigee rimane attivo.
Consulta http://apigee.com/docs/api-services/content/managing-organization-users.
Opzioni di filtro nell'interfaccia utente di gestione
Nelle pagine Proxy API, Prodotti, Sviluppatori e App dell'interfaccia utente di gestione sono disponibili nuove opzioni di filtro per la ricerca.
Strumento Trace offline
Lo strumento Offline Trace ti consente di visualizzare e analizzare le sessioni di tracciamento salvate in precedenza. Una sessione di traccia salvata è essenzialmente una "registrazione" di una sessione di traccia e può essere utile nei casi in cui sono necessari la risoluzione dei problemi e ulteriori analisi. L'interfaccia utente dello strumento Offline Trace è simile a quella dello strumento Trace "live".
Per saperne di più, consulta Utilizzare lo strumento di tracciamento offline.
Ruoli utente visualizzati in Impostazioni utente
Nella pagina Impostazioni utente dell'interfaccia utente di gestione (nome utente > Impostazioni utente), ora vengono visualizzati i ruoli dell'utente.
Miglioramenti all'interfaccia utente di gestione dei bordi
Questa release include una serie di piccoli miglioramenti all'usabilità e alla coerenza nell'interfaccia utente di gestione di Edge.
Servizi di analisi
Di seguito sono riportate le nuove funzionalità e i miglioramenti di Edge Analytics Services.
Sei mesi di dati disponibili
Quando generi report di analisi con l'API o la UI di gestione, i dati precedenti a sei mesi rispetto alla data corrente non sono accessibili per impostazione predefinita. Se vuoi accedere a dati più vecchi di sei mesi, contatta l'assistenza Apigee Edge.
Variabili aggiunte ad Analytics
Le seguenti nuove variabili vengono trasmesse ad Edge Analytics, visibili nella fase AX della finestra di traccia del proxy API.
- apigee.edge.execution.is_target_error: consente di identificare se gli errori API sono errori lato target (valore "1") o errori non target per risposte HTTP non riuscite (valore "0"). Il valore è nullo per una risposta HTTP riuscita.
-
apigee.edge.execution.is_policy_error: consente di identificare se una policy
non è riuscita (valore "1") o se nessuna policy non è riuscita in una risposta HTTP non riuscita (valore "0"). Il
valore è nullo per una risposta HTTP riuscita.
Le seguenti variabili correlate forniscono i dettagli del criterio che non è stato rispettato per primo. I valori sono null se nessun criterio non è stato rispettato.- apigee.edge.execution.fault_policy_name: il nome del criterio che non è stato rispettato.
- apigee.edge.execution.fault_flow_name: il nome del flusso nella policy che non è andata a buon fine (ad esempio PreFlow, PostFlow o un flusso definito dall'utente).
- apigee.edge.execution.fault_flow_state: la posizione in cui la policy è stata collegata nel flusso. Valori possibili: PROXY_REQ_FLOW, TARGET_REQ_FLOW, TARGET_RESP_FLOW, PROXY_RESP_FLOW.
Dashboard
- I grafici del rendimento per API, sviluppatori, prodotti e app per sviluppatori sono stati spostati. In passato venivano visualizzati nella parte inferiore delle pagine principali di queste entità. Ora puoi accedere ai grafici selezionando la scheda Analytics nella parte superiore di ogni pagina.
- Questa release include un lavoro importante sui seguenti pannelli esistenti o nuovi:
- Dashboard Apigee (revisionata): include tre grafici delle metriche: traffico proxy, coinvolgimento degli sviluppatori e app per sviluppatori. Ogni grafico fornisce una visualizzazione "Più dettagli" che ti consente di esaminare in dettaglio ogni metrica. Consulta la dashboard di Apigee.
- Prestazioni proxy (novità): mostra i pattern di traffico proxy API e i tempi di elaborazione. Sostituisce la dashboard Prestazioni proxy API. Consulta Prestazioni dei proxy API.
- Composizione del traffico (revisione): aspetto, sensazione e contenuti della dashboard completamente rivisti. Misura il contributo relativo delle tue API, app, sviluppatori e prodotti principali al tuo programma API complessivo. Consulta la sezione Composizione del traffico.
- Analisi degli errori (revisione): aspetto e contenuti completamente rivisti. Mostra i tassi di errore per i proxy API e i target. Consulta la dashboard Analisi dei codici di errore.
-
Queste dashboard esistenti sono state rinominate:
- Rendimento endpoint è stato rinominato Rendimento target: mostra i pattern di traffico e le metriche di rendimento per i target di backend del proxy API. Consulta Rendimento target.
- Coinvolgimento dei partner è stato rinominato Coinvolgimento degli sviluppatori: mostra quali sviluppatori di app registrati generano il maggior traffico API. Per ogni sviluppatore, puoi scoprire chi genera il maggior numero di errori e il maggior traffico API. Vedi Coinvolgimento degli sviluppatori.
Servizi per gli sviluppatori
Di seguito sono riportate le nuove funzionalità e i miglioramenti di Edge Developer Services.
Supporto di Swagger 2.0 per Smart Docs
Smart Docs supporta l'importazione di documenti di specifica Swagger 2.0 e mantiene la compatibilità con Swagger 1.2. Il supporto per gli oggetti dello schema di sicurezza e gli schemi centralizzati sarà disponibile in una release futura.
Monetizzazione
Di seguito sono riportate le nuove funzionalità e i miglioramenti della monetizzazione Edge. Consulta anche la sezione "Problemi noti" per ulteriori informazioni sulla monetizzazione.
Gestione separata di aziende e sviluppatori
Ora le aziende e gli sviluppatori vengono gestiti separatamente, il che consente una maggiore flessibilità nell'aggiunta di più aziende agli sviluppatori e più sviluppatori alle aziende. L'interfaccia utente di gestione ora fornisce finestre separate per "Aziende" e "Sviluppatori" (accessibili dal menu "Pubblica").
Consulta l'articolo Gestire aziende e sviluppatori.
Nei report sulla monetizzazione, le aziende rimangono un filtro principale, anche se l'etichetta del filtro è cambiata da "Sviluppatori" a "Aziende".
Bug corretti
In questa release sono stati corretti i seguenti bug.
| ID problema | Descrizione |
|---|---|
| OPDK-954 | 4.15.01 Lo schema Cassandra non viene aggiornato |
| MGMT-1986 | Errore dell'interfaccia utente durante l'aggiunta dello sviluppatore |
| MGMT-1983 | L'API Get an OAuth 2.0 authorization code restituisce lo stato errato |
| MGMT-1962 | Errore di accesso all'interfaccia utente di gestione con password complessa L'accesso all'interfaccia utente con determinati caratteri speciali, ad esempio il segno percentuale, non ha più esito negativo. |
| MGMT-1894 | La pagina App per sviluppatori non viene mai caricata per la colonna Sviluppatore |
| MGMT-1872 | Impossibile scaricare i report personalizzati |
| MGMT-1777 | Impossibile aggiungere un utente con un indirizzo email con TLD .acn |
| MGMT-1362 | L'email Password dimenticata non funziona se l'indirizzo email contiene
'_' Risolve il problema di reimpostazione della password in Private Cloud con indirizzi email che contengono un trattino basso. |
| CORERT-613 | Errori di handshake SSL dovuti a "unrecognized_name" |
| APIRT-1346 | OAuth2.0 - Hashed value is returned in access token response when hash.oauth.tokens.enabled is true |
Questa release contiene anche correzioni di bug delle seguenti release:
| Edge Cloud | Edge for Private Cloud |
|---|---|
Problemi noti
Questa release presenta i seguenti problemi noti.
| ID problema | Descrizione |
|---|---|
| N/D |
Due script Cassandra, che il programma di installazione utilizza nell'installazione o nell'upgrade della monetizzazione, non sono stati inclusi nella release. Per risolvere il problema, esegui i seguenti comandi dopo l'installazione o l'upgrade di Cassandra per completare l'installazione/l'upgrade della monetizzazione:
|
| CORERT-318 | Le chiamate API con payload di grandi dimensioni (centinaia di KB) a volte possono bloccarsi. Per risolvere questo
problema, imposta il seguente valore della proprietà nel file router.properties:HTTPServer.streaming.buffer.limit=0 (l'impostazione predefinita è 10) |