Let a storage backend refuse or defer a deletion, with a reason shown to the user

Aperta
#66,498 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
5/5
Tempo stimato
Più di una settimana
Idoneità per principianti
25/100
Tipo di issue
Funzionalità
Chiarezza
Abbastanza chiara
Stato di attività
Attiva
Stack tecnologico
php

Direzione di ricerca

The proposal identifies AmazonS3::unlink() and S3ObjectTrait::deleteObject() in Nextcloud storage, along with WebDAV deletion and trash emptying, but does not name file paths or tests. Start by tracing those deletion entry points and the current refusal handling; the scope spans a typed refusal, user-visible messages, deletion events, and S3 Object Lock behavior. Done means refused or deferred deletes preserve the item and explain why, while accepted deletes and S3 retention or legal holds are handled and covered by tests.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

0. Needs triage enhancement

[!TIP]

Help move this idea forward
  • Use the 👍 reaction to show support for this feature.
  • Avoid commenting unless you have relevant information to add; unnecessary comments create noise for subscribers.
  • Subscribe to receive notifications about status changes and new comments.

Is your feature request related to a problem? Please describe.

Public bodies must keep records for their full statutory retention period, and may only destroy them through a recorded decision. A record under legal hold may not be destroyed at all. The natural setup for this is Nextcloud on top of storage that enforces retention, such as an S3 bucket with Object Lock. Today the two cannot talk to each other:

  • Deletion is an unconditional instruction. A backend has no way to answer "not yet, and here is why".
  • On S3 it is worse than an error. AmazonS3::unlink() (files_external) and S3ObjectTrait::deleteObject() (primary object storage) send DeleteObject without a VersionId. Object Lock requires versioning, so S3 answers with a delete marker and reports success. The file disappears for the user and from Nextcloud, while the locked bytes stay in the bucket out of sight. Folder deletes use deleteObjects with Quiet: true and do not read back the per-key errors.
  • When a deletion is refused today (a listener throws AbortedEventException, or the storage returns false), WebDAV answers a bare 403 and the reason is lost.

We found this by reading the code on master; we are confirming it on MinIO with Object Lock and will add the results here.

Describe the solution you'd like

  1. A typed refusal. A storage or listener can throw a refusal carrying a reason for the user and, optionally, the date until which the object is held. WebDAV returns it with the message, and Files shows it, also when emptying the trash.
  2. Permanent deletion as a request. Emptying the trash asks the backend, and the backend may refuse or defer. A refused item stays where it is.
  3. Events for both a refused and a completed deletion, carrying the file's identity, so audit logging can record both.
  4. S3 storages that respect Object Lock: recognise retention and legal hold and report them as a refusal instead of writing a delete marker, and check a folder before deleting it so it is never left half deleted.

Core keeps no retention rules. Which object is kept for how long belongs to the backend or to apps; core only understands the answer and shows it.

Describe alternatives you've considered

  • files_retention. Despite the name it solves the opposite half: it deletes tagged files after a period, and nothing stops a user from deleting them earlier. Records need protection until the end date first, and only then destruction with a recorded decision. files_retention would benefit from this proposal: its background job calls Node::delete(), so it would get a clear "not yet" back instead of silently creating a delete marker on S3.
  • App-level protection, such as a listener on BeforeNodeDeletedEvent. It does not hold for records: an admin can disable the app, other code paths bypass it, and it cannot protect against direct access to the bucket. Only the storage layer can enforce retention; core needs to understand its answer.

Additional context

This is one of a small set of storage interface extensions for records-managed backends, together with backend metadata (#66355) and durable object identity (#66499). We (Conduction, working with Dutch municipalities and VNG Common Ground) would like to build and maintain the pull requests, with tests and a MinIO Object Lock test setup.

Lingua principale
PHP
Stelle
37.5k
Fork
5.4k
Merge medio
1g 13h
PR unite (30g)
639

Preparare l'ambiente

Apri in Codespaces

Avvia il container di sviluppo del progetto nel browser, con il tuo account GitHub.

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di nextcloud/server

Tutte le issue di nextcloud/server

Issue simili

Altre issue su PHP

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.