Loading...

Aide CDN.com.tr

URLs signées : liens qui expirent

Protégez un fichier pour qu'il ne puisse être récupéré qu'avec une signature que vous générez, valable jusqu'à un moment que vous choisissez. Les requêtes non signées reçoivent 403, celles qui ont expiré reçoivent 410.

URLs signées : liens qui expirent

Protégez un fichier pour qu'il ne puisse être récupéré qu'avec une signature que vous générez, valable jusqu'à un moment que vous choisissez. Les requêtes non signées reçoivent 403, celles qui ont expiré reçoivent 410.

Vidéo en anglais, sous-titrée en français.

Guide suivant recommande

Chemin dans le panneau

  1. Panneau de gestion
  2. Domaines et règles
  3. URL signées
  4. Clé secrète

Prerequis

  • Un compte avec un domaine ajouté dans l'onglet Domaines
  • Un endroit dans votre application pour générer des liens

Modele de decision

Quels chemins exigent une signature ?

Les URL signées sont un réglage d'une règle de diffusion, pas de tout le compte : seules les requêtes qui correspondent à cette règle exigent une signature, le reste du site reste public. Donnez aux fichiers protégés leur propre dossier, comme /downloads/ ou /video/.

  • Une règle pour le dossier des fichiers payants ou privés : le choix normal
  • Plusieurs dossiers protégés : une règle chacun, chacun avec son propre secret si vous le souhaitez

Combien de temps un lien doit-il rester valide ?

Assez court pour qu'un lien divulgué ne vaille rien, assez long pour qu'une connexion lente puisse terminer le téléchargement. Des minutes pour un document, des heures pour une vidéo volumineuse.

  • Documents et images : 5-15 minutes
  • Vidéo volumineuse ou archives : 1-6 heures

Guide etape par etape

1

Activez-le pour un seul chemin

Ouvrez l'onglet Règles de Domaines et règles, ajoutez ou modifiez la règle du dossier à protéger, activez URL signées et définissez un secret de 16 à 64 lettres, chiffres, - et _. Générer en crée un au hasard.

  • Domaines et règles → Règles → la règle de /downloads/ → URL signées → activé → Générer → Enregistrer la règle

Resultat attendu: Une fois que la configuration atteint les edges, une requête simple vers ce chemin renvoie 403.

2

Générez un lien dans votre application

La signature est la forme base64url du MD5 de l'expiration, du chemin et du secret assemblés, avec un seul espace avant le secret. Ajoutez-la sous la forme md5 et l'expiration sous la forme expires.

  • PHP: $expires = time() + 600; $token = rtrim(strtr(base64_encode(md5($expires . $uri . " " . $secret, true)), "+/", "-_"), "=");
  • Then: https://cdn.example.com/downloads/file.zip?md5=TOKEN&expires=EXPIRES

Resultat attendu: Le lien est servi jusqu'à ce que l'expiration passe.

3

Vérifiez les trois résultats

Vérifiez les cas d'échec en plus de celui de réussite, car ce sont eux que votre équipe de support verra dans les rapports.

  • Récupérez sans paramètres (403)
  • Récupérez avec une expiration passée (410)
  • Récupérez un lien valide (200)

Resultat attendu: Trois réponses différentes, pour qu'un rapport d'utilisateur puisse être classé à partir du seul code de statut.

Verification

  • curl -o /dev/null -w "%{http_code}" "https://cdn.example.com/downloads/file.zip" → 403
  • curl -o /dev/null -w "%{http_code}" "https://cdn.example.com/downloads/file.zip?md5=TOKEN&expires=PAST" → 410

Cas d'usage

Vous vendez une vidéo, un rapport ou un téléchargement, et le lien ne doit pas pouvoir être partagé indéfiniment. La protection anti-hotlink empêche d'autres sites d'intégrer vos fichiers ; une URL signée va plus loin et rend chaque lien personnel et limité dans le temps.

Workflow rapide

  1. Domaines et règles → Règles → ajoutez ou modifiez la règle du dossier à protéger (par exemple /downloads/) → activez URL signées et définissez un secret, ou laissez le panneau en générer un.
  2. Votre application construit le lien : elle hache l'heure d'expiration, le chemin et le secret, puis ajoute la signature et l'expiration à l'URL.
  3. L'edge vérifie la signature avant toute autre chose. Les liens valides sont servis et mis en cache normalement ; les liens invalides n'atteignent jamais votre origin.
  4. Faites tourner le secret en cas de fuite, ou quand quelqu'un s'en va. Chaque lien signé avec l'ancien secret cesse de fonctionner immédiatement.

Verifications

  • Un lien sans les paramètres renvoie 403.
  • Un lien dont l'expiration est dépassée renvoie 410 — un code distinct, pour que vos propres logs distinguent les deux cas.
  • Un lien avec une signature correcte est servi, et la réponse est mise en cache comme n'importe quelle autre.