What is a private document in Maditon, and how is it protected?
A private document is an uploaded file you have marked private — a signed agreement you would not quote to a prospect. It is read and compared like any other but never used for questionnaire drafts, and it is encrypted under a key that exists only for your organisation (AES-256-GCM): file, text, readings and translations are stored as ciphertext. Deleting the organisation deletes the key.
Only an upload can be private: a page a supplier publishes is public by definition. Any member or admin can mark an upload private on its page, or make it public again; the change takes effect immediately.
What private means. The document is still read, and its findings still show on its own page and in the supplier’s cross-check — those are your own readings of your own copy. Questionnaire drafts never see it: when a supplier or system you rely on has a private document, the questionnaire workspace names them, so you know to check that agreement by hand. Private documents are included in your Data Act export, because they are yours, and in your PDF packages, which are for your own filing.
How it is protected. Beyond the encryption at rest that covers all customer content, a private document is encrypted by the application itself: a data key is created for your organisation on the first private upload, wrapped under a master key that lives only in the application’s runtime environment, never in the database. The file in object storage, the extracted text, the AI reading of it, the passages that reading quotes and their translations are all stored as ciphertext and decrypted only in memory, for the reader, the comparison, the SLA view and the exports. Marking a document private encrypts it; un-marking decrypts it; replacing the file keeps the state. This protects the content in a database dump, a backup, storage read outside the application or a mis-scoped query. It does not protect against a compromise of the application host, which holds the master key — the security page says so in as many words.
Replacing the file. A newer version of an uploaded document — private or not — is uploaded on the same document, which keeps its links to systems, its notes, its history and its earlier readings; the new file becomes the current text and is read again.
Related API endpoints
/api/vendors/{vendor_id}/documents/upload bearer Upload a document, optionally marked private
/api/vendor-documents/{document_id} bearer Mark a document private, or make it public again
/api/vendor-documents/{document_id}/upload bearer Replace the file of an uploaded document, keeping its links and history
Base URL https://api.maditon.app ·
full specification at openapi.json
Regulation references
- Regulation (EU) 2016/679 (GDPR) · Art. 32 · CELEX 32016R0679
Read next
A free account runs a real classification on one of your own systems — no card, no sales call.
Run a free classification