Pourquoi ce dispositif
Cirrus Shield bloque automatiquement et temporairement les adresses IP qui envoient un volume anormal de requêtes ou qui accumulent les échecs de connexion. Ce mécanisme protège la plateforme contre les tentatives d’intrusion et garantit des temps de réponse corrects à tous les clients.
Le dispositif s’applique à l’interface web comme à l’API REST. Il est en vigueur depuis le 26 octobre 2026.
Limites appliquées
Les requêtes sont comptées par adresse IP. Pour rester dans un usage normal, ne dépassez pas en moyenne 2 requêtes par seconde et par adresse IP. Au-delà de plusieurs milliers de requêtes en quelques minutes, ou après plusieurs échecs d’authentification rapprochés, l’adresse est bloquée temporairement.
Un premier blocage dure 30 minutes. En cas de récidive, le blocage est prolongé jusqu’à 24 heures.
Tous les utilisateurs qui sortent sur Internet par la même adresse IP (réseau d’entreprise, VPN, serveur d’intégration) partagent le même compteur. Si plusieurs utilisateurs intensifs ou une intégration API partagent une même adresse IP, signalez-le au support (voir dernière section). Les clients qui intègrent l’API peuvent aussi y obtenir les valeurs exactes des limites.
Ce qui se passe en cas de blocage
Une adresse IP bloquée ne peut plus joindre Cirrus Shield : le navigateur ou l’intégration ne parvient plus à se connecter. Les autres adresses IP de votre organisation ne sont pas affectées.
Le déblocage est automatique à la fin de la durée prévue (30 minutes ou 24 heures). Aucune donnée n’est perdue côté Cirrus Shield, mais les requêtes envoyées pendant le blocage ne sont pas traitées : vos intégrations doivent les renvoyer après la levée du blocage.
Bonnes pratiques pour les intégrations API
La plupart des blocages d’intégrations viennent d’une synchronisation complète relancée à intervalle fixe ou d’une boucle de réessais après un échec. Les règles suivantes les évitent :
- Synchronisez uniquement ce qui a changé. Renvoyer à chaque cycle l’ensemble des enregistrements déjà synchronisés multiplie inutilement les appels. Filtrez sur une date de modification ou sur un indicateur de traitement.
- Réutilisez votre jeton d’authentification. Demandez un nouveau jeton seulement quand le précédent est expiré, et non avant chaque appel.
- Arrêtez-vous après un échec d’authentification. Un identifiant ou un jeton invalide ne deviendra pas valide en réessayant : corrigez la configuration au lieu de relancer en boucle.
- Espacez les réessais. Après une erreur, attendez avant de réessayer et augmentez le délai à chaque nouvel échec (par exemple 1, 2, 4 puis 8 minutes).
- Étalez les traitements volumineux. Pour une reprise de données ou un import massif, répartissez les appels dans le temps et prévenez le support à l’avance.
Demander un déblocage ou une exception
Cette démarche est réservée aux clients disposant d’une offre payante, la version gratuite n’incluant pas le support par e-mail. Contactez le support à support@cirrus-shield.com en indiquant :
- l’adresse IP concernée ;
- la date et l’heure approximatives du blocage ;
- l’usage concerné : utilisateurs de l’interface, ou nom et fonction de l’intégration.
Pour une intégration légitime dont le volume dépasse durablement les seuils, nous pouvons autoriser son adresse IP après examen. Cette autorisation suppose une adresse IP fixe et une intégration conforme aux bonnes pratiques ci-dessus. Nous pouvons la retirer si l’intégration dégrade les performances de la plateforme.
