Sicurezza e limiti
Il proxy è progettato in modo che un servizio collegato possa integrare le tue API senza esporle:
- Solo lato server: le richieste partono dai server di Seekdown, quindi il tuo endpoint e
le sue credenziali non vengono mai rivelati alla pagina o al visitatore.
- Solo indirizzi pubblici: un servizio collegato può raggiungere solo host pubblici su internet.
Le richieste verso indirizzi privati, di rete interna o di loopback vengono rifiutate, quindi il proxy non può essere puntato verso l’infrastruttura interna.
- Solo assistenti: i servizi collegati funzionano sugli assistenti, non sui centri di ricerca.
- Metodi consentiti:
GET,POST,PUTeDELETE. - Timeout della richiesta: una chiamata che non risponde entro circa un minuto viene interrotta.
- I valori dinamici sono confinati: un valore
{{params.x}}viene codificato per l’URL nell’URL e ripulito dai
caratteri di controllo negli header, quindi non può iniettare percorsi, query o header aggiuntivi. I segnaposto sono consentiti solo nel percorso, nella query o in un valore di header, mai nell’host, quindi un valore non può mai reindirizzare la richiesta. Se un parametro referenziato non viene fornito, la chiamata fallisce invece di inviare una richiesta parziale.
Risoluzione dei problemi
- La chiamata fallisce subito: verifica che l’URL sia un indirizzo pubblico
https://; gli host interni o
privati sono bloccati per progettazione.
- L’endpoint segnala "unauthorized": verifica che l’Header name corrisponda a ciò che la tua API
si aspetta e che il segreto salvato sia aggiornato. Nel dubbio, usa Remove stored secret e reimpostalo.
- All’invio non succede nulla: assicurati che l’azione o il modulo chiami
executeProxyRequest (o sendProxyForm) con il Service ID esatto.