Domande frequenti sul microgateway perimetrale

Stai visualizzando la documentazione di Apigee Edge.
Vai alla documentazione di Apigee X. informazioni

Come iniziare

Come si installa Edge Microgateway?

Vedi Installazione di Edge Microgateway.

Come faccio a eseguire Edge Microgateway?

Vedi Configurare e configurare Edge Microgateway.

Ho bisogno di un database per eseguire il microgateway?

Le API trasferite al proxy tramite Edge Microgateway possono interagire con un database in esecuzione come parte di un servizio di destinazione. Tuttavia, Edge Microgateway opera indipendentemente da qualsiasi database o datastore di backend.

Operazione

Quali modifiche su Edge richiedono il riavvio di Edge Microgateway?

Edge Microgateway esegue automaticamente il polling delle modifiche apportate su Apigee Edge, ad esempio le modifiche a proxy, prodotti o app per sviluppatori che supportano il microgateway. L'intervallo di polling predefinito è di 600 secondi, ma puoi modificarlo con l'impostazione di configurazione config_change_poll_interval. Vedi gli attributi edgemicro.

Se non vuoi attendere l'intervallo di polling, utilizza il comando edgemicro reload per applicare le modifiche più recenti. Consulta la pagina Ricaricare il cluster del microgateway.

Come posso distinguere un proxy di cui è stato eseguito il deployment su Edge da un proxy su Edge Microgateway?

Quando configuri Edge Microgateway, viene scaricato nella configurazione locale di Edge Microgateway un elenco di proxy compatibili con il gateway di cui è stato eseguito il deployment su Apigee Edge. I proxy sensibili al microgateway sono quelli denominati con il prefisso edgemicro_.

Quali sono le opzioni a mia disposizione per il logging con Edge Microgateway?

Edge Microgateway ha una funzionalità di logging integrata. Per maggiori dettagli, vedi Gestione dei file di log.

Puoi anche scrivere un plug-in personalizzato per utilizzare un servizio di logging di terze parti con Edge Microgateway. A causa del modo in cui funziona Edge Microgateway, non puoi utilizzare il criterio di logging dei messaggi di Apigee Edge per registrare i messaggi per Edge Microgateway. Consulta anche l'articolo della community sul plug-in di Logging per Microgateway.

Posso riutilizzare le combinazioni chiave/segreto tra le istanze di Edge Microgateway?

Finché l'organizzazione e l'ambiente sono gli stessi per le istanze Microgateway, puoi riutilizzare la coppia chiave/segreta generata durante la configurazione.

Come faccio a configurare Edge Microgateway per l'avvio in un ambiente di produzione?

Puoi impostare le variabili di ambiente per i parametri del comando di avvio, ad esempio EDGEMICRO_KEY, EDGEMICRO_SECRET, EDGEMICRO_ORG e EDGEMICRO_ENV. Con queste (e altre) variabili puoi avviare Edge Microgateway con il singolo comando edgemicro start. Vedi anche Impostare le variabili di ambiente.

Posso utilizzare attributi di app per sviluppatori o prodotti personalizzati con Edge Microgateway?

No. Per impostazione predefinita, Edge Microgateway agisce solo sugli attributi relativi al routing di base e alla sicurezza. Tuttavia, per le soluzioni alternative hai a disposizione la seguente opzione:

1. Aggiungi attributi personalizzati al proxy edgemicro-auth di cui Edge Microgateway esegue il deployment su Apigee Edge. Questi attributi saranno disponibili quando utilizzi la sicurezza della chiave API o del token OAuth.
2. Modificare il plug-in OAuth in modo che agisca su questi attributi.

Esiste un limite alle dimensioni dell'intestazione della richiesta?

Se esegui l'upgrade di Node.js alla v8.14.0 o a una versione successiva, tieni presente che la dimensione massima dell'intestazione consentita per le richieste è stata ridotta da 80 kB a 8 kB. Le intestazioni che superano gli 8 kB generano un errore HTTP 431.

Un'opzione di configurazione Node.js aggiunta in Node.js v11.6.0 consente di modificare la dimensione massima predefinita dell'intestazione. Questo parametro, --max-http-header-size, consente di specificare la dimensione massima, in byte, delle intestazioni HTTP.

Per modificare la configurazione predefinita, imposta il valore della variabile di ambiente NODE_OPTIONS nella riga di comando come segue:

NODE_OPTIONS=--max-http-header-size=NUM_BYTES

Ad esempio:

NODE_OPTIONS=--max-http-header-size=80000

Quali API di gestione utilizza Edge Microgateway?

Deployment

Posso eseguire il deployment di Edge Microgateway sullo stesso server su cui è in esecuzione il mio servizio di destinazione?

Sì. Edge Microgateway è un processo leggero che può essere eseguito vicino al servizio di destinazione, anche sulla stessa macchina.

Posso eseguire il deployment di un bundle proxy perimetrale esistente come deployment Edge Microgateway?

No. I proxy compatibili con Edge Microgateway hanno requisiti specifici e non supportano tutte le funzionalità dei normali proxy Edge. Vedi Parte 2: creare entità su Apigee Edge

Posso abilitare il failover tra il deployment di un bundle proxy perimetrale e il deployment di Edge Microgateway per lo stesso proxy API?

No. Edge Microgateway non è a conoscenza dei deployment di proxy API non microgateway su Apigee Edge.

Qual è il modello di deployment ad alta disponibilità per Edge Microgateway?

Per una discussione su come eseguire Edge Microgateway utilizzando NGINX come bilanciatore del carico, vedi Gestione delle API con Apigee Edge Microgateway e NGINX.

Quali bilanciatori del carico posso utilizzare con Edge Microgateway?

Edge Microgateway può funzionare con qualsiasi bilanciatore del carico.

Esiste un limite al numero di proxy Edge Microgateway di cui posso eseguire il deployment?

Fai riferimento ai limiti di configurazione del prodotto specificati per i normali proxy Edge. Il numero di proxy sensibili al microgateway di cui puoi eseguire il deployment in un'organizzazione e in un ambiente Apigee Edge e che puoi chiamare tramite Edge Microgateway deve rispettare gli stessi limiti.

Posso associare il mio deployment Edge Microgateway a un'organizzazione e a un ambiente specifici?

Quando configuri un'istanza di Edge Microgateway, devi associarla a un'organizzazione e un ambiente Edge specifici.

Posso associare il mio deployment Edge Microgateway a una regione specifica (se sono un cliente che include più regioni)?

Edge Microgateway sceglie automaticamente la regione migliore per la sua interazione con Apigee Edge. Puoi eseguire il deployment delle istanze Edge Microgateway in ogni regione che vuoi gestire.

Amministrazione

Devo essere un amministratore dell'organizzazione per configurare ed eseguire il deployment di Edge Microgateway?

Sì. Per configurare ed eseguire il deployment di Edge Microgateway, devi disporre delle credenziali di amministratore dell'organizzazione.

Devo essere un amministratore dell'organizzazione per eseguire Edge Microgateway?

No. Edge Microgateway è un'applicazione Node.js e può essere eseguita da chiunque abbia l'autorizzazione a eseguire queste applicazioni su una determinata macchina.

Qualcuno degli utenti della mia organizzazione può utilizzare Edge Microgateway?

Non è necessario essere un utente dell'organizzazione Apigee Edge per effettuare chiamate API tramite Edge Microgateway. Tuttavia, devi disporre delle autorizzazioni a livello di organizzazione per creare o modificare i proxy sensibili a Edge Microgateway di cui viene eseguito il deployment su Edge.

Esibizione

Quali sono le considerazioni sulle prestazioni da prendere in considerazione per l'utilizzo di Edge Microgateway?

Se esegui Edge Microgateway posizionato con l'applicazione di destinazione, assicurati che il server abbia capacità sufficiente.

Quali sono le best practice per l'esecuzione di Edge Microgateway su larga scala?

Apigee consiglia di eseguire più istanze di Edge Microgateway su server diversi con bilanciatori del carico come NGINX. Vedi anche Gestione delle API con Apigee Edge Microgateway e NGINX e Scalabilità orizzontale verticale nella community Apigee.

Cosa sono i TPS Edge Microgateway per impostazione predefinita e quali sono i requisiti hardware richiesti per un'istanza di microgateway

I requisiti hardware e le misurazioni del TPS sono difficili da misurare con Edge Microgateway. Dipende dalla configurazione, ovvero dalla combinazione tra ottimizzazione di Edge Microgateway, utilizzo dei plug-in, plug-in personalizzati e configurazione di altri elementi come TLS. In genere Apigee consiglia di farsi un'idea di quella combinazione di elementi ed eseguire test delle prestazioni con la configurazione specifica.

Deployment nel cloud privato

Edge Microgateway funziona con Edge per il cloud privato?

Sì. Per maggiori dettagli, consulta i passaggi di configurazione di Apigee Private Cloud.

Plug-in

Come viene applicata la quota con Edge Microgateway?

Facoltativamente, puoi aggiungere un plug-in per la quota alla tua istanza di Edge Microgateway. Per i dettagli, consulta l'articolo sull'utilizzo del plug-in per la quota.

Come viene applicato Spike Arrest con Edge Microgateway?

Facoltativamente, puoi aggiungere un plug-in per l'arresto dei picchi di traffico alla tua istanza di Edge Microgateway. Per maggiori dettagli, consulta l'articolo sull'utilizzo del plug-in per l'arresto dei picchi.

Esistono altri modi per scrivere plug-in diversi da Node.js per Edge Microgateway?

No. I plug-in devono essere scritti in Node.js.

Cosa succede quando Edge Microgateway non riesce a caricare i dati di analisi su Edge?

Edge Microgateway ha un buffer in memoria. Se il buffer si riempie, i payload meno recenti vengono eliminati per consentire il flusso del traffico API senza problemi.

Posso aggiungere criteri a Edge Microgateway?

Se colleghi criteri di Apigee Edge regolari a proxy con conoscenza del microgateway in Apigee Edge, questi verranno ignorati. Edge Microgateway utilizza invece plug-in per fornire funzionalità simili ai criteri di Edge, come quota, arresto dei picchi di traffico, sicurezza delle chiavi API e sicurezza OAuth2. Puoi anche scrivere plug-in personalizzati. Consulta gli articoli Utilizzare i plug-in e Sviluppare plug-in personalizzati.

I seguenti post e blog della community di Apigee parlano di casi d'uso aggiuntivi relativi ai plug-in:

• Come eseguire l'override dell'URL predefinito su Edge Microgateway
• Come far funzionare la quota in Edge Microgateway
• Aggiunta di un plug-in logger a Edge Microgateway

Sicurezza

Come faccio a proteggere la risorsa /products?

Panoramica

Quando configuri Edge Microgateway, viene eseguito il deployment di un proxy API denominato edgemicro-auth in your Organization:environment su Apigee Edge. Questo proxy espone un endpoint /products che restituisce un elenco di prodotti API. Se hai installato Edge Microgateway il o prima del 5 ottobre 2018, Apigee consiglia di adottare misure per proteggere questo endpoint, poiché la risposta contiene l'indirizzo email dello sviluppatore che ha creato e modificato i prodotti API nella tua organizzazione Apigee.

Puoi proteggere l'endpoint eseguendo l'upgrade di Edge Microgateway o configurando TLS Mutual. Entrambe queste opzioni sono descritte di seguito.

Controlla se l'endpoint /products è protetto

Se non hai la certezza che l'endpoint /products sia protetto, vai alla sezione Verifica che la risorsa /products sia protetta e segui i passaggi indicati prima di continuare.

Opzione 1: esegui l'upgrade del microgateway Edge

Se hai installato Edge Microgateway il 5 ottobre 2018 incluso, Apigee ti consiglia di eseguire l'upgrade alla versione più recente di Edge Microgateway. Segui i passaggi descritti in Eseguire l'upgrade di Edge Microgateway se disponi di una connessione a internet.

Se al momento non puoi eseguire l'upgrade, vai all'opzione 2.

Opzione 2: configura TLS reciproca

Se al momento non riesci a eseguire l'upgrade di Edge Microgateway, Apigee consiglia di proteggere la comunicazione tra Edge Microgateway e il proxy edgemicro-auth con TLS reciproco (noto anche come TLS a due vie).

1. Apri il file $HOME/.edgemicro/org-env-config.yaml. Se non riesci a trovare questo file, vedi Dove è installato Edge Microgateway.
2. Aggiungi il seguente blocco tlsOptions al file org-env-config.yaml per abilitare TLS reciproca tra Edge Microgateway e Apigee Edge:

   edge_config:
     bootstrap: >-
       https://domain/edgemicro/bootstrap/organization/org/environment/env
     jwt_public_key: 'https://domain/edgemicro-auth/publicKey'
     managementUri: 'https://api.enterprise.apigee.com'
     tlsOptions:
       agentOptions:
         requestCert: true
         cert: 'path/to/cert'
         key: 'path/to/key'
   

   Ad esempio:

   tlsOptions:
     agentOptions:
       requestCert: true
       cert: '/Users/jdoe/twowayssl/ssl/client.key'
       key: '/Users/jdoe/twowayssl/ssl/ca.crt'

   Puoi anche includere i seguenti parametri agentOptions facoltativi:

   • ca: specifica il percorso dell'autorità di certificazione.
   • pfx: includilo se vuoi utilizzare un file p12/pfx anziché cert e key.
   • passphrase: la passphrase di un file pfx.
   • ciphers: specifica le crittografie TLS.
3. Assicurati che per l'host virtuale su cui viene eseguito il deployment del proxy edgemicro-auth sia abilitato TLS reciproca. Per maggiori dettagli, consulta Definizione di un host virtuale per TLS a due vie nella documentazione di Apigee Edge.

   Il seguente screenshot mostra come abilitare TLS reciproca su un host virtuale nella UI di Apigee Edge:

   
4. Controlla il proxy API edgemicro-auth nella UI perimetrale e assicurati che sia specificato l'host virtuale corretto nella configurazione del proxy. Ad esempio, se hai creato un host virtuale abilitato per TLS chiamato mutualtls, la stanza HTTPProxyConnection del proxy dovrebbe avere il seguente aspetto:

   <HTTPProxyConnection>
       <BasePath>/edgemicro-auth</BasePath>
       <Properties/>
       <VirtualHost>mutualtls</VirtualHost>
   </HTTPProxyConnection>
   

curl -v https://your_domain/edgemicro-auth/products

{
  "error":"unauthorized",
  "error_description": "authentication failed"
}

curl: (35) error:1408F10B:SSL routines:ssl3_get_record:wrong version number

{
   "apiProduct":[
      {
         "apiResources":[
            "/",
            "/**"
         ],
         "approvalType":"auto",
         "attributes":[

         ],
         "createdAt":1537374680948,
         "createdBy":"jdoe@foo.com",
         "description":"",
         "displayName":"mock",
         "environments":[
            "test"
         ],
         "lastModifiedAt":1537374680948,
         "lastModifiedBy":"test@test.com",
         "name":"mock",
         "proxies":[
            "edgemicro-auth",
            "edgemicro_mock"
         ],
         "quota":"null",
         "quotaInterval":"null",
         "quotaTimeUnit":"null",
         "scopes":[
            ""
         ]
      }
   ]
}

curl -v http://your_domain/edgemicro-auth/products

Test e debug

Come posso evitare gli errori "troppi file aperti" durante il test di carico?

In alcuni casi, è possibile che nel sistema si verifichino troppe connessioni file aperte che possono causare l'arresto anomalo di Edge Micro. Il logging predefinito richiede due connessioni HTTP per le transazioni in entrata e in uscita attraverso il microgateway.

A scopo di test e benchmarking, Apigee consiglia di impostare il comando ulimit del sistema su illimitato: ulimit -n unlimited. Vedi anche Errore microgateway perimetrale durante i test di carico nella community di Apigee.

Suggerimenti per sviluppo e debug rapidi

Se stai sviluppando plug-in per Edge Microgateway, potresti notare che il supporto per lo sviluppo rapido è limitato.

Per ora, ecco alcuni suggerimenti:

• Per avviare Edge Microgateway, puoi impostare le variabili di ambiente EDGEMICRO_KEY e EDGEMICRO_SECRET sulla coppia chiave/segreta richiesta dal comando di avvio del Microgateway. In questo modo puoi avviare Edge Microgateway senza inserire la chiave/il secret nella riga di comando. Vedi anche Impostare le variabili di ambiente nella documentazione di Edge Microgateway.
• Avvia Edge Microgateway in modalità DEBUG per visualizzare un output aggiuntivo nel terminale di comando: DEBUG=* edgemicro start -o [org] -e [env] -k [key] -s [secret]

Attività commerciale e licenze

Qual è la relazione tra i modelli di supporto di Apigee-127 e Edge Microgateway?

Apigee-127 è un progetto software open source supportato nel modello open source. In altre parole, puoi segnalare problemi nel progetto GitHub ed effettuare una richiesta di pull se provi a risolvere qualcosa. Apigee-127 non richiede né include alcun Contratto di licenza software con Apigee.

Edge Microgateway, d'altra parte, è un prodotto Enterprise supportato da Apigee per i clienti di Apigee. In altre parole, i clienti di Apigee possono creare ticket di assistenza, richieste di funzionalità e segnalazioni di bug utilizzando l'assistenza Apigee Edge di Google Cloud.