Skip to content

Commit

Permalink
docs: add how to customize CA bundle to use
Browse files Browse the repository at this point in the history
  • Loading branch information
Guts committed Jan 18, 2024
1 parent 65bbd76 commit b428f57
Showing 1 changed file with 29 additions and 0 deletions.
29 changes: 29 additions & 0 deletions docs/guides/howto_behind_proxy.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,8 @@
Only HTTP and HTTPS proxies are supported. No socks, no PAC.
:::

> See [Requests official documentation](https://docs.python-requests.org/en/latest/user/advanced/#proxies)
## Passing as CLI option

- the proxy configuration is scoped to the QDT execution.
Expand Down Expand Up @@ -40,3 +42,30 @@ At the shell session scope:
> $env:QDT_PROXY_HTTP='http://user:password@proxyserver.intra:8765'
> qdt -vvv
```

----

## Defining custom SSL client certificates

Using a proxy for https connections typically requires the local machine to trust the proxy’s root certificate.

> See [Requests official documentation](https://docs.python-requests.org/en/latest/user/advanced/#ca-certificates)
### Using `REQUESTS_CA_BUNDLE` or `CURL_CA_BUNDLE`

Point to a certificat bundle file path (*.pem).

#### Example on Windows PowerShell

Only for the QDT command scope:

```powershell
$env:REQUESTS_CA_BUNDLE="$env:USERPROFILE\cacerts.pem"; qdt -vvv
```

At the shell session scope:

```powershell
> $env:REQUESTS_CA_BUNDLE="$env:USERPROFILE\cacerts.pem"
> qdt -vvv
```

0 comments on commit b428f57

Please sign in to comment.