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 nome precedente del prodotto "Apigee Edge On-premises" o "OPDK" è ora "Apigee Edge for Private Cloud".
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.
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 di 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 Using WebSockets.
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 delle API. Per ulteriori informazioni, consulta la guida Edge for Private Cloud External Authentication Configuration.
Co-branding nella UI di gestione
Puoi applicare il co-branding alla UI di gestione di Edge con il tuo logo personalizzato, che viene visualizzato accanto al logo Apigee. Per ulteriori informazioni, consulta "Adding a custom logo to the Apigee UI menu" in the Guida operativa di Apigee Edge for Private Cloud.
Log di Node.js in Trace
Quando esegui il debug dei proxy API Node.js, puoi abilitare la funzionalità Log di Node.js nella visualizzazione Trace dell'editor del proxy API. Per abilitare la funzionalità, imposta
apigee.feature.disableNodeJSLogs="false" nel file apigee-base.conf o
apigee-onpremise.conf dell'installazione. Per ulteriori informazioni sul log di 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 veniva bloccato a meno che non cambiasse la password prima della scadenza. Tuttavia, ciò ha causato anche la scadenza della password dell'amministratore di sistema, in modo che l'amministratore di sistema non potesse accedere a Edge.
Quando esegui l'upgrade alla versione 4.15.04.00, il comportamento predefinito cambia in modo che le password non scadano. Se
necessario, puoi configurare la scadenza delle password di Edge utilizzando lo
/opt/apigee4/bin/apigee-enable-pwlockout.sh script. 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 di amministratore di sistema o amministratore di sistema di sola lettura agli utenti di domini email specifici. Per abilitare questa funzionalità, aggiungi i domini consentiti al file apigee4/conf/apigee/management-server/security.properties, come descritto nella Guida operativa di Apigee Edge for Private Cloud.
Messaggi di errore della UI di gestione
La visualizzazione dei messaggi di errore nella UI 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 dalla policy OAuthV2:
- oauthV2.<policy-name>.failed : impostato su true se la policy non è riuscita.
- 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 del prodotto
Quando crei un nuovo prodotto, ora puoi specificarne il nome oltre al nome visualizzato.
Consulta http://apigee.com/docs/developer-services/content/creating-api-products.
UI per la rimozione degli utenti da un'organizzazione
Nella pagina Utenti dell'organizzazione della 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 nella UI di gestione
Nelle pagine Proxy API, Prodotti, Sviluppatori e App della UI di gestione sono disponibili nuove opzioni di filtro per la ricerca.
Strumento Trace offline
Lo strumento Trace offline 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 nei casi in cui sono necessari la risoluzione dei problemi e ulteriori analisi. La UI dello strumento Trace offline è simile allo strumento Trace "live".
Per ulteriori informazioni, consulta Utilizzare lo strumento Trace offline.
Ruoli utente visualizzati in Impostazioni utente
Nella pagina Impostazioni utente della UI di gestione (nome utente > Impostazioni utente), ora vengono visualizzati i ruoli dell'utente.
Miglioramenti della UI di gestione di Edge
Questa release include una serie di piccoli miglioramenti di usabilità e coerenza nella UI di gestione di Edge.
Servizi di analisi
Di seguito sono riportate le nuove funzionalità e i miglioramenti dei servizi di analisi di Edge.
Dati disponibili per sei mesi
Quando generi report di analisi con la UI di gestione o l'API, i dati precedenti a sei mesi dalla data corrente non sono accessibili per impostazione predefinita. Se vuoi accedere ai dati precedenti a sei mesi, contatta l'assistenza di Apigee Edge.
Variabili aggiunte all'analisi
Le seguenti nuove variabili vengono trasmesse all'analisi di Edge e sono 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 le risposte HTTP non riuscite (valore "0"). Il valore è null 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 è null per una risposta HTTP riuscita.
Le seguenti variabili correlate forniscono i dettagli della policy che non è riuscita per prima. I valori sono null se nessuna policy non è riuscita.- apigee.edge.execution.fault_policy_name : il nome della policy che non è riuscita.
- apigee.edge.execution.fault_flow_name : il nome del flusso nella policy che non è riuscita (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 sviluppatore sono stati spostati. In precedenza venivano visualizzati nella parte inferiore delle pagine principali di queste entità. Ora puoi accedere ai grafici selezionando la scheda Analisi nella parte superiore di ogni pagina.
- Questa release include un lavoro importante su queste dashboard esistenti o nuove:
- Dashboard Apigee (revisionata): include tre grafici delle metriche: Traffico proxy, Coinvolgimento degli sviluppatori e App sviluppatore. Ogni grafico fornisce una visualizzazione "maggiori dettagli" che consente di approfondire ogni metrica. Consulta Dashboard Apigee.
- Rendimento proxy API (nuova): mostra i pattern di traffico proxy API e i tempi di elaborazione. Sostituisce la dashboard Rendimento proxy API. Consulta Rendimento proxy API Performance.
- Composizione del traffico (revisionata): aspetto, contenuti e funzionalità della dashboard completamente rivisti. Misura il contributo relativo delle API, delle app, sviluppatori e dei prodotti principali al programma API complessivo. Consulta Composizione del traffico.
- Analisi degli errori (revisionata): aspetto, contenuti e funzionalità completamente rivisti. Mostra le percentuali di errore per i proxy API e i target. Consulta 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 di rendimento per i target di backend del proxy API. Consulta Rendimento performance.
- Coinvolgimento dei partner è stato rinominato in Coinvolgimento degli sviluppatori: mostra quali sviluppatori di app registrati generano la maggior parte del traffico API. Per ogni sviluppatore, puoi scoprire chi genera la maggior parte del traffico API e il maggior numero di errori. Consulta Coinvolgimento degli sviluppatori.
Servizi per gli sviluppatori
Di seguito sono riportate le nuove funzionalità e i miglioramenti dei servizi per gli sviluppatori di Edge.
Supporto di Swagger 2.0 per SmartDocs
SmartDocs supporta l'importazione di documenti di specifica 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 successiva.
Monetizzazione
Di seguito sono riportate le nuove funzionalità e i miglioramenti della monetizzazione di Edge. Per ulteriori informazioni sulla monetizzazione, consulta anche la sezione "Problemi noti" .
Gestione separata di aziende e sviluppatori
Ora le aziende e gli sviluppatori vengono gestiti separatamente, il che consente una maggiore flessibilità nell'aggiungere più aziende agli sviluppatori e più sviluppatori alle aziende. La UI di gestione ora fornisce 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 è cambiata da "Sviluppatori" a "Aziende".
Bug corretti
In questa release sono stati corretti i seguenti bug.
| ID problema | Descrizione |
|---|---|
| OPDK-954 | Lo schema Cassandra 4.15.01 non viene sottoposto ad upgrade |
| MGMT-1986 | Errore della UI durante l'aggiunta dello sviluppatore |
| MGMT-1983 | L'API per ottenere un codice di autorizzazione OAuth 2.0 restituisce uno stato errato |
| MGMT-1962 | Errore durante l'accesso alla UI di gestione con una password efficace L'accesso alla UI con determinati caratteri speciali, ad esempio il segno di percentuale, non genera più errori. |
| MGMT-1894 | La pagina App sviluppatore non termina mai il caricamento per la colonna dello sviluppatore |
| MGMT-1872 | Impossibile scaricare i report personalizzati |
| MGMT-1777 | Impossibile aggiungere un utente con un indirizzo email con un TLD di .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 - Il valore con hash viene restituito nella risposta del token di accesso quando hash.oauth.tokens.enabled è 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, utilizzati dall'installer 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 il problema, imposta il seguente valore della proprietà nel file router.properties:HTTPServer.streaming.buffer.limit=0 (l'impostazione predefinita è 10) |