Domande frequenti sul microgateway perimetrale

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

Per iniziare

Come faccio a installare Edge Microgateway?

Consulta Installazione di Edge Microgateway.

Come faccio a eseguire Edge Microgateway?

Consulta Configurazione di Edge Microgateway.

Ho bisogno di un database per eseguire Microgateway?

Le API sottoposte a proxy tramite Edge Microgateway possono interagire con un database in esecuzione come parte di un servizio di destinazione. Tuttavia, Edge Microgateway funziona 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 per rilevare le modifiche apportate ad Apigee Edge, ad esempio quelle a proxy, prodotti o app per sviluppatori compatibili con microgateway. L'intervallo di polling predefinito è 600 secondi, ma puoi modificarlo con l'impostazione di configurazione config_change_poll_interval. Consulta gli attributi di edgemicro.

Se non vuoi attendere l'intervallo di polling, utilizza il comando edgemicro reload per rilevare le ultime modifiche. Vedi Ricarica del cluster microgateway.

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

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

Quali sono le opzioni a mia disposizione per la registrazione con Edge Microgateway?

Edge Microgateway è dotato di 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 Registrazione messaggi per registrare i messaggi per Edge Microgateway. Consulta anche l'articolo della community Plugin di logging per Microgateway.

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

Se l'organizzazione e l'ambiente sono gli stessi per le istanze di Microgateway, puoi riutilizzare la coppia chiave/secret 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 dei comandi 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 Impostazione delle variabili di ambiente.

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

No. Per impostazione predefinita, Edge Microgateway agisce solo sugli attributi correlati al routing di base e alla sicurezza. Tuttavia, come soluzioni alternative, hai la seguente opzione:

1. Aggiungi attributi personalizzati al proxy edgemicro-auth che Edge Microgateway esegue il deployment su Apigee Edge. Questi attributi saranno disponibili quando utilizzi la sicurezza della chiave API o del token OAuth.
2. Modifica 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 nelle 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 di 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 le dimensioni massime, 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 in 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 Edge esistente come deployment di Edge Microgateway?

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

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

No. Edge Microgateway non conosce i deployment di proxy API non microgateway su Apigee Edge.

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

Per una buona discussione su come eseguire Edge Microgateway utilizzando NGINX come bilanciatore del carico, consulta 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 che posso eseguire il deployment?

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

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

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

Posso associare il mio deployment di Edge Microgateway a una regione specifica (se sono un cliente multiregionale)?

Edge Microgateway sceglie automaticamente la regione migliore per la sua interazione con Apigee Edge. Puoi eseguire il deployment delle istanze di 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 e implementare 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 per 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 proxy compatibili con Edge Microgateway che vengono implementati su Edge.

Prestazioni

Quali sono le considerazioni sul rendimento per l'utilizzo di Edge Microgateway?

Se esegui Edge Microgateway in collocazione 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 di cui è stato eseguito il front-end dai bilanciatori del carico come NGINX. Vedi anche Gestione delle API con Apigee Edge Microgateway e NGINX e Scalabilità orizzontale verticale nella community Apigee.

Qual è il TPS di Edge Microgateway per impostazione predefinita e quali sono i requisiti hardware necessari per un'istanza di Microgateway

I requisiti hardware e le misurazioni TPS sono difficili da valutare con Edge Microgateway. Dipende dalla tua configurazione, che è una combinazione di ottimizzazione di Edge Microgateway, utilizzo di plug-in, plug-in personalizzati e configurazione di altri elementi come TLS. Apigee in genere consiglia di farsi un'idea di questa combinazione di elementi ed eseguire test delle prestazioni con la configurazione specifica.

Deployment del cloud privato

Edge Microgateway funziona con Edge for Private Cloud?

Sì. Per maggiori dettagli, vedi Passaggi di configurazione di Apigee Private Cloud.

Plug-in

Come viene applicata la quota con Edge Microgateway?

Se vuoi, puoi aggiungere un plug-in per la quota all'istanza di Edge Microgateway. Per maggiori dettagli, consulta l'articolo Utilizzo del plug-in quota.

Come viene applicato Spike Arrest con Edge Microgateway?

Se vuoi, puoi aggiungere un plug-in di protezione dai picchi alla tua istanza di Edge Microgateway. Per maggiori dettagli, vedi Utilizzo del plug-in di eliminazione 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 Analytics su Edge?

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

Posso aggiungere policy a Edge Microgateway?

Se colleghi criteri Apigee Edge regolari a proxy compatibili con microgateway in Apigee Edge, questi vengono ignorati. Edge Microgateway utilizza invece plug-in per fornire funzionalità simili ai criteri in Edge, come quota, spike arrest, sicurezza della chiave API e sicurezza OAuth2. Puoi anche scrivere plug-in personalizzati. Consulta Utilizzare i plug-in e Sviluppare plug-in personalizzati.

I seguenti post e blog della community Apigee descrivono altri casi d'uso dei plug-in:

• Come sostituire l'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, un proxy API denominato edgemicro-auth viene deployment nell'organizzazione:ambiente su Apigee Edge. Questo proxy espone un endpoint /products che restituisce un elenco di prodotti API. Se hai installato Edge Microgateway entro il 5 ottobre 2018, Apigee consiglia di adottare misure per proteggere questo endpoint, perché 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 reciproco. Entrambe le opzioni sono descritte di seguito.

Controlla se l'endpoint /products è protetto

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

Opzione 1: esegui l'upgrade di Edge Microgateway

Se hai installato Edge Microgateway entro il 5 ottobre 2018, Apigee ti consiglia di eseguire l'upgrade all'ultima versione di Edge Microgateway. Segui i passaggi descritti in Eseguire l'upgrade di Edge Microgateway se hai una connessione a internet.

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

Opzione 2: configura Mutual TLS

Se al momento non riesci ad 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 bidirezionale).

1. Apri il file $HOME/.edgemicro/org-env-config.yaml. Consulta Dove è installato Edge Microgateway se non riesci a trovare questo file.
2. Aggiungi il seguente blocco tlsOptions al file org-env-config.yaml per abilitare mutual TLS 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: includi se vuoi utilizzare un file p12/pfx anziché un certificato e una chiave.
   • passphrase: La passphrase per un file pfx.
   • ciphers: specifica i cifrari TLS.
3. Assicurati che l'host virtuale a cui è distribuito il proxy edgemicro-auth abbia abilitato mutual TLS. Per maggiori dettagli, consulta Definizione di un host virtuale per TLS bidirezionale nella documentazione di Apigee Edge.

   Lo screenshot seguente mostra come attivare mutual TLS su un host virtuale nell'interfaccia utente di Apigee Edge:

   
4. Esamina il proxy API edgemicro-auth nella UI Edge e assicurati che l'host virtuale corretto sia specificato nella configurazione del proxy. Ad esempio, se hai creato un host virtuale abilitato per TLS chiamato mutualtls, la sezione 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 faccio a evitare errori di tipo "Troppi file aperti" durante il test di carico?

In alcuni casi, il sistema potrebbe riscontrare una situazione in cui sono presenti troppe connessioni di file aperte e ciò può causare l'arresto anomalo di Edge Micro. La registrazione predefinita richiede due connessioni HTTP per le transazioni in entrata e in uscita tramite Microgateway.

Per scopi di test e benchmarking, Apigee consiglia di impostare il comando ulimit del sistema su illimitato: ulimit -n unlimited. Consulta anche Errore di Edge Microgateway durante il test di carico nella community di Apigee.

Suggerimenti per lo sviluppo e il debug rapidi

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

Per il momento, ecco alcuni suggerimenti:

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

Attività commerciale e licenze

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

Apigee-127 è un progetto software open source supportato nel modello open source. ovvero, puoi segnalare problemi nel progetto GitHub ed effettuare una richiesta di pull se tenti di risolvere qualcosa. Apigee-127 non richiede né include contratti di licenza software con Apigee.

Edge Microgateway, invece, è un prodotto aziendale supportato da Apigee per i clienti Apigee. Ciò significa che i clienti Apigee possono creare ticket di assistenza, richieste di funzionalità e segnalazioni di bug utilizzando l'assistenza Apigee Edge di Google Cloud.