Note di rilascio di Edge Microgateway

Stai visualizzando la documentazione di Apigee Edge.
Consulta la documentazione di Apigee X. info

Versione 3.3.x

Correzioni di bug e miglioramenti v.3.3.x

3.3.7

Il 17 luglio 2025 abbiamo rilasciato le seguenti correzioni e miglioramenti per Edge Microgateway.

Correzioni di bug e miglioramenti:

edgemicro:
  plugins:
    excludeUrls: '/hello,/proxy_one/*' # global exclude urls
    sequence:
      -oauth
      -json2xml
      -quota
      -json2xml:
          excludeUrls: '/hello/xml/*'  # plugin level exclude urls

Problemi di sicurezza risolti

• CVE-2024-12905
• CVE-2025-46653

3.3.6

Il 16 aprile 2025 abbiamo rilasciato le seguenti correzioni e miglioramenti per Edge Microgateway.

Versioni dei componenti:

La tabella seguente elenca i numeri di versione dei singoli progetti di componenti associati a Edge Microgateway 3.3.6. Tieni presente che, poiché ogni componente è un progetto separato, i numeri di rilascio potrebbero non corrispondere alla versione principale del prodotto:

Problemi di sicurezza risolti

• CVE-2025-27789
• CVE-2024-21538
• CVE-2024-12133

3.3.5

Venerdì 20 dicembre 2024 abbiamo rilasciato le seguenti correzioni e miglioramenti per Edge Microgateway.

Versioni dei componenti:

La tabella seguente elenca i numeri di versione dei singoli progetti di componenti associati a Edge Microgateway 3.3.5. Tieni presente che, poiché ogni componente è un progetto separato, i numeri di rilascio potrebbero non corrispondere alla versione principale del prodotto:

Correzioni di bug e miglioramenti:

current nodejs version is  18.x.x Note, v18.x.x will be out of support soon, see https://docs.apigee.com/release/notes/edge-microgateway-release-notes-0

You are using a version of NodeJS that is not supported

Problemi di sicurezza risolti

• CVE-2024-21538
• CVE-2024-45590
• CVE-2019-3844
• CVE-2019-12290
• CVE-2020-1751
• CVE-2018-12886
• CVE-2023-50387
• CVE-2019-3843
• CVE-2022-4415
• CVE-2021-3997

3.3.4

Il 18 settembre 2024 abbiamo rilasciato le seguenti correzioni e miglioramenti per Edge Microgateway.

Versioni dei componenti:

La tabella seguente elenca i numeri di versione dei singoli progetti di componenti associati a Edge Microgateway 3.3.4. Tieni presente che poiché ogni componente è un progetto separato, i numeri di rilascio potrebbero non corrispondere alla versione principale del prodotto:

Correzioni di bug e miglioramenti:

Problemi di sicurezza risolti

• CVE-2021-23337
• CVE-2024-4068
• CVE-2020-28469
• CVE-2020-28503

3.3.3

Il 25 aprile 2024 abbiamo rilasciato le seguenti correzioni e miglioramenti per Edge Microgateway.

Versioni dei componenti:

La tabella seguente elenca i numeri di versione dei singoli progetti di componenti associati a Edge Microgateway 3.3.3. Tieni presente che poiché ogni componente è un progetto separato, i numeri di rilascio potrebbero non corrispondere alla versione principale del prodotto:

Correzioni di bug e miglioramenti:

Problemi di sicurezza risolti

• CVE-2023-0842
• CVE-2023-26115
• CVE-2022-25883
• CVE-2017-20162
• CVE-2022-31129
• CVE-2022-23539
• CVE-2022-23541
• CVE-2022-23540
• CVE-2024-21484
• CVE-2022-46175
• CVE-2023-45133
• CVE-2020-15366
• CVE-2023-26136
• CVE-2023-26115

3.3.2

Il 18 agosto 2023 abbiamo rilasciato le seguenti correzioni e miglioramenti per Edge Microgateway.

Versioni dei componenti:

La tabella seguente elenca i numeri di versione dei singoli progetti di componenti associati a Edge Microgateway 3.3.2. Tieni presente che poiché ogni componente è un progetto separato, i numeri di rilascio potrebbero non corrispondere alla versione principale del prodotto:

Correzioni di bug e miglioramenti:

Problemi di sicurezza risolti

Nessuno.

3.3.1

Il 7 giugno 2022 abbiamo rilasciato le seguenti correzioni e miglioramenti per Edge Microgateway.

Versioni dei componenti:

La tabella seguente elenca i numeri di versione dei singoli progetti di componenti associati a Edge Microgateway 3.3.1. Tieni presente che poiché ogni componente è un progetto separato, i numeri di rilascio potrebbero non corrispondere alla versione principale del prodotto:

Correzioni di bug e miglioramenti:

Problemi di sicurezza risolti

3.3.0

Il 4 febbraio 2022 abbiamo rilasciato le seguenti correzioni e miglioramenti per Edge Microgateway.

Versioni dei componenti:

La tabella seguente elenca i numeri di versione dei singoli progetti di componenti associati a Edge Microgateway 3.3.0. Tieni presente che poiché ogni componente è un progetto separato, i numeri di rilascio potrebbero non corrispondere alla versione principale del prodotto:

Correzioni di bug e miglioramenti:

npm install apigeetool@0.15.1

Versione 3.2.x

Correzioni di bug e miglioramenti v.3.2.x

3.2.3

Il 17 settembre 2021 abbiamo rilasciato le seguenti correzioni e miglioramenti per Edge Microgateway.

Versioni dei componenti:

La tabella seguente elenca i numeri di versione dei singoli progetti di componenti associati a Edge Microgateway 3.2.3. Tieni presente che poiché ogni componente è un progetto separato, i numeri di rilascio potrebbero non corrispondere alla versione principale del prodotto:

Correzioni di bug e miglioramenti:

Problemi di sicurezza risolti

3.2.2

Giovedì 15 luglio 2021 abbiamo rilasciato le seguenti correzioni e miglioramenti per Edge Microgateway.

Versioni dei componenti:

La tabella seguente elenca i numeri di versione dei singoli progetti di componenti associati a Edge Microgateway 3.2.2. Tieni presente che poiché ogni componente è un progetto separato, i numeri di rilascio potrebbero non corrispondere alla versione principale del prodotto:

Correzioni di bug e miglioramenti:

Problemi di sicurezza risolti

3.2.1

Venerdì 5 marzo 2021 abbiamo rilasciato le seguenti correzioni e miglioramenti per Edge Microgateway.

Versioni dei componenti:

La tabella seguente elenca i numeri di versione dei singoli progetti di componenti associati a Edge Microgateway 3.2.1. Tieni presente che poiché ogni componente è un progetto separato, i numeri di rilascio potrebbero non corrispondere alla versione principale del prodotto:

Correzioni di bug e miglioramenti:

edgemicro:
 enable_GET_req_body: true

3.2.0

Giovedì 21 gennaio 2021 abbiamo rilasciato le seguenti correzioni e miglioramenti per Edge Microgateway.

Versioni dei componenti:

La tabella seguente elenca i numeri di versione dei singoli progetti di componenti associati a Edge Microgateway 3.2.0. Tieni presente che poiché ogni componente è un progetto separato, i numeri di rilascio potrebbero non corrispondere alla versione principale del prodotto:

Correzioni di bug e miglioramenti:

Versione 3.1.x

Correzioni di bug e miglioramenti v.3.1.x

3.1.8

Lunedì 16 novembre 2020 abbiamo rilasciato le seguenti correzioni e miglioramenti per Edge Microgateway.

Versioni dei componenti:

La tabella seguente elenca i numeri di versione dei singoli progetti di componenti associati a Edge Microgateway 3.1.8. Tieni presente che poiché ogni componente è un progetto separato, i numeri di rilascio potrebbero non corrispondere alla versione principale del prodotto:

Correzioni di bug e miglioramenti:

3.1.7

Giovedì 24 settembre 2020 abbiamo rilasciato le seguenti correzioni e miglioramenti per Edge Microgateway.

Versioni dei componenti:

La tabella seguente elenca i numeri di versione dei singoli progetti di componenti associati a Edge Microgateway 3.1.7. Tieni presente che poiché ogni componente è un progetto separato, i numeri di rilascio potrebbero non corrispondere alla versione principale del prodotto:

Correzioni di bug e miglioramenti:

{"message":"write after end","code":"ERR_STREAM_WRITE_AFTER_END"}

3.1.6

Giovedì 20 agosto 2020 abbiamo rilasciato le seguenti correzioni e miglioramenti per Edge Microgateway.

Versioni dei componenti:

La tabella seguente elenca i numeri di versione dei singoli progetti di componenti associati a Edge Microgateway 3.1.6. Tieni presente che poiché ogni componente è un progetto separato, i numeri di rilascio potrebbero non corrispondere alla versione principale del prodotto:

Correzioni di bug e miglioramenti:

3.1.5

Venerdì 26 giugno 2020 abbiamo rilasciato le seguenti correzioni e miglioramenti per Edge Microgateway.

Versioni dei componenti:

La tabella seguente elenca i numeri di versione dei singoli progetti di componenti associati a Edge Microgateway 3.1.5. Tieni presente che poiché ogni componente è un progetto separato, i numeri di rilascio potrebbero non corrispondere alla versione principale del prodotto:

Correzioni di bug e miglioramenti:

3.1.4

Venerdì 23 aprile 2020 abbiamo rilasciato la seguente correzione per Edge Microgateway.

Correzione di bug:

È stato risolto un problema di dipendenza nella versione 3.1.3. La versione 3.1.3 è stata contrassegnata come deprecata nel repository npm. In caso contrario, a questa release si applicano tutte le correzioni di bug e i miglioramenti descritti nelle note di rilascio della versione 3.1.3.

3.1.3

Mercoledì 15 aprile 2020 abbiamo rilasciato le seguenti correzioni e miglioramenti per Edge Microgateway.

Versioni dei componenti:

La tabella seguente elenca i numeri di versione dei singoli progetti di componenti associati a Edge Microgateway 3.1.3. Tieni presente che poiché ogni componente è un progetto separato, i numeri di rilascio potrebbero non corrispondere alla versione principale del prodotto:

Correzioni di bug e miglioramenti:

• 153509313: è stato risolto un problema per cui il modulo di debug Node.js causava perdite di memoria. Il problema si verifica nelle versioni 3.1.0, 3.1.1 e 3.1.2.
• 153509313 - È stato risolto un problema per cui lo stesso ID messaggio per due transazioni diverse veniva stampato nell'output di logging.
• 151673570 - È stato risolto un problema per cui Edge Microgateway non veniva aggiornato per utilizzare le nuove API KVM di Apigee. Edge Microgateway ora utilizza i nuovi comandi per aggiungere e aggiornare i valori KVM.
• 152822846 - Nelle release precedenti, Edge Microgateway è stato aggiornato in modo che l'elaborazione della mappatura del percorso delle risorse corrisponda a quella di Apigee Edge. In questa release è stato corretto un problema per cui il pattern /literal_string/* non veniva gestito correttamente. Ad esempio, /*/2/*. Vedi anche Configurazione del comportamento di un percorso di risorsa di "/", "/*" e "/**".
• 152005003 - Sono state apportate modifiche per attivare gli identificatori con ambito organizzazione e ambiente per le quote.
• 152005003 - Sono state apportate modifiche per attivare gli identificatori con ambito organizzazione e ambiente per le quote. La combinazione di "org + env + appName + productName" viene utilizzata come identificatore della quota.

3.1.2

Lunedì 16 marzo 2020 abbiamo rilasciato le seguenti correzioni e miglioramenti per Edge Microgateway.

Versioni dei componenti:

La tabella seguente elenca i numeri di versione dei singoli progetti di componenti associati a Edge Microgateway 3.1.3. Tieni presente che poiché ogni componente è un progetto separato, i numeri di rilascio potrebbero non corrispondere alla versione principale del prodotto:

Correzioni di bug e miglioramenti:

• 151285018 - È stato apportato un miglioramento della funzionalità per aggiungere il supporto del proxy HTTP per il traffico tra Edge Microgateway e le destinazioni di backend. Inoltre, sono stati risolti problemi relativi al supporto del proxy HTTP esistente tra Edge Microgateway e Apigee Edge. Per maggiori dettagli, vedi:
  • Utilizzare un proxy HTTP per la comunicazione con Apigee Edge
  • Utilizzare un proxy HTTP per la comunicazione di destinazione
• 149101890 - Il codice di notifica del log per i casi in cui il server di destinazione o il bilanciamento del carico chiude la connessione è stato modificato da ERROR a INFO.
• 150746985 - È stato risolto un problema per cui il comando edgemicro verify non funzionava correttamente se nel file di configurazione erano presenti redisBasedConfigCache: true o quotaUri: https://%s-%s.apigee.net/edgemicro-auth.
• 151284716 - È stato apportato un miglioramento per chiudere più rapidamente le connessioni al server quando i worker vengono riavviati durante un ricaricamento.
• 151588764 - Aggiorna la versione di Node.js nell'immagine Docker utilizzata per eseguire Edge Microgateway in un container Docker alla versione 12, perché Node.js v8 è deprecata.
• 151306049 - È stato eseguito un aggiornamento della documentazione per elencare le API di gestione di Apigee Edge utilizzate dai comandi della CLI Edge Microgateway. Consulta Quali API di gestione utilizza Edge Microgateway?.

3.1.1

Giovedì 20 febbraio abbiamo rilasciato le seguenti correzioni e miglioramenti per Edge Microgateway.

Versioni dei componenti:

La tabella seguente elenca i numeri di versione dei singoli progetti di componenti associati a Edge Microgateway 3.1.1. Tieni presente che poiché ogni componente è un progetto separato, i numeri di rilascio potrebbero non corrispondere alla versione principale del prodotto:

Correzioni di bug e miglioramenti:

• 146069701 - È stato risolto un problema per cui il modulo microgateway-core non rispettava le variabili di ambiente HTTP_PROXY e HTTPS_PROXY. Con questa modifica, le impostazioni proxy nel file di configurazione YAML, se specificate, vengono ora ignorate; per specificare il proxy vengono utilizzate solo le variabili di ambiente.

  Se vuoi specificare la configurazione del proxy nel file di configurazione, devi anche specificare una variabile HTTP_PROXY che menzioni lo stesso URL proxy di quello specificato nel file di configurazione. Ad esempio, se specifichi la seguente configurazione:

  edge_config:
    proxy: http://10.128.0.20:3128
    proxy_tunnel: true

  Devi specificare anche questa variabile di ambiente:

  HTTP_PROXY=http://10.128.0.20:3128

• 146320620 - È stato aggiunto un nuovo parametro di configurazione, edgemicro.headers_timeout. Questo attributo limita il tempo (in millisecondi) che il parser HTTP attenderà per ricevere le intestazioni HTTP complete. Ad esempio:

  edgemicro:
  keep_alive_timeout: 6000
  headers_timeout: 12000

  Internamente, il parametro imposta l'attributo Node.js Server.headersTimeout nelle richieste. (Valore predefinito: 5 secondi in più rispetto al tempo impostato con edgemicro.keep_alive_timeout. Questa impostazione predefinita impedisce ai bilanciatori del carico o ai proxy di interrompere erroneamente la connessione.)

• 149278885 - È stata aggiunta una nuova funzionalità che consente di impostare il timeout dell'API di destinazione a livello di proxy API anziché utilizzare un'impostazione di timeout globale.

  Se imposti la proprietà TargetEndpoint io.timeout.millis nel proxy API, Edge Microgateway sarà in grado di recuperare la proprietà e applicare timeout specifici per l'endpoint di destinazione. Se questo parametro non viene applicato, Edge Microgateway utilizza il timeout globale specificato con edgemicro.request_timeout.

3.1.0

Martedì 21 gennaio abbiamo rilasciato le seguenti correzioni e miglioramenti per Edge Microgateway.

Versioni dei componenti:

La tabella seguente elenca i numeri di versione dei singoli progetti di componenti associati a Edge Microgateway 3.1.0. Tieni presente che poiché ogni componente è un progetto separato, i numeri di rilascio potrebbero non corrispondere alla versione principale del prodotto:

Correzioni di bug e miglioramenti:

• 144187500 - Quando viene attivato il flag quotas.failOpen, viene registrato un nuovo evento di livello WARN. Questo flag viene attivato se si verifica un errore di elaborazione della quota o se la richiesta "quota apply" a Edge non riesce ad aggiornare i contatori delle quote remoti. In questo caso, la quota verrà elaborata in base ai conteggi locali solo fino alla successiva sincronizzazione riuscita della quota remota. In precedenza, questo evento veniva registrato solo quando il livello di log era impostato su DEBUG.

  Ad esempio:

  2020-01-20T02:52:53.040Z [warn][localhost:8000][5][foo-eval][test][hello/][]
  [DbpGIq9jKfzPX8jvXEivhA0LPwE][f372cc30-3b2f-11ea-845f-a627f][quota][remote quota not
  available so processing locally, setting quota-failed-open for identifier: AppQuota60.Quota60]
  [GET][][][][]

• 145023519 - È stato risolto un problema per cui le transazioni in corso o nuove venivano interessate ogni volta che Edge Microgateway rilevava una modifica a un proxy API. Ora, quando viene apportata una modifica a un proxy, Edge Microgateway aggiorna la cache e i nodi di lavoro vengono riavviati. Con questa modifica, le transazioni in corso e le nuove chiamate API inviate al microgateway non sono interessate.
• 146378327 - Il livello di log di sourceRequest, targetRequest e targetResponse è stato modificato in INFO.
• 146019878 - È stata corretta una discrepanza tra la latenza calcolata per "Rendimento proxy API" in Edge Analytics e gli eventi di log sourceResponse/targetResponse di Edge Microgateway. Ora, la latenza negli eventi di log di Edge Analytics e Microgateway è allineata.
• Modifiche alla logica di corrispondenza di pattern:
  • 147027862 - Il plug-in oauth è stato aggiornato per supportare i seguenti pattern di corrispondenza del percorso delle risorse come specificato nei prodotti API:
    • /{literal}**
    • /{literal}*
    • Qualsiasi combinazione dei due pattern precedenti

    Con questa modifica, il plug-in Edge Microgateway ora segue lo stesso pattern matching di Apigee Edge, come spiegato in Configurazione del comportamento di un percorso di risorse di "/", "/*" e "/**".

  • 145644205 - Update pattern matching logic of apiKeys plugin to match oauth plugin.
• 143488312 - È stato risolto un problema per cui gli spazi iniziali o finali nel parametro ID client causavano la creazione di un elenco di prodotti JWT vuoto per le richieste di token OAuth e chiave API.
• 145640807 e 147579179: è stata aggiunta una nuova funzionalità che consente a un'istanza speciale di Edge Microgateway chiamata "sincronizzatore" di recuperare i dati di configurazione da Apigee Edge e scriverli in un database Redis locale. Altre istanze di microgateway possono quindi essere configurate per leggere i dati di configurazione dal database. Questa funzionalità aggiunge un livello di resilienza a Edge Microgateway. Consente alle istanze di microgateway di avviarsi e funzionare senza dover comunicare con Apigee Edge. Per maggiori dettagli, vedi Utilizzare lo strumento di sincronizzazione.

  Al momento la funzionalità di sincronizzazione è supportata per l'utilizzo con Redis 5.0.x.

Versione 3.0.x

Correzioni di bug e miglioramenti v.3.0.x

3.0.10

Venerdì 8 novembre abbiamo rilasciato le seguenti correzioni e miglioramenti per Edge Microgateway.

Versioni dei componenti:

La tabella seguente elenca i numeri di versione dei singoli progetti di componenti associati a Edge Microgateway 3.0.10. Tieni presente che poiché ogni componente è un progetto separato, i numeri di rilascio potrebbero non corrispondere alla versione principale del prodotto:

Correzioni di bug e miglioramenti:

• 142677575 - È stato eseguito un aggiornamento delle funzionalità in modo che la corrispondenza dei pattern per i percorsi delle risorse utilizzati nei prodotti API per Edge Microgateway ora sia in linea con la corrispondenza dei pattern dei percorsi delle risorse utilizzata da Apigee Edge, come descritto in Configurazione del comportamento di un percorso delle risorse di "/", "/*" e "/**".

  Nota: se utilizzi un pattern di risorse composto come /*/2/**, devi assicurarti che il proxy edgemicro_auth venga aggiunto a un prodotto API autonomo. Dopodiché, devi includere il prodotto nell'app per sviluppatori del proxy, come illustrato nello screenshot seguente:

  

  Nota: la proprietà di configurazione features.isSingleForwardSlashBlockingEnabled, come descritto in Configurazione del comportamento di un percorso di risorsa di "/", "/*" e "/**", non è supportata per Edge Microgateway.

• 143740696 - La struttura di configurazione di quotas è stata modificata (vedi anche le note di rilascio per la versione 3.0.9). La proprietà quotas viene utilizzata per configurare il plug-in quota. La modifica della struttura è stata apportata per migliorare la chiarezza degli elementi di configurazione. Per configurare il plug-in quota, utilizza la seguente configurazione YAML. Tieni presente che la proprietà di configurazione si chiama quotas. Per informazioni dettagliate sulle singole proprietà di configurazione di quotas, consulta Opzioni di configurazione per la quota.

  edgemicro:
    home: ../gateway
    port: 8000
    max_connections: -1
    max_connections_hard: -1
    logging:
      level: info
      dir: /var/tmp
      stats_log_interval: 60
    plugins:
      dir: ../plugins
      sequence:
        - oauth
        - quota
  quotas:
    bufferSize:
      hour: 20000
      minute: 500
      default: 10000
    useDebugMpId: true
    failOpen: true
  ...

• 141750056 - È stata aggiunta una nuova funzionalità che consente di utilizzare Redis come archivio di supporto delle quote. Se useRedis è true, viene utilizzato il modulo volos-quota-redis. Se true, la quota è limitata solo alle istanze Edge Microgateway che si connettono a Redis. Se false, il modulo volos-quota-apigee viene utilizzato come archivio di backend e il contatore delle quote è globale. Per maggiori dettagli, vedi Opzioni di configurazione per la quota. Ad esempio:

  edgemicro:
  ...
  quotas:
    useRedis: true
    redisHost: localhost
    redisPort: 6379
    redisDb: 1

• 140574210 - Il tempo di scadenza predefinito per i token generati dal proxy edgemicro-auth è stato modificato da 108.000 millisecondi (1,8 minuti) a 1800 secondi (30 minuti).
• 143551282 - Per supportare le organizzazioni abilitate a SAML, il comando edgemicro genkeys è stato aggiornato per includere un parametro ‑‑token. Questo parametro ti consente di utilizzare un token OAuth per l'autenticazione anziché nome utente/password. Per maggiori dettagli, vedi Generare chiavi.

3.0.9

Venerdì 11 ottobre abbiamo rilasciato le seguenti correzioni e miglioramenti per Edge Microgateway.

Versioni dei componenti:

La tabella seguente elenca i numeri di versione dei singoli progetti di componenti associati a Edge Microgateway 3.0.9. Tieni presente che poiché ogni componente è un progetto separato, i numeri di rilascio potrebbero non corrispondere alla versione principale del prodotto:

Correzioni di bug e miglioramenti:

• 141989374 - È stata aggiunta una nuova funzionalità "fail open" per il plug-in quota. Quando questa funzionalità è abilitata, se si verifica un errore di elaborazione della quota o se la richiesta "quota apply" a Edge non riesce ad aggiornare i contatori delle quote remote, la quota verrà elaborata in base ai conteggi locali solo fino alla successiva sincronizzazione riuscita delle quote remote. In entrambi i casi, nel oggetto richiesta viene impostato un flag quota-failed-open.

  Per abilitare la funzionalità di "fail open" della quota, imposta la seguente configurazione:

  quotas :
   failOpen : true

  Nota: inoltre, il nome del flag dell'oggetto richiesta fail-open del plug-in OAuth è stato modificato in oauth-failed-open.

• 142093764 - È stata apportata una modifica alla configurazione del proxy edgemicro-auth per evitare superamenti della quota. La modifica consiste nell'impostazione del tipo di quota su calendario. Per utilizzare questo miglioramento, devi aggiornare edgemicro-auth alla versione 3.0.7 o successive.
• 142520568 - È stata aggiunta una nuova funzionalità per abilitare la registrazione dell'ID MP (message processor) nelle risposte relative alla quota. Per utilizzare questa funzionalità, devi aggiornare il proxy edgemicro-auth alla versione 3.0.7 o successive e impostare la seguente configurazione:

  quotas:
    useDebugMpId: true

  Quando useDebugMpId è impostato, le risposte alla quota da Edge conterranno l'ID MP e verranno registrate da Edge Microgateway. Ad esempio:

  {
      "allowed": 20,
      "used": 3,
      "exceeded": 0,
      "available": 17,
      "expiryTime": 1570748640000,
      "timestamp": 1570748580323,
      "debugMpId": "6a12dd72-5c8a-4d39-b51d-2c64f953de6a"
  }

3.0.8

Giovedì 26 settembre abbiamo rilasciato le seguenti correzioni e miglioramenti per Edge Microgateway.

Versioni dei componenti:

La tabella seguente elenca i numeri di versione dei singoli progetti di componenti associati a Edge Microgateway 3.0.8. Tieni presente che poiché ogni componente è un progetto separato, i numeri di rilascio potrebbero non corrispondere alla versione principale del prodotto:

Correzioni di bug e miglioramenti:

• 140025210 - È stata aggiunta una nuova funzionalità "fail open". Questa funzionalità consente di continuare l'elaborazione delle API se non è possibile aggiornare un token JWT scaduto a causa di un errore di connessione che impedisce una chiamata di verifica della chiave API riuscita al proxy edgemicro-auth.

  La funzionalità consente di impostare un periodo di tolleranza in cui il vecchio token rimane nella cache e viene riutilizzato fino alla scadenza del periodo di tolleranza. La funzionalità consente a Edge Microgateway di continuare a elaborare le richieste in caso di errore di connessione temporaneo. Quando la connettività viene ripristinata e viene eseguita una chiamata API Verify riuscita, viene recuperato un nuovo JWT che sostituisce il vecchio JWT nella cache.

  Per configurare la nuova funzionalità "fail open", segui questi passaggi:

  1. Imposta le seguenti proprietà nella sezione oauth del file di configurazione di Edge Microgateway:

     oauth:
       failOpen: true
       failopenGraceInterval: time_in_seconds
       cacheKey: true
       ...

     Ad esempio:

     oauth:
       failOpen: true
       failopenGraceInterval: 5
       cacheKey: true
       ...

     In questo esempio, il vecchio token verrà utilizzato per 5 secondi se non può essere aggiornato a causa di un problema di connettività. Dopo 5 secondi, verrà restituito un errore di autenticazione.

• 141168968 - È stato eseguito un aggiornamento per includere correlation_id in tutti gli output dei log dei plug-in. Inoltre, i livelli di log per alcuni log sono stati modificati in error in base alle esigenze.
• 140193349 - È stato apportato un aggiornamento al proxy edgemicro-auth per richiedere la verifica della chiave e del secret di Edge Microgateway a ogni richiesta di verifica della chiave API. Edge Microgateway è stato aggiornato per inviare sempre la chiave e il secret a ogni richiesta di verifica della chiave API. Questa modifica impedisce ai client di ottenere un JWT con solo una chiave API.
• 140090250 - È stato eseguito un aggiornamento per aggiungere la registrazione diagnostica per l'elaborazione delle quote. Con questa modifica, ora è possibile correlare l'output del log delle quote con il resto dei log di Edge Microgateway.

3.0.7

Giovedì 12 settembre abbiamo rilasciato le seguenti correzioni e miglioramenti per Edge Microgateway.

Versioni dei componenti:

La tabella seguente elenca i numeri di versione dei singoli progetti di componenti associati a Edge Microgateway 3.0.7. Tieni presente che poiché ogni componente è un progetto separato, i numeri di rilascio potrebbero non corrispondere alla versione principale del prodotto:

Correzioni di bug e miglioramenti:

• 140075602 - È stato apportato un aggiornamento al plug-in OAuth per restituire un codice di stato 5xx laddove appropriato. In precedenza, il plug-in restituiva solo codici di stato 4xx in tutti i casi diversi da 200. Ora, per qualsiasi risposta al messaggio che non sia uno stato 200, verrà restituito il codice 4xx o 5xx esatto, a seconda dell'errore.

  Questa funzionalità è disattivata per impostazione predefinita. Per attivare questa funzionalità, aggiungi la proprietà oauth.useUpstreamResponse: true alla configurazione di Edge Microgateway. Ad esempio:

  oauth:
    allowNoAuthorization: false
    allowInvalidAuthorization: false
    gracePeriod: 10
    useUpstreamResponse: true

• 140090623 - Nella release 3.0.6 è stata aggiunta una nuova proprietà di configurazione, quota.quotaUri. Imposta questa proprietà di configurazione se vuoi gestire le quote tramite il proxy edgemicro-auth che viene implementato nella tua organizzazione. Se questa proprietà non è impostata, l'endpoint quota utilizza per impostazione predefinita l'endpoint Edge Microgateway interno. Ad esempio:

  edge_config:
    quotaUri: https://%s-%s.apigee.net/edgemicro-auth

  Nella release 3.0.7, edgemicro-auth è stato aggiornato per accettare questa nuova configurazione. Per utilizzare la proprietà quotaUri, devi eseguire l'upgrade al proxy edgemicro-auth più recente. Per maggiori dettagli, vedi Upgrade del proxy edgemicro-auth.

• 140470888 - È stata aggiunta un'intestazione di autorizzazione alle chiamate di quota per fornire l'autenticazione. Inoltre, il proxy edgemicro-auth è stato modificato per rimuovere "organization" dall'identificatore della quota. Poiché l'endpoint della quota si trova nell'organizzazione del cliente, l'identificatore della quota non è più necessario.
• 140823165 - Il seguente nome della proprietà:

  edgemicro:
      keepAliveTimeout

  è stato documentato in modo errato nella versione 3.0.6. Il nome corretto della proprietà è:

  edgemicro:
      keep_alive_timeout

• 139526406 - È stato corretto un bug per cui si verificava un conteggio errato della quota se un'app sviluppatore aveva più prodotti. La quota viene ora applicata correttamente a ogni prodotto in un'app che contiene più prodotti. La combinazione di "appName + productName" viene utilizzata come identificatore della quota.

3.0.6

Giovedì 29 agosto abbiamo rilasciato le seguenti correzioni e miglioramenti per Edge Microgateway.

• 138633700 - Aggiunta di una nuova proprietà di configurazione, keepAliveTimeout. Questa proprietà ti consente di impostare il timeout di Edge Microgateway (in millisecondi). (Valore predefinito: 5000 millisecondi)

  Ad esempio:

  edgemicro:
    keep_alive_timeout: 600

• 140090623 - Aggiunta di una nuova proprietà di configurazione, quotaUri. Imposta questa proprietà di configurazione se vuoi gestire le quote tramite il proxy edgemicro-auth distribuito nella tua organizzazione. Se questa proprietà non è impostata, l'endpoint quota utilizza per impostazione predefinita l'endpoint Edge Microgateway interno. Ad esempio:

  edge_config:
    quotaUri: https://your_org-your_env.apigee.net/edgemicro-auth
  

  Per utilizzare questa funzionalità, devi prima eseguire il deployment dell'ultima versione del proxy edgemicro-auth nella tua organizzazione. Per maggiori dettagli, vedi Eseguire l'upgrade del proxy edgemicro-auth.

• 138722809 - Aggiunta di una nuova proprietà di configurazione, stack_trace. Questa proprietà consente di controllare se le analisi dello stack vengono visualizzate nei file di log. Ad esempio:

  stack_trace: false

  Se stack_trace è impostato su true, la traccia dello stack verrà stampata nei log. Se è impostato su false, lo stack trace non verrà stampato nei log.

3.0.5

Giovedì 15 agosto abbiamo rilasciato le seguenti correzioni e miglioramenti per Edge Microgateway.

• 139005279 - È stato risolto un problema per cui il comando edgemicro status non restituiva il numero corretto di processi di lavoro.
• 138437710 - È stato risolto un problema nella classe ExitCounter che impediva la scrittura del log corretto.

• 139064652 - Aggiunta della possibilità di aggiungere livelli di logging trace e debug per i log di eventi e di sistema. Per ora è stata aggiunta solo la funzionalità per aggiungere questi livelli di log. Al momento, i livelli di log disponibili sono info, warn e error.
• 139064616 - L'output dei log è stato standardizzato per tutte le istruzioni di log della console. Le istruzioni di logging della console ora includono questi attributi:
• Timestamp
• Nome componente
• ID processo
• Messaggio di log della console

• 138413755 - Migliora i messaggi di log relativi alla chiave e al secret JWT per questi comandi CLI: cert, verify, upgradekvm, token, genkeys, revokekeys, rotatekey e configure.

• 138413577 - Aggiungi e migliora la gestione degli errori per i timeout del servizio di backend.
• 138413303 - Aggiungere e migliorare la gestione degli errori per i timeout di risposta e socket.
• 138414116 - Aggiunta e miglioramento della gestione degli errori per gli errori "Connessione rifiutata".

3.0.4

Giovedì 1° agosto abbiamo rilasciato le seguenti correzioni e miglioramenti per Edge Microgateway.

• 134445926 - Miglioramenti all'autenticazione interna di Edge Microgateway.
• 137582169 - Risolto un problema per cui venivano avviati processi indesiderati. I processi aggiuntivi hanno causato il ricaricamento dei plug-in e l'utilizzo di memoria eccessiva. Edge Microgateway ora mantiene il numero di processi entro il limite previsto.
• 137768774 - Miglioramenti del messaggio di log:
  • Log delle transazioni (richieste) ripuliti.
  • Sono stati aggiunti altri messaggi di log, se necessario.
  • Spostati i messaggi di log delle transazioni (richieste) dall'output della console al file di log pertinente.
  • Sono stati aggiornati i log della console per utilizzare una funzione di logging centralizzata.
• 138321133, 138320563 - Modifica interna fondamentale al buffer di quota per consentire futuri miglioramenti della quota.

3.0.3

Martedì 23 luglio abbiamo rilasciato le seguenti correzioni e miglioramenti per Edge Microgateway.

• Miglioramenti della registrazione: i log di runtime esistenti utilizzano una nuova funzione eventLog() che acquisisce e registra i dati di runtime in un formato coerente. Le informazioni del log includono:
  • Timestamp (ISO 8601: AAAA-MM-GGTHH:mm:ss.sssZ).
  • Livello di log (errore, avviso o informazioni).
  • Nome host: il nome host richiedente dall'intestazione della richiesta.
  • ID processo: se esegui un cluster di processi Node.js, questo è l'ID del processo in cui si è verificata la registrazione.
  • Nome dell'organizzazione Apigee.
  • Il nome dell'ambiente nell'organizzazione.
  • Nome del proxy API.
  • Indirizzo IP client.
  • ClientId.
  • ID correlazione (non impostato al momento).
  • Nome del componente Edge Microgateway.
  • Messaggio personalizzato: alcuni oggetti potrebbero stampare informazioni aggiuntive trasmesse a questa proprietà di errore.
  • Metodo di richiesta (se richiesta HTTP).
  • Codice di stato della risposta (se richiesta HTTP).
  • Messaggio di errore.
  • Codice di errore: se un oggetto include un codice di errore, questo viene stampato in questa proprietà.
  • Tempo impiegato.
  • Sistema operativo indicatore di fine riga.

  I valori delle proprietà null generano parentesi vuote, [].

  L'esempio seguente mostra il formato del log:

  Timestamp [level][hostname][ProcessId][Org][Environment][APIProxy][ClientIp][ClientId][][component][customMessage][reqMethod][respStatusCode][errMessage][errCode][timeTaken]

  (137770055)

• Rendimento: i prodotti API non venivano filtrati in base all'ambiente. Il problema è stato risolto. (135038879)
• Integrazioni di test funzionali vari e miglioramenti della qualità del codice.

3.0.2

Mercoledì 3 luglio 2019 abbiamo rilasciato le seguenti correzioni e miglioramenti per Edge Microgateway.

Qualità del codice: il codice è stato esaminato per verificarne la qualità e sono state apportate modifiche per soddisfare gli standard di qualità richiesti dagli utenti. Abbiamo risolto gli errori e gli avvisi relativi alla qualità del codice derivanti da JSHint. Di conseguenza, sono stati identificati e corretti alcuni errori di codice effettivi. Tutti i moduli di Apigee Edge Microgateway sono stati sottoposti a questa procedura. Consulta i commit del 28 giugno e del 2 luglio per microgateway-config, microgateway-core, microgateway-plugins e microgateway. Tutti i moduli con modifiche alla qualità del codice sono stati testati con strumenti interni che verificano l'esecuzione di Edge Microgateway per i casi d'uso dei clienti.

3.0.1

Venerdì 21 giugno 2019 abbiamo rilasciato le seguenti correzioni e miglioramenti per Edge Microgateway.

• 134834551 - Modifica le versioni di Node.js supportate per Edge Microgateway
  (versioni di Node.js supportate: 8 e 12; le versioni 7, 9 e 11 sono sperimentali)
• 134751883 - Edge Microgateway si arresta in modo anomalo durante il ricaricamento sotto carico
• 134518428 - L'endpoint Products per Edge Microgateway restituisce 5XX se il pattern di filtro è errato
• 135113408 - Workers should restart if they terminate unexpectedly
• 134945852 - tokenCacheSize non viene utilizzato nel plug-in OAuth
• 134947757 - set cacheTTL in oauth plug-in
• 135445171 - gracePeriod calculation in OAuth is not correct
• Utilizza il modulo memored fornito con l'installazione di Edge Microgateway
• 135367906 - Controllo sicurezza

Versione 2.5.x

Nuove funzionalità e miglioramenti v.2.5.x

(Correzione 2.5.38, 06/07/2019)

I JWT formattati in modo errato possono causare l'arresto anomalo dei worker quando utilizzano la cache dei token. Correzione nel modulo microgateway-plugins di Edge. (b/134672029)

(Aggiunta nella versione 2.5.37) Aggiungi l'opzione CLI edgemicro-cert -t.

L'opzione edgemicro cert -t ti consente di specificare un token OAuth per autenticare le API di gestione. Vedi anche Gestire i certificati.

(Aggiunto nella versione 2.5.35) Aggiungi il supporto per il debug di Edge Microgateway utilizzando edgemicroctl.

Puoi utilizzare il flag mgdebug con edgemicroctl. Vedi anche Attività di integrazione di Kubernetes.

(Aggiunto nella versione 2.5.35) Attiva una build di Windows per edgemicroctl.

(Aggiunto 2.5.31) Nuova API edgemicro-auth/token

È stata aggiunta una nuova API edgemicro-auth/token che consente di passare il client/secret come intestazione di autorizzazione di base codificata in Base64 e grant_type come parametro del modulo. Vedi Ottenere direttamente i token di tipo Bearer.

(Correzione 2.5.31) La configurazione privata non rispetta il flag del token

È stato risolto un problema per cui la configurazione di Edge Microgateway per l'utilizzo di un token di accesso OAuth2 su Edge for Private Cloud non funzionava correttamente (il token non veniva rispettato).

Docker: supporto per l'utilizzo di certificati autofirmati

(Aggiunto il 29/05/2023) Se utilizzi un'autorità di certificazione (CA) non considerata attendibile per impostazione predefinita da Node.js, puoi utilizzare il parametro NODE_EXTRA_CA_CERTS quando esegui un container Docker con Edge Microgateway. Per maggiori dettagli, vedi Utilizzare una CA non attendibile da Node.js.

Docker: supporto di TLS

(Aggiunto 2.5.29) Edge Microgateway in esecuzione in un container Docker ora supporta TLS per le richieste in entrata al server Edge Microgateway (richieste in uscita) e per le richieste in uscita da Edge Microgateway a un'applicazione di destinazione (richieste in entrata).

Gli esempi riportati di seguito spiegano in dettaglio come configurare queste configurazioni TLS:

• Esempio di configurazione TLS in direzione nord
• Esempio di configurazione TLS in direzione sud

In questi esempi, vedrai come utilizzare il punto di montaggio del container /opt/apigee/.edgemicro per caricare i certificati, a cui viene fatto riferimento nel file di configurazione di Edge Microgateway.

Docker: supporto del proxy delle richieste

(Aggiunto 2.5.27) Se esegui Edge Microgateway in un container Docker, puoi utilizzare queste opzioni per controllare il comportamento del proxy quando il microgateway viene eseguito dietro un firewall:

• HTTP_PROXY
• HTTPS_PROXY
• NO_PROXY

Per maggiori dettagli, vedi Eseguire Edge Micro come container Docker.

Docker: istruzioni aggiornate per il plug-in

(Aggiunto 2.5.27) Se esegui Edge Microgateway in un container Docker, ora hai due opzioni per il deployment dei plug-in. Una delle opzioni, che utilizza un punto di montaggio Docker, è nuova. L'altra opzione esisteva in precedenza, è sostanzialmente invariata, ma il Dockerfile è stato aggiornato. Per i dettagli, consulta i seguenti link:

• Opzione A: monta la directory dei plug-in su un volume (novità)
• Opzione B: incorpora i plug-in nel contenitore (aggiornato)

Nuovo supporto dei token OAuth per il comando di upgrade di KVM

(Aggiunto nella versione 2.5.27) Puoi utilizzare un token OAuth con il comando upgradekvm. Per maggiori dettagli, vedi Eseguire l'upgrade di KVM.

Separazione delle API in Edge Analytics

(Aggiunto il 2.5.26) I nuovi flag del plug-in di analisi ti consentono di separare un percorso API specifico in modo che venga visualizzato come un proxy separato nei dashboard di Edge Analytics. Ad esempio, puoi separare le API di controllo di integrità per evitare di confonderle con le chiamate API effettive. Per ulteriori informazioni, vedi Esclusione dei percorsi da Analytics.

Configurazione di un proxy locale

(Aggiunto il 25/05/2022) Con un proxy locale, non è necessario creare manualmente un proxy compatibile con microgateway su Apigee Edge. Il microgateway utilizzerà invece il percorso di base del proxy locale. Per ulteriori informazioni, vedi Utilizzare la modalità proxy locale.

Utilizzo della modalità autonoma

(Aggiunto nella versione 2.5.25) Puoi eseguire Edge Microgateway completamente disconnesso da qualsiasi dipendenza di Apigee Edge. Questo scenario, chiamato modalità standalone, ti consente di eseguire e testare Edge Microgateway senza una connessione a internet. Per maggiori informazioni, consulta Esecuzione di Edge Microgateway in modalità standalone.

Revoca delle chiavi

(Aggiunta 2.5.19) È stato aggiunto un nuovo comando CLI che revoca le credenziali della chiave e del secret per una configurazione di Edge Microgateway.

edgemicro revokekeys -o [organization] -e [environment] -u [username] -k [key] -s [secret]

Supporto Docker

(Aggiunto il 2/5/19) Ora puoi scaricare l'ultima release di Edge Microgateway come immagine Docker:

docker pull gcr.io/apigee-microgateway/edgemicro:latest

Supporto di Kubernetes

(Aggiunto il 2.5.19) Puoi eseguire il deployment di Edge Microgateway come servizio o come gateway sidecar davanti ai servizi di cui è stato eseguito il deployment in un cluster Kubernetes. Vedi: Integrare Edge Microgateway con Kubernetes: panoramica.

Supporto dell'opzione TCP nodelay

(Aggiunta 2.5.16) È stata aggiunta una nuova impostazione di configurazione, nodelay, alla configurazione di Edge Micro.

Per impostazione predefinita, le connessioni TCP utilizzano l'algoritmo Nagle per memorizzare i dati nel buffer prima di inviarli. L'impostazione di nodelay su true disattiva questo comportamento (i dati vengono inviati immediatamente ogni volta che viene chiamato socket.write()). Per ulteriori dettagli, consulta anche la documentazione di Node.js.

Per attivare nodelay, modifica il file di configurazione di Edge Micro come segue:

edgemicro:
  nodelay: true
  port: 8000
  max_connections: 1000
  config_change_poll_interval: 600
  logging:
    level: error
    dir: /var/tmp
    stats_log_interval: 60
    rotate_interval: 24

Nuove opzioni della CLI per il monitoraggio continuo

(Aggiunta 2.5.12) Sono stati aggiunti nuovi parametri al comando edgemicro forever. Questi parametri ti consentono di specificare la posizione del file forever.json e di avviare o interrompere il processo in background Forever. Vedi anche Monitoraggio continuo

Esempi:

Per avviare Forever:

edgemicro forever -f ~/mydir/forever.json -a start

Per interrompere Forever:

edgemicro forever -a stop

Rotazione delle chiavi JWT

È stata aggiunta una nuova funzionalità che consente di ruotare le coppie di chiavi pubblica/privata utilizzate per generare i token JWT utilizzati per la sicurezza OAuth su Edge Microgateway. Consulta Rotazione delle chiavi JWT.

Filtro dei proxy API scaricati

Per impostazione predefinita, Edge Microgateway scarica tutti i proxy nella tua organizzazione Edge che iniziano con il prefisso di denominazione "edgemicro_". Puoi modificare questa impostazione predefinita per scaricare i proxy i cui nomi corrispondono a un pattern. Consulta Filtrare i proxy scaricati.

Specificare i prodotti senza proxy API

In Apigee Edge, puoi creare un prodotto API che non contiene proxy API. Questa configurazione del prodotto consente a una chiave API associata a quel prodotto di funzionare con qualsiasi proxy di cui è stato eseguito il deployment nella tua organizzazione. A partire dalla versione 2.5.4, Edge Microgateway supporta questa configurazione del prodotto.

Supporto per il monitoraggio continuo

Edge Microgateway ha un file forever.json che puoi configurare per controllare il numero di riavvii di Edge Microgateway e gli intervalli tra un riavvio e l'altro. Questo file configura un servizio chiamato forever-monitor, che gestisce Forever in modo programmatico. Vedi Monitoraggio continuo.

Gestione centralizzata del file di configurazione di Edge Micro

Se esegui più istanze di Edge Microgateway, potresti voler gestire le relative configurazioni da un'unica posizione. Puoi farlo specificando un endpoint HTTP da cui Edge Micro può scaricare il file di configurazione. Vedi Specifica di un endpoint del file di configurazione.

Supporto dell'opzione CLI forever

(Aggiunto nella versione 2.5.8) Utilizza il comando edgemicro forever [package.json] per specificare la posizione del file forever.json. Prima dell'aggiunta di questo comando, il file di configurazione doveva trovarsi nella directory principale di Edge Microgateway.

Ad esempio:

edgemicro forever ~/mydir/forever.json

Aggiunta dell'opzione configUrl al comando di ricarica

(Aggiunta nella versione 2.5.8) Ora puoi utilizzare l'opzione --configUrl o -u con il comando edgemicro reload.

Periodo di tolleranza per le discrepanze temporali dei JWT

(Aggiunto nella versione 2.5.7) Un attributo gracePeriod nella configurazione OAuth aiuta a prevenire errori causati da lievi discrepanze tra l'orologio di sistema e gli orari Not Before (nbf) o Issued At (iat) specificati nel token di autorizzazione JWT. Imposta questo attributo sul numero di secondi da consentire per queste discrepanze. Consulta la sezione Attributi OAuth.

(Aggiunto nella versione 2.5.7) Un attributo gracePeriod nella configurazione OAuth aiuta a prevenire errori causati da lievi discrepanze tra l'orologio di sistema e gli orari Not Before (nbf) o Issued At (iat) specificati nel token di autorizzazione JWT. Imposta questo attributo sul numero di secondi da consentire per queste discrepanze. Consulta la sezione Attributi OAuth.

Bug corretti v2.5.x

• (Problema n. 236) Correzione di un errore ortografico durante lo svuotamento della cache.
• (Problema n. 234) Ricaricamento in caso di arresto anomalo per Edge Microgateway 2.5.35.
• (Problema n. 135) Errore di riferimento host virtuale non valido "secure" quando si utilizza l'opzione -v. Questa correzione modifica il proxy edgemicro-auth prima del deployment per assicurarsi che gli host virtuali corrispondano esattamente a quanto specificato nel flag "-v". Inoltre, puoi specificare un numero qualsiasi e un nome qualsiasi per l'host virtuale (non più limitato a predefinito e sicuro).
• (Problema n. 141) Il comando edgemicro reload non supporta l'opzione del file di configurazione -c. Il problema è stato risolto.
• (Problema n. 142) Edge Microgateway segnala la crittografia ritirata al momento dell'installazione. Il problema è stato risolto.
• (Problema n. 145) La quota non funziona con Edge Microgateway. Il problema è stato risolto.
• (Problema della community Apigee: https://community.apigee.com/questions/33149/emg-jwt-token-validated-against-both-api-proxies-a.html#answer-33336) Token JWT convalidato rispetto sia ai proxy API sia all'URI risorsa in OAUTH. Il problema è stato risolto.
• (Problema della community Apigee: https://community.apigee.com/questions/47846/microgateway-not-working-with-oauth.html) Microgateway non funziona con OAuth. Il problema è stato risolto.
• Correzione di pidPath su Windows.
• (Problema n. 157) È stato risolto il problema che causava il seguente messaggio di errore: ReferenceError: deployProxyWithPassword non è definito.
• (Problema n. 169) Aggiorna le dipendenze di Node.js (npm audit)
• Il proxy edgemicro-auth ora utilizza i criteri JWT di Edge. Il proxy non dipende più da Node.js per fornire il supporto JWT.

Versione 2.4.x

Nuove funzionalità e miglioramenti v.2.4.x

1. Imposta un alias personalizzato per il proxy edgemicro-auth (PR 116)

Puoi modificare il basepath predefinito per il proxy edgemicro-auth. Per impostazione predefinita, il percorso di base è /edgemicro-auth. Per modificarlo, utilizza il flag -x nel comando edgemicro configure.

Esempio:

edgemicro configure -x /mypath …

2. Supporto dei caratteri jolly per i percorsi di base (PR 77)

Puoi utilizzare uno o più caratteri jolly "*" nel percorso di base di un proxy edgemicro_*. Ad esempio, un percorso di base /team/*/members consente ai client di chiamare https://[host]/team/blue/members e https://[host]/team/green/members senza che tu debba creare nuovi proxy API per supportare nuovi team. Tieni presente che /**/ non è supportato.

3. Percorso di configurazione personalizzato aggiunto alla CLI per la configurazione di Private Cloud (PR 99)

Per impostazione predefinita, il file di configurazione di microgateway si trova in ./config/config.yaml. Nei comandi init, configure e start, ora puoi specificare un percorso di configurazione personalizzato nella riga di comando utilizzando i flag -c o --configDir. Risolto un problema per cui una directory di configurazione personalizzata per le installazioni di cloud privato non veniva riconosciuta.

Esempio:

edgemicro start -o docs -e test -k abc123 -s xyz456 -c /home/microgateway/config

4. Rispetta le variabili *_PROXY (PR 61)

Se Edge Microgateway è installato dietro un firewall e non è in grado di comunicare con Apigee Edge nel cloud pubblico, ci sono due opzioni da considerare:

Opzione 1:

La prima opzione è impostare l'opzione edgemicro: proxy_tunnel su true nel file di configurazione di microgateway:

edge_config:
   proxy: http://10.224.16.85:3128
   proxy_tunnel: true

Quando proxy_tunnel è true, Edge Microgateway utilizza il metodo HTTP CONNECT per creare un tunnel per le richieste HTTP su una singola connessione TCP. Lo stesso vale se le variabili di ambiente per la configurazione del proxy sono abilitate per TLS.

Opzione 2:

La seconda opzione è specificare un proxy e impostare proxy_tunnel su false nel file di configurazione di microgateway. Ad esempio:

edge_config:
   proxy: http://10.224.16.85:3128
   proxy_tunnel: false

In questo caso, puoi impostare le seguenti variabili per controllare gli host per ogni proxy HTTP che vuoi utilizzare o quali host non devono gestire i proxy Edge Microgateway: HTTP_PROXY, HTTPS_PROXY e NO_PROXY. Puoi impostare NO_PROXY come elenco delimitato da virgole di domini per i quali Edge Microgateway non deve fungere da proxy. Ad esempio:

export HTTP_PROXY='http://localhost:3786'
export HTTPS_PROXY='https://localhost:3786'

Per ulteriori informazioni su queste variabili, consulta:

https://www.npmjs.com/package/request#controlling-proxy-behaviour-using-environment-variables

5. Imposta un timeout personalizzato per le richieste di target (PR 57)

Puoi impostare un timeout personalizzato per le richieste di target con questa configurazione:

edgemicro:
    request_timeout: 10

Il timeout è impostato in secondi. Se si verifica un timeout, Edge Microgateway risponde con un codice di stato 504.

6. Rispetta i messaggi di stato HTTP personalizzati nella risposta di destinazione (PR 53)

Edge Microgateway rispetta i messaggi di stato HTTP personalizzati impostati nella risposta di destinazione. Nelle versioni precedenti, i messaggi di stato inviati dalla destinazione venivano sostituiti con i valori predefiniti di Node.js.

7. L'intestazione X-Forwarded-For può impostare client_ip per analytics

Se presente, l'intestazione X-Forwarded-For imposterà la variabile client_ip riportata in Edge Analytics. Questa funzionalità ti consente di conoscere l'IP del client che ha inviato una richiesta a Edge Microgateway.

8. Modifiche al plug-in OAuth

Il plug-in OAuth supporta la verifica della chiave API e del token di accesso OAuth. Prima di questa modifica, il plug-in accettava entrambe le forme di sicurezza. Con questa modifica, puoi consentire solo uno di questi modelli di sicurezza (mantenendo la compatibilità con le versioni precedenti).

I plug-in OAuth aggiungono due nuovi flag:

• allowOAuthOnly: se impostato su true, ogni API deve includere un'intestazione Authorization con un token di accesso Bearer.

• allowAPIKeyOnly: se impostato su true, ogni API deve includere un'intestazione x-api-key (o una posizione personalizzata) con una chiave API.

Imposta questi flag nel file di configurazione di Edge Microgateway nel seguente modo:

oauth:
    allowNoAuthorization: false
    allowInvalidAuthorization: false
    keep-authorization-header: false
    allowOAuthOnly: false
    allowAPIKeyOnly: false

9. Miglioramento del proxy edgemicro-auth (PR 40)

Sono stati apportati miglioramenti al proxy edgemicro-auth. Prima di queste modifiche, il proxy memorizzava le chiavi in Edge Secure Store, un vault criptato. Ora il proxy memorizza le chiavi nella mappa chiave-valore (KVM) criptata di Edge.

10. Riscrittura dell'URL di destinazione predefinito in un plug-in (PR 74)

Puoi anche eseguire l'override della porta dell'endpoint di destinazione e scegliere tra HTTP e HTTPS. Modifica queste variabili nel codice del plug-in: req.targetPort e req.targetSecure. Per scegliere HTTPS, imposta req.targetSecure su true; per HTTP, impostalo su false. Se imposti req.targetSecure su true, consulta questo thread di discussione per ulteriori informazioni.

11. Supporto iniziale per l'autenticazione con token OAuth (PR 125)

Puoi configurare Edge Microgateway in modo che utilizzi un token OAuth per l'autenticazione anziché nome utente/password. Per utilizzare un token OAuth, utilizza il seguente parametro nel comando edgemicro configure:

-t, --token <token>

Ad esempio:

edgemicro configure -o docs -e test -t <your token>

Bug corretti v2.4.3

• Risolto un problema per cui era necessaria un'organizzazione a pagamento per eseguire correttamente il proxy edgemicro-auth. Ora puoi utilizzare Edge Microgateway anche con le organizzazioni di prova. (PR 5)
• Risolto un problema per cui lo stream non aveva terminato l'elaborazione dei dati, ma i gestori di fine venivano comunque eseguiti. Ciò ha causato l'invio di una risposta parziale. (PR 71)
• Risolto un problema per cui una directory di configurazione personalizzata per le installazioni di Private Cloud non veniva riconosciuta. (PR 110)
• Risolto un problema con SSL bidirezionale tra il client e Edge Microgateway. (PR 70)
• È stato risolto un problema a causa del quale era necessaria una barra finale nel percorso di base del proxy per il corretto funzionamento della verifica della chiave API. Ora, non è necessaria una barra finale alla fine del percorso di base. (PR 48)

Versione 2.3.5

Nuove funzionalità e miglioramenti v.2.3.5

Filtro proxy

Puoi filtrare i proxy compatibili con microgateway che un'istanza di Edge Microgateway elaborerà. Quando Edge Microgateway viene avviato, scarica tutti i proxy compatibili con il microgateway nell'organizzazione a cui è associato. Utilizza la seguente configurazione per limitare i proxy che microgateway elaborerà. Ad esempio, questa configurazione limita a tre i proxy che il microgateway elaborerà: edgemicro_proxy-1, edgemicro_proxy-2 e edgemicro_proxy-3:

proxies:
  - edgemicro_proxy-1
  - edgemicro_proxy-2
  - edgemicro_proxy-3

Mascheramento dei dati di Analytics

Una nuova configurazione consente di impedire la visualizzazione delle informazioni sul percorso della richiesta in Edge Analytics. Aggiungi quanto segue alla configurazione di microgateway per mascherare l'URI della richiesta e/o il percorso della richiesta. Tieni presente che l'URI è composto dalle parti del nome host e del percorso della richiesta.

analytics:
  mask_request_uri: 'string_to_mask'
  mask_request_path: 'string_to_mask'

Versione 2.3.3

Nuove funzionalità e miglioramenti v.2.3.3

Di seguito sono riportate le nuove funzionalità e i miglioramenti di questa release.

Disattivare il polling automatico delle modifiche

Puoi disattivare il polling automatico delle modifiche impostando questo attributo nella configurazione del microgateway:

disabled_config_poll_interval: true

Per impostazione predefinita, il polling periodico rileva le modifiche apportate a Edge (modifiche a prodotti, proxy compatibili con microgateway e così via), nonché le modifiche apportate al file di configurazione locale. L'intervallo di polling predefinito è 600 secondi (5 minuti).

Riscrittura degli URL di destinazione nei plug-in

Puoi sostituire dinamicamente l'URL di destinazione predefinito in un plug-in modificando queste variabili nel codice del plug-in: req.targetHostname e req.targetPath.

Nuova firma della funzione del plug-in

È stata aggiunta una nuova firma della funzione del plug-in che fornisce la risposta di destinazione come argomento. Questa aggiunta semplifica l'accesso dei plug-in alla risposta di destinazione.

function(sourceRequest, sourceResponse, targetResponse, data, cb)

Output di logging predefinito semplificato

Per impostazione predefinita, il servizio di logging ora omette il JSON dei proxy, dei prodotti e dei JWT scaricati. Puoi impostare l'output predefinito di questi oggetti impostando DEBUG=* all'avvio di Edge Microgateway. Ad esempio:

DEBUG=* edgemicro start -o docs -e test -k abc123 -s xyz456

Percorso di configurazione personalizzato aggiunto alla CLI

Per impostazione predefinita, il file di configurazione di microgateway si trova in ./config/config.yaml. Nei comandi init, configure e start, ora puoi specificare un percorso di configurazione personalizzato nella riga di comando. Ad esempio:

edgemicro start -o docs -e test -k abc123 -s xyz456 -c /home/microgateway/config

Bug corretti v2.3.3

• È stata corretta una perdita di memoria che si verificava durante richieste/risposte di grandi dimensioni.
• L'ordine di esecuzione dei plug-in è stato corretto. Ora si comporta come descritto nella documentazione.
• Il plug-in accumulate-request non si blocca più per le richieste GET.
• È stato risolto un problema nel plug-in accumulate-response per cui la mancanza di un corpo della risposta causava errori.

Release 2.3.1

Nota sull'installazione

Alcune versioni precedenti di Edge Microgateway consentono di installare il software scaricando un file ZIP. Questi file ZIP non sono più supportati. Per installare Edge Microgateway, devi utilizzare:

npm install -g edgemicro

Per ulteriori dettagli, consulta l'argomento sull'installazione.

Nuove funzionalità e miglioramenti v.2.3.1

Di seguito sono riportate le nuove funzionalità e i miglioramenti di questa release.

Filtrare i proxy

Una nuova configurazione consente di filtrare i proxy che Edge Microgateway caricherà all'avvio. In precedenza, il microgateway caricava tutti i proxy compatibili con il microgateway (proxy denominati edgemicro_*) estratti dall'organizzazione/ambiente Edge specificato nel comando edgemicro configure. Questa nuova funzionalità ti consente di filtrare questo elenco di proxy in modo che Edge Microgateway carichi solo quelli che specifichi. Basta aggiungere l'elemento proxy al file di configurazione di microgateway come segue:

edge micro:
proxies:
    - edgemicro_[name]
    - edgemicro_[name]
    ...

Ad esempio, supponiamo che tu abbia 50 proxy edgemicro_* nella tua organizzazione/nel tuo ambiente Edge, inclusi quelli denominati edgemicro_foo e edgemicro_bar. Puoi indicare al microgateway di utilizzare solo questi due proxy nel seguente modo:

edge micro:
proxies:
    - edgemicro_foo
    - edgemicro_bar

All'avvio, il microgateway potrà chiamare solo i proxy specificati. Qualsiasi tentativo di chiamare altri proxy compatibili con microgateway scaricati dall'organizzazione/dall'ambiente Edge comporterà un errore.

Impostare le intestazioni delle richieste di destinazione nei plug-in

Esistono due pattern di base da considerare se vuoi aggiungere o modificare le intestazioni delle richieste di destinazione: uno in cui la richiesta in entrata contiene dati (come in una richiesta POST) e uno in cui non li contiene (come in una semplice richiesta GET).

Consideriamo un caso in cui la richiesta in entrata contiene dati e vuoi impostare le intestazioni della richiesta nella richiesta di destinazione. Nelle versioni precedenti di Edge Microgateway, non era possibile impostare in modo affidabile le intestazioni di destinazione in questo caso.

La chiave di questo pattern è accumulare prima tutti i dati in entrata dal cliente. Poi, nella funzione onend_request(), utilizza la nuova funzione request.setOverrideHeader(name, value) per personalizzare le intestazioni.

Ecco un codice plug-in di esempio che mostra come farlo. Le intestazioni impostate in onend_request vengono inviate alla destinazione:

module.exports.init = function(config, logger, stats) {


  function accumulate(req, data) {
    if (!req._chunks) req._chunks = [];
    req._chunks.push(data);
  }

  return {

    ondata_request: function(req, res, data, next) {
      if (data && data.length > 0) accumulate(req, data);
      next(null, null);
    },

    onend_request: function(req, res, data, next) {
      if (data && data.length > 0) accumulate(req, data);
      var content = Buffer.concat(req._chunks);
      delete req._chunks;
      req.setOverrideHeader('foo', 'bar');
      req.setOverrideHeader('content-length', content.length);
      next(null, content);
    },


    onerror_request: function(req, res, data, next) {
      next(null, null);
    }

  };

}

Se la richiesta non include dati, puoi impostare le intestazioni di destinazione nel gestore onrequest(). Questo pattern non è nuovo: è stato documentato in precedenza ed è stato utilizzato nei plug-in di esempio forniti con Edge Microgateway.

onrequest: function(req, res, next) {
      debug('plugin onrequest');
      req.headers['x-foo-request-id'] = "bar";
      req.headers['x-foo-request-start'] = Date.now();
      next();
    }

Funzionalità di ricaricamento senza tempi di inattività

Dopo aver apportato una modifica alla configurazione di Edge Microgateway, puoi caricare la configurazione senza eliminare alcun messaggio. Con questa modifica, Edge Microgateway viene sempre avviato in modalità cluster e l'opzione --cluster è stata rimossa dal comando edgemicro start.

Inoltre, sono stati aggiunti tre nuovi comandi CLI. Devi eseguire questi comandi dalla stessa directory in cui è stato eseguito il comando di avvio di edgemicro:

• edgemicro status - Controlla se Edge Microgateway è in esecuzione o meno.
• edgemicro stop - Arresta il cluster Edge Microgateway.
• edgemicro reload: ricarica la configurazione di Edge Microgateway senza tempi di inattività.

Ricarica automatica della configurazione senza tempi di inattività

Edge Microgateway carica periodicamente una nuova configurazione ed esegue un ricaricamento se qualcosa è cambiato. Il polling rileva le modifiche apportate a Edge (modifiche a prodotti, proxy compatibili con microgateway e così via), nonché le modifiche apportate al file di configurazione locale. L'intervallo di polling predefinito è 600 secondi (5 minuti). Puoi modificare il valore predefinito nel file di configurazione del microgateway come segue:

edgemicro:
    config_change_poll_interval: [seconds]

Aggiunte informazioni sulla versione alla CLI

È stato aggiunto un flag --version alla CLI. Per ottenere la versione attuale di Edge Microgateway, utilizza:

edgemicro --version

Nuove opzioni SSL del server Edge Microgateway

Edge Microgateway ora supporta le seguenti opzioni SSL del server oltre a key e cert:

Inviare i file di log a stdout

Puoi inviare i dati di log all'output standard con una nuova impostazione di configurazione:

edgemicro:
  logging:
    to_console: true  

Vedi Gestione dei file di log.

Versione 2.1.2

Di seguito sono riportate le nuove funzionalità e i miglioramenti di questa release.

Consenti endpoint API personalizzato per la configurazione

Sono disponibili nuovi endpoint configurabili per il proxy di autorizzazione che supportano l'utilizzo di un servizio di autenticazione personalizzato. Questi endpoint sono:

• edgeconfig:verify_api_key_url
• edgeconfig:products

Per maggiori dettagli, vedi Utilizzo di un servizio di autenticazione personalizzato.

Versione 2.1.1

Di seguito sono riportate le nuove funzionalità e i miglioramenti di questa release.

Esegui il deployment del proxy di autenticazione compatibile con più piattaforme

È stato apportato un miglioramento in modo che il comando utilizzato per il deployment del proxy di autorizzazione Edge Microgateway su Edge sia compatibile con i sistemi Windows.

Versione 2.1.0

Nuove funzionalità e miglioramenti v.21.0

Di seguito sono riportate le nuove funzionalità e i miglioramenti:

Specifica le opzioni SSL/TLS del client

Puoi specificare le opzioni client per le connessioni SSL/TSL alle destinazioni utilizzando un nuovo insieme di opzioni di configurazione. Consulta Utilizzo delle opzioni SSL/TLS client.

Versione 2.0.11

Nota di installazione v2.0.11

Alcune versioni precedenti di Edge Microgateway consentono di installare il software scaricando un file ZIP. Questi file ZIP non sono più supportati. Per installare Edge Microgateway, devi utilizzare:

npm install -g edgemicro

Per ulteriori dettagli, consulta l'argomento sull'installazione.

Nuove funzionalità e miglioramenti v.2.0.11

Di seguito sono riportate le nuove funzionalità e i miglioramenti:

Specificare una porta all'avvio

Il comando start consente di specificare un numero di porta per ignorare la porta specificata nel file di configurazione. Puoi anche specificare un numero di porta utilizzando la variabile di ambiente PORT. Per maggiori dettagli, vedi il comando start.

(Facoltativo) Conservare le intestazioni di autenticazione

Una nuova impostazione di configurazione, keepAuthHeader, consente di conservare l'intestazione Authorization inviata nella richiesta. Se è impostato su true, l'intestazione Auth viene passata alla destinazione. Vedi gli attributi OAuth.

Possibilità di utilizzare un servizio di autorizzazione personalizzato

Se vuoi utilizzare il tuo servizio personalizzato per gestire l'autenticazione, modifica il valore di authUri nel file di configurazione di Edge Microgateway in modo che punti al tuo servizio. Per maggiori dettagli, vedi Utilizzo di un servizio di autenticazione personalizzato.

Versione 2.0.4

Edge Microgateway v.2.0.4 è stato rilasciato il 25 maggio 2016.

Nuove funzionalità e miglioramenti v2.0.4

Di seguito sono riportate le nuove funzionalità e i miglioramenti di questa release.

Supporto dei percorsi delle risorse nei prodotti

Edge Microgateway ora supporta i percorsi delle risorse nei prodotti. I percorsi delle risorse ti consentono di limitare l'accesso alle API in base al suffisso del percorso del proxy. Per informazioni dettagliate sulla creazione di prodotti e sulla configurazione dei percorsi delle risorse, vedi Creare prodotti API.

Supporto per l'installazione globale di npm

Ora puoi installare Edge Microgateway utilizzando l'opzione npm -g (globale). Per informazioni dettagliate su questa opzione, consulta la documentazione di npm.

Versione 2.0.0

Edge Microgateway v2.0.0 è stato rilasciato il 18 aprile 2016.

Nuove funzionalità e miglioramenti v.2.0.0

Di seguito sono riportate le nuove funzionalità e i miglioramenti di questa release.

Server di elaborazione singolo

Edge Microgateway ora è un server a processo singolo. Non utilizza più un modello a due processi in cui un processo (precedentemente noto come "agente") avvia Edge Microgateway, il secondo processo. La nuova architettura semplifica l'automazione e la containerizzazione.

File di configurazione con spazio dei nomi

I file di configurazione ora sono spazi dei nomi che utilizzano l'organizzazione e l'ambiente in modo che più istanze di Microgateway possano essere eseguite sullo stesso host. Puoi trovare i file di configurazione in ~/.edgemicro dopo aver eseguito il comando di configurazione di Edge Microgateway.

Nuove variabili di ambiente

Ora sono disponibili quattro variabili di ambiente: EDGEMICRO_ORG, EDGEMICRO_ENV, EDGEMICRO_KEY, EDGEMICRO_SECRET. Se imposti queste variabili sul tuo sistema, non devi specificarne i valori quando utilizzi l'interfaccia a riga di comando (CLI) per configurare e avviare Edge Microgateway.

Configurazione memorizzata nella cache

Edge Microgateway utilizza un file di configurazione memorizzato nella cache se viene riavviato senza connessione ad Apigee Edge.

Modalità cluster

Ora sono disponibili opzioni per avviare Edge Microgateway in modalità cluster. La modalità cluster consente di sfruttare i sistemi multi-core. Il microgateway utilizza il modulo cluster Node.js per questa funzionalità. Per maggiori dettagli, consulta la documentazione di Node.js.

Bug corretti v2.0.0

Il ciclo di vita degli eventi del plug-in ora gestisce correttamente il codice asincrono che contiene codice con una nuova callback.

Versione 1.1.2

Edge Microgateway v. 1.1.2 è stato rilasciato il 14 marzo 2016.

Nuove funzionalità e miglioramenti v.1.1.2

Di seguito sono riportate le nuove funzionalità e i miglioramenti di questa release.

Miglioramento delle prestazioni

Edge Microgateway ora utilizza correttamente l'agente HTTP Node.js per un migliore pool di connessioni. Questo miglioramento aumenta le prestazioni e la stabilità complessiva in condizioni di carico elevato.

Supporto del debugger remoto

Puoi configurare Edge Microgateway per l'esecuzione con un debugger remoto, come node-inspector.

Nuova posizione del file di configurazione

Quando configuri Edge Microgateway, il file agent/config/default.yaml viene ora copiato in ~./edgemicro/config.yaml.

Rotazione dei file di log

Un nuovo attributo di configurazione consente di specificare un intervallo di rotazione per i log di Edge Microgateway.

Bug corretti v1.1.2

I seguenti bug sono stati corretti nella versione 1.1.2.