# Protéger les PDF générés par mot de passe


Vous pouvez générer des PDF protégés par mot de passe en passant une clé `_password` dans les **métadonnées** du document. Le fichier généré est chiffré en AES-256 et nécessite le mot de passe pour être ouvert. Si vous omettez `_password`, les documents se génèrent sans chiffrement comme d'habitude.

## Définir le mot de passe via l'API

Incluez la clé `_password` dans l'objet `meta` lorsque vous [créez](../api/documents.md#create-a-document) un document :

```bash
curl https://api.pdfmonkey.io/api/v1/documents \
  -X POST \
  -H 'Authorization: Bearer YOUR_SECRET_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "document": {
      "document_template_id": "YOUR_TEMPLATE_ID",
      "status": "pending",
      "payload": { "name": "Jane Doe" },
      "meta": {
        "_password": "s3cur3-p@ss!"
      }
    }
  }'
```

Vous pouvez combiner `_password` avec d'autres clés meta comme [`_filename`](./nom-de-fichier-personnalise.md) :

```json
{
  "meta": {
    "_filename": "contrat-jane-doe.pdf",
    "_password": "s3cur3-p@ss!"
  }
}
```

## Définir le mot de passe depuis le tableau de bord

1. Ouvrez un document dans l'éditeur de document.
2. Passez à l'onglet **Meta data**.
3. Saisissez la clé `_password` et le mot de passe souhaité :

```json
{
  "_password": "s3cur3-p@ss!"
}
```

4. Cliquez sur **Save**, puis sur **Generate**.

Pour un guide complet, consultez [Générer des documents depuis le tableau de bord](./utiliser-le-tableau-de-bord.md).

## Fonctionnement

Quand `_password` est présent dans le meta, PDFMonkey chiffre le PDF généré en **AES-256** après le rendu. Le destinataire a besoin du mot de passe exact pour ouvrir le document. Sans lui, le contenu reste inaccessible.

- **Tous les templates fonctionnent.** Éditeur Code, Builder, templates existants — la protection par mot de passe marche avec tout.
- **Aucune configuration nécessaire.** Pas besoin d'activer quoi que ce soit sur le template ou votre compte.
- **Compatible avec toutes les intégrations.** Zapier, Make, Workato, n8n, Bubble, Glide, API directe — partout où vous pouvez définir le champ `meta`.
- **Contrôle par document.** Un document peut être protégé pendant que le suivant ne l'est pas.
- **Disponible sur tous les plans.** Plan gratuit inclus.

## Questions fréquentes

**Que se passe-t-il si je ne définis pas de mot de passe ?**

Les documents se génèrent sans chiffrement, exactement comme avant. La protection par mot de passe est optionnelle.

**Puis-je utiliser des données dynamiques dans le mot de passe ?**

Pas directement dans la valeur `_password`. Cependant, dans la plupart des plateformes d'intégration (Zapier, Make, n8n), vous pouvez utiliser des champs dynamiques ou des expressions pour construire la chaîne du mot de passe avant de la transmettre à PDFMonkey.

**La protection par mot de passe fonctionne-t-elle avec les formats d'image ?**

Non. La protection par mot de passe s'applique uniquement à la sortie PDF. Les formats d'image (PNG, WebP, JPG) ne prennent pas en charge le chiffrement.

## Pages associées

- [Nom de fichier personnalisé](./nom-de-fichier-personnalise.md) — une autre clé meta qui contrôle le comportement de la génération
- [Référence API Documents](../api/documents.md) — documentation complète des paramètres `meta` et autres champs
- [Générer des PDF via l'API](./generation-pdf-via-api.md) — workflow complet de génération
- [Générer des documents depuis le tableau de bord](./utiliser-le-tableau-de-bord.md) — utilisation de l'onglet Métadonnées


## FAQ

**Comment protéger un PDF par mot de passe avec PDFMonkey ?**

Passez une clé "_password" dans le champ meta du document. Via l'API, incluez-la dans l'objet meta lors de la création d'un document : "meta": { "_password": "votre-mot-de-passe" }. Le PDF généré sera chiffré en AES-256 et nécessitera le mot de passe pour être ouvert.

**Quel chiffrement PDFMonkey utilise-t-il pour les PDF protégés ?**

PDFMonkey utilise le chiffrement AES-256. Le PDF est chiffré après la génération, et le destinataire a besoin du mot de passe exact que vous avez spécifié pour ouvrir le document.

**Est-ce que je peux générer des PDF sans mot de passe ?**

Oui. Si vous n'incluez pas le champ _password dans le meta, les PDF se génèrent exactement comme avant : pas de chiffrement, pas de mot de passe. La protection par mot de passe est entièrement optionnelle, document par document.