Passa al contenuto principale

Regole di riscrittura

Le regole di riscrittura sono costituite da due parti: Regole di corrispondenza (quali richieste riscrivere) e Regole di riscrittura (come riscrivere).

Il Rewrite Debug supporta la riscrittura per HTTP(S), WebSocket, TCP e UDP. Puoi reindirizzare le richieste, riscrivere percorso/query/header/corpo, o simulare risposte per protocollo — vedi Modifica TCP o WebSocket per le specifiche dei flussi binari.

1. Reindirizzamento delle richieste per «HTTP&WebSocket&TCP»​

Il reindirizzamento serve a cambiare l'indirizzo e la porta di destinazione di una richiesta e può anche decidere se usare la cifratura SSL/TLS. Questa regola è particolarmente utile per i frequenti passaggi tra indirizzi del server di test e del server di produzione durante il testing.

2. Riscrittura dei percorsi per «HTTP&WebSocket»​

L'HTTP Path si riferisce alla parte dell'URL dopo il nome host, usata per identificare il percorso delle risorse sul server web.

https://example.com/api/user?name=john&age=25

In questo esempio, /api/user è il Path, che tipicamente inizia con /. Quando riscrivi il Path, l'intero percorso deve essere sostituito. Se vuoi sostituire il Path con niente, compila semplicemente /.

3. Riscrittura delle query per «HTTP&WebSocket»​

L'HTTP Query è una tecnica per passare dati attraverso un URL, che consente di passare parametri e valori nell'URL usando il simbolo «?». Le query sono costituite da una o più coppie chiave-valore separate da «&».

Ad esempio, il seguente URL contiene una query string con due parametri (name e age):

https://example.com/api/user?name=john&age=25

In questo esempio, name=john&age=25 è la query string, composta da più coppie chiave-valore concatenate con «&». Durante la riscrittura, Hodor analizza la Query in coppie chiave-valore (gestendo ordine e situazioni di array) e modifica le coppie Chiave, Valore corrispondenti. Inoltre, questi nomi e valori di parametro devono essere URL-encoded, ad esempio «value 1» verrà codificato come «value%201». Hodor gestisce automaticamente queste conversioni per te.

4. Riscrittura degli header per «HTTP&WebSocket»​

Gli HTTP Header sono un insieme di coppie chiave-valore. Puoi aggiungere o rimuovere valori dall'HTTP Header. Tuttavia, ci sono alcune considerazioni speciali per campi come Range, Content-Range, Content-Length, Content-Encoding, Content-Transfer-Encoding, Transfer-Encoding, che sono controllati dal sistema e risulterebbero inefficaci se compilati manualmente. Se viene specificato Content-Type, sovrascriverà l'impostazione mime-type del sistema.

5. Modifica del Body per «HTTP»​

L'HTTP Body può trasmettere dati in vari formati di codifica. Hodor supporta la decodifica dei dati in quattro formati di codifica (testo, JSON, x-www-form-urlencoded, multipart/form-data) e la loro modifica come coppie chiave-valore. In alternativa, puoi sostituire dinamicamente l'intera sezione del Body con dati preparati in anticipo.

5.1. Decodifica come testo e modifica con espressioni regolari​

Per la documentazione dettagliata, consulta il documento di esempio.

5.2. Decodifica come JSON per la modifica​

Per la documentazione dettagliata, consulta il documento di esempio.

5.3. Decodifica come x-www-form-urlencoded per la modifica​

Per la documentazione dettagliata, consulta il documento di esempio.

5.4. Decodifica come multipart/form-data per la modifica​

Per la documentazione dettagliata, consulta il documento di esempio.

6. Sostituzione del Body per «HTTP»​

Sostituisci direttamente la sezione del Body prima che l'App invii la richiesta al Server e prima che i dati del Server tornino all'App.

7. Riscrittura del codice per «HTTP»​

Hodor può cambiare i codici di stato HTTP e può anche reindirizzare tramite codici di risposta HTTP, scegliendo tra 301, 302, 307, 308 con indirizzi di reindirizzamento configurabili.

8. Mocking per «HTTP»​

Usato principalmente per restituire contenuti specifici per una particolare richiesta: puoi pensarlo come un server HTTP locale che restituisce contenuti preimpostati per le richieste corrispondenti.

9. Modifica dei dati per «TCP&WebSocket»​

Converti il flusso di dati upstream e downstream di TCP o WebSocket in stringhe o hex16, poi usa espressioni regolari per modificare questi dati. Per la documentazione dettagliata, consulta il documento di esempio.