Tous les produits
Search
Centre de documentation

ApsaraVideo VOD:Configurer une liste noire ou une liste blanche User-Agent

Dernière mise à jour :Sep 25, 2026

L'en-tête HTTP User-Agent identifie le client à l'origine de la requête, notamment le système d'exploitation, sa version, le navigateur et sa version. Configurez une liste noire ou une liste blanche User-Agent pour filtrer les requêtes selon l'identité du client et contrôler l'accès aux ressources ApsaraVideo VOD.

Notes d'utilisation

  • Liste blanche : seules les requêtes dont l'en-tête User-Agent correspond à une règle de la liste blanche peuvent accéder à vos ressources.

  • Liste noire : les requêtes dont l'en-tête User-Agent correspond à une règle de la liste noire sont bloquées. Une requête bloquée atteint toujours un nœud de périphérie (POP), mais ce dernier la rejette et renvoie un code d'état HTTP 403. Les requêtes refusées sont enregistrées dans les journaux CDN.

  • La liste noire et la liste blanche s'excluent mutuellement ; vous ne pouvez pas les configurer simultanément.

Procédure

  1. Connectez-vous à la console ApsaraVideo VOD.

  2. Dans le volet de navigation de gauche, choisissez Configuration Management > CDN Configuration > Domain Names.

  3. Recherchez le nom de domaine à configurer et cliquez sur Configure dans la colonne Actions.

  4. Dans le volet de navigation de gauche du nom de domaine sélectionné, cliquez sur Resource Access Control.

  5. Cliquez sur l'onglet User-Agent Blacklist/Whitelist.

  6. Sous l'onglet User-Agent Blacklist/Whitelist, cliquez sur Modify.

  7. Configurez la Blacklist ou la Whitelist User-Agent selon les instructions.

    Élément

    Description

    Type

    Le type de liste.

    • Blacklist

      Si l'en-tête User-Agent d'une requête correspond à une valeur figurant dans la liste noire, l'accès est refusé et un code d'état 403 est renvoyé.

    • Whitelist

      Seules les requêtes dont l'en-tête User-Agent correspond à une valeur figurant dans la liste blanche peuvent accéder aux ressources du domaine.

    Rules

    Spécifiez les valeurs User-Agent. Séparez plusieurs valeurs par une barre verticale (|). Vous pouvez utiliser un astérisque () comme caractère générique. Exemple : curl|IE|chrome|firefox*.

    Remarque
    • Pour contrôler l'accès des requêtes dont l'en-tête User-Agent est vide, utilisez this-is-empty-ua pour représenter une valeur User-Agent vide.

      • Sur une liste blanche : si une règle inclut this-is-empty-ua, les requêtes dont l'en-tête User-Agent est vide sont autorisées.

      • Sur une liste noire : si une règle inclut this-is-empty-ua, les requêtes dont l'en-tête User-Agent est vide sont refusées.

    • La liste noire et la liste blanche User-Agent ne prennent pas en charge le contrôle d'accès pour les requêtes dépourvues d'en-tête User-Agent. Vous pouvez utiliser EdgeScript pour activer cette fonctionnalité. Pour plus d'informations, consultez la rubrique Présentation d'EdgeScript.

  8. Cliquez sur OK pour terminer la configuration.

Exemples de configuration

  • Exemple 1 : configurer une liste blanche

    Règle : *IE*|*firefox*

    Résultat attendu : seules les requêtes envoyées depuis IE ou Firefox sont autorisées à accéder aux ressources sur les nœuds de périphérie (POP).

  • Exemple 2 : configurer une liste noire

    Règle : *IE*|this-is-empty-ua

    Résultat attendu : les requêtes envoyées depuis IE ou contenant un en-tête User-Agent vide sont rejetées.