Appliquer une limite de débit sur les API REST

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 2 minutes de lecture

    • Appliquez une limite de taux aux API REST pour éviter une utilisation excessive ou abusive des éléments de catalogue accessibles au public.

    Avant de commencer

    Rôle requis : admin, catalog_admin web_service_admin

    Pourquoi et quand exécuter cette tâche

    La limitation des taux restreint la création incontrôlée d’éléments de catalogue accessibles au public, atténuant ainsi les risques associés aux acteurs malveillants et aux robots automatisés.

    Procédure

    1. Accédez à la Tout > Services web du système > Règles de limites de taux.
    2. Sélectionnez Nouveau.
      Affichage du formulaire de règles de limite de taux
    3. Entrez les valeurs de champ suivantes.
      Tableau 1. Champs du formulaire Règle de limite de taux d’API REST
      Champ Description
      Ressource d'API REST Valeur dérivée des valeurs saisies dans les champs suivants.
      Nom Nom unique de la règle de limite de taux.
      API REST

      API REST sélectionnée dans la liste de toutes les API REST orientées vers l’extérieur de l’instance.

      Sélectionnez Catalogue de services.
      Version

      Version de REST API. Les valeurs répertoriées dépendent de l’API REST sélectionnée.

      Sélectionnez le plus récent.
      Ressource

      Ressource pour la version. Les valeurs répertoriées dépendent de la version sélectionnée.

      Sélectionnez les ressources requises :

      Par exemple :

      • Acheter un élément
      • Soumettre un créateur d'enregistrement
      • Valider Regex variable (si l’élément se compose d’une variable qui nécessite une validation Regex)
      • Vérifier le guide de commande
      • Valeur d’affichage de variable
      • Vérifier la délégation demandée sur l’élément
      Actif Case à cocher pour indiquer que la règle de limite de taux est active.

      Les règles de limite de taux sont activées par défaut dès que vous les créez. Vous pouvez désactiver les règles de limite de taux pour arrêter l’application d’une limite de taux ou activer les règles de limite de taux pour reprendre l’application d’une limite de taux.
      Limite de demandes par heure Nombre maximal de demandes autorisées par heure.
      Remarque :
      Chaque fois que vous mettez à jour la valeur de ce champ, réinitialise Now Platform le nombre de demandes à 0 et supprime toutes les violations pour l’heure en cours.
      Appliquer à
      Utilisateurs restreints par cette règle :
      • Un seul utilisateur applique la limite de taux à un utilisateur spécifique.
      • Utilisateurs disposant d’un rôle applique la limite de taux à tous les utilisateurs ayant un rôle spécifique.
      • Tous les utilisateurs appliquent la limite de taux à tous les utilisateurs.
      Sélectionnez Utilisateurs dotés d’un rôle.
      Rôle

      Rôle auquel s’applique la limite de taux.

      Sélectionnez Utilisateur invité.
      Remarque :
      S’affiche uniquement lorsque vous sélectionnez Utilisateurs disposant d’un rôle dans le champ Appliquer à .
    4. Sélectionnez Soumettre.

    Résultats

    La limitation des taux est appliquée aux API accessibles au public.