Skip to content

Commit 46ab1b7

Browse files
committed
readme: document tlscookie auth
1 parent 05a05c3 commit 46ab1b7

1 file changed

Lines changed: 4 additions & 0 deletions

File tree

README.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -302,6 +302,10 @@ Authentication parameters are passed as URI via `-auth` parameter. Scheme of URI
302302
* `code` - optional parameter specifying HTTP response code. Default is 403.
303303
* `body` - optional parameter specifying file with response body.
304304
* `headers` - optional parameter specifying file with response headers. It uses format identical to request header file format used by `curl` program.
305+
* `tlscookie` - (EXPERIMENTAL) auth provider which grants access to whitelisted TLS session IDs. Whitelist is checked by query of another auth provider (provided as URL in `lookup` query parameter) with session ID as username and empty password. Example of auth parameter: `-auth tlscookie://?lookup=basicfile%3A%2F%2F%3Fpath%3D%2Fetc%2Fdumbproxy%2Fsessions`. Parameters of this scheme are:
306+
* `next` - optional URL specifying the next auth provider to chain to, if authentication succeeded.
307+
* `else` - optional URL specifying the next auth provider to chain to, if authentication failed.
308+
* `lookup` - mandatory URL specifying another auth provider queried for session validity (typically `basicfile` or some Redis-backed password auth). Queries to this lookup provider ask for validity of session providing hexadecimal session ID as username and empty string as password.
305309
306310
## Scripting
307311

0 commit comments

Comments
 (0)