add an expiration timestamp to grants

David Christofas · David Christofas · commit ec4bcc98b736 · 2023-01-04T15:50:04.000+01:00
The expiration timestamp limits the access of a share in time
diff --git a/cs3/sharing/collaboration/v1beta1/resources.proto b/cs3/sharing/collaboration/v1beta1/resources.proto
@@ -163,6 +163,9 @@ message ShareGrant {
   // REQUIRED.
   // The share permissions for the grant.
   SharePermissions permissions = 2;
+  // OPTIONAL
+  // Expiration of the grant.
+  cs3.types.v1beta1.Timestamp expiration = 3;
 }
 
 // Represents a filter to apply to the request.
diff --git a/cs3/storage/provider/v1beta1/resources.proto b/cs3/storage/provider/v1beta1/resources.proto
@@ -325,6 +325,9 @@ message Grant {
   // OPTIONAL
   // The Creator of the grant
   cs3.identity.user.v1beta1.UserId creator = 3;
+  // OPTIONAL
+  // Expiration of the grant.
+  cs3.types.v1beta1.Timestamp expiration = 4;
 }
 
 // A grantee is the receiver of a grant.
diff --git a/docs/index.html b/docs/index.html
@@ -8295,6 +8295,12 @@ <h3 id="cs3.identity.user.v1beta1.UserType">UserType</h3>
                 <td><p>A lightweight user account without access to various major functionalities.</p></td>
               </tr>
             
+              <tr>
+                <td>USER_TYPE_SPACE_OWNER</td>
+                <td>8</td>
+                <td><p>A space owner to allow access for public link or content indexing.</p></td>
+              </tr>
+            
           </tbody>
         </table>
       
@@ -10953,6 +10959,14 @@ <h3 id="cs3.sharing.collaboration.v1beta1.ShareGrant">ShareGrant</h3>
 The share permissions for the grant. </p></td>
                 </tr>
               
+                <tr>
+                  <td>expiration</td>
+                  <td><a href="#cs3.types.v1beta1.Timestamp">cs3.types.v1beta1.Timestamp</a></td>
+                  <td></td>
+                  <td><p>OPTIONAL
+Expiration of the grant. </p></td>
+                </tr>
+              
             </tbody>
           </table>
 
@@ -17490,6 +17504,14 @@ <h3 id="cs3.storage.provider.v1beta1.Grant">Grant</h3>
 The Creator of the grant </p></td>
                 </tr>
               
+                <tr>
+                  <td>expiration</td>
+                  <td><a href="#cs3.types.v1beta1.Timestamp">cs3.types.v1beta1.Timestamp</a></td>
+                  <td></td>
+                  <td><p>OPTIONAL
+Expiration of the grant. </p></td>
+                </tr>
+              
             </tbody>
           </table>
 

Original file line number	Diff line number	Diff line change
`@@ -163,6 +163,9 @@ message ShareGrant {`
`163`	`163`	`// REQUIRED.`
`164`	`164`	`// The share permissions for the grant.`
`165`	`165`	`SharePermissions permissions = 2;`
	`166`	`+ // OPTIONAL`
	`167`	`+ // Expiration of the grant.`
	`168`	`+ cs3.types.v1beta1.Timestamp expiration = 3;`
`166`	`169`	`}`
`167`	`170`
`168`	`171`	`// Represents a filter to apply to the request.`
Original file line number	Diff line number	Diff line change
`@@ -325,6 +325,9 @@ message Grant {`
`325`	`325`	`// OPTIONAL`
`326`	`326`	`// The Creator of the grant`
`327`	`327`	`cs3.identity.user.v1beta1.UserId creator = 3;`
	`328`	`+ // OPTIONAL`
	`329`	`+ // Expiration of the grant.`
	`330`	`+ cs3.types.v1beta1.Timestamp expiration = 4;`
`328`	`331`	`}`
`329`	`332`
`330`	`333`	`// A grantee is the receiver of a grant.`