From d1657c2556ebd247d37424eb69a4b7bf672d3a2b Mon Sep 17 00:00:00 2001 From: Simon Shanks Date: Wed, 12 Jun 2024 16:17:45 +0100 Subject: [PATCH 1/4] fix dot z ref (auth/dependencies section corrupt in prev update) --- docs/ref/dotz.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/docs/ref/dotz.md b/docs/ref/dotz.md index f8f77e3a3..d4be7cfd7 100644 --- a/docs/ref/dotz.md +++ b/docs/ref/dotz.md @@ -110,6 +110,18 @@ The relevant HTTP callback to handle this request will be allowed. * User not authorized/authenticated (custom response) ```q (2;"response text") +``` +The custom reponse to be sent should be provided in the "response text" section. +The "response text" should be comprised of a valid HTTP response message e.g. can be used to provide a +401 response with a customised message. +An HTTP callback to handle the original request will not be called. +* Fallback to basic authentication +```q +(4;"") +``` +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 +sics/cmdline.md#-u-usr-pwd-local)/[`-U`](../basics/cmdline.md#-u-usr-pwd) file and [`.z.pw`](#zpw-validate-user) (if defined). +If the user is not permitted, the client will be sent a default 401 HTTP unauthorized response. Since V4.0 2021.07.12. !!! note "If .z.ac is not defined, it uses basic access authentication as per `(4;"")` above" From 7770c5b45cd89c2ae9e7db8968b45d5999bcac1b Mon Sep 17 00:00:00 2001 From: Simon Shanks <59612559+sshanks-kx@users.noreply.github.com> Date: Wed, 12 Jun 2024 17:45:27 +0100 Subject: [PATCH 2/4] Update docs/ref/dotz.md Co-authored-by: natalietanner <142605282+natalietanner@users.noreply.github.com> --- docs/ref/dotz.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/docs/ref/dotz.md b/docs/ref/dotz.md index d4be7cfd7..34f671912 100644 --- a/docs/ref/dotz.md +++ b/docs/ref/dotz.md @@ -112,9 +112,8 @@ The relevant HTTP callback to handle this request will be allowed. (2;"response text") ``` The custom reponse to be sent should be provided in the "response text" section. -The "response text" should be comprised of a valid HTTP response message e.g. can be used to provide a -401 response with a customised message. -An HTTP callback to handle the original request will not be called. +The response text should be comprised of a valid HTTP response message, for example a 401 response with a customised message. +An HTTP callback to handle the original request is not called. * Fallback to basic authentication ```q (4;"") From ac668786abce2ed0b83bc1786be03cfab13501f3 Mon Sep 17 00:00:00 2001 From: Simon Shanks <59612559+sshanks-kx@users.noreply.github.com> Date: Wed, 12 Jun 2024 17:45:44 +0100 Subject: [PATCH 3/4] Update docs/ref/dotz.md Co-authored-by: natalietanner <142605282+natalietanner@users.noreply.github.com> --- docs/ref/dotz.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/ref/dotz.md b/docs/ref/dotz.md index 34f671912..6f416b8dd 100644 --- a/docs/ref/dotz.md +++ b/docs/ref/dotz.md @@ -120,7 +120,7 @@ An HTTP callback to handle the original request is not called. ``` 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 sics/cmdline.md#-u-usr-pwd-local)/[`-U`](../basics/cmdline.md#-u-usr-pwd) file and [`.z.pw`](#zpw-validate-user) (if defined). -If the user is not permitted, the client will be sent a default 401 HTTP unauthorized response. Since V4.0 2021.07.12. +If the user is not permitted, the client is sent a default 401 HTTP unauthorized response. Since V4.0 2021.07.12. !!! note "If .z.ac is not defined, it uses basic access authentication as per `(4;"")` above" From 7ebcad01010cbc19df6c6a0b31e3ed3322785220 Mon Sep 17 00:00:00 2001 From: Simon Shanks <59612559+sshanks-kx@users.noreply.github.com> Date: Wed, 12 Jun 2024 17:46:00 +0100 Subject: [PATCH 4/4] Update docs/ref/dotz.md Co-authored-by: natalietanner <142605282+natalietanner@users.noreply.github.com> --- docs/ref/dotz.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/ref/dotz.md b/docs/ref/dotz.md index 6f416b8dd..32bd57266 100644 --- a/docs/ref/dotz.md +++ b/docs/ref/dotz.md @@ -111,7 +111,7 @@ The relevant HTTP callback to handle this request will be allowed. ```q (2;"response text") ``` -The custom reponse to be sent should be provided in the "response text" section. +The custom response to be sent should be provided in the "response text" section. The response text should be comprised of a valid HTTP response message, for example a 401 response with a customised message. An HTTP callback to handle the original request is not called. * Fallback to basic authentication