Stai visualizzando la documentazione di Apigee Edge.
Vai alla sezione
Documentazione di Apigee X. Informazioni
Martedì 8 settembre 2015 abbiamo rilasciato un'importante versione di Apigee Edge per privati Google Cloud.
Dalla precedente release trimestrale di Edge per il cloud privato (4.15.04.00), le seguenti sono state eseguite e sono incluse in questa versione trimestrale:
A quali versioni Edge puoi eseguire l'upgrade 4.15.07.00
A seconda della versione corrente di Edge, puoi:
- Aggiornamento diretto a 4.15.07.00
- Upgrade incrementale, vale a dire che devi eseguire l'upgrade dalla versione attuale a un'altra di Edge, quindi aggiorna alla 4.15.07.00.
Per saperne di più, consulta A quali versioni Edge per il cloud privato puoi eseguire l'upgrade 4.15.07.00.
Prima di eseguire l'upgrade dalla versione 4.15.01.x o da una versione precedente
- Controlla la versione di Cassandra SSTable:
- Cambia la directory in /<install-root>/apigee4/data/cassandra/data.
- Esegui un comando Trova,
> trova . -name *-ic-*
I risultati dovrebbero restituire un insieme di file .db se esegui Cassandra 1.2 SSTable. - Esegui questo comando di ricerca:
> trova . -name *-hf-*
I risultati dovrebbero essere vuoti, il che significa che nessun file .db è in formato hf. Se non vedi alcun file nella hf, allora stai fatto ed è possibile eseguire l'aggiornamento alla versione 4.15.07.00.
Il formato hf è per SSTables di Cassandra 1.0. Se hai file *.db in formato hf, devi: eseguire l'upgrade della tabella SSTable come descritto nella parte restante di questa procedura.
- Se trovi file *.db nel formato hf, esegui l'upgrade della tabella SSTable
eseguendo questo comando su ogni nodo Cassandra fino a quando non avrai eseguito l'upgrade di tutti i servizi Cassandra
nodi:
> /<install-root>/apigee4/share/apache-cassandra/bin/nodetool -h localhost upgradestables -a - Ripeti il passaggio 1 per verificare che tutti i file *.db siano nel formato ic per Cassandra 1.2 completamente gestita.
- Ripeti i passaggi da 1 a 3 su ogni nodo Cassandra nell'installazione Edge.
- Aggiorna a Edge 4.15.07.00.
- Dopo l'upgrade 4.15.07.00, controllare i file *.db per assicurarsi che siano stati aggiornati tutti
allo stabile in stile C* 2.0:
> cd /<install-root>/apigee4/data/cassandra/data
> trova . -name *-jb-*
Questo comando dovrebbe restituire un set di file .db se esegui Cassandra 2.0.
Nuove funzionalità e miglioramenti
Di seguito sono riportate le nuove funzioni e i miglioramenti di questa release.
Installazione e upgrade
Upgrade e disinstallazione selettivi dei componenti
Gli script apigee-upgrade.sh e apigee-deploy.sh ora consentono di selezionare i componenti Edge eseguire l'upgrade o la disinstallazione. In precedenza, eseguiva l'upgrade o la disinstallazione di tutti i componenti sul nodo. (OPDK-1377, OPDK-1175)
Rollback dell'upgrade
Se apigee-upgrade.sh non va a buon fine durante un upgrade, ora puoi utilizzare apigee-rollback.sh per eseguire il rollback dell'upgrade. Puoi riprovare a eseguire l'upgrade dopo aver risolto eventuali problemi. (OPDK-1275)
Opzioni dello script del programma di installazione abbreviate
Gli script di installazione non assumono più la forma estesa di opzioni, ad esempio --help. Ora solo prendi opzioni a lettera singola, come -h. (OPDK-1356)
Installazione di SmartDocs
Quando installi SmartDocs con lo script setup-smartdocs.sh, ti viene richiesto di inserire il organizzazione, ambiente e host virtuale, che garantisce che SmartDocs sia installato posizione prevista. In precedenza, questi valori erano impostati come hardcoded nello script. (OPDK-1310)
Esecuzione di update-cass-pwd-in-config.sh senza prompt
Lo script update-cass-pwd-in-config.sh può essere eseguito senza prompt se imposti Variabili di ambiente ENABLE_CASS_AUTH, CASS_USERNAME e CASS_PASSWORD. (OPDK-1309)
Piattaforma perimetrale
Di seguito sono riportate le nuove funzionalità della piattaforma Edge incluse in questa release.
OpenJDK 1.7 supportato da Edge Private Cloud
Questa versione di Edge supporta Oracle JDK 1.7 e OpenJDK 7 e ha rimosso il supporto per JDK 1.6. (OPDK-1187)
Supporto per sistemi operativi
Apigee Edge per il Private Cloud ha esteso il supporto del suo sistema operativo per includere Red Hat Enterprise Linux 6.6 e 7.0 (64 bit), CentOS 6.5, 6.6 e 7.0 (64 bit) e Oracle Linux 6.5.
Cassandra 2.0.15 incluso in OPDK 15.07
Questa release installa Cassandra 2.0.15. Se esegui l'upgrade per una release precedente, di Cassandra verrà aggiornata. (OPDK-1197)
Supporto SHA2 per l'hashing dei token OAuth
Per proteggere meglio i token OAuth in caso di violazione della sicurezza del database, Edge supporta SHA2 algoritmi per l'hashing dei token OAuth (oltre a SHA1). Con il nuovo livello di organizzazione proprietà dell'hashing, puoi attivare e configurare l'hashing per i nuovi token e conservare l'hashing precedente su tutti i token esistenti prima di questa nuova funzionalità. In precedenza in Edge per Private Cloud, denominata hash.oauth.tokens.enabled nel file keymanagement.properties (nelle server di gestione e processori di messaggi) hanno abilitato l'hashing SHA1 automatico dei token OAuth. Questo è stata ritirata.
Se in precedenza hai utilizzato la proprietà hash.oauth.tokens.enabled per abilitare l'hashing SHA1, lo script di upgrade di questa release genera automaticamente le nuove proprietà a livello di organizzazione. A esegui la verifica dopo l'upgrade, esegui una richiesta GET come amministratore di sistema con questa API: https://{host}:{port}/v1/o/{your_org}.
- Per informazioni su come attivare l'hashing dei token nella tua organizzazione con le nuove proprietà, consulta "Hashing di token nel database" nel campo Richiedere i token di accesso per ogni argomento.
- Per informazioni sull'hashing collettivo dei token esistenti, consulta la documentazione Edge per il cloud privato Guida alle operazioni. (APIRT-1389)
Struttura semplice della directory per i file di log
Puoi configurare Edge per archiviare i file di log in una struttura di directory flat impostando un nuovo
Proprietà enable.flat.directory.structure su true in message-logging.properties
. Per ulteriori informazioni, consulta il criterio di logging dei messaggi.
(APIRT-1394)
Prestazioni della cache dell'ambiente
Per migliorare la gestione e l'utilizzo della cache in memoria, la colonna "Numero massimo di elementi in memoria" le impostazioni delle risorse della cache dell'ambiente sono state deprecate. Il numero totale di elementi presenti tutte le risorse cache (compresa quella predefinita) dipendono dalla memoria totale allocata . Per impostazione predefinita, la memoria totale allocata per la memorizzazione nella cache in memoria su un determinato processore di messaggi è il 40% della memoria totale disponibile, in base alle impostazioni delle proprietà cache del messaggio. processor cache.properties. Gli elementi verranno rimossi dalla cache in memoria solo se sono presenti memoria della cache insufficiente o gli elementi scadono.
Per ripristinare il comportamento precedente dell'utilizzo del campo "Numero massimo di elementi in memoria" proprietà per
gestione della cache, imposta la proprietà overrideMaxElementsInCacheResource=false nel
cache.properties. (APIRT-1140)
Servizi API
Di seguito sono riportate le nuove funzionalità dei servizi API incluse in questa release.
Nuovo editor proxy come predefinito
Il nuovo editor proxy API è abilitato per impostazione predefinita nell'interfaccia utente di gestione. Il nuovo editor include molti miglioramenti all'usabilità, tra cui visualizzazioni più complete dei flussi condizionali e gli endpoint sulla pagina Panoramica, tutte le configurazioni nella pagina Sviluppo, l'aggiunta flussi condizionali, endpoint e criteri, visualizzazioni XML più complete piuttosto che piccoli snippet, che esegue la scansione di nomi file e testo e altro. (MGMT-2279)
Nuovo criterio relativo all'eliminazione delle informazioni OAuth v2.0
Nuova richiesta di eliminazione delle informazioni OAuth v2.0 consente di eliminare i token di accesso e le autorizzazioni OAuth v2 i codici. Il criterio sostituisce la funzionalità fornita in precedenza dall'API di gestione. Per ulteriori informazioni informazioni, consulta la sezione Elimina Norme relative alle informazioni OAuthV2. (MGMT-2257)
Nuovo criterio relativo all'eliminazione delle informazioni OAuth v1.0
Nuova richiesta di eliminazione delle informazioni OAuth v1.0 consente di eliminare i token di richiesta OAuth v1.0, l'accesso di token e codici di verifica. Il criterio sostituisce la funzionalità fornita in precedenza dal l'API di gestione. Per maggiori informazioni, consulta le norme relative all'eliminazione delle informazioni per OAuth V1. (APIRT-1351)
Criterio di controllo dell'accesso
Il criterio di controllo dell'accesso è stato migliorato per consentire una valutazione più granulare degli indirizzi IP
per inserire nella lista consentita e nella lista bloccata gli indirizzi IP quando sono contenuti
Intestazione HTTP X-FORWARDED-FOR.
Con il controllo di più indirizzi IP abilitato nell'intestazione (contatta l'Assistenza per impostare il
feature.enableMultipleXForwardCheckForACL), un
Il nuovo elemento <ValidateBasedOn> del criterio consente di confrontare
il primo IP, l'ultimo IP o tutti gli IP nell'intestazione. Per maggiori informazioni, vedi Criterio di controllo dell'accesso.
Nuove entità nel criterio dell'entità di accesso
Il criterio Access Entity consente di accedere alle seguenti nuove entità: consumerkey-scopes, il codice di autorizzazione, il token di richiesta e lo strumento di verifica. Per ulteriori informazioni, consulta le norme relative all'entità di accesso.
Criterio di raccolta delle statistiche: conversione automatica del nome delle statistiche in minuscolo
Durante la creazione di una raccolta di analisi personalizzata nell'editor proxy API (pagina Sviluppo > Strumenti > raccolta personalizzata di Analytics), la variabile raccoglitore (statistica) "Nome" devono essere in minuscolo. Se inserisci il nome con lettere maiuscole, lo strumento converte automaticamente il nome della statistica. in minuscolo nel criterio Statistics Collector. (MGMT-740)
Rimozione della traccia classica nell'editor proxy API
L'ultima versione della funzionalità Trace nell'editor proxy API è stata spostata dalla versione beta a disponibilità generale. Accesso alla "tracce classica" con il riquadro "Accedi alla versione classica di trace" non è più disponibile.
Accesso alla community Apigee dal menu Guida dell'interfaccia utente di gestione
Puoi accedere alla community di Apigee dal menu Guida dell'interfaccia utente di gestione.
Messaggi di errore nell'interfaccia utente di gestione
Di seguito sono riportati i miglioramenti ai messaggi di errore nell'interfaccia utente di gestione:
- L'interfaccia utente di gestione utilizzata per raggruppare e visualizzare tutti i messaggi di errore nella UI per l'intero a meno che tu non li abbia ignorati. Con questo aggiornamento, i messaggi di errore vengono cancellati automaticamente quando esci dalla pagina in cui si trovano. (MGMT-2254)
- L'interfaccia utente di gestione non elimina più i messaggi di errore duplicati. (MGMT-2242)
Miglioramenti delle prestazioni e degli errori dell'interfaccia utente
Sono stati apportati miglioramenti generali a diverse aree dell'interfaccia utente di gestione, inclusa la visualizzazione delle pagine. la pulizia delle prestazioni e dei messaggi di errore.
Link ipertestuali dei ruoli nella pagina Utenti dell'organizzazione dell'interfaccia utente di gestione
Nella pagina Utenti dell'organizzazione dell'interfaccia utente di gestione (Amministratore > Utenti dell'organizzazione), il ruolo ora i nomi sono link ipertestuali, così puoi passare rapidamente alle pagine dei ruoli. (MGMT-1055)
Nuove variabili target nel flusso di messaggi
Le nuove variabili nei flussi di messaggi forniscono informazioni URL più complete per gli endpoint di destinazione e server di destinazione:
-
Endpoint di destinazione:
request.urlsostituiscetarget.basepath.with.query. -
TargetServer:
loadbalancing.targetserversostituiscetargetserver.name. Inoltre,target.basepathviene compilato solo quando l'elemento<Path>viene utilizzato nel tag Elemento HTTPTargetConnection<LoadBalancer>.
Supporto SNI (Server Name Indication)
Edge supporta l'uso dell'indicazione del nome server in direzione sud (dal processore di messaggi alla destinazione endpoint. Se desideri utilizzare SNI, contatta l'assistenza Apigee.
È richiesto Java 1.7.
Con SNI, che è un'estensione di TLS/SSL, è possibile gestire più destinazioni HTTPS dallo stesso Indirizzo IP e porta senza richiedere che tutte queste destinazioni utilizzino lo stesso certificato.
Non è richiesta alcuna configurazione specifica per Edge. Se il tuo ambiente è configurato per la direzione sud SNI (il cloud Edge è per impostazione predefinita), Edge lo supporta.
Edge estrae automaticamente il nome host dall'URL della richiesta e lo aggiunge alla richiesta di handshake SSL. Ad esempio, se l'host di destinazione è https://example.com/request/path: Edge aggiunge l'estensione server_name come mostrato sotto:
Per ulteriori informazioni su SNI, visita la pagina http://en.wikipedia.org/wiki/Server_Name_Indication.
"Algoritmo di firma" nei dettagli dei certificati SSL
Un nuovo "algoritmo di firma" è stato aggiunto ai dettagli del certificato SSL, visibili nella l'interfaccia utente di gestione (Amministrazione > Certificati SSL) e l'API di gestione (Ottieni dettagli del certificato da un archivio chiavi o un truststore). Il campo mostra "sha1WithRSAEncryption" o "sha256WithRSAEncryption", a seconda del tipo di algoritmo di hashing utilizzato per generare certificato.
Visualizzazione dei certificati SSL prossimi alla scadenza
La pagina Certificati SSL dell'interfaccia utente di gestione (Amministratore > Certificati SSL) indica quando I certificati SSL scadono entro 10, 15, 30 o 90 giorni, in base alla selezione effettuata nella nuovo campo a discesa.
Configurazione degli errori di protezione dalle minacce
Per impostazione predefinita, Edge genera un codice di stato Errore interno del server HTTP 500 e un errore ExecutionFailed
se un messaggio non supera un criterio di protezione dalle minacce JSON o XML. Puoi modificare
per modificare il comportamento
di errore con una nuova proprietà a livello di organizzazione. Quando imposti l'organizzazione
features.isPolicyHttpStatusEnabled su true, come segue
che si verifica:
- Richiesta: con un criterio di protezione dalle minacce collegato a qualsiasi flusso di richieste, i messaggi non validi restituiscono un codice di stato 400, insieme a un messaggio di errore relativo al criterio corrispondente.
- Risposta: con un criterio di protezione dalle minacce collegato a qualsiasi flusso di risposta, i messaggi non validi restituiscono comunque un codice di stato 500 e viene restituito uno dei messaggi di errore relativi ai criteri corrispondenti (anziché solo ExecutionFailed).
I clienti Cloud devono contattare l'assistenza Apigee per impostare proprietà dell'organizzazione. Questa funzionalità sarà disponibile per i clienti del cloud privato perimetrale in Rilascio trimestrale di Private Cloud.
Schemi aggiornati per endpoint, proxy e altre entità
Gli schemi di riferimento sono stati aggiornati per entità diverse dai criteri come TargetEndpoint, ProxyEndpoint, APIProxy e molti altri. Visita la pagina https://github.com/apigee/api-platform-samples/tree/master/schemas. (APIRT-1249)
Servizi per gli sviluppatori
Di seguito sono riportate le nuove funzionalità dei Servizi per gli sviluppatori incluse in questa release.
Disponibilità generale di SmartDocs
SmartDocumenti sta passando dalla versione beta alla disponibilità generale. Aggiornamenti e nuove funzionalità include:
- Supporto per Swagger 2.0, inclusa l'importazione tramite file o URL, incluso il supporto per oggetti di sicurezza con nome personalizzato.
- Miglioramenti del design visivo nei modelli che generano SmartDocs.
- Miglioramenti dell'usabilità e del flusso di lavoro nel Portale per gli sviluppatori, disponibile tramite la sezione > Menu SmartDocs in Drupal.
- noto come "token personalizzato" l'autenticazione è ora chiamata "Chiave API".
- "Sicurezza" dell'autenticazione predefiniti a livello di revisione.
- Configurazione dell'autenticazione client a livello di modello. Le nuove revisioni non vengono più reimpostate eventuali credenziali client SmartDocs preconfigurate.
Per altre descrizioni delle caratteristiche, visita questo blog post.
Per la documentazione di SmartDocs, vedi Using SmartDocs to document per le API.
Nome dell'app sviluppatore visualizzato nell'interfaccia utente di gestione
Le app sviluppatore in Edge hanno sia un Nome interno che non cambia sia un Nome visualizzato che puoi modificare. Nella pagina dell'app sviluppatore nell'interfaccia utente di gestione (Pubblica > App sviluppatore > nome dell'app), il "Nome" interno dell'app compare insieme al "Nome visualizzato", semplificando per identificare visivamente le app in base ai loro nomi interni per la risoluzione dei problemi e la gestione delle API.
Servizi di analisi
Di seguito sono riportate le nuove funzionalità di Analytics Services incluse in questa versione.
Limite di tempo per i dati conservati
Durante la generazione di report di analisi con l'interfaccia utente o l'API di gestione, i dati risalenti a più di sei mesi fa dalla data corrente non è accessibile per impostazione predefinita. Se vuoi accedere a dati più vecchi di sei mesi, contatta l'assistenza Apigee.
Rimozione della versione classica dei report personalizzati dall'interfaccia utente di gestione
La versione classica facoltativa dei report di Analytics personalizzati non è più disponibile in un'interfaccia utente di gestione.
Rendimento del widget Coinvolgimento degli sviluppatori
Il widget della canalizzazione nella dashboard principale di analisi (sezione Coinvolgimento degli sviluppatori) è stato migliorato per migliorare le prestazioni.
Monetizzazione
Di seguito sono riportate le nuove funzionalità per la monetizzazione incluse in questa versione.
Notifiche via email relative al piano tariffario
Un nuovo tipo di notifica via email relativo al piano tariffario ti consente di avvisare gli sviluppatori quando raggiungono un determinato di transazioni o di dollari nei piani tariffari in fasce di volume o pacchetti che hanno acquistato. Per consulta la sezione Configurare tramite modelli di notifica.
Sincronizzazione dei periodi di tariffa ricorrente e base di aggregazione
In un piano tariffario potrebbero essere applicati due periodi di tempo diversi:
- Periodo di tariffa ricorrente, configurato nella scheda Tariffe di un piano tariffario, che determinava quando agli sviluppatori è stata addebitata una tariffa ricorrente.
- Periodo di base di aggregazione, definito nel tariffario per i piani basati sul volume o Pacchetti, che determinato quando l'utilizzo del bundle è stato reimpostato per gli sviluppatori.
Questi due periodi sono ora sincronizzati. Se sia una tariffa ricorrente diversa da zero sia una tariffa basata sul volume o un tariffario del pacchetto esistono in un piano tariffario, il periodo di tariffa ricorrente viene utilizzato per entrambi. Ad esempio: in presenza di una tariffa ricorrente mensile, anche i pacchetti di tariffari vengono reimpostati mensilmente (per impostazione predefinita l'inizio del mese).
Se non è prevista alcuna tariffa ricorrente, i pacchetti vengono reimpostati in base alla base di aggregazione definita nella tariffario. Ad esempio, se uno sviluppatore inizia a utilizzare un tariffario il 19 del mese e La base di aggregazione è ogni mese, poi l'utilizzo del bundle viene reimpostato un mese dopo il 19° giorno.
La base di aggregazione è stata ritirata e verrà rimossa dalla monetizzazione in futuro . Per ulteriori informazioni, consulta la sezione Specificare il piano tariffario. dettagli.
Attributi personalizzati nei report di riepilogo sulle entrate
I criteri di registrazione delle transazioni consentono di acquisire facoltativamente i dati degli attributi personalizzati transazioni, e ora puoi includere questi attributi personalizzati nelle entrate di riepilogo report. Aggiungendo una proprietà MINT.SUMMARY_CUSTOM_ATTRIBUTES alla tua organizzazione, puoi indicano quali attributi personalizzati vengono aggiunti alle tabelle di database per l'utilizzo nei report.
I clienti di Apigee Edge per il cloud privato possono impostare il flag con la seguente chiamata API e Credenziali di amministratore di sistema.
curl -u email:password -X PUT -H "Content-type:application/xml" http://host:8080/v1/o/myorg -d \ "<Organization type="trial" name="MyOrganization"> <Properties> <Property name="features.isMonetizationEnabled">true</Property> <Property name="MINT.SUMMARY_CUSTOM_ATTRIBUTES">["my_attribute_1","my_attribute_2"]</Property> <Property name="features.topLevelDevelopersAreCompanies">false</Property> </Properties> </Organization>"
Tieni presente che l'array di attributi personalizzati nella chiamata API è codificato nell'URL.
Processo di upgrade di SmartDocs
Se hai già utilizzato SmartDocs durante il periodo beta, le nuove funzioni e caratteristiche nella versione in disponibilità generale richiede l'upgrade di SmartDocs nel tuo sviluppatore portale.
Le pagine SmartDoc già pubblicate nel tuo portale per sviluppatori continueranno a funzionano, ma devi seguire la procedura di aggiornamento prima di modificare o pubblicare modifiche a o nuove pagine.
Tieni presente che, anche se puoi eseguire il rendering e pubblicare SmartDocs all'interno del tuo portale per sviluppatori, SmartDocs viene generato dal modello API presente all'interno della gestione delle API Edge di Apigee Servizi. Qualsiasi modifica apportata a un modello API in Edge sarà la stessa in tutto il Pantheon (in modo simile all'esistenza degli sviluppatori negli ambienti Pantheon).
Per eseguire l'upgrade dalla versione beta di SmartDocumenti alla disponibilità generale
- Aggiorna e testa la release 15.05.27 in nei tuoi ambienti dev o test Pantheon.
- Crea un nuovo modello per sostituire l'eventuale modello API esistente che stai utilizzando.
- Se importi documenti Swagger o WADL, importali di nuovo in un nuovo revisione.
- Se hai mantenuto il tuo modello API tramite il modulo SmartDocs, esporta come JSON SmartDocs e importarli nel nuovo modello utilizzando un file allegato.
- Imposta le proprietà di sicurezza della revisione del modello. Nella scheda Contenuti >
SmartDocumenti > modello, seleziona Impostazioni di sicurezza.
- Verifica le autenticazioni preconfigurate nella pagina delle impostazioni del modello (Contenuti >
SmartDocumenti) facendo clic su Impostazioni nella sezione Operazioni
colonna.
- Aggiorna gli eventuali modelli personalizzati per utilizzare la versione 6 degli asset CSS e JS e apporta le modifiche necessarie Eventuali nuovi nomi di oggetti, ad esempio authSchemes e apiSchema. Per informazioni sull'aggiornamento di SmartDocs consulta l'articolo sull'utilizzo SmartDocumenti per documentare le API.
- Esegui di nuovo il rendering e pubblica la revisione del modello.
- Dopo aver convalidato la nuova documentazione, aggiorna dal portale di produzione alla release 15.05.27.
Se sei un cliente Edge Enterprise e hai domande o dubbi sull'upgrade invia un'email a marsh@apigee.com e cnovak@apigee.com. In caso contrario, utilizza la community Apigee per la risposta corretta.
Modifiche e miglioramenti futuri alle funzionalità
Questa sezione mostra in anteprima le modifiche e i miglioramenti futuri previsti per le funzionalità:
Cambia in Comportamento dei criteri della cache delle risposte
In arrivo in una versione futura (da determinare), il comportamento predefinito <ExcludeErrorResponse> del criterio Cache di risposta verrà modificato.
Comportamento attuale: l'elemento <EscludiErrorResponse> nel il criterio della cache delle risposte è false per impostazione predefinita. Ciò significa che, per impostazione predefinita, le risposte con qualsiasi un possibile codice di stato HTTP (compreso 3xx) venga memorizzato nella cache in base al criterio Response Cache (Cache delle risposte).
Comportamento futuro: l'elemento <EscludiErrorResponse> nel Il criterio della cache delle risposte viene impostato su true per impostazione predefinita. Ciò significa che, per impostazione predefinita, solo le risposte con HTTP I codici di stato da 200 a 205 verranno memorizzati nella cache. Per ignorare questo comportamento e memorizzare nella cache le risposte per tutti codici di stato, dovrai impostare l'elemento <EscludiErrorResponse> a true in modo esplicito.
Soluzione attuale: per Private Cloud 4.15.07.00 e versioni precedenti, se memorizzare nella cache solo le risposte con i codici di stato da 200 a 205, è necessario impostare elemento <EscludiErrorResponse> su true.
Bug corretti
In questa release sono stati corretti i bug riportati di seguito.
| ID problema | Descrizione |
|---|---|
| OPDK-1521 | Problema di crittografia della password |
| OPDK-1201 | Impossibile ripristinare i dati dell'interfaccia utente |
| OPDK-1112 | Il criterio per le password LDAP personalizzate non viene applicato all'amministratore Apigee utente |
| OPDK-1097 | Eccezione spazio delle chiavi durante l'upgrade di OPDK |
| OPDK-1068 | Possibilità di cambiare la password amministratore in caso di errore durante l'installazione |
| OPDK-1053 | Zookeeper è in esecuzione come root |
| OPDK-967 | Quando si imposta OpenLDAP sull'avvio automatico utilizzando set-autostart.sh, all-status.sh segnala come morto |
| OPDK-905 | Produzione Smartdocs già registrata nel gruppo axgroup001 |
| OPDK-899 | Errore durante l'onboarding |
| OPDK-847 | L'utente creato durante l'onboarding non riceve un'email per la reimpostazione la password |
| OPDK-817 | Gli script init.d generano un errore |
| OPDK-815 | Lo script ax-purge.sh richiede l'eliminazione definitiva delle tabelle di campionamento |
| MGMT-2246 | La pagina Crea report personalizzato non viene visualizzata correttamente nella gestione UI |
| MGMT-2235 | Per i certificati SSL in scadenza, il tempo relativo alla scadenza può creare confusione
arrotondato Per i certificati SSL in scadenza, la data di scadenza è sempre indicata in giorni anziché essere arrotondati per eccesso ai mesi, quando il certificato scade dopo 90 giorni o meno risorse. |
| MGMT-2193 | Rotellina di caricamento durante la modifica di un'API |
| MGMT-2173 | La UI di Trace non consente l'utilizzo di URL legali L'interfaccia utente di Trace ora consente di inviare richieste con valori dei parametri di query che contengono parametri di ricerca. |
| MGMT-2162 | Problema di compilazione JavaScript |
| MGMT-2124 | Le autorizzazioni del ruolo cliente vengono reimpostate al momento del salvataggio delle autorizzazioni nel UI |
| MGMT-2114 | L'indirizzo IP Syslog non valido nel criterio MessageLogging dovrebbe generare un errore corretto durante deployment |
| MGMT-2067 | Traccia: se viene eseguito il deployment della revisione del proxy API in due ambienti, selezionando la revisione e ambiente non funziona correttamente |
| MGMT-2061 | La password dimenticata deve inviare email solo agli utenti registrati L'opzione "Password dimenticata?" nella pagina di accesso all'interfaccia utente di gestione invia email solo agli utenti registrati Utenti Apigee. |
| MGMT-2048 | Può eseguire il deployment di un utente con un ruolo personalizzato che limita le autorizzazioni di deployment a un ambiente in altre |
| MGMT-2041 | Rimuovi l'elemento FaultRules dal modello di allegato predefinito L'elemento FaultRules, che non viene utilizzato nei criteri o nei passaggi del proxy API, non è più vengono aggiunti automaticamente quando crei proxy API o aggiungi criteri. |
| MGMT-2034 | Errore di recupero WSDL: "Errore di recupero WSDL: errore di elaborazione "WSDL". |
| MGMT-1986 | Errore nell'interfaccia utente durante l'aggiunta dello sviluppatore |
| MGMT-1983 | L'API Ottieni un codice di autorizzazione OAuth 2.0 restituisce uno stato errato |
| MGMT-1962 | Errore durante l'accesso all'interfaccia utente di gestione con password efficace L'accesso all'interfaccia utente con alcuni caratteri speciali, ad esempio il segno della percentuale, non è più non riesce. |
| MGMT-1947 | Ruoli non intuitivi nell'interfaccia utente di gestione Se un utente non dispone dell'autorizzazione per creare o modificare un criterio di registrazione delle transazioni, la UI i pulsanti per creare e modificare un criterio di registrazione delle transazioni sono ora disattivati. |
| MGMT-1899 | Percorsi delle risorse eliminati dopo il salvataggio delle impostazioni del prodotto Durante la modifica di un prodotto API, i percorsi delle risorse del prodotto potrebbero essere eliminati se l'utente ho fatto doppio clic sul pulsante Salva. Il problema è stato risolto. |
| MGMT-1894 | La pagina delle app sviluppatore non termina mai il caricamento per lo sviluppatore colonna |
| MGMT-1882 | Il nuovo proxy API di WSDL mostra solo i dettagli dell'ultimo parametro |
| MGMT-1878 | Se viene eseguito il deployment di più revisioni in un ambiente, Trace mostra solo uno dei le |
| MGMT-1872 | Impossibile scaricare report personalizzati |
| MGMT-1863 | Log di Node.js non visualizzabili nella UI di gestione |
| MGMT-1843 | Il proxy API non si apre |
| MGMT-1833 | l'utente sysadmin non deve avere la possibilità di cambiare la password nell'interfaccia utente per OPDK |
| MGMT-1825 | Bug cross-site scripting (XSS) |
| MGMT-1824 | Errore di recupero WSDL durante l'importazione di un file WSDL con estensione .xml |
| MGMT-1812 | Aggiungi la convalida di TargetEndpoint durante l'importazione Analogamente a ProxyEndpoint, TargetEndpoint verrà convalidato per ottenere lo schema corretto espressioni utilizzate nelle condizioni durante l'importazione del proxy API. |
| MGMT-1804 | In alcuni casi, l'API Node.js invia JSON non valido Schermata dei log di Node.js utilizzata per mostrare i log non formattati se i dati json non erano validi caratteri. Questo problema è stato risolto in questa release e ora l'interfaccia utente mostra il formato node.js corretto logaritmi. |
| MGMT-1802 | URL di reimpostazione password 118 Se l'interfaccia utente di gestione si trova dietro un server di terminazione SSL, l'interfaccia utente di gestione ora genera un'email di reimpostazione della password con un link a un URL https anziché a un URL http. |
| MGMT-1799 | Vulnerabilità dell'UI che invia una richiesta in Trace |
| MGMT-1777 | Impossibile aggiungere un utente con un indirizzo email che ha un dominio di primo livello .acn |
| MGMT-1735 | Branding "Errore durante il recupero di W" Con effetto immediato abbiamo rimosso il supporto del branding personalizzato in Edge OPDK. Anche se che questo potrebbe deludere i pochi clienti che lo utilizzavano, non si tratta di una che migliora direttamente le capacità di Edge relative alla gestione delle API. |
| MGMT-1569 | Problema di collegamento del proxy API a un prodotto API esistente È stato corretto il collegamento di un proxy API a un prodotto API nell'interfaccia utente di gestione quando il proxy API aveva una risorsa per "/" del tuo percorso di apprendimento. |
| MGMT-1563 | Il pulsante Invia su Trace rimane disabilitato se si verifica un errore |
| MGMT-1362 | Password dimenticata tramite email non funziona se l'indirizzo email contiene
'_' Corregge il problema di reimpostazione della password in OPDK con indirizzi email che contengono un trattino basso. |
| MGMT-1345 | L'importazione di WSDL con più spazi dei nomi genera un errore di Build SOAP Passaggio |
| MGMT-1193 | Il salvataggio del proxy come nuova revisione modifica inaspettatamente la regola di route |
| MGMT-1061 | SmartDocs: descrizione del parametro del tipo di corpo nella definizione Swagger non visualizzata nell'UI del documento |
| MGMT-800 | Creazione della risorsa con nome "default" in corso... causa un errore dell'UI |
| MGMT-787 | Problema di usabilità degli avvisi nell'interfaccia utente Nell'interfaccia utente di gestione, quando fai clic su + Proxy API e viene visualizzata la finestra di dialogo Nuovo proxy API, puoi premere Esc per chiudere la finestra di dialogo. |
| MGMT-619 | Attiva l'impaginazione nella pagina dell'interfaccia utente del proxy API |
| MGMT-602 | Vista Sviluppo proxy API: aggiungere un criterio Cache risposte quando l'endpoint PreFlow/PostFlow causa un errore |
| MGMT-460 | La ridenominazione del criterio genera un comportamento glitchy, un criterio duplicato che non può essere rimosso |
| DEVRT-1644 | La ricerca delle notifiche per nome causa l'invio di email errate |
| DEVRT-1583 | UI di monetizzazione mostra "Futuro" badge per un piano tariffario attuale |
| DEVRT-1546 | I limiti del piano non funzionano |
| DEVRT-1511 | Errore mint.resourceNonExist per uno sviluppatore esistente |
| CORERT-639 | TCPSysLogSocket deve essere asincrono |
| CORERT-613 | Errori di handshake SSL dovuti a "un known_name" |
| AXAPP-1728 | Ignorare le variabili di monetizzazione in Analytics |
| AXAPP-1708 | L'API di Analytics sembra produrre numeri diversi per la stessa statistica. a seconda di come chiedo |
| AXAPP-1707 | Migliora le prestazioni di analisi dei pod senza costi |
| AXAPP-1690 | "Errore API non valida" sui report personalizzati |
| AXAPP-1533 | La mappa geografica di Analytics genera un errore di chiamata API non valida |
| AXAPP-1493 | Statistiche sulle prestazioni della cache errate |
| APIRT-1436 | Creare strumenti/script per eseguire l'hashing dei token non sottoposti ad hashing |
| APIRT-1425 | Attributo keepOnError se impostato su "true" non ha effetto in JavaCallout norme |
| APIRT-1346 | OAuth2.0: il valore con hash viene restituito nella risposta del token di accesso quando hash.oauth.tokens.enabled è vero |
| APIRT-1206 | target_ip non viene registrato nella tabella delle informazioni per gli errori 503 e la maggior parte delle 504 |
| APIRT-1170 | File di risorse mancante ha causato il mancato caricamento di un ambiente da parte di MP |
| APIRT-1148 | GET della variabile {message.version} in ResponseFlow, per i lanci di una destinazione Node.js NPE |
| APIRT-1054 | Il logging dei messaggi non riesce quando si tenta di accedere a una directory diversa da predefinita |
| APIRT-387 | Esegui OrganizationService con stile "others" su MP |
| APIRT-67 | Il criterio OAuthGenerateAccessToken non imposta la variabile oauthV2.failed correttamente |
| APIRT-52 | Report personalizzati: il codice di stato della risposta per molte API è nullo |
Problemi noti
Questa release presenta i seguenti problemi noti.
| ID problema | Descrizione |
|---|---|
| OPDK-1586 |
Il portale API BaaS non si avvia se il supporto IPV6 non è abilitato
|
| OPDK-1785 |
Installa il componente di monetizzazione su un dispositivo Edge di cui è stato eseguito l'upgrade
ambiente
La soluzione alternativa consiste nell'impostare la versione corretta della monetizzazione nel file apigee-env.sh.
prima di tentare di installare la Monetizzazione. Per ottenere la versione della monetizzazione in 4.15.07
(dopo aver già eseguito l'upgrade a Edge 4.15.07) esegui:
> source /{install-dir}/apigee4/bin/apigee-env.sh
> VER=`basename $(find $SHARE_DIR/installer/monetization -name "mint-*.zip") | cut -d "-" -f 2,3,4`
Per impostazione predefinita, install-dir è /opt.
Il valore di VER di cui sopra deve essere impostato in apigee-env.sh:
> sed -i "s/^MONETIZATION_VERSION=.*/MONETIZATION_VERSION=$VER/" /install-dir/apigee4/bin/apigee-env.sh
Se hai provato a installare i Prodotti per la monetizzazione senza svolgere i passaggi precedenti, il
l'installazione non riesce e probabilmente esiste un link simbolico inattivo nella directory di condivisione. Ti servono
per rimuovere il link simbolico:
> rm /install-dir/apigee4/share/monetization
Dopo aver rimosso il link simbolico, segui i passaggi precedenti per impostare la versione per la monetizzazione,
e riprova a eseguire l'installazione di Monetizzazione.
|
| OPDK-1857 |
Versione Python 2.6 hardcoded in bin/qpid-stat.sh e
bin/qpid-config.sh Su CentOS e RedHat 7.0, diversi script in bin/qpid-stat.sh e bin/qpid-config.sh sono hardcoded per utilizzare Python versione 2.6. La soluzione alternativa a questo problema è cambiare la riga che esporta PYTHONPATH in qpid-stat.sh e qpid-config.sh nella directory apigee4/bin.
Per determinare la versione Python sul tuo sistema, controlla la versione Python nella directory /opt/apigee4/share/apache-qpid/lib. Molto probabilmente la directory è python2.7. Devi quindi aggiornare l'impostazione PYTHONPATH in qpid-stat.sh e qpid-config.sh con il percorso corretto. Ad esempio:
|
| DEVRT-1574 | Equilibrio e utilizzo incoerenti per gli sviluppatori con più tariffe attive
piani Nella monetizzazione, se uno sviluppatore è attivo su più di un piano tariffario che prevede per ogni chiamata API. aggiuntivi, l'utilizzo del saldo monetario potrebbe talvolta non essere coerente. |
| APIBAAS-1647 | Dopo l'accesso come amministratore di sistema, nell'interfaccia utente di BaaS viene visualizzato il messaggio "Errore durante il recupero dei ruoli"
messaggio Questo messaggio di errore viene visualizzato al primo accesso al sistema da parte dell'amministratore di sistema dopo Upgrade dalla versione 4.15.01 alla 4.15.07. Puoi ignorare questo messaggio. |
| DEVRT-1834 |
Upgrade della monetizzazione al 15/04/07 Lo script apigee-upgrade.sh stampa il seguente messaggio alla fine che ti chiede di esegui un altro script: ************************************** In order to complete the monetization upgrade please run: sudo /opt/apigee4/share/monetization/schema/migration/MOPDK4.15.04.00/ 365-create-notification-condition.sh ************************************** Puoi ignorare questo messaggio. Questo script non è obbligatorio e non può essere eseguito. |
| DEVRT-1951 |
Monetizzazione della nuova installazione senza configurazioni delle notifiche
In una nuova installazione di Apigee Edge per il cloud privato versione 4.15.07.00,
le seguenti configurazioni per le notifiche sulla monetizzazione risultano mancanti. Questi valori corrispondono
ai tipi di notifica nella pagina Amministrazione > Notifiche nell'interfaccia utente di gestione.
mint.scheduler.${ORG_ID}.adhocnotify@@@management
mint.scheduler.${ORG_ID}.expiringrateplannotify@@@management
mint.scheduler.${ORG_ID}.newpkgnotify@@@management
mint.scheduler.${ORG_ID}.newproductnotify@@@management
mint.scheduler.${ORG_ID}.newrateplannotify@@@management
mint.scheduler.${ORG_ID}.tncacceptancenotify@@@management
Per risolvere il problema, procedi nel seguente modo. Ti servirà l'indirizzo IP del tuo
Istanza Cassandra. Per trovarla, cerca
<installation-root>/apigee4/conf/cassandra/cassandra.yaml oppure
<installation-root>/apigee4/conf/cassandra/cassandra-topology.properties.
|
| DEVRT-1952 |
Notifica mancante per l'upgrade della monetizzazione dal 14/07/00
configurazioni
In un upgrade di Apigee Edge per il cloud privato dalla versione 4.14.07.00 alla 4.15.07.00, viene restituito
le seguenti configurazioni per le notifiche sulla monetizzazione non sono presenti, il che fa sì che
report sulla monetizzazione non funzionano correttamente.
mint.scheduler.${ORG_ID}.chargedaily@@@management
mint.scheduler.${ORG_ID}.chargehourly@@@management
Per risolvere il problema, procedi nel seguente modo. Ti servirà l'indirizzo IP del tuo
Istanza Cassandra. Per trovarla, cerca
<installation-root>/apigee4/conf/cassandra/cassandra.yaml oppure
<installation-root>/apigee4/conf/cassandra/cassandra-topology.properties.
|
| OPDK-1878 | Impossibile impostare il nome del pod in più installazioni di data center La Guida all'installazione di Edge specifica di impostare i nomi dei pod come "gateway-1" e "gateway-2" nel i file di installazione silenziosa per più installazioni in data center. Tuttavia, rinominando il pod impedisce che router e processori di messaggi vengano registrati correttamente e accessibili. Inoltre, questo problema impedisce allo script setup-org.sh di essere in grado di i processori di messaggi disponibili. La soluzione alternativa è impostare il nome del pod, utilizzando la proprietà MP_POD, su "gateway" nel il file di installazione invisibile per entrambi i data center. |
| OPDK-1886 |
Il nodo non può accedere agli indirizzi IP locali come 192.168.x.y
connect.ranges.denied=10.0.0.0/8,192.168.0.0/16,127.0.0.1/32
Quindi, riavvia i nodi del processore di messaggi:
<install_dir>/apigge4/bin/apigee-service message-processor restart
|
| OPDK-1958 | Durante l'upgrade, tutti i nodi richiederanno l'accesso alla porta 8080 in gestione
Server In fase di runtime, i seguenti componenti richiedono l'accesso alla porta 8080 sul server di gestione: router, processore di messaggi, UI, Postgres e Qpid. Tuttavia, quando esegui l'upgrade, tutti i nodi richiedono l'accesso alla porta 8080 su Management Server, inclusi Cassandra e Zookeeper nodi. |
| OPDK-1962 | Devi riconfigurare SSL per l'API Edge dopo l'upgrade Se hai configurato l'API Edge per l'utilizzo di SSL prima di eseguire l'upgrade alla versione 4.15.07.00, riconfigurare SSL dopo l'upgrade. Consulta la Guida alle operazioni di Edge per le per configurare il protocollo SSL per l'API Edge. |