Stai visualizzando la documentazione di Apigee Edge.
Vai alla documentazione di Apigee X. info
Martedì 19 maggio 2015 abbiamo rilasciato una versione trimestrale di Apigee Edge per Private Cloud.
Il precedente nome del prodotto "Apigee Edge on-premise" o "OPDK" ora è "Apigee Edge for Private Cloud".
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.
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 e un server web, 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 per il cloud privato che utilizza WebSocket.
Supporto per i provider di autenticazione esterni per la gestione delle API
Edge si integra con Active Directory e altri fornitori di autenticazione/sistemi LDAP esterni che contengono gli utenti amministrativi dell'API. Per ulteriori informazioni, consulta la guida Configurazione dell'autenticazione esterna di Edge per Private Cloud.
Co-branding nell'interfaccia utente di gestione
Puoi applicare il co-branding all'interfaccia utente di gestione di 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 di Apigee" nella Guida alle operazioni di Apigee Edge for Private Cloud.
Log di Node.js nella traccia
Durante il debug dei proxy API Node.js, puoi attivare la funzionalità di log di Node.js nella visualizzazione della traccia dell'editor del proxy API. Per attivare la funzionalità, imposta apigee.feature.disableNodeJSLogs="false" nel file apigee-base.conf o apigee-onpremise.conf dell'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 più accedere a meno che non avesse modificato 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, il valore predefinito 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 alle operazioni 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 determinati domini email. Per attivare questa funzionalità, aggiungi i domini consentiti al file apigee4/conf/apigee/management-server/security.properties, come descritto nella Guida alle operazioni di Apigee Edge per il cloud privato.
Messaggi di errore dell'interfaccia utente di gestione
La visualizzazione dei messaggi di errore nell'interfaccia utente di gestione è stata riprogettata per utilizzare in modo più efficiente lo spazio sullo schermo.
Nuove variabili di errore OAuthV2
Queste nuove variabili correlate agli errori vengono impostate dal criterio OAuthV2:
- oauthV2.<policy-name>.failed: impostato su true se il criterio non è andato a buon fine.
- 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 Expired
Consulta http://apigee.com/docs/api-services/content/oauthv2-policy.
Creazione di prodotti
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'interfaccia utente, il pulsante Elimina è stato sostituito da un pulsante Rimuovi. Questo serve a chiarire che quando rimuovi un utente da un'organizzazione, l'account Apigee dell'utente 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 di traccia offline
Lo strumento Offline Trace ti consente di visualizzare e analizzare le sessioni di traccia salvate in precedenza. Una sessione di traccia salvata è essenzialmente una "registrazione" di una sessione di traccia e può essere utile per i casi in cui è necessaria la risoluzione dei problemi e un'ulteriore analisi. L'interfaccia utente dello strumento di monitoraggio offline è simile a quella dello strumento di monitoraggio "in tempo reale".
Per ulteriori informazioni, consulta la sezione Utilizzare lo strumento Tracce 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 per la gestione di Edge
Questa release include una serie di piccoli miglioramenti all'usabilità e alla coerenza dell'interfaccia utente di gestione di Edge.
Servizi di analisi
Di seguito sono riportate le nuove funzionalità e i miglioramenti di Edge Analytics Services.
Sono disponibili i dati degli ultimi 6 mesi
Quando generi report di analisi con l'API o l'interfaccia utente di gestione, i dati precedenti a sei mesi dalla data corrente non sono accessibili per impostazione predefinita. Se vuoi accedere a dati risalenti a più di sei mesi fa, contatta l'assistenza Apigee.
Variabili aggiunte all'analisi
Le seguenti nuove variabili vengono passate ad Edge Analytics, visibili nella fase AX della finestra della traccia del proxy dell'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 le risposte HTTP non riuscite (valore "0"). Il valore è nullo per una risposta HTTP riuscita.
-
apigee.edge.execution.is_policy_error: consente di identificare se un criterio
non è riuscito (valore "1") o se nessun criterio non è riuscito 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 ha avuto esito negativo per primo. I valori sono null se nessun criterio ha avuto esito negativo.- apigee.edge.execution.fault_policy_name: il nome del criterio che ha avuto esito negativo.
- apigee.edge.execution.fault_flow_name: il nome del flusso nel criterio che ha avuto esito negativo (ad esempio PreFlow, PostFlow o un flusso definito dall'utente).
- apigee.edge.execution.fault_flow_state: la posizione in cui è stato collegato il criterio nel flusso. Valori possibili: PROXY_REQ_FLOW, TARGET_REQ_FLOW, TARGET_RESP_FLOW, PROXY_RESP_FLOW.
Dashboard
- I grafici sul rendimento per API, sviluppatori, prodotti e app per sviluppatori sono stati spostati. In precedenza, 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 importanti interventi su queste dashboard esistenti o nuove:
- Dashboard Apigee (riveduta): include tre grafici delle metriche: traffico proxy, coinvolgimento degli sviluppatori e app per sviluppatori. Ogni grafico fornisce una visualizzazione "Altro" che ti consente di visualizzare in dettaglio ogni metrica. Consulta la dashboard di Apigee.
- Prestazion. proxy (novità): mostra i pattern di traffico e i tempi di elaborazione dei proxy API. Sostituisce la dashboard Prestazioni dei proxy API. Consulta Proxy API Prestazioni.
- Composizione del traffico (riveduta): aspetto e contenuti della dashboard completamente rivisti. Misura il contributo relativo delle API, delle app, degli sviluppatori e dei prodotti principali al tuo programma API complessivo. Consulta Composizione del traffico.
- Analisi degli errori (versione aggiornata): aspetto e contenuti completamente rivisti. Mostra le percentuali di errore per i proxy e i target API. Consulta la dashboard Analisi dei codici di errore.
-
Queste dashboard esistenti sono state rinominate:
- Rendimento endpoint è stato rinominato in Rendimento target: mostra i pattern di traffico e le metriche sul 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 stanno generando più traffico API. Per ogni sviluppatore, puoi scoprire chi genera più traffico API e più errori. 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 SmartDocs
SmartDocs supporta l'importazione dei documenti delle specifiche Swagger 2.0 e mantiene la compatibilità con le versioni precedenti di 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 di Edge. Consulta anche la sezione "Problemi noti" per ulteriori informazioni sulla monetizzazione.
Gestione separata di aziende e sviluppatori
Le aziende e gli sviluppatori vengono ora gestiti separatamente, il che consente una maggiore flessibilità nell'aggiunta di più aziende agli sviluppatori e di più sviluppatori alle aziende. L'interfaccia utente di gestione ora offre finestre separate per "Aziende" e "Sviluppatori" (accessibili dal menu "Pubblica").
Consulta Gestire aziende e sviluppatori.
Nei report sulla monetizzazione, le aziende rimangono un filtro principale, anche se l'etichetta del filtro è stata modificata da "Sviluppatori" in "Aziende".
Bug corretti
In questa release sono stati corretti i seguenti bug.
| ID problema | Descrizione |
|---|---|
| OPDK-954 | Non viene eseguito l'upgrade dello schema Cassandra 4.15.01 |
| MGMT-1986 | Errore UI 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 una password complessa L'accesso all'interfaccia utente con determinati caratteri speciali, come il segno di percentuale, non avviene più più. |
| MGMT-1894 | Il caricamento della pagina App sviluppatore non termina mai per la colonna dello sviluppatore |
| MGMT-1872 | Impossibile scaricare i report personalizzati |
| MGMT-1777 | Impossibile aggiungere un utente con un indirizzo email con un dominio di primo livello .acn |
| MGMT-1362 | L'email per la password dimenticata non funziona se l'indirizzo email contiene "_" È stato risolto il problema di reimpostazione della password in Private Cloud con gli indirizzi email contenenti un carattere sottolineato. |
| CORERT-613 | Errori di handshake SSL dovuti a "unrecognized_name" |
| APIRT-1346 | OAuth2.0: il valore sottoposto ad hashing viene restituito nella risposta del token di accesso quando hash.oauth.tokens.enabled è true |
Questa release include 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 |
Nella release non sono stati inclusi due script Cassandra, utilizzati dall'installatore nell'installazione o nell'upgrade della monetizzazione. 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 | A volte le chiamate API con payload di grandi dimensioni (centinaia di KB) possono bloccarsi. Per risolvere il problema, imposta il seguente valore della proprietà nel file router.properties:HTTPServer.streaming.buffer.limit=0 (l'impostazione predefinita è 10) |