Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Requirements pertaining to storage #208

Merged
merged 12 commits into from
Nov 8, 2020
Merged

Requirements pertaining to storage #208

Changes from all commits
Commits
Show all changes
12 commits
Select commit Hold shift + click to select a range
381145f
Specify data pod requirements wrt storage
csarven Nov 6, 2020
416db50
Add server advertising pim:Storage
csarven Nov 6, 2020
1731450
Add client determining pim:Storage
csarven Nov 6, 2020
c05fdd2
Add client determining storage of a resource
csarven Nov 6, 2020
d25817c
Add client discovery of storage in resource body
csarven Nov 6, 2020
9569dbe
Add root container's ACL and Control access privilege
csarven Nov 6, 2020
d3bd433
Add sources of Storage requirements
csarven Nov 6, 2020
655231c
Update main/resource-access.bs
csarven Nov 8, 2020
4fa43f6
Update main/resource-access.bs
csarven Nov 8, 2020
e0ccac7
Update main/resource-access.bs
csarven Nov 8, 2020
4356daf
Clarify storage's request URI
csarven Nov 8, 2020
cd78a59
Add brief description from pim/space
csarven Nov 8, 2020
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
40 changes: 40 additions & 0 deletions main/resource-access.bs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -95,6 +95,46 @@ Behaviour pertaining to authorization MUST proceed this optional redirect

## Linked Data ## {#linked-data}

### Storage ### {#storage}
csarven marked this conversation as resolved.
Show resolved Hide resolved

When a server supports a data pod, it MUST provide one or more storages
(`pim:Storage`) - a space of URIs in which data can be accessed. A storage is
the root container for all of its contained resources (see
[[#resource-containment]]).

When a server supports multiple storages, the URIs MUST be allocated to
non-overlapping space.

Servers exposing the storage resource MUST advertise by including the HTTP
`Link` header with `rel="type"` targeting
`http://www.w3.org/ns/pim/space#Storage` when responding to storage's request
URI.

Clients can determine a resource is of type storage by making an HTTP `HEAD`
or `GET` request on the target URL, and checking for the `Link` header with
`rel="type"` targeting `http://www.w3.org/ns/pim/space#Storage`.

Clients can determine the storage of a resource by moving up the URI path
hierarchy until the response includes a `Link` header with `rel="type"`
RubenVerborgh marked this conversation as resolved.
Show resolved Hide resolved
targeting `http://www.w3.org/ns/pim/space#Storage`. Clients may check the root
path of a URI for the storage claim at any time.

Clients can discover a storage by making an HTTP `GET` request on the target
URL to retrieve an RDF representation [[!RDF11-CONCEPTS]], whose encoded RDF
graph contains a relation of type `http://www.w3.org/ns/pim/space#storage`.
The object of the relation is the storage (`pim:Storage`).
RubenVerborgh marked this conversation as resolved.
Show resolved Hide resolved

[[Source](https://github.com/solid/data-interoperability-panel/issues/10#issuecomment-598694029)]
[[Source](https://github.com/solid/specification/issues/153#issuecomment-624630022)]

When using Web Access Control ([[#wac]]):

The root container (`pim:Storage`) MUST have an ACL auxiliary resource
directly associated to it. The associated ACL document MUST include an authorization
policy with `acl:Control` access privilege.

[[Source](https://github.com/solid/specification/issues/197#issuecomment-699937520)]

### Containment ### {#resource-containment}

Solid has the notion of containers to represent a collection of linked
Expand Down