CommunitySolidServer/docs/interfaces/_authorization_aclmanager_.aclmanager.html
2020-12-28 22:58:08 +00:00

314 lines
17 KiB
HTML

<!doctype html>
<html class="default no-js">
<head>
<meta charset="utf-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<title>AclManager | Community Solid Server</title>
<meta name="description" content="Documentation for Community Solid Server">
<meta name="viewport" content="width=device-width, initial-scale=1">
<link rel="stylesheet" href="../assets/css/main.css">
</head>
<body>
<header>
<div class="tsd-page-toolbar">
<div class="container">
<div class="table-wrap">
<div class="table-cell" id="tsd-search" data-index="../assets/js/search.json" data-base="..">
<div class="field">
<label for="tsd-search-field" class="tsd-widget search no-caption">Search</label>
<input id="tsd-search-field" type="text" />
</div>
<ul class="results">
<li class="state loading">Preparing search index...</li>
<li class="state failure">The search index is not available</li>
</ul>
<a href="../index.html" class="title">Community Solid Server</a>
</div>
<div class="table-cell" id="tsd-widgets">
<div id="tsd-filter">
<a href="#" class="tsd-widget options no-caption" data-toggle="options">Options</a>
<div class="tsd-filter-group">
<div class="tsd-select" id="tsd-filter-visibility">
<span class="tsd-select-label">All</span>
<ul class="tsd-select-list">
<li data-value="public">Public</li>
<li data-value="protected">Public/Protected</li>
<li data-value="private" class="selected">All</li>
</ul>
</div>
<input type="checkbox" id="tsd-filter-inherited" checked />
<label class="tsd-widget" for="tsd-filter-inherited">Inherited</label>
<input type="checkbox" id="tsd-filter-externals" checked />
<label class="tsd-widget" for="tsd-filter-externals">Externals</label>
<input type="checkbox" id="tsd-filter-only-exported" />
<label class="tsd-widget" for="tsd-filter-only-exported">Only exported</label>
</div>
</div>
<a href="#" class="tsd-widget menu no-caption" data-toggle="menu">Menu</a>
</div>
</div>
</div>
</div>
<div class="tsd-page-title">
<div class="container">
<ul class="tsd-breadcrumb">
<li>
<a href="../globals.html">Globals</a>
</li>
<li>
<a href="../modules/_authorization_aclmanager_.html">&quot;authorization/AclManager&quot;</a>
</li>
<li>
<a href="_authorization_aclmanager_.aclmanager.html">AclManager</a>
</li>
</ul>
<h1>Interface AclManager</h1>
</div>
</div>
</header>
<div class="container container-main">
<div class="row">
<div class="col-8 col-content">
<section class="tsd-panel tsd-comment">
<div class="tsd-comment tsd-typography">
<div class="lead">
<p>Handles where acl resources are stored.</p>
</div>
</div>
</section>
<section class="tsd-panel tsd-hierarchy">
<h3>Hierarchy</h3>
<ul class="tsd-hierarchy">
<li>
<span class="target">AclManager</span>
</li>
</ul>
</section>
<section class="tsd-panel">
<h3>Implemented by</h3>
<ul class="tsd-hierarchy">
<li><a href="../classes/_authorization_urlbasedaclmanager_.urlbasedaclmanager.html" class="tsd-signature-type">UrlBasedAclManager</a></li>
</ul>
</section>
<section class="tsd-panel-group tsd-index-group">
<h2>Index</h2>
<section class="tsd-panel tsd-index-panel">
<div class="tsd-index-content">
<section class="tsd-index-section ">
<h3>Properties</h3>
<ul class="tsd-index-list">
<li class="tsd-kind-property tsd-parent-kind-interface"><a href="_authorization_aclmanager_.aclmanager.html#getaclconstrainedresource" class="tsd-kind-icon">get<wbr>Acl<wbr>Constrained<wbr>Resource</a></li>
<li class="tsd-kind-property tsd-parent-kind-interface"><a href="_authorization_aclmanager_.aclmanager.html#getacldocument" class="tsd-kind-icon">get<wbr>Acl<wbr>Document</a></li>
<li class="tsd-kind-property tsd-parent-kind-interface"><a href="_authorization_aclmanager_.aclmanager.html#isacldocument" class="tsd-kind-icon">is<wbr>Acl<wbr>Document</a></li>
</ul>
</section>
</div>
</section>
</section>
<section class="tsd-panel-group tsd-member-group ">
<h2>Properties</h2>
<section class="tsd-panel tsd-member tsd-kind-property tsd-parent-kind-interface">
<a name="getaclconstrainedresource" class="tsd-anchor"></a>
<h3>get<wbr>Acl<wbr>Constrained<wbr>Resource</h3>
<div class="tsd-signature tsd-kind-icon">get<wbr>Acl<wbr>Constrained<wbr>Resource<span class="tsd-signature-symbol">:</span> <span class="tsd-signature-symbol">(</span>id<span class="tsd-signature-symbol">: </span><a href="_ldp_representation_resourceidentifier_.resourceidentifier.html" class="tsd-signature-type">ResourceIdentifier</a><span class="tsd-signature-symbol">)</span><span class="tsd-signature-symbol"> =&gt; </span><span class="tsd-signature-type">Promise</span><span class="tsd-signature-symbol">&lt;</span><a href="_ldp_representation_resourceidentifier_.resourceidentifier.html" class="tsd-signature-type">ResourceIdentifier</a><span class="tsd-signature-symbol">&gt;</span></div>
<aside class="tsd-sources">
<ul>
<li>Defined in <a href="https://github.com/solid/community-server/blob/a23c36b/src/authorization/AclManager.ts#L36">src/authorization/AclManager.ts:36</a></li>
</ul>
</aside>
<div class="tsd-comment tsd-typography">
<div class="lead">
<p>Returns the identifier of the resource on which the acl constraints are placed.
In general, this is the resource identifier when the input is a normal resource,
or the non-acl version if the input is an acl resource.
This does not guarantee that this resource exists.</p>
</div>
<dl class="tsd-comment-tags">
<dt>param</dt>
<dd><p>Identifier of the acl resource.</p>
</dd>
<dt>returns</dt>
<dd><p>The ResourceIdentifier of the corresponding resource.</p>
</dd>
</dl>
</div>
<div class="tsd-type-declaration">
<h4>Type declaration</h4>
<ul class="tsd-parameters">
<li class="tsd-parameter-signature">
<ul class="tsd-signatures tsd-kind-type-literal tsd-parent-kind-property">
<li class="tsd-signature tsd-kind-icon"><span class="tsd-signature-symbol">(</span>id<span class="tsd-signature-symbol">: </span><a href="_ldp_representation_resourceidentifier_.resourceidentifier.html" class="tsd-signature-type">ResourceIdentifier</a><span class="tsd-signature-symbol">)</span><span class="tsd-signature-symbol">: </span><span class="tsd-signature-type">Promise</span><span class="tsd-signature-symbol">&lt;</span><a href="_ldp_representation_resourceidentifier_.resourceidentifier.html" class="tsd-signature-type">ResourceIdentifier</a><span class="tsd-signature-symbol">&gt;</span></li>
</ul>
<ul class="tsd-descriptions">
<li class="tsd-description">
<h4 class="tsd-parameters-title">Parameters</h4>
<ul class="tsd-parameters">
<li>
<h5>id: <a href="_ldp_representation_resourceidentifier_.resourceidentifier.html" class="tsd-signature-type">ResourceIdentifier</a></h5>
</li>
</ul>
<h4 class="tsd-returns-title">Returns <span class="tsd-signature-type">Promise</span><span class="tsd-signature-symbol">&lt;</span><a href="_ldp_representation_resourceidentifier_.resourceidentifier.html" class="tsd-signature-type">ResourceIdentifier</a><span class="tsd-signature-symbol">&gt;</span></h4>
</li>
</ul>
</li>
</ul>
</div>
</section>
<section class="tsd-panel tsd-member tsd-kind-property tsd-parent-kind-interface">
<a name="getacldocument" class="tsd-anchor"></a>
<h3>get<wbr>Acl<wbr>Document</h3>
<div class="tsd-signature tsd-kind-icon">get<wbr>Acl<wbr>Document<span class="tsd-signature-symbol">:</span> <span class="tsd-signature-symbol">(</span>id<span class="tsd-signature-symbol">: </span><a href="_ldp_representation_resourceidentifier_.resourceidentifier.html" class="tsd-signature-type">ResourceIdentifier</a><span class="tsd-signature-symbol">)</span><span class="tsd-signature-symbol"> =&gt; </span><span class="tsd-signature-type">Promise</span><span class="tsd-signature-symbol">&lt;</span><a href="_ldp_representation_resourceidentifier_.resourceidentifier.html" class="tsd-signature-type">ResourceIdentifier</a><span class="tsd-signature-symbol">&gt;</span></div>
<aside class="tsd-sources">
<ul>
<li>Defined in <a href="https://github.com/solid/community-server/blob/a23c36b/src/authorization/AclManager.ts#L15">src/authorization/AclManager.ts:15</a></li>
</ul>
</aside>
<div class="tsd-comment tsd-typography">
<div class="lead">
<p>Returns the identifier of the acl resource corresponding to the given resource.
This does not guarantee that this acl resource exists.
In the case the input is already an acl resource that will also be the response.</p>
</div>
<dl class="tsd-comment-tags">
<dt>param</dt>
<dd><p>The ResourceIdentifier of which we need the corresponding acl resource.</p>
</dd>
<dt>returns</dt>
<dd><p>The ResourceIdentifier of the corresponding acl resource.</p>
</dd>
</dl>
</div>
<div class="tsd-type-declaration">
<h4>Type declaration</h4>
<ul class="tsd-parameters">
<li class="tsd-parameter-signature">
<ul class="tsd-signatures tsd-kind-type-literal tsd-parent-kind-property">
<li class="tsd-signature tsd-kind-icon"><span class="tsd-signature-symbol">(</span>id<span class="tsd-signature-symbol">: </span><a href="_ldp_representation_resourceidentifier_.resourceidentifier.html" class="tsd-signature-type">ResourceIdentifier</a><span class="tsd-signature-symbol">)</span><span class="tsd-signature-symbol">: </span><span class="tsd-signature-type">Promise</span><span class="tsd-signature-symbol">&lt;</span><a href="_ldp_representation_resourceidentifier_.resourceidentifier.html" class="tsd-signature-type">ResourceIdentifier</a><span class="tsd-signature-symbol">&gt;</span></li>
</ul>
<ul class="tsd-descriptions">
<li class="tsd-description">
<h4 class="tsd-parameters-title">Parameters</h4>
<ul class="tsd-parameters">
<li>
<h5>id: <a href="_ldp_representation_resourceidentifier_.resourceidentifier.html" class="tsd-signature-type">ResourceIdentifier</a></h5>
</li>
</ul>
<h4 class="tsd-returns-title">Returns <span class="tsd-signature-type">Promise</span><span class="tsd-signature-symbol">&lt;</span><a href="_ldp_representation_resourceidentifier_.resourceidentifier.html" class="tsd-signature-type">ResourceIdentifier</a><span class="tsd-signature-symbol">&gt;</span></h4>
</li>
</ul>
</li>
</ul>
</div>
</section>
<section class="tsd-panel tsd-member tsd-kind-property tsd-parent-kind-interface">
<a name="isacldocument" class="tsd-anchor"></a>
<h3>is<wbr>Acl<wbr>Document</h3>
<div class="tsd-signature tsd-kind-icon">is<wbr>Acl<wbr>Document<span class="tsd-signature-symbol">:</span> <span class="tsd-signature-symbol">(</span>id<span class="tsd-signature-symbol">: </span><a href="_ldp_representation_resourceidentifier_.resourceidentifier.html" class="tsd-signature-type">ResourceIdentifier</a><span class="tsd-signature-symbol">)</span><span class="tsd-signature-symbol"> =&gt; </span><span class="tsd-signature-type">Promise</span><span class="tsd-signature-symbol">&lt;</span><span class="tsd-signature-type">boolean</span><span class="tsd-signature-symbol">&gt;</span></div>
<aside class="tsd-sources">
<ul>
<li>Defined in <a href="https://github.com/solid/community-server/blob/a23c36b/src/authorization/AclManager.ts#L25">src/authorization/AclManager.ts:25</a></li>
</ul>
</aside>
<div class="tsd-comment tsd-typography">
<div class="lead">
<p>Checks if the input identifier corresponds to an acl resource.
This does not check if that acl resource exists,
only if the identifier indicates that there could be an acl resource there.</p>
</div>
<dl class="tsd-comment-tags">
<dt>param</dt>
<dd><p>Identifier to check.</p>
</dd>
<dt>returns</dt>
<dd><p>true if the input identifier points to an acl resource.</p>
</dd>
</dl>
</div>
<div class="tsd-type-declaration">
<h4>Type declaration</h4>
<ul class="tsd-parameters">
<li class="tsd-parameter-signature">
<ul class="tsd-signatures tsd-kind-type-literal tsd-parent-kind-property">
<li class="tsd-signature tsd-kind-icon"><span class="tsd-signature-symbol">(</span>id<span class="tsd-signature-symbol">: </span><a href="_ldp_representation_resourceidentifier_.resourceidentifier.html" class="tsd-signature-type">ResourceIdentifier</a><span class="tsd-signature-symbol">)</span><span class="tsd-signature-symbol">: </span><span class="tsd-signature-type">Promise</span><span class="tsd-signature-symbol">&lt;</span><span class="tsd-signature-type">boolean</span><span class="tsd-signature-symbol">&gt;</span></li>
</ul>
<ul class="tsd-descriptions">
<li class="tsd-description">
<h4 class="tsd-parameters-title">Parameters</h4>
<ul class="tsd-parameters">
<li>
<h5>id: <a href="_ldp_representation_resourceidentifier_.resourceidentifier.html" class="tsd-signature-type">ResourceIdentifier</a></h5>
</li>
</ul>
<h4 class="tsd-returns-title">Returns <span class="tsd-signature-type">Promise</span><span class="tsd-signature-symbol">&lt;</span><span class="tsd-signature-type">boolean</span><span class="tsd-signature-symbol">&gt;</span></h4>
</li>
</ul>
</li>
</ul>
</div>
</section>
</section>
</div>
<div class="col-4 col-menu menu-sticky-wrap menu-highlight">
<nav class="tsd-navigation primary">
<ul>
<li class="globals ">
<a href="../globals.html"><em>Globals</em></a>
</li>
<li class="current tsd-kind-module">
<a href="../modules/_authorization_aclmanager_.html">&quot;authorization/<wbr>Acl<wbr>Manager&quot;</a>
</li>
</ul>
</nav>
<nav class="tsd-navigation secondary menu-sticky">
<ul class="before-current">
</ul>
<ul class="current">
<li class="current tsd-kind-interface tsd-parent-kind-module">
<a href="_authorization_aclmanager_.aclmanager.html" class="tsd-kind-icon">Acl<wbr>Manager</a>
<ul>
<li class=" tsd-kind-property tsd-parent-kind-interface">
<a href="_authorization_aclmanager_.aclmanager.html#getaclconstrainedresource" class="tsd-kind-icon">get<wbr>Acl<wbr>Constrained<wbr>Resource</a>
</li>
<li class=" tsd-kind-property tsd-parent-kind-interface">
<a href="_authorization_aclmanager_.aclmanager.html#getacldocument" class="tsd-kind-icon">get<wbr>Acl<wbr>Document</a>
</li>
<li class=" tsd-kind-property tsd-parent-kind-interface">
<a href="_authorization_aclmanager_.aclmanager.html#isacldocument" class="tsd-kind-icon">is<wbr>Acl<wbr>Document</a>
</li>
</ul>
</li>
</ul>
<ul class="after-current">
</ul>
</nav>
</div>
</div>
</div>
<footer>
<div class="container">
<h2>Legend</h2>
<div class="tsd-legend-group">
<ul class="tsd-legend">
<li class="tsd-kind-object-literal"><span class="tsd-kind-icon">Object literal</span></li>
<li class="tsd-kind-variable"><span class="tsd-kind-icon">Variable</span></li>
<li class="tsd-kind-function"><span class="tsd-kind-icon">Function</span></li>
<li class="tsd-kind-function tsd-has-type-parameter"><span class="tsd-kind-icon">Function with type parameter</span></li>
<li class="tsd-kind-type-alias"><span class="tsd-kind-icon">Type alias</span></li>
<li class="tsd-kind-type-alias tsd-has-type-parameter"><span class="tsd-kind-icon">Type alias with type parameter</span></li>
</ul>
<ul class="tsd-legend">
<li class="tsd-kind-interface"><span class="tsd-kind-icon">Interface</span></li>
<li class="tsd-kind-interface tsd-has-type-parameter"><span class="tsd-kind-icon">Interface with type parameter</span></li>
<li class="tsd-kind-property tsd-parent-kind-interface"><span class="tsd-kind-icon">Property</span></li>
</ul>
<ul class="tsd-legend">
<li class="tsd-kind-class"><span class="tsd-kind-icon">Class</span></li>
<li class="tsd-kind-class tsd-has-type-parameter"><span class="tsd-kind-icon">Class with type parameter</span></li>
</ul>
</div>
</div>
</footer>
<div class="overlay"></div>
<script src="../assets/js/main.js"></script>
</body>
</html>