Stai visualizzando la documentazione di Apigee Edge.
Consulta la
documentazione di Apigee X. info
Sintomo
In Edge per il cloud privato, quando tracci un'API nell'interfaccia utente di Edge, nella colonna Stato della finestra di traccia viene visualizzata una risposta HTTP 304:
Messaggi di errore
Non sono presenti messaggi di errore: la chiamata al proxy API restituisce effettivamente una risposta di operazione riuscita, ad esempio HTTP 200. Tuttavia, la finestra di traccia nell'interfaccia utente di Edge mostra una risposta HTTP 304 e non vengono raccolti dati di traccia.
Possibili cause
In Edge per il cloud privato, l'interfaccia utente di Edge sta tentando di tracciare un proxy API a cui si accede tramite un indirizzo IP privato.
Lo strumento di traccia nell'interfaccia utente di Edge ha la capacità di inviare richieste API a qualsiasi URL. In uno scenario di deployment in cui l'interfaccia utente di Edge è ospitata insieme ad altri servizi interni, un utente malintenzionato potrebbe utilizzare in modo improprio lo strumento di traccia per effettuare richieste ai servizi tramite un indirizzo IP privato, ad esempio localhost o 127.0.0.1.
In un ambiente di produzione, in genere lasci il valore predefinito così com'è per impedire agli utenti di tracciare un indirizzo IP privato. Ad esempio, è così che viene eseguito il deployment della versione pubblica dell'interfaccia utente di Edge.
Tuttavia, per un ambiente di sviluppo o test interno, puoi sostituire questo valore predefinito per consentire agli sviluppatori di API di tracciare qualsiasi indirizzo IP. In genere, un ambiente di sviluppo/test è protetto da un firewall che non consente l'accesso pubblico.
Nota: come best practice, ti consigliamo di lasciare il valore predefinito così com'è per impedire l'accesso alla traccia agli indirizzi IP privati, anche in un ambiente di sviluppo/test, a meno che non si verifichi una situazione in cui devi abilitarlo.
Causa: tentativo di accedere a un proxy API tramite un indirizzo IP privato
Per impostazione predefinita, l'interfaccia utente di Edge per Edge per il cloud privato impedisce agli utenti di tracciare le chiamate API effettuate tramite indirizzi IP privati. L'elenco degli indirizzi IP privati include:
- Indirizzo di loopback (127.0.0.1 o localhost)
- Indirizzi locali del sito (per IPv4 - 10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16)
- Qualsiasi indirizzo locale (qualsiasi indirizzo che risolve in localhost)
Ad esempio, il seguente comando curl effettua una chiamata a un proxy API utilizzando un indirizzo IP 127.0.0.1, considerato un indirizzo IP privato:
curl http://127.0.0.1:9001/myapiproxy
Nella finestra di traccia per questa chiamata, viene visualizzata una risposta HTTP 304 anche se il comando curl ha restituito un risultato positivo.
Risoluzione
Per consentire all'interfaccia utente di Edge di tracciare gli indirizzi IP privati per Edge per il cloud privato, imposta il seguente token in ui.properties:
conf_apigee-base_apigee.feature.enabletraceforinternaladdresses="true"
Per impostare questa proprietà:
- Apri il file
ui.propertiesin un editor. Se il file non esiste, crealo.
vi /opt/apigee/customer/application/ui.properties
- Imposta le seguenti proprietà su true:
conf_apigee-base_apigee.feature.enabletraceforinternaladdresses="true"
- Salva le modifiche apportate a
ui.properties. - Assicurati che il file delle proprietà sia di proprietà dell'utente "apigee":
chown apigee:apigee /opt/apigee/customer/application/ui.properties
- Riavvia l'interfaccia utente di Edge:
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
L'interfaccia utente di Edge può ora accedere agli indirizzi IP privati nello strumento di traccia.
Per disattivare in un secondo momento la traccia delle richieste tramite indirizzi IP privati, modifica ui.properties impostando la proprietà su false e poi riavvia l'interfaccia utente di Edge.
Documenti correlati (facoltativo)
Per saperne di più, consulta Consentire all'interfaccia utente di Edge di accedere agli indirizzi IP locali.