Skip to content

Commit e80a8e5

Browse files
committed
Make quoted access modes optional with recommendations
1 parent e026785 commit e80a8e5

File tree

1 file changed

+10
-6
lines changed

1 file changed

+10
-6
lines changed

main/authorization.bs

Lines changed: 10 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -30,16 +30,16 @@ The syntax for the `WAC-Allow` header, using the ABNF syntax defined in
3030
Section 1.2 of [[!RFC7231]], is:
3131

3232
```
33-
wac-allow = "WAC-Allow" ":" OWS #access-param OWS
34-
access-param = permission-group OWS "=" OWS quoted-access-modes
35-
permission-group = 1*ALPHA
36-
quoted-access-modes = DQUOTE OWS *1(access-mode *(RWS access-mode)) OWS DQUOTE
37-
access-mode = "read" / "write" / "append" / "control"
33+
wac-allow = "WAC-Allow" ":" OWS #access-param OWS
34+
access-param = permission-group OWS "=" OWS access-modes
35+
permission-group = 1*ALPHA
36+
access-modes = *1DQUOTE OWS *1(access-mode *(RWS access-mode)) OWS *1DQUOTE
37+
access-mode = "read" / "write" / "append" / "control"
3838
```
3939

4040
The `WAC-Allow` HTTP header's field-value is a comma-separated list of
4141
`access-param`s. `access-param` is a whitespace-separated list of `access
42-
mode`s granted to a `permission-group`.
42+
modes` granted to a `permission-group`.
4343

4444
This specification defines the following `permission-group`s:
4545

@@ -62,6 +62,10 @@ handling. When the received message fails to match an allowed pattern, finds
6262
unrecognised access parameters or access modes, clients MUST ignore the
6363
received `WAC-Allow` header-field.
6464

65+
The quoted and unquoted values for `access-modes` are equivalent. Servers are
66+
recommended to use quoted values in the response. Clients' are recommended to
67+
be able to parse both quoted and unquoted values.
68+
6569
[[Source](https://github.com/solid/specification/issues/171)]
6670
[[Source](https://github.com/solid/specification/issues/170)]
6771
[[Source](https://github.com/solid/specification/issues/181)]

0 commit comments

Comments
 (0)