diff options
author | Vivien Kraus <vivien@planete-kraus.eu> | 2021-10-14 22:32:42 +0200 |
---|---|---|
committer | Vivien Kraus <vivien@planete-kraus.eu> | 2021-10-20 18:07:07 +0200 |
commit | 7debf052567f50d2c2510d80405069e53b0971bf (patch) | |
tree | 2a669dfd528dfcb9920f96e4b317fbafb7943ba7 /doc | |
parent | 34624c72245b483e645efd281a27c9c9e210a19a (diff) |
server: add a resource server endpoint
Diffstat (limited to 'doc')
-rw-r--r-- | doc/disfluid.texi | 36 |
1 files changed, 36 insertions, 0 deletions
diff --git a/doc/disfluid.texi b/doc/disfluid.texi index d85afd8..7e47022 100644 --- a/doc/disfluid.texi +++ b/doc/disfluid.texi @@ -1551,6 +1551,7 @@ the user. * Reverse proxy:: * Client pages:: * Identity provider:: +* Resource server:: @end menu @node Error signalling @@ -1845,6 +1846,41 @@ Return the endpoint where all requests that aren’t handled by any element of the @var{identity-provider} go. @end deffn +@node Resource server +@section Resource server +The resource server is a read-write server with fine-grained +authorizations. You can create one in the +@emph{(webid-oidc server endpoint resource-server)} module. + +@deftp {Class} <resource-server> (<endpoint>) @var{server-uri} @var{owner} @var{data-home} +Create a resource server endpoint. To manage RDF data, and in +particular to identify owned resources, it is necessary that the +server knows its public @var{server-uri}. @var{owner} is the webid of +someone that has total control. + +If you want to manage multiple resource servers, you must make sure +that each one of them has a separate @var{data-home} directory. + +You can construct one with @code{#:@var{server-uri}} (an URI), +@code{#:@var{owner}} (an URI) and @code{#:@var{data-home}} (a +directory file name or a thunk returning a file name; it may exist or +not, defaults to @code{$XDG_CACHE_HOME}). +@end deftp + +@deffn {Generic} server-uri @var{resource-server} +Return the public URI of the @var{resource-server}. +@end deffn + +@deffn {Generic} owner @var{resource-server} +Return the webid of a user that has full control over +@var{resource-server}. +@end deffn + +@deffn {Generic} data-home @var{resource-server} +Return the directory where @var{resource-server} stores persistent +data. +@end deffn + @node Running an Identity Provider @chapter Running an Identity Provider |