Sanitize a PDF document on Apryse Server SDK

Apryse SDK's Sanitizer ensures that if specified content categories are present in a document, the content is permanently destroyed, not simply disabled or obscured. This prevents leakage of sensitive data such as authoring details, editing history, private identifiers, residual form entries, and neutralizes scripts or attachments.

Sanitization is recommended prior to external sharing with clients, partners, or regulatory bodies. It helps align with privacy policies and compliance requirements by permanently removing any potentially sensitive hidden data.

The sanitization process in the Apryse SDK consists of two parts:

• Content detection
• Document sanitization

A user calls pdftron.PDF.Sanitizer.GetSanitizableContent() to retrieve a SanitizeOptions object outlining the sanitizable content groups present within the document. For each content group in the provided document, the corresponding category is automatically enabled. This helps you understand how sanitization will modify the document and make informed decisions about which content groups to remove.

With pdftron.PDF.Sanitizer.SanitizeDocument(), you can instruct the sanitizer to permanently strip the specified content from the document.

You can optionally provide a SanitizeOptions object to specify which content categories to remove. For example, remove only metadata, form data, and bookmarks while leaving other content intact. Only the categories explicitly enabled in the SanitizeOptions object are sanitized. All other content remains unchanged.

In summary, the behavior differs depending on how sanitizeDocument() is called:

• SanitizeDocument(doc) → Removes all sanitizable content.
• SanitizeDocument(doc, options) → Removes only the content categories explicitly enabled in the SanitizeOptions object.
• SanitizeDocument(doc, new SanitizeOptions()) → Removes no content because an empty SanitizeOptions object is provided with no categories enabled.

For example, to sanitize content from a PDF document using an optional SanitizeOptions() object with categories, use the following code:

1SanitizeOptions options = new SanitizeOptions();
2options.SetMetadata(true);
3options.SetFormData(true);
4options.SetBookmarks(true);
5
6PDFDoc doc = new PDFDoc(filename);
7Sanitizer.SanitizeDocument(doc, options);

1options := NewSanitizeOptions()
2options.SetMetadata(true)
3options.SetFormData(true)
4options.SetBookmarks(true)
5
6doc := NewPDFDoc(filename)
7SanitizerSanitizeDocument(doc, options)

1SanitizeOptions options;
2options.SetMetadata(true);
3options.SetFormData(true);
4options.SetBookmarks(true);
5
6PDFDoc doc(filename);
7Sanitizer::SanitizeDocument(doc, &options);

1SanitizeOptions options = new SanitizeOptions();
2options.setMetadata(true);
3options.setFormData(true);
4options.setBookmarks(true);
5
6PDFDoc doc = new PDFDoc(filename);
7Sanitizer.sanitizeDocument(doc, options);
8

1const options = new PDFNet.Sanitizer.SanitizeOptions();
2options.setMetadata(true);
3options.setFormData(true);
4options.setBookmarks(true);
5
6const doc = await PDFNet.PDFDoc.createFromURL(filename);
7await PDFNet.Sanitizer.sanitizeDocument(doc, options);

1$options = new SanitizeOptions();
2$options->SetMetadata(true);
3$options->SetFormData(true);
4$options->SetBookmarks(true);
5
6$doc = new PDFDoc(filename);
7Sanitizer::SanitizeDocument($doc, $options);

1options = SanitizeOptions.new
2options.SetMetadata(true)
3options.SetFormData(true)
4options.SetBookmarks(true)
5
6doc = PDFDoc.new(filename)
7Sanitizer.SanitizeDocument(doc, options)

1PTSanitizeOptions *opts = [[PTSanitizeOptions alloc] init];
2[opts SetMetadata: YES];
3[opts SetFormData: YES];
4[opts SetBookmarks: YES];
5
6PTPDFDoc *doc = [[PTPDFDoc alloc] initWithFilepath: filename];
7[PTSanitizer SanitizeDocument: doc options: opts];

1options = SanitizeOptions()
2options.SetMetadata(True)
3options.SetFormData(True)
4options.SetBookmarks(True)
5
6doc = PDFDoc(filename)
7Sanitizer.SanitizeDocument(doc, options)

1Dim options As SanitizeOptions = New SanitizeOptions()
2options.SetMetadata(True)
3options.SetFormData(True)
4options.SetBookmarks(True)
5
6Dim doc As PDFDoc = New PDFDoc(filename)
7Sanitizer.SanitizeDocument(doc, options)

See our full code sample for PDF sanitization to learn how to use pdftron.PDF.Sanitizer to permanently remove hidden and sensitive content from PDF documents. The sample is available in C#, Go, Java, C++, JavaScript, Python, PHP, Ruby, VB, and Objective-C.