mirror of
https://github.com/pomerium/pomerium.git
synced 2025-06-01 02:12:50 +02:00
docs/configuration: add doc for trailing slash limitation in "To" field (#1040)
Due to the limitation of envoy, it can't handle rewriting of "From" field without path to a destination with path. Updates #880 Updates #1033
This commit is contained in:
parent
f80a72d680
commit
2c3c7b837d
1 changed files with 25 additions and 1 deletions
|
@ -976,10 +976,34 @@ Remove Request Headers allows you to remove given request headers. This can be u
|
|||
- `yaml`/`json` setting: `to`
|
||||
- Type: `URL` (must contain a scheme and hostname)
|
||||
- Required
|
||||
- Example: `http://httpbin` , `https://192.1.20.12:8080`, `http://neverssl.com`
|
||||
- Example: `http://httpbin` , `https://192.1.20.12:8080`, `http://neverssl.com`, `https://httpbin.org/anything/`
|
||||
|
||||
`To` is the destination of a proxied request. It can be an internal resource, or an external resource.
|
||||
|
||||
Be careful with trailing slash.
|
||||
|
||||
With rule:
|
||||
|
||||
```yaml
|
||||
- from: https://httpbin.corp.example.com
|
||||
to: https://httpbin.org/anything
|
||||
```
|
||||
|
||||
Requests to `https://httpbin.corp.example.com` will be forwarded to `https://httpbin.org/anything`, while requests to
|
||||
`https://httpbin.corp.example.com/foo` will be forwarded to `https://httpbin.org/anythingfoo`.To make the request forwarded to
|
||||
`https://httbin.org/anything/foo`, you can use double slashes in your request `https://httbin.corp.example.com//foo`.
|
||||
|
||||
While with rule:
|
||||
|
||||
```yaml
|
||||
- from: https://httpbin.corp.example.com
|
||||
to: https://httpbin.org/anything/
|
||||
```
|
||||
|
||||
All requests to `https://httpbin.corp.example.com/*` will be forwarded to `https://httpbin.org/anything/*`. That means accessing to
|
||||
`https://httpbin.corp.example.com` will be forwarded to `https://httpbin.org/anything/`. That said, if your application does not handle
|
||||
trailing slash, the request will end up with 404 not found.
|
||||
|
||||
### TLS Skip Verification
|
||||
|
||||
- Config File Key: `tls_skip_verify`
|
||||
|
|
Loading…
Add table
Add a link
Reference in a new issue