Stai visualizzando la documentazione di Apigee Edge.
Vai alla
documentazione di Apigee X. informazioni
Martedì 19 maggio 2015 abbiamo rilasciato una versione trimestrale di Apigee Edge per il cloud privato.
Il precedente nome del prodotto "Apigee Edge On-premise" o "OPDK" ora si chiama "Apigee Edge per il cloud privato".
Se hai domande, rivolgiti all'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 ed upgrade
OpenLDAP è ora l'unico server LDAP supportato da Edge per le installazioni nuove e di upgrade.
Servizi API
Di seguito sono riportati 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 l'utilizzo di WebSocket in Edge, consulta la guida Apigee Edge per il cloud privato utilizzando 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 dell'API. Per ulteriori informazioni, consulta la guida Configurazione dell'autenticazione esterna di Edge per Cloud privato.
Co-branding nell'interfaccia utente di gestione
Puoi eseguire il co-branding dell'UI di gestione perimetrale con il tuo logo personalizzato, visualizzato accanto al logo Apigee. Per ulteriori informazioni, consulta la sezione "Aggiunta di un logo personalizzato al menu dell'interfaccia utente di Apigee" nella guida operativa di Apigee Edge per il cloud privato.
Log Node.js in Trace
Durante il debug dei proxy API Node.js, puoi abilitare la funzionalità Log Node.js nella vista Trace dell'editor proxy API. Per abilitare la funzionalità, imposta
apigee.feature.disableNodeJSLogs="false" nel file apigee-base.conf o apigee-onpremise.conf nella tua installazione. Per maggiori informazioni 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 sono scadute automaticamente dopo 30 giorni. Ciò significava che un utente è stato bloccato a meno che non avesse cambiato la password prima della scadenza. Tuttavia, anche la password dell'amministratore di sistema scadeva, impedendo all'amministratore di sistema di accedere a Edge.
Quando si esegue l'aggiornamento a 4.15.04.00, l'impostazione predefinita viene modificata in modo che le password non scadano. Se necessario, puoi configurare la scadenza delle password perimetrali utilizzando lo script /opt/apigee4/bin/apigee-enable-pwlockout.sh. Per ulteriori informazioni, consulta la guida alle operazioni di Apigee Edge per il cloud privato.
Limitare l'accesso dell'amministratore di sistema a domini email specifici
Puoi limitare l'appartenenza ai ruoli di sola lettura sysadmin o sysadmin 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 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 lo spazio sullo schermo in modo più efficiente.
Nuove variabili di errore OAuthV2
Queste nuove variabili relative all'errore sono impostate dal criterio OAuthV2:
- oauthV2.<nome-criteri>.failed: viene impostato su true se il criterio non viene completato.
- 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
Vedi 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.
Vedi http://apigee.com/docs/developer-services/content/creating-api-products.
UI per la rimozione di utenti da un'organizzazione
Nella pagina Utenti dell'organizzazione nell'interfaccia utente, il pulsante Elimina è stato sostituito con un pulsante Rimuovi. Questo serve a chiarire che quando rimuovi un utente da un'organizzazione, il suo account Apigee rimane attivo.
Vedi 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 Traccia offline
Lo strumento Traccia 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 necessarie risoluzione dei problemi e ulteriori analisi. L'interfaccia utente dello strumento Traccia offline è simile allo strumento Traccia offline.
Per maggiori informazioni, consulta la sezione Utilizzare lo strumento Traccia offline.
Ruoli utente visualizzati in Impostazioni utente
Nella pagina Impostazioni utente dell'interfaccia utente di gestione (nome utente > Impostazioni utente), sono ora visualizzati i ruoli dell'utente.
Miglioramenti all'interfaccia utente di gestione perimetrale
Questa release include una serie di piccoli miglioramenti a livello di usabilità e coerenza nell'interfaccia utente di gestione perimetrale.
Servizi di analisi
Di seguito sono riportati i miglioramenti e le nuove funzionalità dei servizi di analisi di Edge.
Sei mesi di dati disponibili
Quando generi report di analisi con l'interfaccia utente o l'API di gestione, i dati che risalgono a più di sei mesi prima della data corrente non sono accessibili per impostazione predefinita. Se desideri accedere a dati risalenti a più di sei mesi fa, contatta l'assistenza Apigee.
Variabili aggiunte ad Analytics
Le nuove variabili seguenti vengono passate all'analisi Edge, visibili nella fase AX della finestra della traccia del proxy API.
- apigee.edge.execution.is_target_error: consente di identificare se gli errori API sono errori lato target (valore "1") o non target per risposte HTTP non riuscite (valore "0"). Il valore è null per una risposta HTTP riuscita.
-
apigee.edge.execution.is_policy_error: consente di identificare se un criterio
ha avuto esito negativo (valore "1") o se nessun criterio ha avuto esito negativo in una risposta HTTP non riuscita (valore "0"). Il valore è null per una risposta HTTP riuscita.
Le seguenti variabili correlate forniscono dettagli sul criterio che ha avuto esito negativo per primo. I valori sono nulli se non si verifica alcun criterio.- apigee.edge.execution.fault_policy_name: il nome del criterio non superato.
- 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 località in cui il criterio è stato allegato nel flusso. Valori possibili: PROXY_REQ_FLOW, TARGET_REQ_FLOW, TARGET_RESP_FLOW, PROXY_RESP_FLOW.
Dashboard
- I grafici sul rendimento di API, sviluppatori, prodotti e app sviluppatore sono stati spostati. In precedenza erano visualizzate 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 gli interventi più importanti su queste dashboard nuove o esistenti:
- Dashboard Apigee (rivista): include tre grafici di metriche: Traffico proxy, Coinvolgimento degli sviluppatori e App degli sviluppatori. Ogni grafico fornisce una visualizzazione "Ulteriori dettagli" che ti consente di visualizzare in dettaglio ogni metrica. Vedi la dashboard Apigee.
- Prestazioni del proxy (novità): mostra i modelli di traffico e i tempi di elaborazione del proxy API. Sostituisce la dashboard delle prestazioni dei proxy API. Vedi Prestazioni del proxy API.
- Composizione del traffico (rivista): aspetto e contenuti della dashboard completamente rivisti. Misura il contributo relativo di API, app, sviluppatori e prodotti principali al programma API complessivo. Consulta la sezione Composizione del traffico.
- Analisi degli errori (rivista): aspetto e contenuti completamente rivisti. Mostra i tassi di errore per i proxy e i target API. Consulta la dashboard di analisi del codice di errore.
-
Queste dashboard esistenti sono state rinominate:
- Prestazioni degli endpoint è stato rinominato in Prestazioni target: mostra i pattern di traffico e le metriche delle prestazioni per i target di backend del proxy API. Consulta la pagina relativa alle prestazioni target.
- Coinvolgimento dei partner è stato rinominato in Coinvolgimento degli sviluppatori: mostra quali degli sviluppatori di app registrati stanno generando il maggior traffico API. Per ciascuno dei tuoi sviluppatori, puoi scoprire chi sta generando il maggior traffico API e il maggior numero di errori. Consulta Coinvolgimento degli sviluppatori.
Servizi per gli sviluppatori
Di seguito sono riportati le nuove funzionalità e i miglioramenti dei Servizi per sviluppatori periferici.
Supporto di Swagger 2.0 per Smart Docs
SmartDocumenti supporta l'importazione di documenti delle specifiche di 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 riportati i miglioramenti e le nuove funzionalità della monetizzazione 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, consentendo una maggiore flessibilità nell'aggiunta di più società 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 Gestione di 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 bug indicati di seguito.
| ID problema | Descrizione |
|---|---|
| OPDK-954 | 4.15.01 Lo schema Cassandra non viene aggiornato |
| MGMT-1986 | Errore nell'interfaccia utente durante l'aggiunta dello sviluppatore |
| MGMT-1983 | L'API OAuth 2.0 del codice di autorizzazione restituisce uno stato errato |
| MGMT-1962 | Errore durante l'accesso all'interfaccia utente di gestione con password efficace L'accesso all'interfaccia utente con determinati caratteri speciali, ad esempio il segno percentuale, non funziona più. |
| MGMT-1894 | Il caricamento della pagina App per sviluppatori per la colonna Sviluppatore non finisce mai |
| MGMT-1872 | Impossibile scaricare i report personalizzati |
| MGMT-1777 | Impossibile aggiungere un utente con un indirizzo email che ha un dominio di primo livello .acn |
| MGMT-1362 | L'indirizzo email della password dimenticata non funziona se l'indirizzo email contiene "_" Risolve il problema di reimpostazione della password nel Private Cloud con indirizzi email che contengono un trattino basso. |
| CORERT-613 | Errori di handshake SSL dovuti a "unRecognize_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 versioni:
| Cloud Edge | Edge per cloud privato |
|---|---|
Problemi noti
Questa release presenta i problemi noti riportati di seguito.
| ID problema | Descrizione |
|---|---|
| N/A |
Due script Cassandra, utilizzati dal programma di installazione durante l'installazione o l'upgrade per la monetizzazione, non sono stati inclusi nella release. Per risolvere il problema, esegui i comandi seguenti 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 (100 kB) si possono bloccare. Per risolvere questo problema, imposta il seguente valore della proprietà nel file router.properties:HTTPServer.streaming.buffer.limit=0 (l'impostazione predefinita è 10) |