Filigrane

Le filigrane incruste un texte semi-transparent par-dessus les documents que vous partagez, afin de dissuader la rediffusion et de garder une trace visible de qui a reçu quoi. Vous l'activez avec deux champs disponibles aussi bien sur les transferts que sur les coffres : watermark_enabled pour l'allumer, et watermark_text pour choisir ce qui s'affiche. Le marquage est appliqué côté serveur au moment où le document est consulté ou téléchargé : il n'altère jamais le fichier d'origine que vous avez déposé.

Ce que marque le filigrane

À l'écran, un filigrane diagonal recouvre l'aperçu du document pendant la consultation. Pour les fichiers PDF, le même marquage est aussi incrusté dans le document servi : un texte diagonal répété sur chaque page, accompagné d'un bandeau en pied de page. Résultat, la copie téléchargée par le destinataire conserve la trace, là où un simple filigrane d'écran disparaîtrait au téléchargement. Les fichiers qui ne sont pas des PDF restent marqués à l'écran pendant la lecture.

Variables dynamiques

Le texte du filigrane peut contenir des variables qui sont remplacées au moment du rendu, ce qui rend chaque copie unique et attribuable. Si une valeur n'est pas disponible (par exemple un destinataire non vérifié), la variable est simplement remplacée par une chaîne vide.

Exemple de gabarit conseillé : Confidentiel · {recipient_email} · {download_timestamp}. Si vous laissez watermark_text vide tout en activant watermark_enabled, un libellé par défaut est appliqué.

Activer le filigrane sur un transfert

Passez watermark_enabled: true et un watermark_text à la création du transfert. Le marquage s'appliquera à la consultation et au téléchargement des fichiers concernés. Vous pouvez le combiner avec un recipient pour que la variable {recipient_email} soit renseignée.

import { Coffrify } from '@coffrify/sdk';
 
const coffrify = new Coffrify({ apiKey: process.env.COFFRIFY_API_KEY });
 
const transfer = await coffrify.transfers.create({
  files: [{ name: 'contrat.pdf', size: 184320, mime_type: 'application/pdf' }],
  recipient: 'partenaire@exemple.fr',
  transfer_title: 'Contrat de partenariat',
  watermark_enabled: true,
  watermark_text: 'Confidentiel · {recipient_email} · {download_timestamp}',
  expires_in_hours: 72,
  max_downloads: 3,
});
 
console.log(transfer.share_url);

Après la création, téléversez chaque fichier sur l'URL renvoyée dans upload_urls avec une requête PUT et les en-têtes fournis. Le filigrane n'intervient pas au téléversement : il est appliqué plus tard, à la lecture par le destinataire.

Activer le filigrane sur un coffre

Les coffres acceptent les mêmes champs. Tous les documents déposés dans le coffre héritent du filigrane lorsque les invités les consultent. C'est le réglage recommandé pour une data room où plusieurs personnes accèdent aux mêmes pièces : combiné à require_email_verification, la variable {recipient_email} permet d'attribuer chaque copie à son lecteur.

const coffre = await coffrify.coffres.create({
  title: 'Due diligence · Série A',
  watermark_enabled: true,
  watermark_text: 'Réservé à {recipient_email} · {download_timestamp}',
  require_email_verification: true,
  allowed_emails: ['investisseur@fonds.fr'],
});
 
console.log(coffre.id, coffre.slug);

Bonnes pratiques

• Préférez un texte court : un libellé trop long se chevauche et devient illisible sur les petites pages.
• Mettez en avant l'identité du lecteur avec {recipient_email} plutôt qu'un simple mot « Confidentiel », car c'est l'attribution qui dissuade le partage.
• Le filigrane est complémentaire : associez-le à password, max_downloads et expires_in_hours pour un partage réellement maîtrisé.
• Pour un partage où le serveur ne doit jamais lire le contenu (mode de bout en bout), gardez à l'esprit que l'incrustation côté serveur dans le PDF suppose que le serveur peut rendre le document : réservez le filigrane embarqué aux partages chiffrés côté serveur.

En résumé, watermark_enabled allume le marquage et watermark_text le personnalise, avec des variables {recipient_email}, {download_timestamp} et {short_code} qui rendent chaque copie traçable. Les mêmes deux champs fonctionnent à l'identique sur les transferts et les coffres, sans jamais modifier le fichier que vous avez déposé.