HTTP/s middlewares
A list of HTTP built-in middlewares that you can use in your HTTP/s tunnels
Middleware is a function that tweaks the requests before sending them to your localhost services or before the answer from your localhost services are sent to the clients, you can use these built-in middlewares without touching your services.
Sometimes you need modify (add or delete) the request headers before reaching your local web server, you can do that by passing
--request-header or -H in short then the header you want to edit for example:loclx tunnel http --request-header host:dev.laravel --request-header token:secret
the above command will add two headers to the request
host and token, if the headers already existed in the request then they will be overwritten, in case you want to delete a specific header from the request, you will need to pass an empty value for example --request-header 'host:'.
Modify response headers before sending it back to the client (e.g. browser), you need to pass the
--response-header or -R in short, then the value that you want to edit, for example:loclx tunnel http --response-header role:admin --response-header user:admin
the above command will add two response headers to the response
role and user, if the headers already existed in the response then they will be overwritten, in case you want to delete a specific header from the response, you will need to pass an empty value for example --response-header 'role:'.
Baisc authentication middleware restricts access to your services to known users for example:
loclx tunnel http --baisc-auth user:pass
Key authentication middleware restricts access to your services to those who have the access token only, it is ideally used in local API services, when you want to access your localhost API service from external API client (e.g. curl, insomnia, SDKs), then from your API client you can authenticate against your local API services by passing
X-TOKEN header with the token value, for example:loclx tunnel http --key-auth secureToken
Then access your local services by doing
curl https://hello.loclx.io -H 'X-TOKEN:secureToken' , otherwise you will get Access Denied
IP whitelisting middleware restricts access to specific IP addresses only, you can pass CIDR format for example:
loclx tunnel http --ip-whitelist 192.168.100.3 --ip-whitelist 10.20.100.10/24
Control the number of requests per second going to your local services, it ensures that services will receive a fair amount of requests, for example:
loclx tunnel http --rate-limit 20
This will only accept 20 requests per second otherwise you will receive
429 Too Many Requests.
Add requests auto redirection from HTTP to HTTPS, for example a request to
http://hello.loclx.io will be redirected to https://hello.loclx.io.loclx tunnel http --https-redirect
Prefix the request path with a custom path, if your tunnel is
hello.loclx.io , then adding prefix path like /foo/bar will update the incoming requests URL path before forwarding it to your localhost server.loclx tunnel http --prefix-path /foo/bar
So if the incoming request is
https://hello.loclx.io/api/v1 then after the modification it will become https://hello.loclx.io/foo/bar/api/v1.Last modified 4mo ago