Edge Security Acceleration:Configurer des noms de domaine

Prérequis

Les fonctionnalités Custom Domains et Routes nécessitent toutes deux un site actif dans votre compte.

Un site actif dispose d'un abonnement souscrit et est connecté via un enregistrement NS ou CNAME.

Choisir une méthode de configuration

Associer un domaine personnalisé

Utilisez Custom Domains pour diriger tout le trafic d'un domaine vers une seule instance Functions and Pages.

Liez Functions and Pages au domaine de votre site. Une fois l'association effectuée, accédez à Functions and Pages via le domaine personnalisé. Le domaine associé à Functions and Pages doit appartenir à un site disponible. ESA ajoute automatiquement un enregistrement DNS pour le domaine associé.

1. Connectez-vous à la console ESA, puis dans le volet de navigation de gauche, choisissez Edge Computing and AI > Functions and Pages. Cliquez sur l'instance Functions and Pages cible.

2. Cliquez sur l'onglet Domain Names. Dans la section Custom Domains, cliquez sur Add Domain Name.

3. Saisissez le nom de domaine à associer à votre instance Functions and Pages, par exemple pages.example.com. ESA crée automatiquement un enregistrement DNS pour ce domaine sur le site correspondant.

   Remarque

   Un nouveau domaine hérite de la configuration de son site. Si le site ne possède pas de certificat SSL/TLS, le domaine n'est pas accessible via HTTPS. Configurez SSL/TLS pour activer l'accès HTTPS.

   

4. Suivez les étapes ci-après selon la méthode de connexion de votre site.

   Enregistrement NS

   Si votre site utilise un enregistrement NS, patientez environ une minute pour que l'enregistrement DNS prenne effet. Ouvrez ensuite un navigateur et visitez le domaine personnalisé, par exemple pages.example.com, pour vérifier le résultat.

   Enregistrement CNAME

   Si votre site utilise un enregistrement CNAME, ajoutez un enregistrement CNAME chez votre fournisseur DNS pour activer le domaine.

   1. Dans la liste des domaines personnalisés, localisez votre nouveau domaine et cliquez sur View DNS Records.

      

   2. Copiez la valeur CNAME générée par ESA.

      

   3. Accédez au site web de votre fournisseur DNS et ajoutez un enregistrement CNAME avec les informations suivantes :

      • Host Record : saisissez le préfixe du domaine personnalisé. Pour cet exemple, saisissez pages.

      • Record Type : sélectionnez CNAME.

      • Record Value : collez la valeur CNAME copiée à l'étape précédente.

      

   4. Retournez dans la console ESA et attendez que le CNAME Status affiche Configured.Vous pouvez alors consulter la page en visitant le domaine personnalisé que vous venez d'associer, par exemple pages.example.com, dans un navigateur.

Configurer des routes

Dirigez les requêtes correspondant à des chemins d'URL spécifiques vers une instance Functions and Pages afin d'assurer un contrôle granulaire du trafic. Les requêtes correspondantes sont traitées par Functions and Pages ; les requêtes non correspondantes suivent le flux standard d'accélération et de mise en cache d'ESA. Par exemple, une route pour example.com/a* sur le site example.com envoie les requêtes vers /a, /a1 et /a2 à Functions and Pages, tandis que les requêtes vers /b, /c et /d sont dirigées vers l'origine ou le cache.

1. Connectez-vous à la console ESA, puis dans le volet de navigation de gauche, choisissez Edge Computing and AI > Functions and Pages. Cliquez sur l'instance Functions and Pages cible.

2. Cliquez sur l'onglet Domain Names. Dans la section Routes, cliquez sur Add Route.

3. Saisissez un Route Name. Dans la liste Select Website, sélectionnez le site cible, par exemple example.com.

4. Sélectionnez un Route Mode.

   1. Simple Mode : fait correspondre les requêtes uniquement selon l'URL (nom d'hôte et chemin). Vous pouvez par exemple configurer une règle pour diriger toutes les requêtes dont le préfixe d'URL est pages.example.com vers votre instance Functions and Pages.

   2. Custom Mode : combine plusieurs conditions telles que les en-têtes de requête, les cookies et les méthodes de requête pour une correspondance complexe. Définissez la relation logique entre les conditions (All/Any). Par exemple, transférez une requête vers Functions and Pages uniquement lorsque le Hostname est égal à www.example.com et que l'en-tête de requête User-Agent contient Mobile :

5. Dans un navigateur, visitez une URL correspondant à la route pour observer le résultat.

   

Mode Bypass

L'activation du Bypass Mode pour une route envoie les requêtes correspondantes au service Functions and Pages sous forme de sous-requêtes. Utilisez ce mode pour l'authentification ou la journalisation sans interrompre le flux de requêtes principal vers l'origine :

1. Un client envoie une requête à un point de présence (POP) ESA.

2. La requête correspond à une route et est transférée à Functions and Pages pour des opérations telles que la journalisation ou l'authentification. En mode bypass, le corps de la requête n'est pas transféré à Functions and Pages.

3. Si Functions and Pages renvoie un code d'état 200, la requête passe à l'étape suivante. Si un autre code d'état est renvoyé, ESA arrête le traitement et retourne un code d'état 403 au client.

4. La requête suit le flux ESA standard, où elle est vérifiée par rapport aux politiques de cache ou transférée au serveur d'origine.

5. La réponse provenant d'un succès de cache ou du serveur d'origine est renvoyée au nœud ESA. À ce stade, la réponse n'est plus traitée par Functions and Pages.

6. La réponse est envoyée au client.

Cas d'utilisation

• Journalisation : utilisez le mode bypass pour transférer des requêtes spécifiques à Functions and Pages et définir une logique de journalisation personnalisée dans votre fonction.

• Authentification pour les téléchargements de fichiers volumineux : le transfert de réponses volumineuses via une fonction consomme beaucoup de temps CPU et augmente les coûts. Privilégiez le mode bypass pour vous authentifier d'abord auprès de Functions and Pages, évitant ainsi le transfert du fichier volumineux via la fonction.

FAQ

import { createHash } from "node:crypto";

async function handleRequest(request) {
  const url = new URL(request.url);
  const path = url.pathname;
  const delta = 3600;

  const authKeyTypeA = url.searchParams.get('auth_key');

  const privateKey = 'your_secret_key'
  const currentTimestamp = Math.floor(Date.now() / 1000);

  if (!authKeyTypeA) {
    // In an authentication failure scenario, the edge node returns a 403 error to the client by default.
    return new Response('Unauthorized', { 
      status: 401,
    });
  }

  const [timestamp, rand, uid, signature] = authKeyTypeA.split('-');

  if (currentTimestamp > parseInt(timestamp)+ delta) {
    // In an authentication failure scenario, the edge node returns a 403 error to the client by default.
    return new Response('Link expired', {
      status: 403,
    });
  }

  const signString = [path, timestamp, rand, uid, privateKey].join('-');

  const md5 = createHash('md5').update(signString).digest('hex');

  if (md5 !== signature) {
  
    return new Response('Unauthorized', {
      status: 401
    });
  }

  // If the resource is on another domain, fetch it and return the response.
  // const yourUrl = `https://your-dcdn-domain.com${path}${url.search}`
  // const cdnResponse = await fetch(yourUrl, request)
  // return new Response(cdnResponse.body, cdnResponse)

  // In most cases, fetching from the origin is sufficient.
  return fetch(request.url)
}

export default {
  async fetch(request) {
    return handleRequest(request)
  }
}

import { createHash } from "node:crypto";

    async function handleRequest(request) {
      const url = new URL(request.url);
      const path = url.pathname;
      const delta = 3600;

      const authKeyTypeA = url.searchParams.get("auth_key");

      const privateKey = "your_secret_key";
      const currentTimestamp = Math.floor(Date.now() / 1000);

      if (!authKeyTypeA) {
        // Authentication failed. If you pass false, the edge node returns a 403 error to the client by default.
        return new ResponseBypass(false, {
          status: 401,
        });
      }

      const [timestamp, rand, uid, signature] = authKeyTypeA.split("-");

      if (currentTimestamp > parseInt(timestamp) + delta) {
        // Authentication failed. If you pass false, the edge node returns a 403 error to the client by default.
        return new ResponseBypass(false, {
          status: 403,
        });
      }

      const signString = [path, timestamp, rand, uid, privateKey].join("-");

      const md5 = createHash("md5").update(signString).digest("hex");

      if (md5 !== signature) {
        // Authentication failed. If you pass false, the edge node returns a 403 error to the client by default.
        return new ResponseBypass(false, {
          status: 401,
        });
      }

      // Authentication succeeded. If you pass true, the request proceeds to the origin, and the response is no longer processed by this function.
      const resSuccess = new ResponseBypass(true);
      return resSuccess;
    }

    export default {
      async bypass(request) {
        return handleRequest(request);
      },
    };