Skip to content

Commit 6bf5f05

Browse files
Merge pull request #287 from sshanks-kx/httpauth
fix dot z ref (auth/dependencies section corrupt in prev update)
2 parents eae46a2 + 7ebcad0 commit 6bf5f05

File tree

1 file changed

+11
-0
lines changed

1 file changed

+11
-0
lines changed

docs/ref/dotz.md

+11
Original file line numberDiff line numberDiff line change
@@ -110,6 +110,17 @@ The relevant HTTP callback to handle this request will be allowed.
110110
* User not authorized/authenticated (custom response)
111111
```q
112112
(2;"response text")
113+
```
114+
The custom response to be sent should be provided in the "response text" section.
115+
The response text should be comprised of a valid HTTP response message, for example a 401 response with a customised message.
116+
An HTTP callback to handle the original request is not called.
117+
* Fallback to basic authentication
118+
```q
119+
(4;"")
120+
```
121+
Fallback to [basic access authentication](https://en.wikipedia.org/wiki/Basic_access_authentication#Client_side), where the username/password are base64 decoded and processed via the [`-u`](../ba
122+
sics/cmdline.md#-u-usr-pwd-local)/[`-U`](../basics/cmdline.md#-u-usr-pwd) file and [`.z.pw`](#zpw-validate-user) (if defined).
123+
If the user is not permitted, the client is sent a default 401 HTTP unauthorized response. Since V4.0 2021.07.12.
113124

114125
!!! note "If .z.ac is not defined, it uses basic access authentication as per `(4;"")` above"
115126

0 commit comments

Comments
 (0)